[comp.sys.amiga] Layers help anyone??

crunch@well.UUCP (John Draper) (12/31/86)

  I'm trying to set a smaller area in an Intuition window to render
text to.   I want the text to remain "clipped" into a specified rectangle.
I looked in the documentation and see no function that can set up a
clipped region.    I assume that I must use the Layers routines.

  Because I never used the Layers routines,  I have a few questions
related to the Layers library.

#1.  Because I'm using Intuition,  I would like to know if I still have
     to open the Layers Library?   Or does Intuition do that for you.
     
#2.  I assume that I do the following sequence of calls:
      a) NewLayerInfo - To get our Layer structure
      b) CreateLayerInfo - Get a pointer to an initialized Layer
         structure.
	 
	 ( The RKM says that I'm supposed to do "LockLayerInfo()"
	   call when using this function,  But I see NO examples
	   that call "LockLayerInfo()".
	   
      c) CreateUpfrontLayer() - According to RKM, is supposed to specify
         the area on the screen where the layer is supposed to be.   It
	 also says that I'm supposed to give it a pointer to a
	 "common BitMap used by all layers.   Now,  Where is this so
	 called "common bitmap?",   there is ABSOLUTLY NO DOCUMANTATION
	 that explains this.   do I:
	 
	 #1. declare a bitmap structure and point to it?
	 #2. get the bitmap from the ClipRect pointed to by the
	     ClipRect field in the Layer structure pointed to by the
	     WLayer field in the Window structure??
	 #3. Or get the bitmap from some other place??
	   
     Using the RastPort from the newly created "Layer" structure,
     I happily render all my stuff in there without messing up any
     gadgets that happen to be laying around.  Which leads to my next
     question.
     
#3.  Do the Coordinates reference to the ULC of the new Layer area,
     or are they referenced from the ULC of the Intuition Window?
     (ULC = Upper Left Corner).
     
NOTE:   Naturally,  I didn't mention above,  but I assume that I must
     a) DeleteLayer
     b) DisposeLayerInfo
      < in that order - before exiting >
     
  I would appreciate a prompt reply,  as I only have one more week to
go in my Amiga programming vacation,  and would like something to show
for all my work.   And everyone will eventually appreciate what I'm doing.

Crunch - Programmers Network
WELL: crunch
UUCP: ihnp4!ptsfa!well!crunch
BIX: crunch
CIS: 76703,4322