Class TSFImage

DescriptionHierarchyFieldsMethodsProperties

Unit

Declaration

type TSFImage = class(TX3DSingleField)

Description

no description available, TX3DSingleField description follows
no description available, TX3DField description follows

Base class for all VRML/X3D fields.

Common notes for all descendants: most of them expose field or property "Value", this is (surprise, surprise!) the value of the field. Many of them also expose DefaultValue and DefaultValueExists fields/properties, these should be the default VRML value for this field. You can even change DefaultValue after the object is created.

Most of descendants include constructor that initializes both DefaultValue and Value to the same thing, as this is what you usually want.

Some notes about Assign method (inherited from TPersistent and overridied appropriately in TX3DField descendants):

  1. There are some exceptions, but usually assignment is possible only when source and destination field classes are equal.

  2. Assignment (by Assign, inherited from TPersistent) tries to copy everything: name (with alternative names), default value, IsClauseNames, ValueFromIsClause, Exposed, and of course current value.

    Exceptions are things related to hierarchy of containers: ParentNode, ParentInterfaceDeclaration. Also ExposedEventsLinked.

    If you want to copy only the current value, use AssignValue (or AssignLerp, where available).

Hierarchy

Overview

Fields

Public Value: TCastleImage;

Methods

Protected procedure SaveToStreamValue(Writer: TX3DWriter); override;
Public constructor Create(AParentNode: TX3DFileItem; const AName: string; const AValue: TCastleImage);
Public constructor CreateUndefined(AParentNode: TX3DFileItem; const AName: string; const AExposed: boolean); override;
Public destructor Destroy; override;
Public procedure ParseValue(Lexer: TX3DLexer; Reader: TX3DReader); override;
Public function Equals(SecondValue: TX3DField; const EqualityEpsilon: Double): boolean; override;
Public procedure Assign(Source: TPersistent); override;
Public procedure AssignValue(Source: TX3DField); override;
Public class function TypeName: string; override;
Public class function CreateEvent(const AParentNode: TX3DFileItem; const AName: string; const AInEvent: boolean): TX3DEvent; override;

Description

Fields

Public Value: TCastleImage;

Value is owned by this object - i.e. in destructor we do Value.Free.

Value may be IsEmpty, and then we know that there is no image recorded in this field. Value may never be nil. Remember — Value is freed by this object, but if you're altering it in any other way, you're responsible for good memory managing.

Methods

Protected procedure SaveToStreamValue(Writer: TX3DWriter); override;
 
Public constructor Create(AParentNode: TX3DFileItem; const AName: string; const AValue: TCastleImage);
 
Parameters
AValue
is the initial value for Value.

Note - our constructor COPIES passed reference AValue, not it's contents (I mean, we do Value := AValue, NOT Value := ImageCopy(AValue), so don't Free image given to us (at least, don't do this without clearing our Value field)). You can pass AValue = nil, then Value will be inited to null image TRGBImage.Create.

Public constructor CreateUndefined(AParentNode: TX3DFileItem; const AName: string; const AExposed: boolean); override;
 
Public destructor Destroy; override;
 
Public procedure ParseValue(Lexer: TX3DLexer; Reader: TX3DReader); override;
 
Public function Equals(SecondValue: TX3DField; const EqualityEpsilon: Double): boolean; override;
 
Public procedure Assign(Source: TPersistent); override;
 
Public procedure AssignValue(Source: TX3DField); override;
 
Public class function TypeName: string; override;
 
Public class function CreateEvent(const AParentNode: TX3DFileItem; const AName: string; const AInEvent: boolean): TX3DEvent; override;
 

Generated by PasDoc 0.14.0.