"

 COPYRIGHT (c) 1996 by Claus Gittinger

              All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libview2' }"

ImageReader subclass:#PNGReader

	instanceVariableNames:'colorType depth compressionMethod filterMethod interlaceMode

		redBytes greenBytes blueBytes'

	classVariableNames:''

	poolDictionaries:''

	category:'Graphics-Images-Readers'

!

!PNGReader class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1996 by Claus Gittinger

              All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    This class will provide methods for loading PNG pictures.

    It is currenty unfinished and untested (need a Zlib inflater).

    In the meantime, use a pngtoXXX converter.

    [See also:]

        Image Form Icon

        BlitImageReader FaceReader GIFReader JPEGReader PBMReader PCXReader 

        ST80FormReader SunRasterReader TargaReader TIFFReader WindowsIconReader 

        XBMReader XPMReader XWDReader 

    [author:]

        Claus Gittinger

"

!

examples

"

    PNGReader fromFile:'/home/cg/AudioExplorer_51_files/use_small.png'

"

! !

!PNGReader class methodsFor:'initialization'!

initialize

    "install myself in the Image classes fileFormat table

     for the `.png' extension."

    "/ not yet finished - do not add

    "/ MIMETypes defineImageType:'image/x-png'  suffix:'png' reader:self.

    "Modified: 1.2.1997 / 15:02:47 / cg"

! !

!PNGReader class methodsFor:'testing'!

isValidImageFile:aFileName

    "return true, if aFileName contains a PNG image"

    |inStream magic|

    inStream := self streamReadingFile:aFileName.

    inStream isNil ifTrue:[^ false].

    inStream binary.

    magic := ByteArray new:8.

    inStream nextBytes:8 into:magic.

    inStream close.

    ^ (magic = #[137 80 78 71 13 10 26 10])

    "

     self isValidImageFile:'/home/cg/AudioExplorer_51_files/use_small.png'

    "

    "Modified: 21.6.1996 / 20:38:46 / cg"

! !

!PNGReader methodsFor:'private'!

getChunk

    |len type crc|

    inStream atEnd ifTrue:[^ false].

    len := inStream nextLongMSB:true.

    type := String new:4.

    (inStream nextBytes:4 into:type) ~~ 4 ifTrue:[^ false].

"/ 'len: ' print. len print. ' type: ' print. type printCR.

    type = 'IEND' ifTrue:[^ false].

    (self processChunk:type len:len) ifFalse:[^ false].

    crc := inStream nextLongMSB:true.  "/ ignored - for now

    ^ true

    "Created: 21.6.1996 / 21:09:36 / cg"

    "Modified: 21.6.1996 / 21:20:26 / cg"

!

getIHDRChunk

    |len type crc|

    len := inStream nextLongMSB:true.

    type := String new:4.

    inStream nextBytes:4 into:type.

    type = 'IHDR' ifFalse:[self halt. ^ false].

    len == 13 ifFalse:[self halt. ^ false].

    width := inStream nextLongMSB:true.        

    height := inStream nextLongMSB:true.        

    (width <= 0 or:[height <= 0]) ifTrue:[

        'PNGReader: invalid dimension(s)' infoPrintCR.

        ^ false.

    ].

    self reportDimension.

    depth := inStream nextByte.

    colorType := inStream nextByte.

    compressionMethod := inStream nextByte.

    filterMethod := inStream nextByte.

    interlaceMode := inStream nextByte.

    inStream skip:4.

"/    crc := inStream nextLongMSB:true.

    ^ true

    "Modified: 21.6.1996 / 21:38:35 / cg"

!

processBKGDChunkLen:len

    inStream skip:len.

    ^ true

    "Created: 21.6.1996 / 21:15:49 / cg"

!

processChunk:type len:len

    type = 'gAMA' ifTrue:[^ self processGAMAChunkLen:len].

    type = 'sBIT' ifTrue:[^ self processSBITChunkLen:len].

    type = 'tEXt' ifTrue:[^ self processTEXTChunkLen:len].

    type = 'IDAT' ifTrue:[^ self processIDATChunkLen:len].

    type = 'tIME' ifTrue:[^ self processTIMEChunkLen:len].

    type = 'bKGD' ifTrue:[^ self processBKGDChunkLen:len].

    type = 'zTXt' ifTrue:[^ self processZTXTChunkLen:len].

    type = 'PLTE' ifTrue:[^ self processPLTEChunkLen:len].

    type = 'pHYs' ifTrue:[^ self processPHYSChunkLen:len].

    type = 'tRNS' ifTrue:[^ self processTRNSChunkLen:len].

    type = 'IHDR' ifTrue:[^ self processIHDRChunkLen:len].

    ('PNGReader: unrecognized chunk: ' , type , ' ignored.') infoPrintCR.

    inStream skip:len.

    ^ true.

    "Created: 21.6.1996 / 21:10:37 / cg"

    "Modified: 21.6.1996 / 21:22:37 / cg"

!

processGAMAChunkLen:len

    inStream skip:len.

    ^ true

    "Created: 21.6.1996 / 21:10:52 / cg"

!

processIDATChunkLen:len

    interlaceMode == 0 ifTrue: [

        ^ self processNonInterlacedDATA:len

    ]. 

    ^ self processInterlacedDATA:len

!

processIHDRChunkLen:len

    "header chunk - currently unhandled"

    |width height bitsPerChannel interlaceMethod palette image bitsPerPixel bytesPerScanline rowSize|

self halt.        

    width := inStream nextLongMSB:true.   "/ 1..4

    height := inStream nextLongMSB:true.  "/ 5..8

    bitsPerChannel := inStream nextByte.  "/ 9

    colorType := inStream nextByte.       "/ 10

    inStream nextByte. "/ 11

    inStream nextByte. "/ 12

    interlaceMethod := inStream nextByte. "/ 13

    (#(2 4 6) includes: colorType) ifTrue:[

        depth := 32.

        palette := self class defaultPalette.

        image := Image extent: width @ height depth: depth palette: palette

    ].

    (#(0 3) includes: colorType) ifTrue:[ 

        depth := bitsPerChannel min: 8.

        image := Image extent: width @ height

                       depth: depth

                       palette: (colorType = 0 

                                        ifTrue: [self grayColorsFor: depth] 

                                        ifFalse: [palette := self class defaultPalette])].

    bitsPerPixel := (BPP at: colorType + 1) at: bitsPerChannel highBit.

    bytesPerScanline := (width * bitsPerPixel + 7) // 8.

    rowSize := image width * image depth + 31 >> 5

!

processInterlacedDATA:len

    inStream skip:len.

    ^ true

!

processNonInterlacedDATA:len

    | zlibReader filter temp prevScanline thisScanline bytesPerScanline filtersSeen|

    zlibReader := ZLibReadStream on:inStream from: 1 to:len.

    prevScanline := ByteArray new: bytesPerScanline.

    thisScanline := ByteArray new: bytesPerScanline.

    0 to: height - 1 do: 

            [:index | 

            filter := (zlibReader next: 1) first.

            filtersSeen add: filter.

            (filter isNil or: [(filter between: 0 and: 4) not]) ifTrue: [^self].

            thisScanline := zlibReader next: bytesPerScanline into: thisScanline startingAt: 1.

            self filterScanline: filter count: bytesPerScanline.

            self copyPixels: index.

            temp := prevScanline.

            prevScanline := thisScanline.

            thisScanline := temp]

!

processPHYSChunkLen:len

    "physical pixel chunk - currently unhandled"

    'PNGReader: unhandled chunk type: PHYS' infoPrintCR.

    ^ false

!

processPLTEChunkLen:len

    "read a color palette"

    |n "{ Class: SmallInteger }"|

    (len \\ 3) ~~ 0 ifTrue:[

        'PNGReader: invalid size of PLTE chunk' infoPrintCR.

        ^ false

    ].

    n := len // 3.

    redBytes := ByteArray new:n.

    greenBytes := ByteArray new:n.

    blueBytes := ByteArray new:n.

    1 to:n do:[:i |

        redBytes at:i put:(inStream nextByte).

        greenBytes at:i put:(inStream nextByte).

        blueBytes at:i put:(inStream nextByte)

    ].

    ^ true

    "Created: 21.6.1996 / 21:22:28 / cg"

    "Modified: 21.6.1996 / 21:43:01 / cg"

!

processSBITChunkLen:len

    inStream skip:len.

    ^ true

    "Created: 21.6.1996 / 21:13:09 / cg"

!

processTEXTChunkLen:len

    inStream skip:len.

    ^ true

    "Modified: 21.6.1996 / 21:15:27 / cg"

!

processTIMEChunkLen:len

    inStream skip:len.

    ^ true

    "Created: 21.6.1996 / 21:15:43 / cg"

    "Modified: 21.6.1996 / 21:20:42 / cg"

!

processZTXTChunkLen:len

    inStream skip:len.

    ^ true

    "Created: 21.6.1996 / 21:15:58 / cg"

! !

!PNGReader methodsFor:'private-reading'!

setColorType:colorType

    colorType == 0 ifTrue:[

        photometric := #blackIs0.

        samplesPerPixel := 1.

        bitsPerSample := Array with:depth.

        ^ true.

    ].

    colorType == 2 ifTrue:[

        depth < 8 ifTrue:[

            'PNGReader: invalid colorType/depth combination' infoPrintCR.

            ^ false.

        ].

        photometric := #rgb.

        samplesPerPixel := 3.

        bitsPerSample := Array with:depth with:depth with:depth.

        ^ true.

    ].

    colorType == 3 ifTrue:[

        depth == 16 ifTrue:[

            'PNGReader: invalid colorType/depth combination' infoPrintCR.

            ^ false.

        ].

        photometric := #palette.

        samplesPerPixel := 1.

        bitsPerSample := Array with:depth.

        ^ true.

    ].

    colorType == 4 ifTrue:[

        depth < 8 ifTrue:[

            'PNGReader: invalid colorType/depth combination' infoPrintCR.

            ^ false.

        ].

        photometric := #blackIs0.

        samplesPerPixel := 2.

        bitsPerSample := Array with:depth with:depth.

        ^ true.

    ].

    colorType == 6 ifTrue:[

        depth < 8 ifTrue:[

            'PNGReader: invalid colorType/depth combination' infoPrintCR.

            ^ false.

        ].

        photometric := #rgb.

        samplesPerPixel := 4.

        bitsPerSample := Array with:depth with:depth with:depth with:depth.

        ^ true.

    ].

    ('PNGReader: invalid colorType: ' , colorType printString , '.') infoPrintCR.

    ^ false

! !

!PNGReader methodsFor:'reading'!

fromStream:aStream

    "read a stream containing a PNG image.

     Leave image description in instance variables."

    |header|

    inStream := aStream.

    aStream binary.

    "PNG-files are always msb (network-world)"

    byteOrder := #msb.

    header := ByteArray new:8.

    aStream nextBytes:8 into:header.

    header ~= #[137 80 78 71 13 10 26 10] ifTrue:[

        'PNGReader: not a png file.' infoPrintCR.

        ^ nil

    ].

    (self getIHDRChunk) ifFalse:[

        'PNGReader: required IHDR chunk missing.' infoPrintCR.

        ^ nil

    ].

    compressionMethod ~~ 0 ifTrue:[

        ('PNGReader: compressionMethod ' , compressionMethod printString , ' not supported.') infoPrintCR.

        ^ nil

    ].

    filterMethod > 0 ifTrue:[

        'PNGReader: invalid filterMethod' infoPrintCR.

        ^ nil.

    ].

    interlaceMode > 1 ifTrue:[

        'PNGReader: invalid interlaceMode' infoPrintCR.

        ^ nil.

    ].

    (self setColorType:colorType) ifFalse:[

        ^ nil

    ].

    [self getChunk] whileTrue.

    photometric == #palette ifTrue:[

        redBytes isNil ifTrue:[

            'PNGReader: missing palette chunk.' infoPrintCR.

            ^ nil

        ].

        colorMap := MappedPalette 

                        redVector:redBytes 

                        greenVector:greenBytes 

                        blueVector:blueBytes.

    ].

    self halt.

    "

     PNGReader fromFile:'/home/cg/libpng-0.89c/pngtest.png'

    "

    "Modified: 21.6.1996 / 21:44:34 / cg"

! !

!PNGReader class methodsFor:'documentation'!

version

    ^ '$Header: /cvs/stx/stx/libview2/PNGReader.st,v 1.10 2003-11-19 15:38:33 cg Exp $'

! !

PNGReader initialize!