GNU Octave  4.0.0
A high-level interpreted language, primarily intended for numerical computations, mostly compatible with Matlab
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Pages
Public Member Functions | Private Attributes | List of all members
graphics_object Class Reference

#include "graphics.h"

Collaboration diagram for graphics_object:
Collaboration graph
[legend]

Public Member Functions

 graphics_object (void)
 
 graphics_object (base_graphics_object *new_rep)
 
 graphics_object (const graphics_object &obj)
 
 graphics_object (void)
 
 graphics_object (base_graphics_object *new_rep)
 
 graphics_object (const graphics_object &obj)
 
 ~graphics_object (void)
 
 ~graphics_object (void)
 
void add_property_listener (const std::string &nm, const octave_value &v, listener_mode mode=POSTSET)
 
void add_property_listener (const std::string &nm, const octave_value &v, listener_mode mode=POSTSET)
 
void adopt (const graphics_handle &h)
 
void adopt (const graphics_handle &h)
 
void build_user_defaults_map (property_list::pval_map_type &def, const std::string go_name) const
 
void build_user_defaults_map (property_list::pval_map_type &def, const std::string go_name) const
 
void defaults (void) const
 
void defaults (void) const
 
void delete_property_listener (const std::string &nm, const octave_value &v, listener_mode mode=POSTSET)
 
void delete_property_listener (const std::string &nm, const octave_value &v, listener_mode mode=POSTSET)
 
void finalize (void)
 
void finalize (void)
 
octave_value get (bool all=false) const
 
octave_value get (const caseless_str &name) const
 
octave_value get (const std::string &name) const
 
octave_value get (const char *name) const
 
octave_value get (bool all=false) const
 
octave_value get (const caseless_str &name) const
 
octave_value get (const std::string &name) const
 
octave_value get (const char *name) const
 
octave_value get_alim (void) const
 
octave_value get_alim (void) const
 
graphics_object get_ancestor (const std::string &type) const
 
graphics_object get_ancestor (const std::string &type) const
 
octave_value get_clim (void) const
 
octave_value get_clim (void) const
 
octave_value get_default (const caseless_str &name) const
 
octave_value get_default (const caseless_str &name) const
 
octave_value get_defaults (void) const
 
octave_value get_defaults (void) const
 
property_list get_defaults_list (void) const
 
property_list get_defaults_list (void) const
 
octave_value get_factory_default (const caseless_str &name) const
 
octave_value get_factory_default (const caseless_str &name) const
 
octave_value get_factory_defaults (void) const
 
octave_value get_factory_defaults (void) const
 
property_list get_factory_defaults_list (void) const
 
property_list get_factory_defaults_list (void) const
 
graphics_handle get_handle (void) const
 
graphics_handle get_handle (void) const
 
graphics_handle get_parent (void) const
 
graphics_handle get_parent (void) const
 
base_propertiesget_properties (void)
 
const base_propertiesget_properties (void) const
 
base_propertiesget_properties (void)
 
const base_propertiesget_properties (void) const
 
graphics_toolkit get_toolkit (void) const
 
graphics_toolkit get_toolkit (void) const
 
octave_value get_xlim (void) const
 
octave_value get_xlim (void) const
 
octave_value get_ylim (void) const
 
octave_value get_ylim (void) const
 
octave_value get_zlim (void) const
 
octave_value get_zlim (void) const
 
bool has_readonly_property (const caseless_str &pname) const
 
bool has_readonly_property (const caseless_str &pname) const
 
void initialize (void)
 
void initialize (void)
 
bool is_aliminclude (void) const
 
bool is_aliminclude (void) const
 
bool is_climinclude (void) const
 
bool is_climinclude (void) const
 
bool is_handle_visible (void) const
 
bool is_handle_visible (void) const
 
bool is_xliminclude (void) const
 
bool is_xliminclude (void) const
 
bool is_yliminclude (void) const
 
bool is_yliminclude (void) const
 
bool is_zliminclude (void) const
 
bool is_zliminclude (void) const
 
bool isa (const std::string &go_name) const
 
bool isa (const std::string &go_name) const
 
void mark_modified (void)
 
void mark_modified (void)
 
 operator bool (void) const
 
 operator bool (void) const
 
graphics_objectoperator= (const graphics_object &obj)
 
graphics_objectoperator= (const graphics_object &obj)
 
void override_defaults (base_graphics_object &obj)
 
void override_defaults (void)
 
void override_defaults (base_graphics_object &obj)
 
void override_defaults (void)
 
void remove_child (const graphics_handle &h)
 
void remove_child (const graphics_handle &h)
 
void reparent (const graphics_handle &h)
 
void reparent (const graphics_handle &h)
 
void reset_default_properties (void)
 
void reset_default_properties (void)
 
void set (const caseless_str &name, const octave_value &val)
 
void set (const octave_value_list &args)
 
void set (const Array< std::string > &names, const Cell &values, octave_idx_type row)
 
void set (const octave_map &m)
 
void set (const caseless_str &name, const octave_value &val)
 
void set (const octave_value_list &args)
 
void set (const Array< std::string > &names, const Cell &values, octave_idx_type row)
 
void set (const octave_map &m)
 
void set_defaults (const std::string &mode)
 
void set_defaults (const std::string &mode)
 
void set_from_list (property_list &plist)
 
void set_from_list (property_list &plist)
 
void set_value_or_default (const caseless_str &name, const octave_value &val)
 
void set_value_or_default (const caseless_str &name, const octave_value &val)
 
std::string type (void) const
 
std::string type (void) const
 
void update (int id)
 
void update (int id)
 
void update_axis_limits (const std::string &axis_type)
 
void update_axis_limits (const std::string &axis_type, const graphics_handle &h)
 
void update_axis_limits (const std::string &axis_type)
 
void update_axis_limits (const std::string &axis_type, const graphics_handle &h)
 
bool valid_object (void) const
 
bool valid_object (void) const
 
std::string value_as_string (const std::string &prop)
 
std::string value_as_string (const std::string &prop)
 
std::string values_as_string (void)
 
std::string values_as_string (void)
 
octave_map values_as_struct (void)
 
octave_map values_as_struct (void)
 

Private Attributes

base_graphics_objectrep
 

Detailed Description

Definition at line 3230 of file graphics.h.

Constructor & Destructor Documentation

graphics_object::graphics_object ( void  )
inline

Definition at line 3233 of file graphics.h.

graphics_object::graphics_object ( base_graphics_object new_rep)
inline

Definition at line 3235 of file graphics.h.

graphics_object::graphics_object ( const graphics_object obj)
inline

Definition at line 3238 of file graphics.h.

graphics_object::~graphics_object ( void  )
inline

Definition at line 3257 of file graphics.h.

graphics_object::graphics_object ( void  )
inline

Definition at line 2975 of file graphics.in.h.

graphics_object::graphics_object ( base_graphics_object new_rep)
inline

Definition at line 2977 of file graphics.in.h.

graphics_object::graphics_object ( const graphics_object obj)
inline

Definition at line 2980 of file graphics.in.h.

graphics_object::~graphics_object ( void  )
inline

Definition at line 2999 of file graphics.in.h.

Member Function Documentation

void graphics_object::add_property_listener ( const std::string &  nm,
const octave_value v,
listener_mode  mode = POSTSET 
)
inline

Definition at line 3183 of file graphics.in.h.

void graphics_object::add_property_listener ( const std::string &  nm,
const octave_value v,
listener_mode  mode = POSTSET 
)
inline

Definition at line 3441 of file graphics.h.

Referenced by Faddlistener(), and Fwaitfor().

void graphics_object::adopt ( const graphics_handle h)
inline

Definition at line 3111 of file graphics.in.h.

void graphics_object::adopt ( const graphics_handle h)
inline

Definition at line 3369 of file graphics.h.

Referenced by adopt().

void graphics_object::build_user_defaults_map ( property_list::pval_map_type def,
const std::string  go_name 
) const
inline

Definition at line 3017 of file graphics.in.h.

void graphics_object::build_user_defaults_map ( property_list::pval_map_type def,
const std::string  go_name 
) const
inline
void graphics_object::defaults ( void  ) const
inline

Definition at line 3115 of file graphics.in.h.

void graphics_object::defaults ( void  ) const
inline

Definition at line 3373 of file graphics.h.

void graphics_object::delete_property_listener ( const std::string &  nm,
const octave_value v,
listener_mode  mode = POSTSET 
)
inline

Definition at line 3187 of file graphics.in.h.

void graphics_object::delete_property_listener ( const std::string &  nm,
const octave_value v,
listener_mode  mode = POSTSET 
)
inline

Definition at line 3445 of file graphics.h.

Referenced by Fdellistener().

void graphics_object::finalize ( void  )
inline

Definition at line 3193 of file graphics.in.h.

void graphics_object::finalize ( void  )
inline

Definition at line 3451 of file graphics.h.

Referenced by finalize_r().

octave_value graphics_object::get ( bool  all = false) const
inline

Definition at line 3042 of file graphics.in.h.

octave_value graphics_object::get ( const caseless_str name) const
inline

Definition at line 3044 of file graphics.in.h.

octave_value graphics_object::get ( const std::string &  name) const
inline

Definition at line 3052 of file graphics.in.h.

octave_value graphics_object::get ( const char name) const
inline

Definition at line 3057 of file graphics.in.h.

octave_value graphics_object::get ( bool  all = false) const
inline
octave_value graphics_object::get ( const caseless_str name) const
inline

Definition at line 3302 of file graphics.h.

octave_value graphics_object::get ( const std::string &  name) const
inline

Definition at line 3310 of file graphics.h.

octave_value graphics_object::get ( const char name) const
inline

Definition at line 3315 of file graphics.h.

octave_value graphics_object::get_alim ( void  ) const
inline

Definition at line 3148 of file graphics.in.h.

octave_value graphics_object::get_alim ( void  ) const
inline

Definition at line 3406 of file graphics.h.

Referenced by get_children_limits().

graphics_object graphics_object::get_ancestor ( const std::string &  type) const
graphics_object graphics_object::get_ancestor ( const std::string &  type) const
octave_value graphics_object::get_clim ( void  ) const
inline

Definition at line 3151 of file graphics.in.h.

octave_value graphics_object::get_clim ( void  ) const
inline

Definition at line 3409 of file graphics.h.

Referenced by get_children_limits().

octave_value graphics_object::get_default ( const caseless_str name) const
inline

Definition at line 3062 of file graphics.in.h.

octave_value graphics_object::get_default ( const caseless_str name) const
inline
octave_value graphics_object::get_defaults ( void  ) const
inline

Definition at line 3072 of file graphics.in.h.

octave_value graphics_object::get_defaults ( void  ) const
inline

Definition at line 3330 of file graphics.h.

property_list graphics_object::get_defaults_list ( void  ) const
inline

Definition at line 3074 of file graphics.in.h.

property_list graphics_object::get_defaults_list ( void  ) const
inline

Definition at line 3332 of file graphics.h.

octave_value graphics_object::get_factory_default ( const caseless_str name) const
inline

Definition at line 3067 of file graphics.in.h.

octave_value graphics_object::get_factory_default ( const caseless_str name) const
inline

Definition at line 3325 of file graphics.h.

Referenced by base_graphics_object::get_factory_default().

octave_value graphics_object::get_factory_defaults ( void  ) const
inline

Definition at line 3079 of file graphics.in.h.

octave_value graphics_object::get_factory_defaults ( void  ) const
inline

Definition at line 3337 of file graphics.h.

property_list graphics_object::get_factory_defaults_list ( void  ) const
inline

Definition at line 3084 of file graphics.in.h.

property_list graphics_object::get_factory_defaults_list ( void  ) const
inline

Definition at line 3342 of file graphics.h.

Referenced by base_graphics_object::reset_default_properties().

graphics_handle graphics_object::get_handle ( void  ) const
inline

Definition at line 3105 of file graphics.in.h.

graphics_handle graphics_object::get_handle ( void  ) const
inline
graphics_handle graphics_object::get_parent ( void  ) const
inline

Definition at line 3103 of file graphics.in.h.

graphics_handle graphics_object::get_parent ( void  ) const
inline
base_properties& graphics_object::get_properties ( void  )
inline

Definition at line 3119 of file graphics.in.h.

const base_properties& graphics_object::get_properties ( void  ) const
inline

Definition at line 3121 of file graphics.in.h.

base_properties& graphics_object::get_properties ( void  )
inline

Definition at line 3377 of file graphics.h.

Referenced by base_graphics_object::add_property_listener(), base_graphics_object::adopt(), calc_dimensions(), axes::properties::calc_tightbox(), QtHandles::Canvas::canvasMousePressEvent(), QtHandles::Canvas::canvasWheelEvent(), property::create(), QtHandles::ObjectFactory::createObject(), delete_graphics_object(), base_graphics_object::delete_property_listener(), do_cleanup_waitfor_listener(), children_property::do_get_children(), gh_manager::do_make_graphics_handle(), gh_manager::do_post_callback(), gh_manager::do_process_events(), set_event::execute(), F__go_figure__(), F__image_pixel_size__(), F__zoom__(), Faddproperty(), Fdrawnow(), QtHandles::Backend::finalize(), gnuplot_graphics_toolkit::finalize(), finalize_r(), Fwaitfor(), G__osmesa_print__(), base_graphics_object::get(), axes::properties::get_boundingbox(), uicontrol::properties::get_boundingbox(), uipanel::properties::get_boundingbox(), axes::properties::get_extent(), uicontrol::properties::get_extent(), base_graphics_object::get_handle(), base_graphics_object::get_parent(), base_graphics_object::get_toolkit(), QtHandles::Backend::initialize(), initialize_r(), base_graphics_object::mark_modified(), base_graphics_object::override_defaults(), QtHandles::Backend::print_figure(), QtHandles::Object::properties(), QtHandles::Utils::properties(), QtHandles::Backend::redraw_figure(), base_graphics_object::remove_child(), base_graphics_object::reparent(), opengl_selector::select(), base_graphics_object::set(), base_graphics_object::set_from_list(), figure::properties::set_integerhandle(), base_properties::set_parent(), base_graphics_object::type(), gnuplot_graphics_toolkit::update(), base_properties::update_autopos(), base_properties::update_boundingbox(), axes::properties::update_title_position(), base_properties::update_uicontextmenu(), axes::properties::update_units(), uicontrol::properties::update_units(), uipanel::properties::update_units(), axes::properties::update_xlabel_position(), axes::properties::update_ylabel_position(), axes::properties::update_zlabel_position(), QtHandles::Canvas::updateCurrentPoint(), xcreatefcn(), xreset_default_properties(), and xset_gcbo().

const base_properties& graphics_object::get_properties ( void  ) const
inline

Definition at line 3379 of file graphics.h.

graphics_toolkit graphics_object::get_toolkit ( void  ) const
inline

Definition at line 3181 of file graphics.in.h.

graphics_toolkit graphics_object::get_toolkit ( void  ) const
inline
octave_value graphics_object::get_xlim ( void  ) const
inline

Definition at line 3154 of file graphics.in.h.

octave_value graphics_object::get_xlim ( void  ) const
inline

Definition at line 3412 of file graphics.h.

Referenced by get_children_limits().

octave_value graphics_object::get_ylim ( void  ) const
inline

Definition at line 3157 of file graphics.in.h.

octave_value graphics_object::get_ylim ( void  ) const
inline

Definition at line 3415 of file graphics.h.

Referenced by get_children_limits().

octave_value graphics_object::get_zlim ( void  ) const
inline

Definition at line 3160 of file graphics.in.h.

octave_value graphics_object::get_zlim ( void  ) const
inline

Definition at line 3418 of file graphics.h.

Referenced by get_children_limits().

bool graphics_object::has_readonly_property ( const caseless_str pname) const
inline

Definition at line 3089 of file graphics.in.h.

bool graphics_object::has_readonly_property ( const caseless_str pname) const
inline
void graphics_object::initialize ( void  )
inline

Definition at line 3191 of file graphics.in.h.

void graphics_object::initialize ( void  )
inline
bool graphics_object::is_aliminclude ( void  ) const
inline

Definition at line 3163 of file graphics.in.h.

bool graphics_object::is_aliminclude ( void  ) const
inline

Definition at line 3421 of file graphics.h.

Referenced by get_children_limits().

bool graphics_object::is_climinclude ( void  ) const
inline

Definition at line 3166 of file graphics.in.h.

bool graphics_object::is_climinclude ( void  ) const
inline

Definition at line 3424 of file graphics.h.

Referenced by get_children_limits().

bool graphics_object::is_handle_visible ( void  ) const
inline

Definition at line 3178 of file graphics.in.h.

bool graphics_object::is_handle_visible ( void  ) const
inline

Definition at line 3436 of file graphics.h.

Referenced by gh_manager::is_handle_visible().

bool graphics_object::is_xliminclude ( void  ) const
inline

Definition at line 3169 of file graphics.in.h.

bool graphics_object::is_xliminclude ( void  ) const
inline

Definition at line 3427 of file graphics.h.

Referenced by get_children_limits().

bool graphics_object::is_yliminclude ( void  ) const
inline

Definition at line 3172 of file graphics.in.h.

bool graphics_object::is_yliminclude ( void  ) const
inline

Definition at line 3430 of file graphics.h.

Referenced by get_children_limits().

bool graphics_object::is_zliminclude ( void  ) const
inline

Definition at line 3175 of file graphics.in.h.

bool graphics_object::is_zliminclude ( void  ) const
inline

Definition at line 3433 of file graphics.h.

Referenced by get_children_limits().

bool graphics_object::isa ( const std::string &  go_name) const
inline

Definition at line 3117 of file graphics.in.h.

bool graphics_object::isa ( const std::string &  go_name) const
inline
void graphics_object::mark_modified ( void  )
inline

Definition at line 3005 of file graphics.in.h.

void graphics_object::mark_modified ( void  )
inline

Definition at line 3263 of file graphics.h.

Referenced by base_properties::mark_modified().

graphics_object::operator bool ( void  ) const
inline

Definition at line 3141 of file graphics.in.h.

graphics_object::operator bool ( void  ) const
inline

Definition at line 3399 of file graphics.h.

graphics_object& graphics_object::operator= ( const graphics_object obj)
inline

Definition at line 2985 of file graphics.in.h.

graphics_object& graphics_object::operator= ( const graphics_object obj)
inline

Definition at line 3243 of file graphics.h.

References base_graphics_object::count, and rep.

void graphics_object::override_defaults ( base_graphics_object obj)
inline

Definition at line 3007 of file graphics.in.h.

void graphics_object::override_defaults ( void  )
inline

Definition at line 3012 of file graphics.in.h.

void graphics_object::override_defaults ( base_graphics_object obj)
inline
void graphics_object::override_defaults ( void  )
inline

Definition at line 3270 of file graphics.h.

void graphics_object::remove_child ( const graphics_handle h)
inline

Definition at line 3109 of file graphics.in.h.

void graphics_object::remove_child ( const graphics_handle h)
inline

Definition at line 3367 of file graphics.h.

Referenced by delete_graphics_object(), reparent(), and base_properties::set_parent().

void graphics_object::reparent ( const graphics_handle h)
inline

Definition at line 3113 of file graphics.in.h.

void graphics_object::reparent ( const graphics_handle h)
inline

Definition at line 3371 of file graphics.h.

Referenced by reparent().

void graphics_object::reset_default_properties ( void  )
inline

Definition at line 3197 of file graphics.in.h.

void graphics_object::reset_default_properties ( void  )
inline

Definition at line 3455 of file graphics.h.

Referenced by axes::properties::set_defaults().

void graphics_object::set ( const caseless_str name,
const octave_value val 
)
inline

Definition at line 3025 of file graphics.in.h.

void graphics_object::set ( const octave_value_list args)
void graphics_object::set ( const Array< std::string > &  names,
const Cell values,
octave_idx_type  row 
)
void graphics_object::set ( const octave_map m)
void graphics_object::set ( const caseless_str name,
const octave_value val 
)
inline
void graphics_object::set ( const octave_value_list args)

Definition at line 2140 of file graphics.cc.

References error(), error_state, and octave_value_list::length().

void graphics_object::set ( const Array< std::string > &  names,
const Cell values,
octave_idx_type  row 
)

Definition at line 2184 of file graphics.cc.

References Array< T >::columns(), error(), error_state, names(), and Array< T >::numel().

void graphics_object::set ( const octave_map m)
void graphics_object::set_defaults ( const std::string &  mode)
inline

Definition at line 3040 of file graphics.in.h.

void graphics_object::set_defaults ( const std::string &  mode)
inline

Definition at line 3298 of file graphics.h.

Referenced by F__go_axes_init__().

void graphics_object::set_from_list ( property_list plist)
inline

Definition at line 3023 of file graphics.in.h.

void graphics_object::set_from_list ( property_list plist)
inline

Definition at line 3281 of file graphics.h.

void graphics_object::set_value_or_default ( const caseless_str name,
const octave_value val 
)
void graphics_object::set_value_or_default ( const caseless_str name,
const octave_value val 
)
std::string graphics_object::type ( void  ) const
inline

Definition at line 3139 of file graphics.in.h.

std::string graphics_object::type ( void  ) const
inline
void graphics_object::update ( int  id)
inline

Definition at line 3195 of file graphics.in.h.

void graphics_object::update ( int  id)
inline

Definition at line 3453 of file graphics.h.

Referenced by base_property::set(), and figure::properties::set_integerhandle().

void graphics_object::update_axis_limits ( const std::string &  axis_type)
inline

Definition at line 3126 of file graphics.in.h.

void graphics_object::update_axis_limits ( const std::string &  axis_type,
const graphics_handle h 
)
inline

Definition at line 3131 of file graphics.in.h.

void graphics_object::update_axis_limits ( const std::string &  axis_type)
inline
void graphics_object::update_axis_limits ( const std::string &  axis_type,
const graphics_handle h 
)
inline

Definition at line 3389 of file graphics.h.

bool graphics_object::valid_object ( void  ) const
inline

Definition at line 3137 of file graphics.in.h.

bool graphics_object::valid_object ( void  ) const
inline

Definition at line 3395 of file graphics.h.

Referenced by base_graphics_object::add_property_listener(), base_graphics_object::adopt(), calc_dimensions(), QtHandles::Canvas::canvasAutoAxes(), QtHandles::Canvas::canvasKeyPressEvent(), QtHandles::Canvas::canvasMouseMoveEvent(), QtHandles::Canvas::canvasMousePressEvent(), QtHandles::Canvas::canvasMouseReleaseEvent(), QtHandles::Canvas::canvasToggleAxes(), QtHandles::Canvas::canvasToggleGrid(), QtHandles::Canvas::canvasWheelEvent(), convert_cdata(), property::create(), QtHandles::ObjectFactory::createObject(), base_graphics_object::defaults(), delete_graphics_object(), base_graphics_object::delete_property_listener(), axes::properties::delete_text_child(), children_property::do_delete_children(), gh_manager::do_post_callback(), QtHandles::Panel::eventFilter(), gh_manager::execute_callback(), QtHandles::ContextMenu::executeAt(), base_graphics_object::get(), axes::properties::get_boundingbox(), uicontrol::properties::get_boundingbox(), base_graphics_object::get_defaults_list(), base_graphics_object::get_handle(), base_graphics_object::get_parent(), base_graphics_object::get_toolkit(), gh_manager::is_handle_visible(), base_graphics_object::mark_modified(), base_graphics_object::override_defaults(), QtHandles::Canvas::print(), base_graphics_object::remove_child(), base_graphics_object::reparent(), base_graphics_object::set(), base_graphics_object::set_from_list(), base_graphics_object::type(), base_properties::update_autopos(), base_properties::update_boundingbox(), axes::properties::update_title_position(), axes::properties::update_xlabel_position(), axes::properties::update_ylabel_position(), axes::properties::update_zlabel_position(), QtHandles::Figure::updateBoundingBoxHelper(), QtHandles::Figure::updateMenuBar(), QtHandles::SliderControl::valueChanged(), and uicontextmenu::~uicontextmenu().

std::string graphics_object::value_as_string ( const std::string &  prop)
inline

Definition at line 3096 of file graphics.in.h.

std::string graphics_object::value_as_string ( const std::string &  prop)
inline

Definition at line 3354 of file graphics.h.

Referenced by Fset().

std::string graphics_object::values_as_string ( void  )
inline

Definition at line 3094 of file graphics.in.h.

std::string graphics_object::values_as_string ( void  )
inline

Definition at line 3352 of file graphics.h.

Referenced by Fset().

octave_map graphics_object::values_as_struct ( void  )
inline

Definition at line 3101 of file graphics.in.h.

octave_map graphics_object::values_as_struct ( void  )
inline

Definition at line 3359 of file graphics.h.

Referenced by Fset().

Member Data Documentation

base_graphics_object * graphics_object::rep
private

Definition at line 3459 of file graphics.h.

Referenced by operator=().


The documentation for this class was generated from the following files: