Gorilla.Context.Texturing

Fields

• protected FKind : TGorillaTextureKind
  
• protected FTextureUnit : Integer
  
• protected FComponents : TPixelFormatEx
  
• protected FFormat : TPixelFormatEx
  
• protected FDataType : TGorillaTextureDataType
  
• protected FWrapS : TGorillaTextureWrap
  
• protected FWrapT : TGorillaTextureWrap
  
• protected FWrapR : TGorillaTextureWrap
  
• protected FBorderColor : TAlphaColorF
  
• protected FDepth : Integer
  
• protected FAttachedCubeMapFace : TGorillaCubeMapFace
  
• protected FIsCompressed : Boolean
  
• protected FBuffer : Pointer
  
• protected FBufferSize : Int64
  

Methods

• public constructor Create  ( ) ;
• public destructor Destroy  ( ) ;
• protected procedure SetFormat  ( const  AValue :  TPixelFormatEx ) ;
• protected procedure InternalAssignError  ( Source :  TPersistent ) ;
• protected procedure InheritedAssign  ( Source :  TPersistent ) ;
• public procedure Assign  ( Source :  TPersistent ) ;  override;

  Overrides the internal assignment routine to apply gorilla specific extended fields to the texture.

• public procedure GetBindingAndKind  ( out  ABinding :  Cardinal; out  AKind :  Cardinal ) ;

  Returns the graphics api value (f.e. OpenGL) for texture binding type (GL_TEXTURE_BINDING_2D, GL_TEXTURE_BINDING_3D, GL_TEXTURE_BINDING_CUBE_MAP) and texture kind (GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_CUBE_MAP)

• public procedure GetFormatAndType  ( out  AComps :  Cardinal; out  AFormat :  Cardinal; out  ADataType :  Cardinal ) ;

  Request the graphics api value (f.e. OpenGL) for components (internal-format), format and datatype.

Properties

• public Kind : TGorillaTextureKind

  Define which kind of texture should be established.

  read FKind
  write FKind
  
• public TextureUnit : Integer

  Stores the texture unit id which was used at latest activation, f.e. "GL_TEXTURE0", "GL_TEXTURE1", ...

  read FTextureUnit
  write FTextureUnit
  
• public Components : TPixelFormatEx

  Initializing a texture allows a format value and a component value.

  read FComponents
  write FComponents
  
• public Format : TPixelFormatEx

  Extends the basic "PixelFormat" field. This allows to add more types of color components. Check out the TPixelFormatEx type.

  read FFormat
  write SetFormat
  
• public DataType : TGorillaTextureDataType

  Allows to read / write the datatype of bytes in a texture: dtByte, dtUnsignedByte, dtShort, dtUnsignedShort, dtInt, dtUnsignedInt, dtFloat, dt2Bytes, dt3Bytes, dt4Bytes, dtDouble

  read FDataType
  write FDataType
  
• public WrapS : TGorillaTextureWrap

  Allows to read / write the wrapping on S-axis: Clamp, ClampToEdge, ClampToBorder, Repeated, MirroredRepeat

  read FWrapS
  write FWrapS
  
• public WrapT : TGorillaTextureWrap

  Allows to read / write the wrapping on T-axis: Clamp, ClampToEdge, ClampToBorder, Repeated, MirroredRepeat

  read FWrapT
  write FWrapT
  
• public WrapR : TGorillaTextureWrap

  Allows to read / write the wrapping on R-axis: Clamp, ClampToEdge, ClampToBorder, Repeated, MirroredRepeat

  read FWrapR
  write FWrapR
  
• public BorderColor : TAlphaColorF

  Color of the texture border.

  read FBorderColor
  write FBorderColor
  
• public Depth : Integer

  Depth value support for 3D texture types.

  read FDepth
  write FDepth
  
• public AttachedCubeMapFace : TGorillaCubeMapFace

  Before attaching a cubemap texture for FBO rendering you have to define which side will be rendered. Set this property before calling FBO.AttachTexture(...)

  read FAttachedCubeMapFace
  write FAttachedCubeMapFace
  
• public IsCompressed : Boolean

  Defines if a texture is compressed in GPU memory or not. Set this property by the owning TGorillaTextureBitmap component and not directly in this texture object, because compressed image data is stored in the owning bitmap.

  read FIsCompressed
  write FIsCompressed
  
• public Buffer : Pointer
  read FBuffer
  write FBuffer
  
• public BufferSize : Int64
  read FBufferSize
  write FBufferSize
  

Fields

• public FTexture : TTexture
  

Fields

• protected FKind : TGorillaTextureKind
  
• protected FComponents : TPixelFormatEx
  
• protected FFormat : TPixelFormatEx
  
• protected FMinFilter : TTextureFilter
  
• protected FMagFilter : TTextureFilter
  
• protected FWrapS : TGorillaTextureWrap
  
• protected FWrapT : TGorillaTextureWrap
  
• protected FWrapR : TGorillaTextureWrap
  
• protected FDataType : TGorillaTextureDataType
  
• protected FStyle : TTextureStyles
  
• protected FBorderColor : TAlphaColorF
  
• protected FDepth : Integer
  
• protected FAttachedCubeMapFace : TGorillaCubeMapFace
  
• protected FProtectFormatSettings : Boolean
  
• protected FSettingUp : Integer
  
• protected FIsCompressed : Boolean
  
• protected FCompressedData : TMemoryStream
  
• protected FIsDecompressing : Integer
  
• protected FBuffer : PByte
  
• protected FBufferSize : Int64
  

Methods

• public constructor Create  ( ) ;
• public constructor Create  ( const  AWidth :  Integer; const  AHeight :  Integer ) ;
• public destructor Destroy  ( ) ;
• protected procedure SetKind  ( const  AValue :  TGorillaTextureKind ) ;  virtual;
• protected procedure SetFormat  ( const  AValue :  TPixelFormatEx ) ;  virtual;
• protected procedure SetComponents  ( const  AValue :  TPixelFormatEx ) ;  virtual;
• protected procedure SetDataType  ( const  AValue :  TGorillaTextureDataType ) ;  virtual;
• protected procedure SetAttachedCubeMapFace  ( const  AValue :  TGorillaCubeMapFace ) ;  virtual;
• protected function GetGorillaTexture  ( )  : TGorillaTexture ;  virtual;
• protected function GetTextureReference  ( )  : TTexture ;
• protected procedure SetTextureReference  ( const  AValue :  TTexture ) ;
• protected procedure SetIsCompressed  ( const  AValue :  Boolean ) ;
• protected procedure BitmapChanged  ( ) ;  override;
• protected procedure InheritedDestroyResources  ( ) ;  virtual;
• protected procedure DoInitBuffer  ( ) ;  virtual;

  Initializes the workaround buffer for other bitmap data formats.

• protected procedure DoFreeBuffer  ( ) ;  virtual;

  Destroys the workaround buffer for other bitmap data formats.

• protected procedure DoCreateHandle  ( const  AValue :  TPixelFormat ) ;  virtual;
• protected procedure DoFreeHandle  ( ) ;  virtual;
• protected function GLHasAnyErrors  ( )  : Boolean ;  class;
• public procedure ClearAfterCompression  ( ) ;
• public procedure Recompress  ( ) ;
• public procedure Decompress  ( ) ;
• public procedure ValidateBuffer  ( ) ;
• public procedure Assign  ( Source :  TPersistent ) ;  override;

  Overrides the internal assignment routine to apply gorilla specific extended fields to the texture.

• public procedure GetFormatAndType  ( ATexture :  TTexture; out  AComps :  Cardinal; out  AFormat :  Cardinal; out  ADataType :  Cardinal ) ;

  Request texture format components (internalformat), general format and datatype.

• public procedure SetPixelFormat  ( const  AValue :  TPixelFormat ) ;

  DirtyHack method to change pixel format of bitmap image.

• public procedure BeginSetup  ( ) ;

  Use this method when setting up texture properties. We need to initialize the texture with all properties.

• public procedure EndSetup  ( ) ;

  Call this method after setting up texture properties. A previous call to BeginSetup() is needed.

• public procedure Set3DSize  ( AWidth :  Integer; AHeight :  Integer; ADepth :  Integer ) ;
• public procedure UpdateCubeMapFace  ( const  ASide :  TGorillaCubeMapFace; ATexture :  TTexture; const  ABits :  Pointer; const  APitch :  Integer ) ;  overload;

  Call this method to upload image data for a specific face of a cube map texture.

• public procedure UpdateCubeMapFace  ( const  ASide :  TGorillaCubeMapFace; ATexture :  TBitmap ) ;  overload;

  Call this method to upload image data for a specific face of a cube map texture.

• public procedure UpdateBuffer  ( ABuffer :  Pointer; ASize :  Int64 ) ;

  Upload complete image data for textures instead of cube map textures.

• public procedure Update3DSlice  ( ASlice :  Integer; ABuffer :  Pointer; ASize :  Int64 ) ;

  Upload image data for a specific slice (by depth) to a 3D texture.

Properties

• public Kind : TGorillaTextureKind

  Defines which kind of texture should be established: 2D, 3D or a CubeMap-Side.

  read FKind
  write SetKind
  
• public Format : TPixelFormatEx

  Extends the basic "PixelFormat" field. This allows to add more types of color components. Check out the TPixelFormatEx type.

  read FFormat
  write SetFormat
  
• public Components : TPixelFormatEx

  Specifies the number of color components in the texture. In OpenGL this is called InternalFormat.

  read FComponents
  write SetComponents
  
• public MinFilter : TTextureFilter

  Allows to read / write the type of min filter: nearest or linear.

  read FMinFilter
  write FMinFilter
  
• public MagFilter : TTextureFilter

  Allows to read / write the type of mag filter: nearest or linear.

  read FMagFilter
  write FMagFilter
  
• public WrapS : TGorillaTextureWrap

  Allows to read / write the wrapping on S-axis: Clamp, ClampToEdge, ClampToBorder, Repeated, MirroredRepeat

  read FWrapS
  write FWrapS
  
• public WrapT : TGorillaTextureWrap

  Allows to read / write the wrapping on T-axis: Clamp, ClampToEdge, ClampToBorder, Repeated, MirroredRepeat

  read FWrapT
  write FWrapT
  
• public WrapR : TGorillaTextureWrap

  Allows to read / write the wrapping on R-axis: Clamp, ClampToEdge, ClampToBorder, Repeated, MirroredRepeat (for 3DTextures only!)

  read FWrapR
  write FWrapR
  
• public DataType : TGorillaTextureDataType

  Allows to read / write the datatype of bytes in a texture: dtByte, dtUnsignedByte, dtShort, dtUnsignedShort, dtInt, dtUnsignedInt, dtFloat, dt2Bytes, dt3Bytes, dt4Bytes, dtDouble

  read FDataType
  write SetDataType
  
• public BorderColor : TAlphaColorF

  Allows to read / write the border color in a texture.

  read FBorderColor
  write FBorderColor
  
• public Depth : Integer

  Get or set depth value for 3D textures.

  read FDepth
  write FDepth
  
• public Style : TTextureStyles

  Allows the read / write protected field for texture style: MipMaps, Dynamic, RenderTarget, Volatile.

  read FStyle
  write FStyle
  
• public GorillaTexture : TGorillaTexture

  Returns a new or existing texture instance. Instead of FMX default property "Texture" the routine checks if a texture already exists, instead of always creating a new one.

  read GetGorillaTexture
  
• public AttachedCubeMapFace : TGorillaCubeMapFace

  Before attaching a cubemap texture for FBO rendering you have to define which side will be rendered. Set this property before calling FBO.AttachTexture(...)

  read FAttachedCubeMapFace
  write SetAttachedCubeMapFace
  
• public ProtectFormatSettings : Boolean

  Because bitmaps created by FMX are always of BGRA format, we need the opportunity to protect Gorilla3D-bitmaps from modifying the format, when assigning from FMX-bitmap. Otherwise different format settings will appear.

  read FProtectFormatSettings
  write FProtectFormatSettings
  
• public IsCompressed : Boolean

  Enables/disables image compression.

  read FIsCompressed
  write SetIsCompressed
  
• public CompressedData : TMemoryStream

  Contains compressed texture data in PNG format.

  read FCompressedData
  
• public Buffer : PByte

  The main problem with texturing in FMX is, that it uses only BGRA / RGBA as bitmap data. This leads to problems in OpenGL rendering when another bitmap format is needed. If a format, different from default, is detected we build our own buffer. This leads to more memory usage, but helps to solve the problem until the problem is fixed in FMX.

  read FBuffer
  
• public BufferSize : Int64

  Size of workaround buffer.

  read FBufferSize
  
• public TextureReference : TTexture

  Returns only the reference to the texture. Instead of the "Texture" property, this will not instanciate a new texture.

  read GetTextureReference
  write SetTextureReference
  

Fields

• protected FFace :
  

Methods

• public constructor Create  ( ) ;
• public constructor Create  ( const  AWidth :  Integer; const  AHeight :  Integer ) ;
• public destructor Destroy  ( ) ;
• protected procedure DoChange  ( ) ;  override;
• protected function GetCubeMapFace  ( AIndex :  TGorillaCubeMapFace )  : TTextureBitmap ;
• protected procedure SetCubeMapFace  ( AIndex :  TGorillaCubeMapFace; AValue :  TTextureBitmap ) ;
• protected procedure DoCreateCubeMapFaces  ( ) ;
• protected procedure DoFreeCubeMapFaces  ( ) ;
• protected procedure UpdateCubeMapFaces  ( ) ;

Properties

• public Face[Index] : TTextureBitmap
  read GetCubeMapFace
  write SetCubeMapFace