Provided by: xcftools_1.0.7-3ubuntu1_amd64 bug

NAVN

       xcf2pnm - konverter xcf-filer til ppm/pgm/pbm-format

OVERBLIK

       xcf2pnm [ flag ] filnavn [ lagnavne ]

BESKRIVELSE

       xcf2pnm  er  et  kommandolinjeværktøj til at fladgøre og konvertere billedfiler i gimp(1)s
       interne format XCF til de generelle billedformater pbm(5), pgm(5) og ppm(5).   Det  kræver
       ikke at Gimp selv er installeret.

ALMINDELIGE FLAG

       -a filnavn, --alpha filnavn
               Skriv  en  gennemsigtighedsmaske til filnavn som en pgm(5)-fil, udover det normale
               uddata.   Hvis  det  fladgjorte  billede  slet  ikke  har  (helt  eller   delvist)
               gennemsigtige  partier,  vil  der  fremkomme en fejlbesked og afslutningskode 101;
               dette kan undertrykkes med -A-flaget.

       -A, --force-alpha
               Konstruér  en  triviel  gennemsigtighedskanal  selvom  billedet   er   fuldstændig
               ugennemsigtigt.

       -b farve, --background farve
               Giv  gennemsigtige  partier  af billedet denne farve.  Baggrundsfarven kan angives
               hexadecimalt som #rrggbb eller  #rgb,  eller  med  et  X11-farvenavn  (sidstnævnte
               virker kun hvis der kan findes en database med farvenavne i en standardplacering).

       -c, --color, --colour
               Brug  RGB-format  for  uddata  selvom  der  er mere kompakte alternative formater.
               Dette bliver valgt automatisk hvis uddatafilens navn ender på .ppm.

       -C, --autocrop
               Placer det konvertede område af billedet til så det netop dækker alle  de  synlige
               (eller  valgte)  lag.   Billedet  kan  blive  større  eller  mindre  end lærredet,
               afhængigt af de synlige lags størrelse og placering.  (Bemærk at tilskæringen ikke
               tager hensyn til indholdet af lagene).

               Normalt vil det konverterede område være det samme som XCF-lærredet.

       -D, --dissolve
               Foretag  et  "opløs"-skridt for at udrydde delvis gennemsigtighed i det fladgjorte
               billede.  Hvis -b-flaget også gives, sker dette før baggrundsfarven påføres.

       -f, --full-image
               Start med at  fladgøre  hele  billedet  til  RAM,  og  analysér  så  billedet  før
               detaljerne i uddataformatet bliver besluttet (fx om gråtoner er tilstrækkeligt til
               at repræsentere billeder).  Hvis dette flag ikke gives, vil programmet  nøjes  med
               at fladgøre en enkelt række "fliser" (af højden 64 pixels) ad gangen.

       -g, --gray, --grey
               Repræsentér  uddata  som  gråtoner  selv  hvis  det  er rent sort/hvidt.  Stop med
               afslutningskode 103 hvis der mødes  nogen  farvede  pixels.   Dette  bliver  valgt
               automatisk hvis uddatafilens navn ender på .pgm.

       -G, --for-gif
               Påstå at der ikke er nogen delvist gennemsigtige pixels i uddata (hvilket muliggør
               en  effektivere  repræsentation  af   gennemsigtighed   i   uddata).    Stop   med
               afslutningskode  102 hvis der alligevel findes nogen delvist gennemsigtige pixels.
               Hvis -b-flaget også gives, handler denne test om om der er  delvist  gennemsigtige
               pixels over den angivne baggrund.

       -h, --help
               Udskriv en oversigt over flag og kommandolinjesyntaks, og afslut med kode 0.

       -j, --bzip
               Gør det samme som -Z bzcat.  Vælges automatisk hvis filnavnet slutter med bz2.

       -m, --mono
               Repræsentér  uddata  som et rent sort/hvidt billede.  Stop med afslutningskode 103
               hvis ikke alle pixels er enten sorte eller hvide.  Dette bliver  valgt  automatisk
               hvis uddatafilens navn ender på .pbm.

       -n, --pnm
               Lad  være med at bruge uddatafilnavnet til at vælge mellem -c, -g og -m, og vælg i
               stedet  et  uddataformat   på   grundlag   af   billedets   indhold.    Dette   er
               standardfremgangsmåden  hvis  filnavnet ikke kan genkendes, og når billedet bliver
               skrevet til standarduddata.

       -o filnavn, --output filnavn
               Skriv det konverterede billede til filnavn i stedet for til standarduddata.

       -O x,y, --offset x,y
               Forskyd det konverterede billede fra det øverste venstre hjørne  af  XCF-lærredet.
               Bruges normalt sammen med -S.

       -S bxh, --size bxh
               Beskær det konverterede billede til bredde b og højde b.

       -T, --truecolor
               Brug  fuldt  RGB-farverum  til  at fladgøre indekserede billeder.  Hvis dette flag
               ikke gives, vil xcf2pnm efterligne Gimps nuværende princip, hvor gennemsigtigheden
               af  hver  pixel afrundes til enten "helt gennemsigtig" eller "helt ugennemsigtig",
               og fortolke alle lagtilstande som Normal.

       -u, --utf8
               Brug den  rå  UTF-8-repræsentation  fra  XCF-filen  til  at  sammenligne  og  vise
               lagnavne.   Normalt forsøger programmet at transkribere lagnavnene til det tegnsæt
               der angives af lokalitetsinstillingen.

       -v, --verbose
               Giv fremgangsbeskeder til standardfejl undervejs.

       -V, --version
               Skriv versionsnummeret for xcftools til standarduddata, og afslut med kode 0.

       -z, --gzip
               Gør det samme som -Z zcat.  Vælges automatisk hvis filnavnet slutter med gz.

       -Z kommando, --unpack kommando
               Angiv en kommando som inddatafilen skal behandles af før  den  kan  fortolkes  som
               XCF-fil.  Kommandoen  bliver  startet  som  kommando  filnavn,  og skal skrive sit
               resultat til standarduddata.  Bemærk at kommando ikke  kan  indeholde  argumenter.
               Hvis  filnavnet  ender  på  gz  eller  bz2,  vil  et  udpakkeprogram  blive  valgt
               automatisk; dette kan slås fra ved at angive -Z cat (hvilket bliver  optimeret  så
               der ikke faktisk bliver startet end cat(1)-proces).

       Visse grupper af flag udelukker gensidigt hinanden.  I hver af de følgende grupper vil det
       sidst givne flag vinde:

       1)  -A og -b.

       2)  -c, -g, -m og -n.

       3)  -D og -G.

       4)  -j, -z og -Z.

       5)  -C og -O/-S.

VALG AF LAG

       Hvis kommandolinjen ikke indeholder noget lagnavn, bliver alle de synlige lag i  XCF-filen
       fladgjort  til  et  enkelt  uddatabillede.  Man kan også vælge de lag der skal kombineres,
       udtrykkeligt ved at angive deres  navne  som  selvstændige  kommandolinjeargumenter  efter
       navnet   på  inddatafilen.  I det tilfælde vil uddata kun indeholde de angivne lag. Lagene
       vil blive kombineret i den rækkefølge de står på kommandolinjen,  med  det  lag  der  står
       længst  til  venstre,  som  det  "nederste" - det vil sige at den indbyrdes position i XCF
       filen ikke betyder noget.

       De følgende flag kan gives efter et lagnavn for at tilsidesætte lagets globale egenskaber:

       --mask  Aktivér lagmasken.

       --mode mode
               Vælg lagtilstanden (fx Normal eller LægTil).

       --nomask
               Deaktivér lagmasken.

       --opacity n
               Vælg gennemsigtighed på  en  skala  fra  0  (helt  gennemsigtigt)  til  255  (helt
               ugennemsigtig).

       --percent n
               Vælg  gennemsigtighed  på  en  skala  fra  0  (helt  gennemsigtigt)  til 100 (helt
               ugennemsigtig).

AFSLUTNINGSKODER

       Her er de mulige afslutningskoder fra xcf2pnm:

       0    Alt OK

       20   Gal kommandolinjesyntaks, herunder ukendte farvenavne i -B (eller farvenavnsdatabasen
            mangler).

       21   Den angivne XCF-fil findes ikke eller kan ikke læses.

       22   Et  lag  der angives på kommandolinjen findes ikke, eller --mask-flaget er anvendt på
            et lag der ikke har nogen lagmaske.

       100  Der er fundet gennemsigtige pixels, men hverken -a eller -b er specificeret.

       101  -a-flaget er givet, men billedet er fuldstændig  ugennemsigtigt.   (Brug  -A  for  at
            ignorere dette).

       102  -G-flaget er givet, men billedet indeholder delvist gennemsigtige pixels.

       103  -g-  (eller  -m-)flaget  er  givet, men billedet indeholder farvede (eller mellemgrå)
            pixels.

       123  XCF-filen indeholder egenskaber som xcftools ikke forstår.  (Der  er  så  vidt  vides
            ingen måde at få Gimp til at skrive en XCF-fil som medfører denne aflutningskode. Lad
            venligst forfatteren vide det hvis du opdager én).

       125  XCF-filen er beskadiget eller ugyldig.

       126  Det lykkedes ikke at udføre udpakkeprogrammet (eller det blev dræbt undervejs).

       127  Uventet I/O-fejl, interne fejl og lignede "umulige" situationer.

       Hvis  et  udpakkeprogram  stopper  med  en  fejlkode,  bliver  denne  kode  også  xcf2pnms
       afslutningskode.

EKSEMPLER

              xcf2pnm -b white noget.xcf > noget.ppm

              xcf2pnm -a noget-gnms.pgm -o noget.pgm noget.xcf Lag1 Lag2

       Følgende kommando tjekker om det fladgjorte billede indeholder nogen gennemsigtighed:

              xcf2pnm noget.xcf > /dev/null

       For at tjekke om det fladgjorte indeholder nogen delvis gennemsigtighed kan man bruge

              xcf2pnm -b white -G > /dev/null

FEJL OG BEGRÆNSNINGER

       Når flere delvist gennemsigtige lag skal kombineres, bliver pixelværdierne kombineret uden
       gammakorrektion. (Sådan gør Gimp det også). Ved kombinationen  vil  der  uvægerligt  opstå
       mindre  afrundingsfejl  - nogen gange giver xcf2pnm andre fejl end Gimp selv, især når der
       er tale om mere end to lag, eller ved nogen af  de  mere  eksotiske  lagtilstande.   Disse
       forskelle er normalt ikke synlige.

       Flydende markeringer bliver p.t. ikke behandlet korrekt.

       Der er sikkert også andre fejl som viser sig i særlige situationer.  Hvis du finder en, så
       vær rar at fortælle forfatteren om den.

FILER

       /etc/X11/rgb.txt

       /usr/share/X11/rgb.txt

       /usr/lib/X11/rgb.txt
               Database med farvenavne der forstås af -b.

FORFATTER

       xcf2pnm og denne manualside er skrevet af Henning Makholm <henning@makholm.net>.

SE OGSÅ

       xcfinfo(1), xcf2png(1)