image->load

Documentation
- Reference manual
- Packages
  - XPCE
    - Classes
      - class image
        
        Send methods
        
        image->initialise
        
        image->unlink
        
        image->load
        
        image->save
        
        image->resize
        
        image->copy
        
        image->draw_in
        
        image->clear
        
        image->fill
        
        image->pixel
        
        image->has_alpha

image ->load: from=[source_sink], path=[char_array]

Load pixels from a file or other source_sink. When the source is a file, it is first located via file->find on path (defaults to image.path).

The decoder is SDL_image, so PNG, JPEG, BMP, GIF, PCX and the other formats supported by SDL_image all load. SVG is recognised by file extension or by sniffing the stream and is rendered through SDL's size-aware SVG loader:

both image<-width and image<-height non-zero â SVG is rendered at exactly that size;
both zero â SVG viewport size is used;
one of the two zero â the other dimension scales to preserve the SVG's aspect ratio.
Streams that are not SVG fall back to a built-in PNM reader when SDL_image cannot interpret them.

See also
pce_image_directory/1