Scratch

The file format for 2.0 projects should be XML, and should work similar to snap (the sequel to BYOB)
The top-level code will be

<project name=project name>
  <notes>
     project notes
  </notes>*
  <thumbnail>
    base-64 encoded image
  <blocks>
     custom block definitions, see below
  </blocks>*
  <stage background=stage background number>
    stage declaration, see below
  </stage>
  <sprites>
    sprite declarations, see below
  </sprites>
  <var-watcher var=variable name x=watcher x y=watcher y readout=readout (normal, large or slider) slider-min=slider min** slider-max=slider max**/>*
   ...
    <list-watcher list=list name x=watcher x y=watcher y w=width h=height/>*
   ...
</project>

*omitted if there are none
**only for sliders

Custom blocks: (confirmed 2.0 feature)

<blocks>
  <block-definition catograry=catograry (motion, control, ect)scope=scope* type=either stack, reporter or Boolean>
    <block-name>
       first bit of block name <block-input type=input type** default=default value>input name</block-input>second bit of block name ...
     </block-name>
     <script hat='block-definition'>
       block script, see below
     </script>
  </block-definition>
  ...
</blocks>

*what objects can use it, either sprites, stage or global
**either number, string or Boolean (or drop-down if it is implemented)

Stage/sprite declarations:

<stage background=stage background number>
  <variables>
    variable declarations, see below
  </variables>
  <media>
    media declarations, see below
  </media>
  <scripts>
    scripts, see below
  </scripts>
</stage>
<sprites>
  <sprite name=sprite name x=x position y=y position dir=sprite direction costume=costume number hidden='hidden'* rotate=rotation style either normal, flip or none>
    <variables>
      variable declarations
    </variables>
    <media>
      media declarations
    </media>
    <scripts>
      scripts
    </scripts>
  </sprite>
  ...
</sprites>

*omit if sprite is shown

Variable declarations:

<variables>
  <variable name=var name>value</variable>
  ...
  <list name=list name>
    <item>value,</item>
    ...
  </list>
  ...
</variables>

*omit if watcher is hidden
**only if readout is slider

Media:

<media>
  <costume name=costume name rotationx=costume center x* rotationy=costume center y*>
    <text x=x position of text layer* y=y position of text layer* size=text size font=text font>text content</text>
    ...
    <image>base-64 encoded image</image>
  </costume>**
  ...
  <sound name=sound name>base-64 encoded sound</sound>
  ...
</media>

* relative to top-left corner of costume
**on the stage it is background not costume and there is no rotation center

Scripts:

<scripts>
  <script hat=script hat* input=hat block input**>
    <block type=stack, report or Boolean>first bit of block name, for example 'move'<input type=input type***>value****</input>2nd bit of block name, for example 'steps'   ...<c-mouth>If it is a c-block, script goes in here. If not, omit the c-mouth bit</c-mouth></block>
    ...
  </script>
  ...
</scripts>

*either 'green-flag', 'receive','key-pressed'or 'sprite-clicked'
**only for receive and key-pressed
***either 'number', 'string', 'reporter','Boolean', 'drop-down' , 'variable-name' 'list-name'. 
****if it is a Boolean or reporter this will be another block tag.

Here is a DTD:

<!DOCTYPE project [
<!ELEMENT project (notes?, blocks?, stage, sprites, (var-watcher|list-watcher)*)>
<!ELEMENT notes (#PCDATA)>
<!ELEMENT thumbnail (#PCDATA)>
<!ELEMENT var-watcher (#EMPTY)>
<!ELEMENT list-watcher (#EMPTY)>


<!ATTLIST var-watcher var-name IDref #REQUIRED>
<!ATTLIST var-watcher x CDATA #REQUIRED>
<!ATTLIST var-watcher y CDATA #REQUIRED>
<!ATTLIST var-watcher readout (normal|large|slider) normal>
<!ATTLIST var-watcher slider-min CDATA 1>
<!ATTLIST var-watcher slider-max CDATA 10>

<!ATTLIST list-watcher list-name IDref #REQUIRED>
<!ATTLIST list-watcher x CDATA #REQUIRED>
<!ATTLIST list-watcher y CDATA #REQUIRED>
<!ATTLIST list-watcher w CDATA 95>
<!ATTLIST list-watcher h CDATA 115>


<!ELEMENT blocks (block-definition*)>
<!ELEMENT block-definition (block-name, script)>
<!ELEMENT block-name ((#PCDATA|block-input)*)>
<!ELEMENT block-input (#PCDATA)>


<!ATTLIST block-definition catograry, (motion|control|looks|sensing|operators|pen|sound|variables|lists|other)  #REQUIRED>
<!ATTLIST block-definition scope (sprites|stage|global) global>
<!ATTLIST block-definition type (stack|reporter|boolean) stack>

<!ATTLIST block-input type (number|string|boolean) string>
<!ATTLIST block-input default CDATA #IMPLIED>


<!ELEMENT stage (variables, media, scripts)>
<!ELEMENT sprites (sprite*)>
<!ELEMENT sprite (variables, media, scripts)>


<!ATTLIST stage background CDATA #REQUIRED>

<!ATTLIST sprite name ID #REQUIRED>
<!ATTLIST sprite x CDATA #REQUIRED> 
<!ATTLIST sprite y CDATA #REQUIRED>
<!ATTLIST sprite costume CDATA #REQUIRED>
<!ATTLIST sprite hidden (hidden|shown) shown>
<!ATTLIST sprite rotation (normal|flip|none) normal)>


<!ELEMENT variables (variable*, list*)>
<!ELEMENT variable (#PCDATA)>
<!ELEMENT list (item*)>
<!ELEMENT item (#PCDATA)>


<!ATTLIST variable name ID #REQUIRED>

<!ATTLIST list name ID #REQUIRED>


<!ELEMENT media ((costume*|background*),sound*)>
<!ELEMENT costume (text*,image)>
<!ELEMENT background (text*, image)>
<!ELEMENT text (#PCDATA)>
<!ELEMENT image (#PCDATA)>
<!ELEMENT sound (#PCDATA)>

<!ATTLIST costume name ID #REQUIRED>
<!ATTLIST costume rotationx CDATA #REQUIRED>
<!ATTLIST costume rotationy CDATA #REQUIRED>

<!ATTLIST background name ID #REQUIRED>

<!ATTLIST text x CDATA #REQUIRED>
<!ATTLIST text y CDATA #REQUIRED>
<!ATTLIST text size CDATA #REQUIRED>
<!ATTLIST text font CDATA #REQUIRED>

<!ATTLIST sound name ID #REQUIRED>


<!ELEMENT scripts (script*)>
<!ELEMENT script (block*)>
<!ELEMENT block ((#PCDATA|input|c-mouth)*)>
<!ELEMENT input (#PCDATA|block)>
<!ELEMENT c-mouth (block*)>


<!ATTLIST script hat (green-flag|receive|key-pressed|sprite-clicked|block-definition) green-flag>
<!ATTLIST script input CDATA #IMPLIED>

<!ATTLIST block type (stack|reporter|boolean) stack>

<!ATTLIST input type (number|string|boolean|drop-down|variable-name|list-name)>
]>

There would be an application to convert old .sb files into this format.

Advantages:
You could make a scratch project in notepad without scratch installed!
Smaller file size,
Recognized by tons of programming languages,
Easy to store on the internet,
You can copy scripts, costumes, and even entire sprites to another scratch window,
Easy to read and write by humans,
Projects will load faster.

Last edited by joefarebrother (2012-04-13 06:10:57)