Index

Symbols

~LGWorld() destructor 344

~StOffscreenGWorld() destructor 348

A

AcceptIncoming()

and accepting connection 126

and responder 124

LEndpoint 114

AckSends()

LEndpoint 115, 118

actions

class hierarchy 295

creating classes 300

described 293

in LCaption class 294

posting 295, 301

see also undo

Actions in PowerPlant 293-309

ActivateSelf()

LTableView 207

AddDesc()

UAEDesc 261

AddDropArea()

LDropArea 317

AddFlavors()

LDragTask 315, 316, 326

Adding the Classes

Other file requirements 34

Resolving file conflicts 34-35

AddKeyDesc()

UAEDesc 261

AddLastChildNode()

LCollapsableTree 219

AddLastChildRow()

LHierarchyTable 211

AddPtr()

UAEDesc 261

AddRectDragItem()

LDragTask 315, 316, 326

address, obtaining network 121

AddSubModel()

LModelObject 253

aedt resource 265

AEOM 247

and aete resource 250, 263

and LModelObject 250

and LModelProperty 258

class stored in mModelKind 251

concepts 247

containment hierarchy 252

terminology 248

aete resource 263

editing 265

editing with Resorcerer 265

AllocateThreads()

LThread 61, 72

allocating memory for threads 72, 74

Apple event

adding an AEOM class to your code 266

adding custom events 269

adding properties to your AEOM class 268

classes 249-263

default submodel 270

described 247

implementing 266-271

lazy objects 270

recordability 271

resources 263-266

set tell target 270

strategy 246-248

whose clause 271

Apple Event Object ModelþSee AEOM

Apple Events in PowerPlant 245-292

AssertHandleLocked_() 32

AssertHandleUnlocked_() 32

asynchronous behavior

in threads classes 88-94

asynchronous threads

Speech Manager example 92

attaching an undoer 301

B

background highlighting 321

BeginDrawing()

LGWorld 344, 345

Bind()

and IP address 122

and listening for connection 125

and responder class 124

LEndpoint 113, 117

Block()

LThread 56, 62

blocked thread 56

C

callback functions in drag and drop 329

CanRedo()

LAction 297

CanUndo()

LAction 297

cell

addressing 198

as STableCell object 199

changing size 224

data storage size 218

drawing 228

finding 229

finding data in 230

finding next selected 216

getting data 225

handling click in 227

highighting 229

location in PowerPlant 202

nesting level 228

order in table 198, 230

refreshing 229

see also table

setting data 225

CellIsSelected()

LTableSelector 215

LTableView 206

CellToIndex()

LTableView 205

CheckForMissingParameters()

UAppleEventMgr 260

click

in drag and drop 321

in table cell 227

Click()

overriding LPane for drag and drop 321, 322

ClickCell()

LTableView 208

overriding 227

ClickInContent()

LWindow 324

ClickSelect()

LTableSelector 215

LTableView 206

ClickSelf()

LHierarchyTable 227

LTableView 208, 227

client

compared to responder 124

creating 120

creating endpoint 121

described 119

client/server

described 119

coerce data in Apple event 259

CompactAndPurgeHeap() 28

CompactHeap() 28

Connect()

LEndpoint 113

context switching in threads 79

CopyImage()

LGWorld 344, 345

CountReadyThreads()

LThread 61

CountSubModels()

LModelObject 254

CreateInternetMapper()

UNetworkFactory 110

CreateTCPEndpoint()

creating endpoint 126

UNetworkFactory 109

creating threads 72

criticality 78

current drop area 317

current thread 55

custom callbacks for drag and drop 328

D

data coherency in threads 78-88

datagram 127

DeactivateSelf()

LTableView 207

DebugCast_() 31

DebugCastConst_() 31

Debugging Classes

PP_DebugConstants.h 21

Debugging in PowerPlant 15-52

Debugging Classes described 17-30

Debugging Code Exercise 38-52

Debugging Macros 30-32

Debugging Strategy 16-17

Introduction 15

Debugging Macros

AssertHandleLocked_() 32

AssertHandleUnlocked_() 32

DebugCast_() 31

DebugCastConst_() 31

DisposOf_() 32, 37

FindPaneByID_() 31

ValidateHandle_() 32

ValidateObj_() 32

ValidateOjbect_() 32

ValidatePtr_() 32

ValidateSimpleObject_() 32

ValidateThis_() 32

Debugging PowerPlant Projects 33-38

Adding the classes 34

Configuring Your Project 33-34

Customizing the Debugging Classes 37-38

Installing the Menu 35-37

DebugNew 16, 20

default submodel 270

delaySelect

attribute in drag and drop 322

DeleteThread()

LThread 63, 77

deleting threads 64, 77

Disconnect()

LEndpoint 113

DisposOf_() 32, 37

DoDrag()

LDragTask 315, 316, 326

DoDragDrawing()

LDropArea 329

DoDragInput()

LDropArea 329

DoDragReceive()

LDropArea 318, 328

DoDragSendData()

LDropArea 329

DoForEach()

LQueue 69

LThread 61

DontAckSends()

LEndpoint 115, 118

double bufferingþSee offscreen drawing

drag and drop

adding flavors 315, 326

adding to a pane 319

background highlighting 321

class hierarchy 314

classes 314-320

clicking in background window 321

creating a drag task 324

current drop area 317

custom callback functions 329

custom callbacks 328

delaySelect attribute 322

detecting a drag 324

finding Drag Manager 317, 320

handling click 321

highlighting drop area 327

implementing 320-330

implementing special behavior 327

initiating drag 316, 326

item acceptability 327

multiple items or flavors 325

promise 328

receiving a drop 318, 328

simple technique 324

strategy 312-314

tracking a drag 326

Drag and Drop in PowerPlant 311-339

Drag Manager

finding 317, 320

drag region 315, 316, 325, 326

drag task 324

DragAndDropIsPresent()

LDropArea 317, 320

DragIsAcceptable()

LDropArea 318

DragLib, importing weak 320

DragSelect()

LTableSelector 215

Draw()

LDropFlag 220

LOffscreenView 350

DrawCell()

LSmallIconTable 209

LTableView 208

LTextHierTable 212

overriding 228

DrawDropFlag()

LHierarchicalTable 229

DrawSelf()

LTableView 207

drop flag

drawing for table row 228

including icons 220

E

EndDrawing()

LGWorld 344, 345

endpointþþSee LEndpoint

EnterCritical()

LThread 61, 78

EnterDropArea()

LDropArea 318, 327

ExecuteSelf()

LUndoer 298

LYieldAttachment 66

ExitCritical()

LThread 61, 78

expansion triangle in table See drop flag

F

Finalize()

in multilevel undo 302

LAction 297

FindCellData()

LTableStorage 217

LTableView 206

parameters 230

search algorithm 230

FindDropArea()

LDropArea 317

FindPaneByID_() 31

FindUndoStatus()

LUndoer 298

FinishCreateSelf()

to attach helpers in table 221

flavors

adding to a drag 315, 326

Flush() 23

FocusDropArea()

LDragAndDrop 319

LDropArea 318, 319

G

gDebugSignal 20

gDebugThrow 20

generic network interface 107

GetAEProperty()

LModelObject 255

GetAmountUnread()

LEndpoint 115

GetCellData()

LTableStorage 217

LTableView 206

parameters 225

uses wide-open cell 207

GetCellHitBy()

LTableView 208

GetClickCount()

in table cell 227

GetColHitBy()

LTableGeometry 213

GetColWidth()

LTableGeometry 213

LTableView 205

GetCurrentThread()

LThread 61

GetDescription()

LAction 297

GetExposedIndex()

LCollapsableTree 219

LHierarchyTable 210

GetFreeThreads()

LThread 61

GetHeader() 23

GetImageCellBounds()

LTableGeometry 213

LTableView 205

GetImportantAEProperties()

LModelObject 256, 257

GetLink()

LLink 68

GetLocalAddress()

LEndpoint 114, 117

GetLocalCellRect()

LTableView 205

GetMacGWorld()

LGWorld 344

StOffscreenGWorld 348

GetMainThread()

LThread 61

GetModelKind()

LModelObject 253

GetNestingLevel()

LCollapsableTree 219, 228

GetNextCell()

LTableView 205, 229

GetNextSelectedCell()

LTableView 205, 229

GetOptionalParamDesc()

StAEDescriptor 260

GetParamDesc()

StAEDescriptor 260

GetParentIndex()

LCollapsableTree 219

GetPositionOfSubModel()

LModelObject 253, 254

GetRemoteHostAddress()

LEndpoint 114, 118

GetResult()

LThread 63, 64

GetRowHeight()

LTableGeometry 213

LTableView 205

GetRowHitBy()

LTableGeometry 213

GetSize()

LQueue 69

GetState()

LEndpoint 115, 118

GetStorageSize()

LTableStorage 217

GetSubModelByComplexKey()

whose clauses 271

GetSubModelByName()

LModelObject 254

GetSubModelByPosition()

and laziness 270

LModelObject 254

GetSuperModel()

LModelObject 253

GetTableDimensions()

LTableGeometry 213

GetTableSize()

LTableView 204

GetWideOpenIndex()

LCollapsableTree 219

LHierarchyTable 210

GetWideOpenTableSize()

LHierarchyTable 210

H

HandleAppleEvent()

implementing 269

LModelObject 255, 256

HandleClone()

LModelObject 256, 257

HandleCount()

LModelObject 256, 257

HandleCreateElementEvent()

LModelObject 256

sample code 267

HandleDelete()

LModelObject 256, 257

HandleDragDrawing()

LDropArea 329

HandleDragInput()

LDropArea 329

HandleDragReceive()

LDropArea 317

HandleDragSendData()

LDropArea 329

HandleDragTracking()

LDropArea 317

HandleMove()

LModelObject 256, 257

helper classes for tables 196

hierarchical table described 197

highlight drop area 327

HiliteCell()

overriding 229

HiliteCellActively()

LTableView 207

LTextHierTable 212

overriding 229

HiliteCellInactively()

LTableView 207

LTextHierTable 212

overriding 229

HiliteDropArea()

LDragAndDrop 319

LDropArea 318, 327

HiliteSelection()

overriding 229

I

IndexToCell()

LTableView 205

initializing threads 71

InMainThread()

LThread 61

InsertChildNodes()

LCollapsableTree 219

InsertChildRows()

LHierarchyTable 211

InsertCols()

LTableGeometry 213

LTableSelector 215

LTableStorage 217

LTableView 204

parameters 222

InsertRows()

effect in hierarchical tables 222

LHierarchyTable 211

LTableGeometry 213

LTableSelector 215

LTableStorage 217

LTableView 204

InsertSibling Nodes()

LCollapsableTree 219

InsertSiblingRows()

LHierarchyTable 210

parameters 223

InsideDropArea()

LDropArea 318, 319, 327

InstallHandlers()

LDropArea 317, 330

Internet Programming in PowerPlant 137-193

inter-thread communication 57, 85-88

InTrackingWindow()

LDropArea 317, 318

IP address

defined 107

IsAckingSends()

LEndpoint 115, 118

IsCurrent()

LThread 62

IsDone()

LAction 297

IsEmpty()

LQueue 69

IsNullCell()

STableCell 202

IsPostable()

LAction 297

overriding in action classes 300

IsSubModelOf()

LModelObject 253

IsValidCell()

LTableView 204

IsValidCol()

LTableView 204

IsValidRow()

LTableView 204

ItemIsAcceptable()

LDropArea 318, 319, 327

L

LAction 296

data members 296

member functions 297

relation to LUndoer and LCommander 294

subclassing 300

laziness 270

LCollapsableTree 218

member functions 219

LColumnView 208

LCommander 295

LCommanderTree 24-25

LDebugMenuAttachment 18-19

constructor for 20

destructor for 20

InitDebugMenu() 20, 36

InstallDebugMenu() 20, 21, 35, 36, 37

SetDebugInfoDefaults() 20, 36, 37

LDebugMenuAttachment.h 38

LDebugStream 21-23

Flush() 23

GetHeader() 23

mFlushLocation 22

PutBytes() 23

SetFilename() 23

TimeStamp() 23

WriteBlock() 23

WriteData() 23

LDocument

as example of LModelObject 251

LDragAndDrop 319-320

member functions 319

LDragTask 314-316

data members 314

member functions 315

LDropArea 316-319

custom callback functions 329

data members 316

member functions 318

static functions 317

LDropFlag 220

LeaveDropArea()

LDropArea 318, 327

LEndpoint 112, 117

LEndpoint() constructor 113, 117

LEventSemaphore 67

LGWorld 343-347

data members 343

in non-PowerPlant code 347

limitations 346

member functions 344

sample code 352

using 352

LGWorld() constructor 344

LHeapAction 27

LHierarchyTable 209

data members 210

member functions 210

LInternetIPAddress

and binding to port 122

and servers 125

Listen()

LEndpoint 114

responding to network connection 126

LLink 68

LModelDirector 257

LModelObject 250-257

and AEOM 248, 250

class hierarchy 251

constructor 252

containment hierarchy 252

data members 251

handling events in 255

handling properties in 255

LDocument as example 251

LWindow as example 251

managing elements in 252

LModelProperty 257

LMutexSemaphore 67

example of use 82

LNodeArrayTree 219

LNTable (obsolete class) 196

LOffscreenView 349

and Constructor 350

using 351

LPaneTree 25-27

LQueue 69

data members 69

member functions 69

LSemaphore 66

data members 67

LSharedQueue 70

inter-thread communication 85

LSimpleThread 64-65

LSmallIconTable 209

LTableArrayStorage 217

constructors 218

LTableGeometry 212

member functions 213

LTableMonoGeometry 213

LTableMultiGeometry 214

LTableMultiSelector 216

LTableSelector 214

member functions 215

LTableSingleSelector 215

LTableStorage 216

member functions 217

LTableView 202

as example class 203

cell access functions 205

cell geometry functions 205

cell management functions 204

cell selection functions 206

data members 203

data storage functions 206

drawing and clicking functions 207

services 204

setting helper classes 203

LTCPEndpoint 112-117

functions 113

LTEClearAction 299

LTECopyAction doesn't exist 299

LTECutAction 299

LTEPasteAction 299

LTETextAction 299

LTETypingAction 299

LTextColumn 209

LTextHierTable 212

LThread 59-64

constructor 73

data members 60

state-related functions 62

static member functions 61

vital functions 62

LThread()

LThread 62

LUDPEndpoint 117-119

functions 117

LUndoer 298

and redo 298

as attachment to LCommander 294

member functions 298

LWindow

as example of LModelObject 251

LYieldAttachment 66

M

MacsBug 16

main thread, creating 71

MakeAppleEvent()

UAppleEventsMgr 262

MakeBooleanDesc()

UAEDesc 261

MakeDragRegion()

LDragTask 315, 316, 326

MakeInsertionLoc()

UAEDesc 261

MakeRange()

UAEDesc 261

mapper

created by UNetworkFactory 107

creating with UNetworkFactory 109

mBounds

LGWorld 343

StOffscreenGWorld 348

mFlushLocation 22

mMacGWorld

LGWorld 343

StOffscreenGWorld 348

mModelKind 251

modifying thread state 75

mSaveDevice

LGWorld 343

StOffscreenGWorld 348

mSavePort

LGWorld 343

StOffscreenGWorld 348

mSubModels 251

mSuperModel 251

N

nesting level 228

networking

accepting connection 126

binding to local port 121

classes 108-119

client and responder compared 124

client described 119

client/server described 119

connecting to a server 122

creating a server 124

creating client 120

creating client endpoint 121

disconnect from server 123

generic interface 107

implementing 119-128

obtaining an address 121

protocol for server 124

rejecting connection 126

responding to connection 126

send data 123

server described 119

strategy 106-108

TCP ports 112

Networking in PowerPlant 103-136

next of kin in threads 60, 63

Next()

LSharedQueue 70, 86

NextGet()

LQueue 69

use in LSharedQueue 70

NextPut()

LQueue 69

LSharedQueue 86

notifier

and UNetworkFactory functions 109

O

offscreen drawing

classes 343-350

implementing 350-366

strategy 342

Offscreen Drawing in PowerPlant 341-366

operator !=()

STableCell 202

operator ==()

STableCell 202

operator new

use with threads 72

P

pane

adding drag and drop 319

PointInDropArea()

LDragAndDrop 319

LDropArea 318, 319

port

binding to local 121

PostAction()

executing action 301

LCommander 295

LUndoer 298

LUndoer and LCommander compared 299

PostAnAction()

LCommander 295

posting an action 295, 301

preemptive threads 59, 74

promise in drag and drop 328

protocol for network server 124

PurgeHeap() 28

PutBytes() 23

Q

QC 16, 20

R

ready thread 55

Receive()

LEndpoint 115

ReceiveDragItem()

LDropArea 318, 319, 328

receiving a drop 318, 328

recordable application 271

redo See undo

Redo()

LAction 297

RedoSelf()

in text action classes 299

LAction 297

overriding in action classes 300

RefreshCell()

LTableView 207, 229

RefreshCellRange()

LTableView 207, 229

RejectIncoming()

and rejecting connection 126

LEndpoint 114

Remove()

LQueue 69

RemoveCols()

LTableGeometry 213

LTableSelector 215

LTableStorage 217

LTableView 204

RemoveDropArea()

LDropArea 317

RemoveNode()

LCollapsableTree 219

RemoveRows()

LHierarchyTable 211

LTableGeometry 213

LTableSelector 215

LTableStorage 217

LTableView 204

parameters 223

RemoveSubModel()

LModelObject 253

Reset()

LEventSemaphore 67

Resorcerer

and aete resource 265

responder 124

compared to client 124

result

in LSimpleThread 65

of a thread 63

Resume()

LThread 55, 62

to run a thread 75

use in main thread 72

rows, insert requires wide-open index 211

Run()

effect on deleting a thread 77

LSimpleThread 65

LThread 62, 63

not for running a thread 75

UMainThread 65

use in main thread 72

running a thread 63, 75

S

ScrampleHeap() 28

scriptabilityþSee Apple event

SelectAllCells()

LTableSelector 215

LTableView 206

SelectCell()

LTableSelector 215

LTableView 206

SelectCellBlock()

LTableMultiSelector 216

SelectionChanged()

LTableView 206, 227

semaphore

described 57

using 81-85

send data, networking 123

Send()

and sending data 123

LEndpoint 114

SendAppleEvent()

UAppleEventsMgr 262

SendAppleEventWithReply()

UAppleEventsMgr 262

SendSelfAE()

recordability 271

server

accepting connection 126

and responder class 124

choosing a protocol 124

connecting to 122

creating 124

described 119

disconnecting 123

listening for connection 125

rejecting connection 126

responding to connection 126

set tell target 270

SetAEProperty()

LModelObject 255

SetBounds()

LGWorld 344

LGWorld example 346

SetCell()

STableCell 202

SetCellData()

LTableStorage 217

LTableView 206

parameters 225

uses wide-open cell 207

SetColWidth()

LTableGeometry 213

LTableView 205

parameters 224

SetDragDrawingProc() (Mac OS) 330

SetDragInputProc() (Mac OS) 330

SetDragSendProc() (Mac OS) 330

SetFilename() 23

SetLaziness

LModelObject 270

SetLink()

LLink 68

SetModelKind()

LModelObject 253

SetNextOfKin()

LThread 63, 64

SetResult()

LThread 62, 63

SetRowHeight()

LTableGeometry 213

LTableView 205

parameters 224

SetSuperModel()

LModelObject 253

SetTableGeometry()

LTableView 204

SetTableSelector()

LTableView 204

SetTableStorage()

LTableView 204

SetTellTarget()

LModelObject 270

SetUseSubModelList()

LModelObject 252

ShowDragHilite() (Mac OS) 327

Signal()

LEventSemaphore 67

LMutexSemaphore 68

LSemaphore 56, 67

using with semaphores 81

Simple Objects

Defined 32

Sleep()

LThread 56, 62

sleeping thread 56

Spotlight 16

STableCell 202

in calls to get/set data 207

member functions 202

StAEDescriptor 259

encoding data with 260

member functions 260

state transition in threads 56

StCritical 68

advantages of 79

SThreadParamBlk 91

StMutex 68

in mutual exclusion strategy 83

StOffscreenGWorld 347-349

data members 348

member functions 348

sample code 351

using 351

StOffscreenGWorld() constructor 348

Suspend()

LThread 55, 62

suspended thread 55

SwapContext()

calling inherited 81

LThread 62, 72, 79

T

T_LISTEN 126

table

accessing data directly 226

addressing cell 198

cell ordering 198, 230

changing row and column size 224

class architecture 196

class hierarchy 200

classes 199-220

creating 221

creating helper object 221

drawing a cell 228

drawing drop flag 228

finding data in 230

finding particular cell 229

getting cell data 225

handling click in cell 227

helper class hierarchies 200

helper classes 196

hierarchical described 197

highlighting cells 229

implementing 220-231

inserting column 222

inserting rows 222

managing rows and columns 222-224

nesting level of row 228

refresh cells 229

removing rows and columns 223

scrolling 231

see also cell

selection changed 227

setting cell data 225

setting helper classes 203

strategy 196-199

TableIndexT 198

Tables in PowerPlant 195-244

TCP

creating endpoint 126

ports 112

terminology resourceþSee aete resouce

TheBoolean()

UExtractFromAEDesc 258

TheEnum()

UExtractFromAEDesc 258

TheInt16()

UExtractFromAEDesc 258

TheInt32()

UExtractFromAEDesc 258

ThePoint()

UExtractFromAEDesc 258

ThePString()

UExtractFromAEDesc 258

TheRect()

UExtractFromAEDesc 258

TheRGBColor()

UExtractFromAEDesc 258

TheType()

UExtractFromAEDesc 258

Thread Manager

finding 71

ThreadAsynchronousResume()

LThread 56

ThreadBeginCritical() (Mac OS) 57, 68

ThreadEndCritical() (Mac OS) 57, 68

ThreadProc function 64

threads

allocating memory 74

allocating memory for 72

asynchronous operations 88-94

blocked 56

calling constructor 73

class hierarchy 58

classes 58-70

Context Switching 79

context switching 79

creating 72

creating main 71

critical data 78

current 55

data coherency 78-88

deleting 64, 77

finding Thread Manager 71

implementing 70-77

initializing 71

inter-thread communication 57, 85-88

modifying state 75

next of kin 60, 63

preemptive 59, 74

ready 55

result 63, 65

running 63, 75

semaphore described 57

sleeping 56

state 55-56

state transition diagram 56

strategy 54-58

suspended 55

using semaphores 81-85

waiting 56

Threads in PowerPlant 53-102

ThreadsLib, importing weak 71

TimeStamp() 23

ToggleAction()

LUndoer 298

ToPoint()

STableCell 202

TrackClick()

LDropFlag 220

TrackDrag() (Mac OS) 316, 325

tracking a drag 326

U

UAEDesc 261

member functions 261

UAEGizmos 249, 270

UAppleEventsMgr 262

member functions 262

UDebugNew 29

ErrorHandler() 29

Forget() 29

GetPtrSize() 29

InstallDefaultErrorHandler() 29

Report() 29

SetErrorHandler() 29

ValidateAll() 29

ValidatePtr() 29

UDebugUtils 29

UDP 127

UExtractFromAEDesc 258

data coercion 259

member functions 258

UHeapUtils 27-28

CompactAndPurgeHeap() 28

CompactHeap() 28

PurgeHeap() 28

ScrampleHeap() 28

UMainThread 65

UMemoryEater 28

Unbind()

LEndpoint 113, 117

undo

attaching undoer 301

classes 294-299

command messages 298

implementing 299-302

menu strings 296

multilevel 302

see also actions, LAction

strategy 293

Undo()

LAction 297

UndoSelf()

in text action classes 299

LAction 297

overriding in action classes 300

UNetworkFactory 109

described 107

functions 109

UnhiliteDropArea()

LDropArea 318, 327

UnselectAllCells()

LTableSelector 215

LTableView 206

UnselectCell()

LTableSelector 215

LTableView 206

UpdateGWorld() (Mac OS) 346

UProcess 30

User Datagram Protocol 127

UValidPPob 23, 30

UVolume 30

V

ValidateHandle_() 32

ValidateObj_() 32

ValidateObject_() 32

ValidatePtr_() 32

ValidateSimpleObject_() 32

ValidateThis_() 32

W

Wait()

LMutexSemaphore 68

LSemaphore 56, 67

using with semaphores 81

waiting thread 56

WaitMouseMoved() (Mac OS) 324

Wake()

LThread 56, 62

WriteBlock() 23

WriteData() 23

Y

yield with LYieldAttachment 66

Yield()

LThread 55, 61, 66

Z

ZoneRanger 16, 19