WWDC2001 Session 113

Transcript

Kind: captions
Language: en
hi buzu on Tracy I'd like to welcome you
to session 1 1 3 text on Mac os10
this session will focus on the
technologies that will enable a cover an
application to display text correctly on
Mac OS 10
when I say correctly I mean two things
first the text has to be in Unicode and
you need to support multilingual text
Mac OS 10 is an internal OS and you see
it Monday with avi we're going to be
shipping like you know a new version of
my question which support with Korean
Chinese and other languages in Europe
and your application needs to support
Unicode Unicode is like you know the
standard for encoding text now the
second point which is very important for
customers is you need to use quartz
rendering to display the text quartz is
a powerful 2d rendering engine but gives
to Mac OS test then it's special taste
with nice anti-aliasing on vertex with
drop shadows you need to use quartz to
render your texture you don't want your
text to stick like at the source term if
you still use the quick-draw rendering
excellent in this session we'll discuss
as well MLT which is the multilingual
text engine last year in this same room
i discussed MLG the benefits with
features and how it could be
implementing in your application we got
tremendous feedback from MLT and I'd
like to show you a couple of
applications that are using MLT and our
shipping actually some of them are
shipping right now or start with Acrobat
Reader we're very pleased Acrobat has
been using MLG for instance here you can
see in the find
window and Acrobat needed to support
Unicode and they had regular
implementation using TextEdit and NLT
fitted very well in this integration
towards Mac OS 10 with an LG they get
the cross Angela Singh and the Unicode
support they needed in there edit text
fields
another client of MLG and were very
happy but they're using it it's Maya
Maya is a huge application and when they
had to find a way to render her texture
in Mac OS Tina
they used an LT MNT was were choice here
a baguette for instance in the script
editor of a full emoji object with the
scroll bars the support Unicode text and
the text isn't areas correctly another
client and we're very pleased of that
because we think it's very important for
the platform is of course we sorcerer
I'm sure all of you know resource earn
here resource are implements MLT as a
you txt editor a lot of the strings are
going to be passing you know to the
parents manager for instance after the
Unicode well now with a new version of
restaurant thanks to MLG the
multilingual text angina you're going to
be able to have Unicode resources in
your application so you don't have to do
is here string and convert to text from
Mac OS encodings to Unicode and then
Pasadena to MLG draw theme text box or
over ap is another great feature but I
really like the new resource or is
actually the Unicode viewer they
implemented in resource server kind of
this window that shows you like you know
all the character set for Unicode with
65,000 characters so you could change
change without and you'd be able to see
other characters here in this case they
use Atsui or actually vertex and joiny
code text box api which enables them
once again to have the Unicode support
and the great quartz rendering last and
this is of course tech just a couple of
our customers the finder the finder uses
MLT the finder needs to be able to enter
Japanese and Roman text in the text
files when here in fact when you addict
texture in the finder in fact behind is
an MLT text object keycaps
you're no chica up ski caps is MLG as
well and uses with drafting text box
api's to display the characters on the
keys another great application of course
is word text which takes power of like a
mentee and shows by advanced typographic
features but we support on Mac OS 10
with that sweet apple type services
medical imaging
there are way more customers of course
and if you look at the carbon
development list you see a lot of
questions on MLT and a lot of developers
using it we're very pleased with what
we've been doing and with very pleased
with the feedback that you're giving us
so far
now the agenda for today I'll give you
quickly a brief overview about the text
architecture how the solutions we're
going to be talking about today are
going to be sitting in the Mac os10
overview and the Mac os10
architecture by itself then John Harvey
a senior architect on the MLT will be
talking about what API is you're going
to be able to use to display static
texture last year actually at the stem
conference we got a lot of feedback and
a lot of people are wanting to have a
Unicode text edit control they wanted
the toolbox to have like you know an MLG
control in the toolbox when I'm glad to
say with a new version of Mac OS 10 the
one but has shipped you know in March oh
you have actually this control and you
can use it John will be talking about
that as well thank you
we'll talk about that don't try and then
of course we still at MLG if you need
more control if you want like you know
support for drag and drop if you want
support for embedded objects we talked a
little bit about how you can do that
once again with the multilingual text
and shine and we have a special guest we
worked very closely with metrics and
happy to say that actually metros in the
next release will implement a couple of
new classes in power plant so in power
plant should be able to drag and drop an
object and you get all the images you
probably want either
Gregg Dao the architect for power plant
will be here and come on stage and show
you a demo of his implementation the
last point that we talked about is
rigged fabric one of Engineers on the
MLG team will talk about tips and tricks
on how to use a multilingual text em
China sometimes we get some questions
since you know architecture is different
between
quick geo textile and you know MLT and
he'll be answering a couple of like most
of the questions was the common
questions when we can ask them pretty
interesting I encourage you to stay
quickly the overview so we'll be talking
today about two different parts the
first thing you have to achieve in your
application is display some static text
and you know you can use
string it's not gonna work or draw text
it's not going to work because it's
going to work but then the text is maybe
winter with quick-draw and you don't
want that you don't want to use texture
to stick out you want it to use squats
and here we talk about solutions to draw
a static text using you know or
technologies that you squat and Unicode
the second part will talk about text
editing and here once again you'll have
two different choices you have we talked
about the single line control which is
what the tool box control talked about
that uses MLT and in order to display
bigger text areas and it once again if
you want support for embedded objects
like sound picture or movies then you'll
be able to use MLT all these
technologies use at Hsu atsui
is the heart or text rendering on Mac OS
10 at SU is Apple type services for
unicode imaging and it's report for
unicode layout engine but enables us to
enter CGI script Chinese Korean Japanese
and give us advantage of quads rendering
and lt of course uses that suite
directly and has its own implementation
using atsui on top of that you'll see
that you know that is by static text and
the single nine control the apparents
manager is the one that would be
actually using at Hsu and below all that
you see that quartz is the heart of a 2d
rendering and gives us a point of
flexibility of this new architecture to
render text on Mac OS 10 alright in
order to talk about these different
solutions to display text on Mac OS 10 I
have to invite on stage John Harvey John
Harvey has been working on MLT and is
the architect over technology hey John
[Applause]
well it's great to have a chance to come
out and talk to people about the things
we've been working on for the last year
and I appreciate your coming there we go
so the survey said I'm going to talk
about three different areas static text
drawing drawing a simple text area via
control the way you did it on system 9
with the edit text control it's exactly
the same kind of thing except you get
all the Mac OS 10 features with this new
control you
editing courts rendering automatic CJK
support and then finally we'll talk a
lot about building your own text area
using ml te it's not that complicated
but obviously there's more api's and so
on you need to be involved in then if
you just use the control okay so
displaying static text now there's
basically two approaches you can use on
ten you can use the theme text api's
which are really pretty nice because
they bring together all the parts you
need to deal with to get the right look
in your text you know it the theme text
API is they know about what is the
localization they know about what the
theme appearance should look like and
know about the state of whatever that
text is and then if you really want a
lot of control and like a incredibly
feature rich set of api's you'd want to
use that soui now in this session I'm
not going to talk anymore about atsui
rather than to say that there wasn't
drawing with that soui session they'll
be feedback for them but it's just
important to know that if you really
want to get down and have fine-tuned
text you those api's are available but
we'll talk about the theme text API is
for static text okay so here's the set
it's a pretty small set obviously the
first thing you want to do is render
text for that there's draw theme text
box it's basically the same kind of
functionality you got from the text edit
text box but you get your courts
rendering which you can see we're gonna
emphasize over and over again how
important that is to have and so I mean
that's other than that you get your
justification right center left the
standard things and I'll talk a little
bit about the parameters that get passed
into this that give you the more
features more control over how the text
looks or what the fun is
if you want to measure that text which
obviously a lot of times you want to do
you want to figure out how big the box
is that you're gonna draw into you can
call the get theme dimensions this
returns not only the height and width of
text but it will also return a baseline
which typically is a small negative
value one or two and you add that to the
height to figure exactly where to start
your drawing and unten since a lot of
things are shadowed you need to find out
like how much shadow space there's gonna
be around your text so you don't clip
that out or draw over it and that second
API text shadow offset will tell you
that it's a rectangle with offset values
as the return okay and finally I think a
nice thing is to truncate theme text on
nine you used to have to call I I think
it's a text utility function to get a
truncated string back and then you'd
have to go to quick draw to render it
truncate theme text will do the
rendering for you and you know these
replace these old familiar routines and
I think a really nice thing is you don't
have to sometimes look in the in
TextEdit sometimes looking quick draws
sometimes looking text utilities they're
all there an appearance manager
specifically appearance dot H it's the
header where you can find them okay so
talk a minute about the parameters that
you pass into this there you have the
concept of meta fun IDs these have been
around for a while in the appearance
manager but they give you some really
nice control it makes it easy for you to
tell what you want the text to look like
without having to do all the work you
had to do online where you'd have to go
looking script manager data structures
and things like that to find what the
right text is you use these api's utaite
you say okay I want the views font the
push-button push-button font something
like that the appearance manager does
all the work what's the localization
what's
shadowing that kind of thing at the same
time if you do want to use a font of the
port there's a metaphor that says use
the information in the poor and by using
these meta fonts you don't have to say a
fine a style size explicitly it figures
that out and again if you wanted to use
the information in the graph port you
use the the meta font which says use
font or port information like I said
these will take care of proprietary
effects you know if something's active
inactive that kind of thing on the
desktop John and why you know the doc
kind of tax that thing those things and
this these are Unicode savvy that the
eunuch eight one way that they are
Unicode savvy is when you pass text into
these api's use a CF string wrap that's
really the way to package Unicode text
on Mac os10
the toolbox deals completely in there's
and it's an opaque structure you're
probably familiar with it and it will
efficiently store Unicode text in there
you just pass it into the end of these
functions or other window tiling menu
functions and it will draw the text in
there
okay so making sure these perform at
their best there's a few things you can
do these a where appropriate these api's
take a cg context ref now if you are
allowed to pass null in if you do the
function will create a cg context ref
and then dispose it obviously that takes
time sometime not a huge amount of time
but if you're calling the function over
and over again it's creating going away
creating thrown away its time wasted so
you can create your own keep it around
and just use that to pass in there's
like anything you cared you know be
careful how often you measure tax catch
the values you get from measuring
attacks and so on don't like constantly
be calling the measurement routine
the time there's a lot more that goes on
on 10 you know probably on nine it was
really easy to just get you know text
width all the time that was real fast
compared to maybe storing it but it's
really it's important to think about
holding on to those values and then of
course in the engineering group
performances you know our utmost concern
and so we're working on speeding things
up internally okay so next area I'll
talk a bit about the edit text control
which you know for your basic editing
needs passwords so on is there it's real
easy to use whoops
keep pointing up with that okay so again
you use this you get courts rendering
for free you don't need to worry about
creating the cg context in this case the
control does that for you the one thing
that's nice is you use the same control
and you'll get building support for CJK
input but really there's a lot a now a
Mac os10 that has input methods I mean
there's unique area to input methods hex
input methods things like that you just
use this control that's all build in
that's different from 909 you had to use
be sure and you use a different proc
idea if you wanted to care about that
I'm probably diddle around a little bit
with TSM te and modified dialogue
structures and things like that but this
is you don't need to think about it it's
just there which of course is really
important on an international system
again you know this controls build on
top of MLT that's different from the
edit text control which was built on top
of TextEdit but it's the same concept
you know the basic text engine and then
the control on top of that if you want
to create this control well all the
controls on 10 now have a create
function which is a bit more
straightforward to use there are only on
10 so the old ways of course still work
new control get new control
and in that case we have the new croc ID
which is K control edit Unicode text
pack
okay so with that we'll move on to the
building you're in text area using M LTE
directly so we've you know last year we
talked about some of these features but
we want to go over them again people may
not have been here people not you know a
lot of new developers coming over to Mac
I think because of system 10 again it's
this is uncarbonated it Unicode text
this is what you use M LTE there's no
more 32k limit that's been said a lot of
times it was was a big problem in the
past with TextEdit for years and years
people said fix that fix that well we
didn't fix it in TextEdit we made a new
engine and again you get your building
support for CJK you don't have to worry
about it and it's really not right as I
said to just say building support for
CJK it's building support for input
methods and there can be an input method
for any language now any section of the
unicode character set in the old days
you had to allocate and hook your scroll
bars up with TextEdit and handle the
scrolling there you don't have to do
that that's build in really everything
is handled drag and drop and any sort of
click handling that you had to deal with
a lot of code in the past well not a lot
but it's significant amount let's just
handle with one function the TXN click
function we support embedded objects
pictures sound movies there's a single
tab for document and we have a multiple
undo redo stack and also a way to find
out what the undo redo action is so you
can then not only just say undo read
but undo typing undo cuts and that kind
of thing and you know again in a game we
were to say this you can you get the
courts rendering which is such a
signature part of Mac os10 okay so quick
comparison you know I talked about how
and TextEdit you had to do work to
scroll and print and things like that so
in TextEdit you had to write code create
the scroll bars hook the rectangles out
deal with offsetting the rack there
certainly was a te click function but if
you were scrolling there was more you
had the more that you had to do than
just call te click all that scrolling is
handled with the TXN click there's one
thing you know it's the multilingual
text engine but for historical reasons
the api's begin with the signature TX
and so it's building building support
for clicks that includes drag and drop
and all the highlighting and the other
big thing is if you want to print text
edit you have the right fairly large
amount of code and that's just you
there's two functions txm page setup and
TX and print you can call and you get
the printing so just to emphasize this
you can see the difference in lines
these it's 269 line these are this
samples are taken from the te sample
which has been shipping with all the
development environments that ever went
amateur works in PW there's 269 lines to
do these things and it compared to two
if you do it in ml te and on the web
there's a piece there's a project a
metro works project which has the old te
sample and then a new ml te sample built
in the same project and you can compare
the files you can see it's the same
basic functionality and it's just a lot
of care dropped out of the MLT
version the nice thing is you know I
mean you need this functionality but you
really probably rather not worry about
it because you're trying to give
something else to your users your
clients so you don't have to anymore
okay now something I'm really looking
forward to because I haven't seen it yet
we're gonna see the demo from Greg Dale
and I think this is gonna be really
great
[Applause]
okay hi
I'm gonna quickly just run through a
couple slides here I think John already
mentioned everything that M LTE and
Atsui and theme texture line can do and
what I've done is created some
powerplant classes that wrap all this
functionality up into simple neat
packages that you can use directly in
power plant so I have a class now for M
LTE it replaces the existing TextEdit
classes there's also a class that calls
L theme textbox to give you just a
simple static text caption that you can
use instead of all the other power plant
caption or static text controls let me
just move quickly to the demo here this
machine's seven
come up I have a project here that I've
built with these new classes I'm just
gonna run it quickly first thing that
comes up is we have an EM LTE pane pane
here I can type text here I can also
here I have in the finder I've just made
a couple of a picture of clippings I can
take that drop that in there now I have
you know light bulb in there can clip
back out another one in car in there so
it supports automatically graphics and
text mixed together again em LTE is
giving me the scroll bars automatically
it's giving me the font menu
automatically it builds the font menu
for me I can select the font in there
something more readable bigger capitals
there different font it also
automatically supports Unicode here I'm
gonna switch over to a Japanese keyboard
here and if I type some there I get to
automatically get Japanese characters
right mixed in with the same English
characters pictures everything is all
wrapped together neatly for me by M LTE
undo/redo here I can undo what I did
there
and do a little more keep going on the
undo here I'm under undoing the picture
drop and then I can go back redo
everything and all this is handled
automatically by M LTE what I did is I
took the existing power plant L edit
text classes pretty much stripped out
all the code in each of the functions
and replace it with one or two lines of
text of calls to M LTE
so in terms of your users your code that
uses power plant it'll be almost exactly
the same the same API you'll be just
calling into a different object but your
calls will be all be the same and it'll
just work much better and faster make
that up here so quickly
here's a demonstration of the theme box
theme text box control or actually not
to control just a pain one of the
problems with this is a normal static
text control people have mentions that
it automatically erases so here you can
see that there's a the grey stripe
background behind the text when I have
it over a picture if you don't want that
to happen you can use the new theme text
box class which will just draw the text
directly without any erasing let's see
if I click off if there the text
automatically dims there comes back and
that's all taken care of automatically
and this is all properly anti-aliased
here over the picture and finally I just
want to show quickly here Atsui although
John didn't mention a lot of the details
of what you can do with it here isn't a
sample here of the animation I'm doing
myself just quickly inside a loop what
I'm doing is I'm changing the degree of
rotation by five degrees each time and
then just redrawing and here I'm drawing
over a background picture
and all that Suey is handling everything
for me so this very flexible text you
can set you know the rotation you can
set the size the style and all sorts of
other features and all that is wrapped
together in a few in the two powerplant
classes one for handling the text layout
itself and the other for handling the
absoutely style and you can take those
classes and use them in a custom pain to
draw captions like me doing a graph or
something like that we need vertical
text on an axis all this is accessible
here from just a couple calls to
absolutely classes and best of all this
is also integrated now into constructor
quickly here you can here's the MLT e
pain that I had up there I can double
click here all the options for ml te are
accessible to you here from the
properties it can change the file type
that's associated with the ml te the
encoding here's some options you
probably can't read maybe all the
options here but I can turn off whether
it has scroll bars whether the carrot
blinks in the background or not we
shrink this one up hearings take this
here and maybe shrink that a bit and go
back here to layout catalog and drag out
a new ml te pane here so I can put a new
one right next to that one there and if
I save this
then go back to my project run you'll
just bring in the new PPO B and here I
have text over here text over here so
again it's very simple to use you just
use it like you do any other power plant
paint again the same thing for the theme
text
theme text window for the theme text box
again I have a couple new options it
supports the theme font ID so here I've
chosen to use the current port fund I
can switch over to use the system font
you won't see it updated in constructors
and constructor hasn't been rebuilt yet
with the new classes and maybe I'll turn
off I don't want it to dim when inactive
I can save this again go back to my
project and run that again through bring
up the theme text and now you can see
the theme text box is again drawn in the
system font again using the theme font
ID so you don't have to worry when your
internationalizing your code whether
it's Japanese Korean and English or
whatever you'll get the proper system
font without worrying about having to
set up in power plant now where you have
to make a text traits resource when you
put the name of the font in there here
you can choose the theme font ID and
again if I click here you can see there
the text doesn't dim I've turned that
off so you have the option of having the
text dim or not in the background
depending on your needs so this is all
built in the power plant unfortunately
it's not in the version you have on your
CD now that version froze about a month
ago and it didn't have time to update it
but it'll be in the next seed version of
power plant which if you haven't signed
up already you should consider joining
the Metalworks beta program and you can
come by the booth and ask about this or
check on the website and it'll give you
directions for sending an email in to
join up on the beta program and that way
you'll be able to get access to the
latest builds of power plant and these
new text features ok
[Applause]
well that that's really great I'm so
rewarding to work on something and you
wonder how much people use it while
you're work on it and then to see that
demo is fantastic for me and I'm really
thanks to Greg for doing that I can't
wait to start using it myself make my
life a lot easier okay so now we'll talk
a little bit about the newer things
we'll talk about quartz rendering again
and so quartz rendering you know over
and over again this is what you can get
you get your anti-aliasing it's really
significant part of the look of Mac OS
10 also in M LTE we have the beginning
of support for Carbon events we're going
to extend this as we go along right now
we support text input Carbon events and
I'll talk about some of what this gives
you in the on system 9 all the input
from Unicare keyboards came through
Apple events currently on the 10 now it
by default comes through Apple events
but you can tell us to use carbon events
or you can put your own text input
handler on top of us and do filtering
which I'll talk about then the other
thing we've we've done is where propria
we haven't changed our api's but
underneath under the hood we've adopted
the newer Mac OS 10 architecture
specific cases are printing and the
scrap manager so we use the promises
things like that if you're familiar with
the new Mac OS 10 scrap manager
ok so quartz rendering let's look at how
you do this you get your system get that
write system look when you do it and
it's really pretty simple to do you
create a CG context and then you hook
the CG context up with your ml te object
that's all you need to do you can show
you the code right here so
there's a few data structures you have
your TX n the preface data structures
the controlled tag and the controlled
demonsaw data the tag you set with a
constants it's actually defined in
at-ats unicode that age that's the etsu
e header the other ones are in mac text
editor dot h that's where ml te
constants and functions are defined and
then you create your cg context with the
create cg context report that's an api
in quick draw it once that's done and
it's done successfully you plug that
into the control data the value field
and then you just simply call this TX n
set TX and object control once you've
done that you get courts rendering you
don't have to do anything else okay the
next thing is the carbon events text
input specifically it's nice you know to
see everything and then it highlight
like that okay so we support all the
text input events so that includes the
text input event when it's coming
directly from a keyboard and then the
text input events that come from an
input method which include all the ones
which tell me which the input method
might ask where the text is or might ask
for the text and that kind of thing the
nice thing about text input events which
for you which was very very hard to do
if close to impossible when we used
Apple events is you can P pre and post
process text input and the other thing
to know is that if if you tell em LTE to
use text input events that's going to be
the optimal path because right now on 10
if we are still using Apple events what
happens is the text services manager has
to take the text input event off the
event view pull the data out allocate a
Apple event fill that in and then pass
that to us I mean it's not something
that's so time-consuming that you really
and you're typing but if you if you tell
ml to e to use the text input and event
handler that doesn't happen the data
structure can just move around s is
without any massaging on the part of the
text services manager okay so how to do
this just see this is the card is
actually very very similar to what we
saw for the cg context graph you've got
those same TX and Control old data
structures this time we use a constant
used carbon events which is in the Mac
text editor header and and we have a an
array of keys and array of values which
we'll use to build a CF dictionary we
use CF dictionary so we can include more
and more carbon events s it's
appropriate
so the expandability is right there and
ready for you or us ready for everyone
okay then there's a data structure the
TXN Carbon event info a few field you
set up there you say I'm using carbon
events today obviously you can turn them
off if you want by setting that to false
in this case there's a flag that says I
want you to turn off the Apple event
handlers this is usually what you want
to do but the thing is that you'll when
you throw this object away
if you have other ticks and objects or
there might be other ticks and objects
around in your application you want to
be sure and tell it to turn the Apple
event handlers back on then you create
your dictionary with CF dictionary
create one of the core foundation
functions and at that point you put a
pointer to the carbon event info in the
value field and you call that same
function again it hooks it up and M LTE
will start using tech handling text
input with a carbon event handler rather
than Apple events and in this case you
need to be sure and release the CF
dictionary because all the information
ml te needs is copied when you call the
set ticks and object control
very straightforward is sort of like
boilerplate now for telling ml te what
to do on tan okay so there's the three
topics again and what I mean I'm not
going to say anything else there's new
slides talking about the printing or the
scrap managers just as I said before we
have the exact same functions that we
had before you know txm pays copy cut TX
and print Tex and page setup but
underneath they use the new
architectures okay so at this point I've
been working a lot with Rick Fabrique
he's done most of the work or all the
work or not all the work but muscles
work on carbon live and he's had the
most interaction with you the developers
and he'll talk about some problems
people have had and issues that they
weren't sure about that he's been able
to help them with and basically his
experience working with developers
thanks a lot thanks John in working with
developers who are integrating ml te
into their applications we get many
questions as Jonah said similar to
what's the best way to program for this
particular task so what we're gonna do
now is go over some of the tests that we
have received the most questions on what
you see here is a list of the tests that
we'll be discussing today and will see
this list several more times as we go
through each of the tasks individually
we're going to be starting with what is
the best way for you to change the size
of your text objects and there are some
key concepts to understand in order to
get the best interaction between the
user and your text object as well as the
printout that you're looking for when
you print the object out now the first
thing to understand is what the
difference is between the view rectangle
and the destination rectangle and how ml
te defines them so the destination
rectangle defines where the text will
wrap in your text objects it's the full
page of text for your object
is what would be printed out when you
print the object out the V rectangle
shows the currently visible portion of
the destination rectangle and is what
the user sees at any one time now in M
LTE the view rectangle includes the area
taken up by the scroll bar so if you're
familiar with the Mac OS as original
text engine the V rectangle in TextEdit
objects doesn't include these the area
of the scroll bars and that's because
TextEdit objects don't have scroll bars
if scroll bars were necessary then the
developer would have to create and
manage them separately from the text
object but since them LTE handles the
creation and event handling
automatically for you we do include the
areas from the scroll bars so the
initial value of these rectangles are
set when you create the object with txon
new object and this abya api has a
parameter that accepts either null or a
pointer to a rectangle if you passed in
null to this API what you would get back
is an object that takes up the entire
window basically the view rectangle
would be the bounds of the window and
the destination rectangle would be set
to the standard u.s. letter page size if
on the other hand you passed in a
pointer to a rectangle the object that
you got back would only take up a
portion of the window and that course
would be equal to the rectangle that you
passed in now in this case the
destination rectangle would be that
rectangle but we don't include the the
scroll bars in this case because you
want the text to wrap at the scroll bar
and not go underneath so let's say you
need to change the size of your object
if you had passed a null and your object
takes up the entire window then what you
should be calling when the user is
trying to change the size of the window
is txon grow window and what this will
do this API changes both the size of the
window and the view rectangle for your
object but if you have passed in the
pointer to a rectangle you would want to
call one of these API so let's say you
have an object that you allow the user
to change the size of and when the size
of the object changes you want the text
to always wrap at the scroll bar in this
case
would call the first API here txon
resize frame passing in the new width
and height of your your object what this
API does is it keeps the destination
rectangle and the view rectangle in sync
so that the text will always wrap at the
scroll bar now let's say you have
another object that when the user
changes its size you don't want to
change the size of the the text the the
destination rectangle on your object
just the view into it in this case you
would call the second API here TX and
set frame bounds in this case you would
be passing in all four boundaries of the
new view rectangle now this API is very
handy if your object takes up the entire
window because what it does is well
actually I'm not I'm not there yet so
what this API will do is it's also
helpful when you want to move the object
around in your window because you are
passing in all four boundaries so we
don't offer an API that allows you to
change just the destination rectangle
but if you find it necessary to change
the dimensions of the destination
rectangle what you can do is call txon
resize frame passing in the new width
and height of the destination rectangle
and what this will do is the side effect
will be that the viewer rectangle will
also change so then you could call after
that txon set frame bounds so that you
can reset the the frame of the view
rectangle back to what you wanted it to
be so we do offer a couple of options
that allow you to change the behavior of
these api and they deal with how the
text will wrap in your objects the first
option here always wrap it view edge if
you go back to the example of your
object where you always want the text
wrap the edge what you could do is pass
in this mask to TX some new object and
you create the object and what this
option will do was it will keep the
destination rectangle always in sync
with the V rectangle regardless of which
of the API you call so what I was going
to say before is if you have a window
that the object takes up the entire
Tiwa no the you're gonna have to call
Jackson grow window and normally this
API only changes the size of the view
rectangle but if this option is set then
the destination rectangle will be kept
in sync with the V rectangle and text
will always wrap in your window so if
you have an object that you allow the
user to edit source code you're going to
want to turn word wrap off so our second
option here allows you to do so what you
would do is you would pass in the word
wrap state tag to the API TX and set TX
and object controls and what that does
is basically sets the the width of the
destination rectangle to be infinite so
text will not wrap unless the user
explicitly enters a character that ends
a line and one example would be
character turn so along with the tag
what you would want to pass in is a
constant that is defined in Mac text
editor dot H telling the object whether
it should be turning word wrap on or off
so we offer several API that lets you
change the size of your objects and that
gives you the flexibility of getting the
exact behavior that you want and you can
have different types of objects
so another task that we've gotten lots
of questions on is how to set the style
of a certain certain range of text in
your object and in order to do that what
you need a call is txon set type
attributes what you would do is you
would fill in an array of txon type
attributes with all of the attributes
that you want to change and then pass
that array into the API along with a
count of the number of attributes are
changing what I want you to note here is
that you can change as many of the
attributes as you want with a single
call to the API just simply by filling
in as many of the elements of the array
that you need now along with the array
and the count you would also be passing
in the start and end offsets for the
text you want updated so in this case
when this text gets executed the current
selection will become read it will have
a font size of 36 and it will become
bold pretty straightforward
filtering text that's another important
thing that we had questions on and so
for instance you may have an ml to e
field that you only want numbers to be
entered into or you want to filter out
characters like the carriage return or
tab character what you would need to do
is install some filters and in this case
four key events entered from the
keyboard
these filters take the form of carbon
event handlers here's an example of one
of them normally what you would do is
you would install this this miss handler
to the particular class the event class
of text input and the event kind of
Unicode for key event so you want to be
doing the test for those values here in
your filter but I put them here so you
can see what their values are this
example here basically just makes sure
that all the the key downs in your
object are numbers if they're not
numbers then they're filtered out so you
do your test if you you you want the
text to be entered into your object then
what you would do is you would return
event not handle they're telling the
carbon event manager that you haven't
handled the event so pass it on to some
other handle that may
in this case that would be ml 2e if you
do want to filter the text out then you
would return no error telling the carbon
event manager that you you've handled
the event with no error and nothing else
needs to happen so this event handler
for Unicode for key event will get
called for every key event that's
entered into the keyboard if there isn't
an input method handling the text if you
do have an active inline area however a
second handler will be called and this
is the update active input area what you
would do here is basically the same
thing but you would need to wait until
the active input area has been confirmed
and there's a piece of information in
the event that you can examine the tail
when this happens when this does happen
then all you need to do is do your test
on all of the text that was just entered
and part of the data for the event is
the range offset so you know exactly
what text to filter and you return the
same values depending on whether you
want to filter that data in the filter
that data out or let it pass in now
normally you want to have two separate
filters you'd have a single one and you
could install it directly to the two
event kinds update active input area and
Unicode for key event I have two filters
here so that I can fit them on a slide
on two slides
okay so entering I data in from the
keyboard is one way to get text into
your object but you can also have drag
events happening so to be able to filter
that data you would need to install your
own drag handlers and it's pretty easy
to do the first thing you need to do is
tell MLT not to install its drag
handlers and then basically you just
install your drag tracking and drag
receive handlers and I'll describe those
two handlers in a second telling ml to
eat nuts to install its drag handlers is
really easy all you do is when you're
creating your object you pass in do not
install drag procs mask to TX a new
object now this method doesn't disable
drag and drop dragging from your object
is still enabled at this point all it
does is it temporarily disables drags to
your object until you've installed your
drag handlers so the first drag handler
you need to install is the direct
tracking procedure and this handler gets
called continuously as you drag as the
user is dragging the data over your
object and mLT's default behavior is
isn't sufficient in most cases so all
you would need to do is pass this event
on to 2m LTE by calling GX and drag
tracker in my example here I'm doing
some eye candy just to show you that if
you need to do something you can but as
I said mLT's default behavior is in most
cases sufficient now the filtering of
the data is done here in your drag
receive procedure and this gets called
once when the user lets go of the mouse
button and has dropped the data into
your object this example here also
filters out anything that isn't a number
so the first thing you need to do is
test the data to see if it's all digits
all numbers if so then you want to pass
the event on to ml to e by calling TX
and drag receiver if you do want to
filter the text out however you pass no
error return no error telling the drag
manager that you've handled the event
with no error and nothing else needs to
happen sorry
so I've given you some help on some of
the tests that we've been getting
questions from from you guys if you have
any more questions and I'm sure you do
please stay for the Q&A session at the
end of this session and let us have it
at this time I'd like to bring exhibit a
back up to go over a quick summary of
what we've been talking about today
[Applause]
all right a quick wrap-up for this
session so once again you don't want
your application to stick out like a
sore thumb by displaying text with
creature text and you want your
customers to be able to enter Unicode
text and use all the power of Atsui and
the quads rendering once again all these
technologies we've been talking about
today
use the power of that suite for doing
the Unicode rendering and use the power
of quad talk to the bleed the text
correctly with the right hand see a
thing
so in order to display text on the Mac
os10
please use VirtualBox api's the theme
text box api's are great
we're still working of course and always
making them better they are like a nice
migration for you to display text static
text correctly if you want to have like
editable text areas you have two
solutions if you want like you know a
quick turnaround and let's say you're
using already you know the alt text edit
control please use the new Unicode edit
text control John talked about how you
can use that it's very straightforward
it could be just a matter of like you
know using the new Pro Qaeda for a
Unicode text control if you need more
controller and as we said if you need
embedded objects if you need support for
like you know sound movies and pictures
in the object if you want to like
control yourself the scroll bars if you
want vertical horizontal if you want
drag and drop please use the MNC ApS
directly I think we show you that you
know the set of API that we're giving
you is very powerful in just a couple of
course you'll be able to achieve a lot
you get not only the support for
multilingual text which would get as
well all these features that have been
missing in text edit as you're saying to
with power plant if you're using power
plant you get all these features very
quickly integrated in your application
which gonna make your life way way
easier I'd like to give you some
information on the where you can get
actual information on or documentation
we just released the MLT documentation
which has been updated tech pubs has
been doing like a fabulous job without
technologies in the last year releasing
more and more information
I'm glad to say that actually we be able
to get the PDF on the web or you can
actually get the bond documentation from
fat brain you have here like you know
but - it's the two places on the web
where you can get them we have a lot of
simple code that uses the multilingual
text I'm China and you'd be able likely
to find the letters simple cannot the
carbon nib SDK we have as well and the
mentee SDK but the carbon leave as DK is
great because we updated every time with
your new release for carbon Lib so
you'll get there like you know the
letters things would get like actually
the application that was written just to
show you the migration between text ly
to Amenti is kind of nice
atsui is the center of text rendering
and that's like you know the foundation
for all your text drawing once again as
John said you need more control and
going out you really need to measure
over text yourself and you need let's
say you're writing your own text engine
then please check out let's we
documentation and here you are which
you'll find it on the report apple.com
so where to go from here we didn't talk
about Kokua text but for a very good
reason which is Kokua text is already
ready for Unicode and support squads as
well if you need more information about
using text where next text view classes
for instance in Cocoa please go to the
session 122 on Thursday which will be
actually in this whole front management
it's a big big big new thing here on Mac
OS 10 with like all these new phones but
we support now I encourage you if you
need to have more information on that to
go to session 128 Thursday at 2:00 in
room C I'll be there we talked about the
Quattroporte and if you need more
information about how do I get you know
my cg contacts on my graph port how can
I manipulate do rotation skewing
rotation and all these new things that
are supported by the quartz rendering
engine
this goes to session 132 graphics and
imaging tips and tricks in room Hey - on
Friday at 9:00 a.m. if you have feedback
and I'm sure you have and you want to
let us know that you know we're on the
right track you love what we're doing or
even if you have questions so you want
to tell us hey I need this API please
come to the International feedback forum
it's a great way for us to measure you
know what we're doing how much like you
know these answers you need and it's a
great way as well to talk to developers
another great way to talk to our
engineers is to come to more of what we
could international lunch where French
food would be served in the cafeteria
actually and we'll have we'll try to get
some balloons and you know we'll have
different themes going on we have like a
table or if you want to talk about the
fault management api's we'll have a
table about text and we'd get you know
cocoa engineers as well there so if you
have you know cocoa and carbon question
on the same table you'll be able to like
you know get your answers we'll have
another table two on localization and
there is a session that is not very but
you'll have a session on localization
and how you can localize your
application for Mac os10 to more
Thursday in room C at 3:30 should you
have any questions you can always
contact me exactly the type elle.com I
work in worldwide developer relations
and that's my job to answer you need and
to make sure that the api's that you
want and the bugs you want to be fixed
are fixed so you can always contact me
it's great I have a lot of developers
already contacted me and have been
working very closely with let probably
some of you here don't hesitate to to
send an email
you