Difference between revisions of "AlcScript"

m
(sound)
Line 58: Line 58:
  
 
===flags===
 
===flags===
  '''sound.flags''' ''type'':string ''range'':[loop, 3d, start] ''default'':null
+
  '''sound.flags''' ''type'':string ''range'':[loop, 3d, start, local] ''default'':null
This controls the sound properties. These can be combined!
+
This controls the sound properties. These can be combined! To combine the properties, separate them with the pipe character (|).
''loop'': causes the sound file to loop indefinitely
+
:''loop'': causes the sound file to loop indefinitely
''3d'': causes the sound to occur from a 3D emission point
+
:''3d'': causes the sound to occur from a 3D emission point
''start'': causes the sound to start immediately upon linking in
+
:''start'': causes the sound to start immediately upon linking in
 
+
:''local'': causes the sound to play only for the local avatar (other avatars will not hear it in a multiplayer environment)
To combine the properties, separate them with the pipe character (|).
+
type = loop|start ''(Will cause the sound to start automatically and loop)''
+
  
 
===file===
 
===file===
Line 86: Line 84:
 
  '''sound.channel''' ''type'':string ''range'':[left, right] ''default'':null
 
  '''sound.channel''' ''type'':string ''range'':[left, right] ''default'':null
 
The channel to which the sound is bound. If no channel is specified, then the sound will be heard through both channels.
 
The channel to which the sound is bound. If no channel is specified, then the sound will be heard through both channels.
 +
 +
===maxfdist===
 +
'''sound.fmaxdist''' ''type'':float
 +
The maximum distance that the sound can be heard. This is only relevant to 3D sounds.
 +
 +
===minfdist===
 +
'''sound.minfdist''' ''type'':float
 +
The minimum distance before the sound begins to fade. This is only relevant to 3D sounds.
  
 
== softvolume ==
 
== softvolume ==

Revision as of 23:46, 23 January 2008

AlcScript is a simple way to use a limited form of programming in your Ages.

AlcScript Tutorials

List of Properties

This list describes current AlcScript properties. If you add to it, be sure to add it under the correct code. Use heading levels to reflect the AlcScript indentation level. Follow the example given to describe the functionality of the field. Please note that not all properties listed on this page are fully implemented at the time of writing! However, the documentation exists so that future implementations can follow existing standards. Properties marks "NIE" are not implemented.

type

type type:string

Can be used to set the type of an object. Valid values include:

object     #Default setting, drawable and other settings
collider   #Acts as a collision mesh, no drawable
region     #Acts as a region
soundemit  #A point from which sound is emitted
softvolume #A volume to confine objects (NIE)

visual

physical

friction

physical.friction type: float

Sets friction of object. If not set, or if set to a value lower than 0.0, friction will be disabled. (This means full friction)

elasticity

physical.elasticity type: float

Sets elasticity of object. Only useful on kickables.

campassthrough

physical.campassthrough type: boolean string ('true' or 'false')

If set to 'true', the camera will pass through the object. If omitted or not set to 'true' the object will block the camera.

physlogic

physical.physlogic type:string

Force the object's physical logic settings

logic

This "logic" is not at all logical... so don't expect anything until Trylon has time to document the changes

camera

brain

Contains camera brain settings:

type

camera.brain.type type:string range:[fixed, circle, firstperson, avatar] default: fixed

Sets the type of camera brain to use. Further camera.brain keys depend on brain type used.

region

type

region.type type:string range:[logic, footstep, swim, climbing, swimdetect, panic, camera] default:logic

sound

flags

sound.flags type:string range:[loop, 3d, start, local] default:null

This controls the sound properties. These can be combined! To combine the properties, separate them with the pipe character (|).

loop: causes the sound file to loop indefinitely
3d: causes the sound to occur from a 3D emission point
start: causes the sound to start immediately upon linking in
local: causes the sound to play only for the local avatar (other avatars will not hear it in a multiplayer environment)

file

sound.file type:string

This is the name of the Blender Sound block that will be exported as a sound file. Do not include the .wav extension.

type

sound.type type:string range:[SoundFX, Ambience, BackgroundMusic, GUISound, NPCVoices] default:Ambience

This controls which type of sound it is. Remember that the volume can be adjusted for each type, so be sure to set the type correctly.

volume

sound.volume type:float

A value between 0.0 and 1.0 that determines the maximum volume of the sound.

softvolume

sound.softvolume type:string

The name of a soft volume object in the Age to which the sound will be confined. You can combine soft volumes using the same method as for lights (U for union, I for intersection, ! for inverse). This will make your sound not work. Do not use it at this point.

channel

sound.channel type:string range:[left, right] default:null

The channel to which the sound is bound. If no channel is specified, then the sound will be heard through both channels.

maxfdist

sound.fmaxdist type:float

The maximum distance that the sound can be heard. This is only relevant to 3D sounds.

minfdist

sound.minfdist type:float

The minimum distance before the sound begins to fade. This is only relevant to 3D sounds.

softvolume

Not currently implemented

type

softvolume.type type:string range:[bounds, convex] default:convex

The type of soft volume region. Bounds will use the bounding box of the object, while convex will take the individual faces and generate a soft volume object.

AlcScript Technical Information

See AlcScript Technical Information.