8 Properties
This section covers SDL property bags, which are key-value stores used internally by SDL and available for application use.
8.1 Creating and Destroying
procedure
Returns a properties ID that can be used with the getter and setter functions.
procedure
(destroy-properties! props) → void?
props : exact-nonnegative-integer?
8.2 Setting Properties
procedure
(set-property-pointer! props name value) → void?
props : exact-nonnegative-integer? name : string? value : cpointer?
procedure
(set-property-string! props name value) → void?
props : exact-nonnegative-integer? name : string? value : string?
procedure
(set-property-number! props name value) → void?
props : exact-nonnegative-integer? name : string? value : exact-integer?
procedure
(set-property-float! props name value) → void?
props : exact-nonnegative-integer? name : string? value : real?
procedure
(set-property-boolean! props name value) → void?
props : exact-nonnegative-integer? name : string? value : boolean?
8.3 Getting Properties
procedure
(get-property-pointer props name [default]) → (or/c cpointer? #f)
props : exact-nonnegative-integer? name : string? default : cpointer? = #f
procedure
(get-property-string props name [default]) → string?
props : exact-nonnegative-integer? name : string? default : string? = ""
procedure
(get-property-number props name [default]) → exact-integer?
props : exact-nonnegative-integer? name : string? default : exact-integer? = 0
procedure
(get-property-float props name [default]) → real?
props : exact-nonnegative-integer? name : string? default : real? = 0.0
procedure
(get-property-boolean props name [default]) → boolean?
props : exact-nonnegative-integer? name : string? default : boolean? = #f