[MD1] Raven 1.5
TweetFollow Us on Twitter

[MD1] Raven 1.5

From: jesjones@halcyon.com (Jesse Jones)
Subject: [ANN] Raven 1.5

I'm happy to announce that Raven 1.5 is available. You can find it at

Raven is a free C++ application framework similar to PowerPlant and MacApp.
The changes in 1.5 are as follows:

Known Bugs:

* Stack crawl doesn't have symbol names if virtual memory is on.

* DTS has confirmed a bug in the 1.0.1 Appearance Extension: if a window's
procID is kWindowModalDialogProc or kWindowAlertProc the window is not
actually modal (ie the user can switch out of the app).

* When using native floating windows the NavServices dialogs don't activate
until they're clicked (OS 8.5f2). Note that this is reproducible with the
Nav Services sample code.
+ CustomGetFile seems to hang if InitFloatingWindows is called (OS 8.5f2).

+ The SIOUX window won't drag if a floater is visible (this is a SIOUX bug).

General Notes:

+ There's now a Raven web page at:
There's also a mailing list. To join send email to
(listserver@justmagic.ml.org) with "Subscribe Raven" in the body of the

+ Examples no longer ship with implicit warning conversion enabled (because
requires lots of changes to MSL).

+ The example projects were built using the 3.2 Universal Headers. If
you're not
using these headers you'll need to remove WindowsLib and ControlsLib in order
to build any of the examples.

* For the next version of Raven I hope to use a cross platform portability
This will likely be packaged as a stand alone class library. It will contain
most of the features found in Raven's Foundation and Core layers. To prepare
the way I've made the following changes:

* Raven's naming conventions have been simplified: classes consisting of only
static methods use the standard T prefix instead of U. Mixin classes start
with T instead of M and end in Mixin. The new library will use X for cross
platform classes, M for Mac classes, and W for Win32 classes. * Removed
HAS_ANSI_EXCEPTIONS and the typedefs mapping standard exception
classes to Raven style names.

* Dropped TLongPoint, TLongSize, and TLongRect. Changed TPoint, TSize, and
TRect so that they use int32. (Note that this will work better in Carbon
as well as Win32). The only problem with doing this is interfacing to the
toolbox. I originaly retained the conversion operators using 8-item static
buffers, but this could lead to nasty bugs if the item was still in use when
the buffer wrapped around. So, by default, the conversion operators are
(you can define IMPLICIT_GEOM_CONV to enable them). If you need to interface to
the toolbox you need to use either GetOSPoint or GetOSRect.

* Disabled streaming of TPoint, TSize, and TRect. This was done because it's
not always possible to determine if a saved object is 16 or 32 bits. To
stream these objects you can make use of temporary objects defined in
ZStreaming.h. They're used like this: stream )) TSize16(mSize) and stream
(( TPoint32(mDelta).
This involves a lot of renaming so I've created a drag and drop app called
BatchRenamer to handle the tedious bits. Note that TLongPoint, TLongSize,
TLongRect are not renamed since you'll want to handle these differently if
they're streamed.

+ modeDoesActivateOnFGSwitch Size flag should be enabled (TApplication ctor
ASSERT if it's not).

+ All example projects/targets weak link to InterfaceLib. You'll have to do
this as
well if you want to run on Systems prior to 8.5.

Bug Fixes and Design Changes:

+ Made significant changes to TDropApp:

- TDropApp now handles iterating over files in folders.

- The error reporting has been significantly improved. For example, the user
will now be told which file the app was working on if an exception occurs.

- mErrorExit, mCancelExit, and mNumProcessedFiles members have been added to
enable better messages when the app exits.

+ TApplication::HandleInit calls AddDialogFilter (instead of the ctor).
This avoids an ASSERT in TApplication::Invariant if a dialog was posed
while the app was initializing.

+ Fixed the TRACEFLOW in TCommanderMixin::HandleMenuCommand (it was printing a
std::string without using c_str).

+ Tweaked TFloatingDesktop::SelectWindow so that it works if there are pending
activate events.

+ TDesktop::AutoPosition correctly handles cases where modal dialog is
offset from
another modal.

+ ZBuildWindowRegions builds the window regions if the window is invisible
OR the
structure region is empty (used to be AND which could fail if the app was

+ TRowSelection::HandleNewTableSize zaps the current selection.

+ Tweaked TPopupMenu so that it no longer ASSERTs when reanimated with
empty menu.

+ TPopupMenu mutators invalidate instead of letting the Control Manager
redraw the
control (note that the old code wasn't setting up the port so the Control
wound up drawing the menu in weird places).

+ Updated TPopupTable SWindowAttr initialization (wasn't working properly
with OS 8.5).

+ ZThumbTracker::OnTrackStop lets the Control Manager redraw the scrollbar
(so scrollbars
will un-hilite after you drag the thumb in the Gizmo or Hi-Tech themes).

+ TStandardFile::GetFile was using the wrong item number with non-empty

+ TInStream::Resurrect no longer keeps a partially initialized object in
the object
cache if an exception is thrown.

+ Added some missing ByteSwap calls to TInStream.

+ Fixed a (really) bad cast in TFileSpec::GetPath and TFolderSpec::GetPath.

+ ZInput.cpp and ZDialogUtils.cpp use BUILD_ROUTINE_DESCRIPTOR only if
is true (this caused crashes on 68K machines running System 7).

+ ZInput.cpp no longer disposes of UPPs created on the stack (via

+ DoubleToStr, DoubleToSciStr, and DoubleToFormStr support zero decimal digits.

+ Fixed a bug in ExtractChar ()) was used instead of &).

+ The cast functions in ZNumbers.h account for float -) int truncation.

+ Made Call_num2decl TARGET_CPU_PPC only (in ZFloatConversions.cpp).


+ Made lot's of changes for OS 8.5. Note that this code is all wrapped in
#if's so
you don't need the 8.5 Universal Headers. If you are using the new headers
need to weak link to ControlsLib and WindowsLib. The changes include:

- ZFloatingWindow.cpp will use native floating windows if they're installed. If
you set NATIVE_FLOATING_WINDOWS to 0 the old floating window code will be used.

- Floating windows are now hidden when modal dialogs appear. (I would
prefer the
old way where floaters are merely disabled but I experienced lot's of problems
with window activation when I tried this).

- Before using Dialog Manager dialogs and alerts you need to create a

- TWindow uses IsWindowInStandardState to compute the zoomed out window bounds.

- Added TWindow::AnimatedShow and AnimatedHide. These let you show and hide
windows with a theme specific animation.

- Moved TBuildWindowRegions into ZWindow.cpp. Added (disabled) code to replace
stuff that used TBuildWindowRegions (it's disabled because GetWindowRegion
doesn't seem to be working quite right in OS 8.5f2).

- TWindow uses SetWindowContentColor (so Window Manager erases window to
color instead of white).

- Added TWindow::GetContentColor and SetContentColor.

- Added support for window proxies to TDocWindow.

- TDesktop::AutoPosition uses new RepositionWindow call.

- Added TScrollBar::SetViewSize (for proportional scrollbars). (Note that with
OS 8.5f2 proportional scroll bars are only enabled if you select the smart
scrolling option). TScroller calls this as needed.

- TScrollBar uses the new live scrollbar proc type if the Appearance Manager is
installed (which means the icky code in ZThumbTracker isn't used).

- TScrollBar and TMacControl use the 32-bit Control Manager functions.

- ZCursor.cpp uses theme cursors for non-animated cursors wherever possible.
(Appearance.h includes a function called SetAnimatedThemeCursor for animated
cursors but it can't be called at interrupt time).

- Added commented out call to
BeginThemeDragSound(kThemeDragSoundDragging) in
TDragSourceMixin::OnDragStart. (It's commented out because I'm reluctant to
include it if users can't disable it and it's not at all clear that the Sound
panel in the Appearance control panel handles this case (and I can't test this
because 8.5f2 only includes the platinum theme which apparently doesn't
include a kThemeDragSoundDragging sound)).

- TFileSystem::GetVolumeTotalBytes and GetVolumeFreeBytes use PBXGetVolInfoSync
(works better with HFS+).

- TFileSystem uses new IsAliasFile and ResolveAliasFileWithMountFlags functions
if they're available.

+ TDocApplication::HandleOpen checks to see if the document is already
open. If it
is the document's window is brought to the front.

+ Rewrote TDocApplication::DoAEOpenDocs and TDropApp::DoAEOpenDocs using
the new Apple
Event classes.

+ TApplication::HandleQuit closes floaters after regular windows (so
floaters aren't
hidden if user cancels out of save dialog).

+ Changed TAppBootStrap::OnPositionSioux to make the SIOUX window a bit
smaller (for
AM's larger window frames).

+ TEventDispatcher ensures that 0.1 seconds have passed before calling
* Changed TDocument:

- OnSave will throw if the file is checked in (using 'CKID' resource).

- OnSave copies the old file's resource fork.

- OnMenuCommand treats save as save as if the file isn't writable.

- TDocument broadcasts kDocumentDirtyChanged and kChangedDocumentFileSpec.
Made mCreator, mFileType, and mFileSpec private. Added accessors for these.

+ Renamed SWindowAttr::eraseOnUpdate eraseContent and added option to use
WindowAttr::color instead of theme brush.

+ TWindow::IsContextClick no longer calls IsShowContextualMenuClick (for
some obscure
reason IsShowContextualMenuClick occasionally returns false under MacOS 8.1).

+ Changed tables:

- Weakened the THierarchicalTable::HandleSelect post condition (TSubNode's
their contents so they don't become selected if they're empty).

- Added TColumnSelection.

- TTableSelection::OnTripleClick takes a cell instead of a row.

+ Worked on 2D graphing code:

- T2DGraph erases using a TEraseExtension (this makes it possible to use draw
extensions to draw "underneath" the graph).

- Added T2DGridExtension. This draws lines along the major ticks.

- Added THistogramPlot.

- Added T2DAxis::OnGetLabel.

- Tweaked TContinuousPlot::Plot so that it will draw a line when y is at x

- T2DAxis converts from floats to pixels by rounding.

- T2DGraph::AdjustGraphSize recomputes bottomSize after changing bottom
axis width
(fixes an ASSERT).

- Sped up T2DAxis::UpdateLabelWidth.

+ Added HandleDeleteCol and HandleInsertCol to TBaseTableView.

+ The HandleNewTableSize methods check the invariant on exit instead of on
entry and exit.

+ TBaseTableNode descends from TSafePtrTargetMixin.

+ TPopupMenu no longer uses NewControl to create the menu (per Tech QA TB42).

+ TMacControl::OnDraw uses DrawControlInCurrentPort if Appearance 1.1 or
later (didn't
seem to work properly in 1.0).

+ TFocusRectExtension only draws dimmed rings if the owner is a latent

+ TTracker will optionally call BeginThemeDragSound.

+ Added TMenu::IsSeperator.

+ Made some changes to TFileSystem:

- Replaced ResolveAlias(FSSpec) with ResolveSpec. This has a slightly different
API (hence the name change) and is based on the code in TN FL 30 "Resolving
Alias Files Quietly". (This is only used prior to OS 8.5).

- Added HasDataFork and HasRsrcFork.

- Added IsWritable. In addition to seeing if the file can be opened with write
permission this will check to see if the volume is locked, if the file doesn't
yet exist, and the 'ckid' resource.

- Added TFileSystem::LaunchApp overload that takes a TFileSpec pointing to
the app
to launch.

- Rewrote TFileSystem::ForceFinderUpdate and LaunchApp (TFileSpec, bool,
bool) using
the new Apple Event classes.

+ Added TFolderSpec::GetFolder (lets you specify the FindFolder constant).

+ Made some changes to TNavigationServices:

- Added overloaded versions of ChooseObject, ChooseFile, and ChooseFolder that
allow filter objects to be specified.

- Fixed a couple of places that would throw if userCanceledErr was returned.

+ Added TKeyEvent::SetChar.

+ Added SPen::operator==.

+ Made some changes to preference handling (based on TN 1134):

- TPreferences::Init again takes a creator type.

- TDocApplication::HandleOpen calls a new method named OnOpenPref for
'pref' files.
To be compliant with TN 1134 apps should override this and display their prefs

+ Made MPurgeable::IsPurgeable virtual. Added a comment to SetPurgeLevel
that kNormalPurgeLevel be used for most objects.

+ Ask, AnswerYes, and AnswerNo filters no longer let DefaultFilter handle

+ Changed Ask and AnswerYes non-AM alerts so that default button is at
bottom right.

+ Tweaked TRecordSound:

- Added work around for 5400 siLevelMeterOnOff bug.

- Switches to mic input source when running System 8.1

+ Changed profiling code:

- Added a warning to ZProfiler.h because the MetroWerk's profiler
apparently uses
shorts internally so that it's easy to cause it to overflow as numFunctions
large. This causes all manner of strange results...

- ZProfiler.cpp defines it's own ASSERT macro (since profiling is often done in
release builds).
- TProfileEnabler can now optionally disable profiling

+ Improved ZParser.h comments. Renamed TParseAggregate::CanParse OnCanParse.
Added TParseOperand (simplifies parsing constructs like "token (operand

+ Added TLexer::SkipToken.

+ TLexer optionally ignores case (when matching).

+ Added swap methods to TSimpleVector, THandle, TPointer, TTree,
TSparseArray, and TArray.

+ Added Compare template argument to TSet.

+ TMemoryHeap::Deallocate will now ASSERT if delete [] is used on
non-arrays (and
vice versa).

+ Renamed TAllocator::ValidateHeap WalkHeap.

+ Tweaked TSimpleAllocator so that WalkHeap walks huge blocks.

+ Added a test to TAllocator unit test to time allocations in a severely
heap (in both debug and release TBestFitAllocator is 10-30x faster than

+ Added ZPointerRef::Invariant.

+ Renamed the int conversion functions (eg ShortToStr is now Int16ToStr)
and added
8-bit functions.

+ ZGetMicroSeconds ASSERTs if time starts going backwards.

+ ZComplex.inc no longer includes xdouble.h

+ Added TGestalt::GetAppearanceVersion.

+ PowerPC byte swapping uses intrinsics instead of asm functions.

+ Searched for cast expressions and changed many of them to use the new
style casts.

+ Removed HAS_BOOL.

+ Enabled STL specializations in ZTypes.h (for Pro 4).

+ RavenHeader.h defines MSIPL_DEBUG_MODE.

+ Uses MoreFiles 1.4.9

+ Added Win32 QTML changes from Loic:

- QD3D Windows draw context

- QD3D Windows file storage object

- Misc minor changes


+ Added a BatchRenamer example project.

+ Added TAEDesc, TAEList, TAERecord, TAppleEvent, and TAEToken classes (in
Core:Apple Events).

+ Added TMouseEnterMixin (lets panes get notified when mouse enters and
leaves the pane).

+ Created ZMath.h and inc. Includes vector and statistics template
functions (most of
the vector functions were moved from TVector).

+ Added Replace (string, string, string) to ZStringUtils.h

+ Added uint32 overload of Random.

+ Added Win implementations of BreakToDebugger and BreakStrToDebugger


+ The window editor now allows you to specify that the window doesn't have
a zoom box.

+ Can specify whether windows will be erased with theme brush or content color.

+ Modal windows can now be resizable (note that they'll have size boxes
only for
Appearance Mgr 1.0.1 and above).

+ Pane edit dialog is now resizable.

+ Uses new AnimatedShow and Hide calls.

+ Popup menu id can now be set to zero if you want to start with an empty
menu (ie
you want to add all the items at runtime).

+ Quill pops up an alert if the file isn't writable and not locked (if it's
the OS will pop up an alert when the file is opened).

-- Jesse


Community Search:
MacTech Search:

Software Updates via MacUpdate

1Password 6.3.5 - Powerful password mana...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
QuickBooks R9 - Financial ma...
QuickBooks helps you manage your business easily and efficiently. Organize your finances all in one place, track money going in and out of your business, and spot areas where you can save. Built for... Read more
TextMate 2.0-beta.12.25 - Code/markup ed...
TextMate is a versatile plain text editor with a unique and innovative feature set which caused it to win an Apple Design Award for Best Mac OS X Developer Tool in August 2006. A rapidly growing... Read more
TunnelBear 3.0.4 - Subscription-based pr...
TunnelBear is a subscription-based virtual private network (VPN) service and companion app, enabling you to browse the internet privately and securely. Features Browse privately - Secure your data... Read more
PDFpen 8.2.1 - $74.95
PDFpen allows users to easily edit PDF's. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even correct text and edit graphics! Features... Read more
PDFpenPro 8.2.1 - $124.95
PDFpenPro allows users to edit PDF's easily. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Create fillable forms and tables of content... Read more
Cosmo Run 2.5.1 - Arcade game with ever-...
Cosmo Run is an arcade game with ever-changing aspect of the play-world. Survive long enough and you will meet special alternative paths - both hardcore and rewarding. Are you worthy to command the... Read more
Box Sync 4.0.7724 - Online synchronizati...
Box Sync gives you a hard-drive in the Cloud for online storage. Note: You must first sign up to use Box. What if the files you need are on your laptop -- but you're on the road with your iPhone? No... Read more
VueScan 9.5.59 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
Skype - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more

Latest Forum Discussions

See All

Best Fiends Forever Guide: How to collec...
The fiendship in Seriously's hit Best Fiends has been upgraded this time around in Best Fiends Forever. It’s a fast-paced clicker with lots of color and style--kind of reminiscent of a ‘90s animal mascot game like Crash Bandicoot. The game... | Read more »
5 apps for the budding mixologist
Creating your own cocktails is something of an art form, requiring a knack for unique tastes and devising interesting combinations. It's easy to get started right in your own kitchen, though, even if you're a complete beginner. Try using one of... | Read more »
5 mobile strategy games to try when you...
Strategy enthusiasts everywhere are celebrating the release of Civilization VI this week, and so far everyone seems pretty satisfied with the first full release in the series since 2010. The series has always been about ultra-addictive gameplay... | Read more »
Popclaire talk to us about why The Virus...
Humanity has succumbed to a virus that’s spread throughout the world. Now the dead have risen with a hunger for human flesh, and all that remain are a few survivors. One of those survivors has just called you for help. That’s the plot in POPCLAIRE’... | Read more »
Oceans & Empires preview build sets...
Hugely ambitious sea battler Oceans & Empires is available to play in preview form now on Google Play - but download it quickly, as it’s setting sail away in just a few days. [Read more] | Read more »
Rusty Lake: Roots (Games)
Rusty Lake: Roots 1.1.4 Device: iOS Universal Category: Games Price: $2.99, Version: 1.1.4 (iTunes) Description: James Vanderboom's life drastically changes when he plants a special seed in the garden of the house he has inherited.... | Read more »
Flippy Bottle Extreme! and 3 other physi...
Flippy Bottle Extreme! takes on the bottle flipping craze with a bunch of increasingly tricky physics platforming puzzles. It's difficult and highly frustrating, but also addictive. When you begin to master the game, the sense of achievement is... | Read more »
Plants vs. Zombies Heroes guide: How to...
Plants vs. Zombies Heroes surprised us all, presenting a deep deck building experience. It's a great CCG that stands up well to the competition. There are a lot of CCGs vying for players' attention at the moment, but PvZ Heroes is definitely one... | Read more »
Arcane Online takes Online RPG’s to anot...
If you think that you need a desktop to enjoy high quality MMO gaming then Arcane Online hopes to prove you emphatically wrong. An epic fantasy Online RPG set in the land of Eldine, Arcane Online offers an abundance of features and content that... | Read more »
It’s time to step up and start your spoo...
So you’ve just downloaded Seekers Notes: Hidden Mystery, and you obviously want to hit the ground running. Well you’re in luck because you just so happen to be reading our very useful guide to playing. First released in July last year, the game has... | Read more »

Price Scanner via MacPrices.net

Check Apple prices on any device with the iTr...
MacPrices is proud to offer readers a free iOS app (iPhones, iPads, & iPod touch) and Android app (Google Play and Amazon App Store) called iTracx, which allows you to glance at today’s lowest... Read more
Apple, Samsung, Lead J.D. Power Smartphone Sa...
Customer satisfaction is much higher among smartphone owners currently subscribing to full-service wireless carriers, compared with those purchasing service through a non-contract carrier, according... Read more
Select 9-inch Apple WiFi iPad Pros on sale fo...
B&H Photo has select 9.7″ Apple WiFi iPad Pros on sale for up to $50 off MSRP, each including free shipping. B&H charges sales tax in NY only: - 9″ Space Gray 256GB WiFi iPad Pro: $799 $0 off... Read more
Apple refurbished 13-inch Retina MacBook Pros...
Apple has Certified Refurbished 13″ Retina MacBook Pros available for up to $270 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 13″ 2.7GHz... Read more
Apple refurbished 15-inch Retina MacBook Pros...
Apple has Certified Refurbished 2015 15″ Retina MacBook Pros available for up to $380 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 15″ 2... Read more
Apple refurbished 11-inch MacBook Airs availa...
Apple has Certified Refurbished 11″ MacBook Airs (the latest models), available for up to $170 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is... Read more
Apple refurbished Apple TVs available for up...
Apple has Certified Refurbished 32GB and 64GB Apple TVs available for up to $30 off the cost of new models. Apple’s standard one-year warranty is included with each model, and shipping is free: -... Read more
15-inch Retina MacBook Pros on sale for $200...
B&H Photo has 15″ Retina Apple MacBook Pros on sale for $200 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799 $200 off MSRP - 15″ 2.5GHz Retina... Read more
Apple refurbished 2016 13-inch MacBook Airs a...
Apple has Certified Refurbished 2016 13″ MacBook Airs available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: - 2016 13″ 1.6GHz/8GB/128GB MacBook... Read more
Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more

Jobs Board

*Apple* Retail - Multiple Positions (Multi-L...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions- New Yor...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions- Yonkers...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Senior Manager, Security Engineering - *Appl...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more Read more
Manager, Threat Intelligence - *Apple* Info...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.