create or replace package odwagrph
is

procedure render_image
( p_irid        in   number  default null
, p_ivid        in   number  default null
, p_session_id  in   number  default null
);


function show_graphic
( p_code             in varchar2
, p_alt_text         in varchar2 default ''
, p_attributes       in varchar2 default ''
, p_include_hotspots in boolean default true
, p_allow_scaling    in boolean default false
, p_link_to_viewer   in boolean default true -- show a link to the Graphics Viewer that allows Scaling/Hotspot Listing
, p_magnitude        in number default 1
, p_width            in number default null
) return varchar2
;

-- this procedure will display an HTML page displaying the indicated ODWA graphic
-- the page will offer Zooming and Hotspot options (when available)
procedure graphic_viewer
( p_session_id   in number
, p_graphic_code in varchar2
, p_magnitude    in number default 1
, p_width        in number default null
);


procedure inflate_Node
( p_node_index    in number
, p_node_level    in number  -- level of node-to-be-inflated (all its children will have p_node_level + 1 or higher)
                             -- node levels in client are number 0..(highest level-1). in server 1..highest level
, p_num_of_nodes           in number
, p_node_value             in varchar2 default null
, p_node_type              in varchar2 default null
, p_entry_point            in number   default null
, p_session_id             in number
, p_root_value             in varchar2
, p_root_classification    in varchar2 default null
);


-- this procedure can be called from the tree from nodes that are clicked
-- this procedure will have to redirect to a procedure
-- that can procedure the appropriate response
procedure node_click
( p_session_id          in number
, p_node_value          in varchar2
, p_node_classification in varchar2
, p_root_value          in varchar2
, p_root_classification in varchar2
);

procedure processPalette
( p_session_id       in number
, p_category_id      in number    default null
, oldGraphicCode     in varchar2
, oldGraphicFilename in varchar2
, oldGraphicRepName  in varchar2
, oldGraphicUrl      in varchar2
, graphicIrid        in number    default null
, graphicIvid        in number    default null
, graphicCode        in varchar2
, graphicType        in varchar2
, graphicDescription in varchar2
, graphicFilename    in varchar2  default null
, graphicUrl         in varchar2  default null
, graphicRepName     in varchar2  default null
, applyGraphic       in varchar2  default null
);


procedure graphicsPalette
( p_session_id    in   number
, p_graphics_code in   varchar2  default null
, p_category_id   in   number    default null
, p_create_new    in   varchar2  default 'N'   -- values Y or N
, graphicIrid        in number    default null
, graphicIvid        in number    default null
, graphicCode        in varchar2  default null
, graphicType        in varchar2  default null
, graphicDescription in varchar2  default null
, graphicFilename    in varchar2  default null
, graphicUrl         in varchar2  default null
, graphicRepName     in varchar2  default null
, p_error_message    in varchar2  default null
);

procedure graphicsCategoryPalette
( p_session_id    in   number
, p_category_id   in   number    default null
, p_create_new    in   varchar2  default 'N'   -- values Y or N
, p_edit          in   varchar2  default 'N'   -- values Y or N
);
procedure processGcatPalette
( p_session_id    in   number
, p_category_id   in   number    default null
, gcatName        in   varchar2
, gcatDescription in   varchar2
) 
;

procedure dataXchange
( p_session_id    in   number
);

procedure graphicsTree
( p_session_id    in   number
);

procedure graphicsLeft
( p_session_id    in   number
);

procedure graphicsCode
( p_session_id    in   number
);

procedure graphicsRight
( p_session_id    in   number
);

procedure topSide
( p_session_id    in   number
);

-- main procedure
-- -------------------------------
-- |              |              |
-- |              |              |
-- |              |              |
-- | graphicsTree | graphics     |
-- |              | Palette      |
-- |              |--------------|
-- |              | dataXchange  |
-- -------------------------------
--                 {graphicsRight}
--
procedure graphics_manager
( p_session_id    in   number default null
);

end; -- odwagrph
/