ivtools-dev 1.2.11a1-2 / usr / include / FrameUnidraw / frameeditor.h

/*
 * Copyright (c) 1994-2000 Vectaport Inc.
 *
 * Permission to use, copy, modify, distribute, and sell this software and
 * its documentation for any purpose is hereby granted without fee, provided
 * that the above copyright notice appear in all copies and that both that
 * copyright notice and this permission notice appear in supporting
 * documentation, and that the names of the copyright holders not be used in
 * advertising or publicity pertaining to distribution of the software
 * without specific, written prior permission.  The copyright holders make
 * no representations about the suitability of this software for any purpose.
 * It is provided "as is" without express or implied warranty.
 *
 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
 * SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
 * IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL,
 * INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
 * FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
 * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
 * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 * 
 */

#ifndef frameeditor_h
#define frameeditor_h

#include <ComUnidraw/comeditor.h>
#include <FrameUnidraw/framekit.h>

#include <Unidraw/iterator.h>

class FrameNumberState;
class FrameListState;
class FrameView;
class TelltaleState;

//: ComEditor specialized for multi-frame use.
class FrameEditor : public ComEditor {
public:
    FrameEditor(OverlayComp*, OverlayKit* = FrameKit::Instance());
    // construct based on pre-existing FrameIdrawComp.
    FrameEditor(const char*, OverlayKit* = FrameKit::Instance());
    // construct from pathname of a flipbook document.
    FrameEditor(boolean initflag, OverlayKit* = FrameKit::Instance());
    // constructor for use of derived classes.
    virtual ~FrameEditor();

    void Init (OverlayComp* = nil, const char* = "FrameEditor");
    virtual void UpdateFrame(boolean txtupdate =true);
    // update state variables and text-editor display for current frame.
    virtual void InitFrame();
    // initialize multi-frame display mechanism.
    virtual void Update();
    // pass to ComEditor.
    virtual void AddCommands(ComTerp*);
    // add interpreter commands to ComTerp associated with this ComEditor.
    virtual void InitCommands();
    // execute Unidraw commands as needed after FrameEditor is constructed.

    void SetFrame(FrameView* f) { _prevframe = _currframe;_currframe = f; }
    // set current frame.
    virtual OverlaysView* GetFrame(int index=-1);
    // return current frame.

    int OtherFrame(){ return _curr_others ? _curr_others[0] : nil; }
    // return index of previous (or secondary) frame.
    void OtherFrame(int other_frame);
    // set index of previous (or secondary) frame.

    int* OtherFrames(){ return _curr_others; }
    // return index of previous (or secondary) frames.
    void OtherFrames(int* other_frames, int num_others);
    // set index of previous (or secondary) frames.

    FrameNumberState*& framenumstate() { return _framenumstate; }
    // return reference to pointer to current-frame-number state variable
    FrameListState*& frameliststate() { return _frameliststate; }
    // return reference to pointer to current-frame-count state variable

    void ToggleAutoNewFrame();
    // toggle flag which indicates a new frame should be automatically
    // created whenever anything is imported.
    boolean AutoNewFrame() { return _autonewframe; }
    // return flag which indicates a new frame should be automatically
    // created whenever anything is imported.
    virtual void DoAutoNewFrame();
    // virtual method which does the work of creating a new frame
    // if flag is set.

    int NumFrames();
    // number of frames not counting background frame

protected:
    FrameView* _currframe;
    FrameView* _prevframe;
    FrameNumberState* _framenumstate;
    FrameListState* _frameliststate;
    int* _curr_others;
    int* _prev_others;
    int _num_curr_others;
    int _num_prev_others;
    boolean _autonewframe;
public:
    TelltaleState* _autonewframe_tts;

friend class FrameKit;
};

declareActionCallback(FrameEditor)

#endif