Todo List

Member nom::audio::SoundBuffer::stream_source

Consider using the AudioSourceType enumeration instead

Member nom::BMFont::parse_string (const std::string &key, std::string &value)

Parsing string sequences with spaces

Struct nom::Color4< T >

Implement specialized Color4<float> operators

Explicitly initialize alpha component of static colors to 255.

Member nom::Color4< T >::Transparent

Consider using Color4::Transparent instead of Color4::null.

Rename constants to ALL UPPERCASE.

Member nom::ConsoleOutput::FG_PURPLE

Implement in WindowsConsoleOutput

Member nom::ConsoleOutput::FG_RED

Implement in UnixConsoleOutput

Member nom::ConsoleOutput::use_color () const

The environment variable's value is case-sensitive.

Provide 'auto' option for NOM_COLOR; this could be tested on Unix platforms with the value of TERM equaling xterm-color or such; see also: gtest.cc.

Class nom::Cursor

Implement interfacing for SDL_CreateCursor and SDL_CreateSystemCursor.

Member nom::Cursor::show_cursor (bool state)

Error handling?

Class nom::Decorator

Implement interface for calculating and providing border dimensions so that our widget(s) are able to better account for their own size requirements.

Class nom::DecoratorPhotograph

Rename class

Member nom::DecoratorPhotograph::image_

Rename

Member nom::DispatchQueue::update (uint32 player_state, real32 delta_time)

Pausing the action does not always take effect for every nom::MoveByAction in the group within ActionTest.RainingRectsStressTest – some actions are sometimes skipped for some mysterious reason!

Class nom::File

Declare methods static

Class nom::FinalFantasyFrame

Relocate to graphics folder?

Member nom::Font::load (const std::string &filename)

Rename to load_file

Member nom::GameController::load_mapping_file (const std::string &filename)

This function call leaks memory from within SDL!

Member nom::GameController::load_mapping_memory (const char *buffer, int buffer_size)

Implement this function

Member nom::Gradient::FillDirection

Rename me – Direction seems fitting? Jeffrey Carpenter i8deg.nosp@m.rees.nosp@m.@gmai.nosp@m.l.co.nosp@m.m @ 2013-10-05

Member nom::Gradient::gradient_

Finish implementing vectorized color container support; we only use the first and last color of whatever is set in the container at the moment.

Member nom::IDrawable::RenderTarget

Remove or relocate this definition to resolve coupling issue?

Member nom::IDrawable::update (void)=0

Not all the interfaced (inherited) IDrawable objects in this library conform to the expectations stated above. We need to first figure out if we wish to stay on this course (of expectation), or diverge all together. Undecided. Jeffrey Carpenter i8deg.nosp@m.rees.nosp@m.@gmai.nosp@m.l.co.nosp@m.m @ 2013-10-03

Member nom::IFont::load (const std::string &filename)=0

Rename to load_file.

Member nom::IFont::set_hinting (int)=0

Rename to set_font_hinting..?

Member nom::IFont::set_outline (int)=0

Rename to set_font_outline..?

Member nom::Image::draw (SDL_Surface *destination, const IntRect &bounds) const

This method needs to mimic nom::Texture::draw

Member nom::Image::locked (void) const

Verify if the SDL_MUSTLOCK macro does the same thing here

Member nom::Image::pixel (int x, int y) const

Test 8-bit, 15/16-bit & 24-bit pixel blits

Member nom::Image::set_pixel (int x, int y, const Color4i &color)

Test 8-bit, 15/16-bit & 24-bit pixel blits

Member nom::IState::on_draw (RenderWindow &)

Consider removing RenderTarget argument; I think we can get away with this.

Member nom::JsonConfigFile::save (void)

Do not output JSON when the object size of a nom::Value is zero.

Class nom::JsonCppDeserializer

Additional error handling via Json::Reader::getFormattedErrorMessage

Member nom::JsonCppDeserializer::read_array (const Json::Value &object, Value &dest) const

Err handling where used in code

Member nom::JsonCppDeserializer::read_object (const Json::Value &object, Value &dest) const

Err handling where used in code

Member nom::JsonCppDeserializer::read_value (const Json::Value &object, Value &dest) const

Err handling where used in code

Member nom::JsonCppSerializer::write_array (const Value &object, Json::Value &dest) const

Err handling where used in code

Member nom::JsonCppSerializer::write_array_value (const Value &object, Json::Value &dest) const

Err handling where used in code

Member nom::JsonCppSerializer::write_object (const Value &object, Json::Value &dest) const

Err handling where used in code

Member nom::JsonCppSerializer::write_value (const Value &object, Json::Value &dest) const

Err handling where used in code

Class nom::Line

Use SDL2's new multi-line API; see SDL_RenderDrawLines.

Member nom::Line::update () override

Measure performance (CPU cycles, ticks/FPS, ...) difference with using a return / abort on rendering when our line object is up-to-date and determine if it is worth the implementation VS risk of inconsistency. Jeffrey Carpenter i8deg.nosp@m.rees.nosp@m.@gmai.nosp@m.l.co.nosp@m.m @ 2013-10-03

Struct nom::MouseButtonAction

Implement nom::MouseButtonEvent's id field (to differentiate between events generated by a touch input device and those generated by a real mouse device).

Member nom::Path::prepend (const std::string &path) const

Rename to append.

Class nom::Point

Use SDL2's new multi-point API; see SDL_RenderDrawPoints.

Class nom::RapidXmlDeserializer

Implement XML comments

Finish implementation of ::serialize_object & related case handling, err handling

Class nom::RapidXmlSerializer

Implement XML comments

Finish implementation of ::serialize_object & related case handling, err handling.

Implement feature

Member nom::Rect< T >::serialize (void) const

Return an Array instead of object?

Rename member key 'width' to 'w'

Rename member key 'h' to 'h'

Class nom::Rectangle

Use SDL2's new multi-rectangle API; see SDL_RenderFillRects.

Member nom::Renderer::pixels () const

Pixels pitch calculation

Member nom::Renderer::scale () const

Rename to logical_scale.

Member nom::Renderer::set_scale (const Point2f &scale_factor)

Rename to set_logical_scale.

Member nom::Renderer::set_viewport (const IntRect &bounds)

Test me!

Member nom::RenderWindow::disable_screensaver (void)

Test me

Member nom::RenderWindow::display_bounds (void) const

Test me

Member nom::RenderWindow::enable_screensaver (void)

Test me

Member nom::RenderWindow::hide_window (void)

Test me

Member nom::RenderWindow::maximize_window (void)

Test me

Member nom::RenderWindow::minimize_window (void)

Test me

Member nom::RenderWindow::raise_window (void)

Test me

Member nom::RenderWindow::restore_window (void)

Test me

Member nom::RenderWindow::save_png_file (const std::string &filename) const

Restructure code shared with ::save_screenshot.

Member nom::RenderWindow::save_screenshot (const std::string &filename) const

Pixels pitch calculation (see screenshot.initialize call)

Member nom::RenderWindow::screen_saver (void)

Test me

Member nom::RenderWindow::set_maximum_window_size (int max_width, int max_height)

Test me

Member nom::RenderWindow::set_minimum_window_size (int min_width, int min_height)

Test me

Member nom::RenderWindow::set_window_grab (bool grab)

Test me

Member nom::RenderWindow::show_window (void)

Test me

Member nom::RenderWindow::window_id (uint32 id)

Is there a reason why this is a static method???

Rename to window_from_id?

Member nom::ResourceFile::loaded_

No idea why I have to declare this mutable and access it directly, but ::ResourceCache::load_resource refuses to compile otherwise, complaining about const issues with ::set_loaded.

Class nom::RocketSDL2RenderInterface

Add support for OpenGLES and OpenGLES2 (mobile platforms).

Member nom::RocketSDL2RenderInterface::SetScissorRegion (int x, int y, int width, int height)

The clipping calculations are slightly off for the y / height dimensions. This bug can often be seen with use of libRocket's scrollbar feature (i.e.: visual debugger's element info window).

Member nom::RocketSDL2SystemInterface::LogMessage (Rocket::Core::Log::Type type, const Rocket::Core::String &message)

Take a look at libRocket.git/Samples/basic/customlog/src/main.cpp

Namespace nom::SDL_PIXELFORMAT

Remove or perhaps better yet, refer to as a light-weight handle..?

Namespace nom::SDL_SURFACE

Remove or perhaps better yet, refer to as a light-weight handle, i.e.: nom::SurfaceHandle?

Namespace nom::SDL_TEXTURE

Remove or perhaps better yet, refer to as a light-weight handle, i.e.: nom::TextureHandle?

Namespace nom::SDL_WINDOW

Remove or perhaps better yet, refer to as a light-weight handle, i.e.: nom::WindowHandle?

Member nom::SDLApp::on_draw (RenderWindow &)

Consider removing RenderTarget argument; I think we can get away with this!

Member nom::SDLApp::Run (void)

Rename to exec..?

Class nom::SearchPath

Add an interface for using this class without a file.

Member nom::SpriteBatch::SpriteBatch ()

Consider initializing sheet_id_ to -1..?

Member nom::SpriteSheet::load_file (const std::string &filename)

Rename to load_sheet_file?

Member nom::Text::draw (RenderTarget &target) const override

Test horizontal tabbing '\t'

Member nom::Text::Style

Implement styles for BitmapFont objects.

Member nom::Texture::draw (SDL_Renderer *target, const real64 angle) const

Implement pivot point & make use of SDL_RendererFlip enum

Member nom::Texture::load (const std::string &filename, bool use_cache=false, enum Texture::Access type=Access::Static)

Test/Research Texture caching – nom::ObjectCache worked beautifully with SDL_Surface, is the same true of SDL_Texture?

merge 'use_cache' in with 'flags'

Member nom::Texture::pixel (int x, int y)

Test 8-bit, 15/16-bit & 24-bit pixel blits

Member nom::Texture::resize (enum ResizeAlgorithm scaling_algorithm)

Improve err handling of this method when ScaleX & HQX algorithms are not built. (Perhaps log a message warning the user that since the algorithms are not built in, that SDL2's bilinear rescaling will be used instead???)

Member nom::Texture::set_colorkey (const Color4i &colorkey)

ERR check on locking call, etc.

Member nom::Texture::size () const

We need to decide if we ought to return the dimensions as per what SDL has on record, or if we should use cached values.

Member nom::Texture::Texture (void)

position_ should be initialized to Point2i::null.

bounds_ should be initialized to IntRect::null.

colorkey_ should be initialized to Color4i::null.

Member nom::Transformable::set_position (int x, int y)

Remove this method; it causes trouble in paradise when we need to overload the virtual set_position method – we unsuspectingly go through the wrong interface.

Member nom::Transformable::set_size (int w, int h)

Remove this method; it causes trouble in paradise when we need to overload the virtual set_position method – we unsuspectingly go through the wrong interface.

Member nom::TrueTypeFont::set_hinting (int type) override

This feature is broken.

Class nom::UIContext

Consider inheriting off nom::IDrawable?

Member nom::UIContext::initialize_debugger ()

Handle positioning of the event log window in regards to independent scale.

Class nom::UIMessageBox

Check for valid element IDs

Member nom::UIMessageBox::message_bounds () const

Rename to message_text_bounds

Member nom::UIMessageBox::set_message_alignment (uint32 align)

This method is currently broken; although the text-align property is, in fact, being updated (as per visual debugger output), we are still getting the original text-align value. Something to do with the internal (libRocket) caching perhaps...

Member nom::UIMessageBox::set_title_alignment (uint32 align)

This method is currently broken; although the text-align property is, in fact, being updated (as per visual debugger output), we are still getting the original text-align value. Something to do with the internal (libRocket) caching perhaps...

Member nom::UIMessageBox::title_bounds () const

Rename to title_text_bounds

Member nom::UIWidget::set_text_alignment (rocket::Element *element, uint32 alignment)

Change return type to boolean

Member nom::UnixFile::mkdir (const std::string &path)

Look into possibly revising our err handling; providing the actual reason for failure is helpful in determining the course of action to take in the application's program flow?

Member nom::UnixFile::path (const std::string &dir_path)

Rename method to dirname?

Member nom::UnixFile::read_dir (const std::string &dir_path)

Implement optional directory recursion.

Member nom::UnixFile::recursive_mkdir (const std::string &path)

Look into possibly revising our err handling; providing the actual reason for failure is helpful in determining the course of action to take in the application's program flow?

Member nom::UnixFile::rmdir (const std::string &path)

Look into possibly revising our err handling; providing the actual reason for failure is helpful in determining the course of action to take in the application's program flow?

Member nom::UnixFile::user_app_support_path (void)

FSFindFolder and FSRefMakePath are deprecated in OS X v10.8+.

Member nom::UnixFile::user_documents_path (void)

FSFindFolder and FSRefMakePath are deprecated in OS X v10.8+.

Class nom::Value

Implement support for (un)-signed 64-bit integers

Implement support for comments (XML & JSON style)

Member nom::Value::member_names () const

Verify working state of method.

Member nom::Value::operator< (const Value &rhs) const

Unit testing of the operator overload logic for lesser than equality.

Member nom::Value::operator== (const Value &rhs) const

Unit testing of the operator overload logic for equality.

Member nom::Value::operator[] (ArrayIndex index) const

Fix index methods – VString, ValueBaseIterator & co; this method call relies on our half-finished implementation stemming from the VString class.

Member nom::Value::type_name () const

Rename to stringify_type?

Class nom::ValueConstIterator

Finish implementation.

Member nom::ValueIteratorBase::key () const

Try handling the return of the key (string) or index (integer) more elegantly? (Presently, we are converting index values to a string).

Member nom::WindowsConsoleOutput::set_style (uint32 style)

Implement styles by adding FOREGROUND_INTENSITY mask onto the current color?

Member nom::WinFile::is_dir (const std::string &file_path)

Verify working functionality.

Member nom::WinFile::mkdir (const std::string &path)

Look into possibly revising our err handling; providing the actual reason for failure is helpful in determining the course of action to take in the application's program flow?

Member nom::WinFile::path (const std::string &dir_path)

Rename method to dirname?

Member nom::WinFile::read_dir (const std::string &dir_path)

Implement optional directory recursion.

Member nom::WinFile::recursive_mkdir (const std::string &path)

Look into possibly revising our err handling; providing the actual reason for failure is helpful in determining the course of action to take in the application's program flow?

Member nom::WinFile::rmdir (const std::string &path)

Look into possibly revising our err handling; providing the actual reason for failure is helpful in determining the course of action to take in the application's program flow?

Member nom::WinFile::user_app_support_path (void)

Support for when the user has changed the default save folder; see http://stackoverflow.com/a/12607759 and http://stackoverflow.com/questions/19553311/windows-8-how-to-read-the-user-documents-folder-path-programmatically-using-c

Member nom::WinFile::user_documents_path (void)

Support for when the user has changed the default save folder; see http://stackoverflow.com/a/12607759 and http://stackoverflow.com/questions/19553311/windows-8-how-to-read-the-user-documents-folder-path-programmatically-using-c