How to use the library

The first thing do to is to run the included samples, it will give you an idea of what can be done. It might also be interesting to look at the huge range of examples at contextfreeart.org for inspiration. However there are some limitations on what can be achieved, I have not yet implemented a depth sampling function so contextfreeart sketches that use the z parameter cannot be translated. But interestingly some sketches like my 'y' sketch are not possible using the c++ program, nor is a gui for adjusting the running sketch (control-panel ruby-processing). The following example demonstrates the DSL features.

# city.rb after city.cfdg

require 'cf3'  # NB: requires ruby 1.9 for rand range

def setup_the_city
  @city = ContextFree.define do
    
    shape :neighborhood do
      split do
        block x: -0.25, y: -0.25
        rewind
        block x: 0.25, y: -0.25
        rewind
        block x: 0.25, y: 0.25
        rewind
        block x: -0.25, y: 0.25
      end
    end
    
    shape :block do
      buildings size: 0.85
    end
    
    shape :block, 5 do
      neighborhood size: 0.5, rotation: rand(-PI..PI), hue: rand(2), brightness: rand(0.75..1.75)
    end
    
    shape :block, 0.1 do
      # Do nothing
    end
    
    shape :buildings do
      square
    end
    
  end
end

def setup
  size 600, 600
  smooth
  setup_the_city
  @background = color 255, 255, 255
  draw_it
end

def draw
  # Do nothing
end

def draw_it
  background @background
  @city.render :neighborhood, 
               start_x: width/2, start_y: height/2, 
               size: height/2.5, color: [0.1, 0.1, 0.1]
end

def mouse_clicked
  draw_it
end

Since conteextfreeart version 3.0 the basic rule, is now called a shape. There may more than one of these shape rules included in the grammar (see :block above where there are three, each given a different weighting or probability no number given equates to a weighting factor of 1.0).