contents

Arguments: texture

Returns (or sets with setf) a nested list that denotes the pixels of a texture object. Each member of the contents list represents one row of the pixmap and is itself a list of non-negative integer values for the columns.

While the pixels are typically stored internally as an array, the format of the array may differ on various platforms or on different releases of Allegro, and so the contents list is the platform- and release-independent programmatic interface to the pixels.

A texture object is used by a pixmap object to specify its pixels, or may be used independently along with a texture-info object. The latter option is provided mostly for backward compatibility, where an aclwin 3.0.x texture array must still be converted to a texture CLOS object for 5.0 and later. The pixmap object alternative is now recommended, though, as it encapsulates the components of a texture, mask-texture, texture-info, and pixmap handle into a single object.

contents is a property of the texture and pixmap classes.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.