// Purpose: wxIconBundle
// Author: Mattia Barbon, Vadim Zeitlin
// Created: 23.03.2002
-// RCS-ID: $Id$
// Copyright: (c) Mattia barbon
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
-// ============================================================================
-// declarations
-// ============================================================================
-
-// ----------------------------------------------------------------------------
-// headers
-// ----------------------------------------------------------------------------
-
// For compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"
#ifndef WX_PRECOMP
#include "wx/settings.h"
- #include "wx/icon.h"
#include "wx/log.h"
#include "wx/intl.h"
#include "wx/bitmap.h"
#include "wx/image.h"
+ #include "wx/stream.h"
#endif
-#include "wx/arrimpl.cpp"
+#include "wx/wfstream.h"
+#include "wx/arrimpl.cpp"
WX_DEFINE_OBJARRAY(wxIconArray)
IMPLEMENT_DYNAMIC_CLASS(wxIconBundle, wxGDIObject)
-#define M_ICONBUNDLEDATA ((wxIconBundleRefData *)m_refData)
+#define M_ICONBUNDLEDATA static_cast<wxIconBundleRefData*>(m_refData)
// ----------------------------------------------------------------------------
// wxIconBundleRefData
class WXDLLEXPORT wxIconBundleRefData : public wxGDIRefData
{
public:
- // default and copy ctors and assignment operators are ok
+ wxIconBundleRefData() { }
-protected:
- wxIconArray m_icons;
+ // We need the copy ctor for CloneGDIRefData() but notice that we use the
+ // base class default ctor in it and not the copy one which it doesn't have.
+ wxIconBundleRefData(const wxIconBundleRefData& other)
+ : wxGDIRefData(),
+ m_icons(other.m_icons)
+ {
+ }
+
+ // default assignment operator and dtor are ok
+
+ virtual bool IsOk() const { return !m_icons.empty(); }
- friend class WXDLLEXPORT wxIconBundle;
+ wxIconArray m_icons;
};
// ============================================================================
// ============================================================================
wxIconBundle::wxIconBundle()
- : wxGDIObject()
{
}
-wxIconBundle::wxIconBundle(const wxString& file, long type)
+#if wxUSE_STREAMS && wxUSE_IMAGE
+
+#if wxUSE_FFILE || wxUSE_FILE
+wxIconBundle::wxIconBundle(const wxString& file, wxBitmapType type)
: wxGDIObject()
{
AddIcon(file, type);
}
+#endif // wxUSE_FFILE || wxUSE_FILE
-wxIconBundle::wxIconBundle(const wxIconBundle& icon)
+wxIconBundle::wxIconBundle(wxInputStream& stream, wxBitmapType type)
: wxGDIObject()
{
- Ref(icon);
+ AddIcon(stream, type);
}
+#endif // wxUSE_STREAMS && wxUSE_IMAGE
wxIconBundle::wxIconBundle(const wxIcon& icon)
: wxGDIObject()
AddIcon(icon);
}
-wxObjectRefData *wxIconBundle::CreateRefData() const
+wxGDIRefData *wxIconBundle::CreateGDIRefData() const
{
return new wxIconBundleRefData;
}
-wxObjectRefData *wxIconBundle::CloneRefData(const wxObjectRefData *data) const
+wxGDIRefData *wxIconBundle::CloneGDIRefData(const wxGDIRefData *data) const
{
- return new wxIconBundleRefData(*wx_static_cast(const wxIconBundleRefData *, data));
+ return new wxIconBundleRefData(*static_cast<const wxIconBundleRefData *>(data));
}
void wxIconBundle::DeleteIcons()
UnRef();
}
-bool wxIconBundle::IsOk() const
+#if wxUSE_STREAMS && wxUSE_IMAGE
+
+namespace
{
- return M_ICONBUNDLEDATA && !M_ICONBUNDLEDATA->m_icons.IsEmpty();
+
+// Adds icon from 'input' to the bundle. Shows 'errorMessage' on failure
+// (it must contain "%d", because it is used to report # of image in the file
+// that failed to load):
+void DoAddIcon(wxIconBundle& bundle,
+ wxInputStream& input,
+ wxBitmapType type,
+ const wxString& errorMessage)
+{
+ wxImage image;
+
+ const wxFileOffset posOrig = input.TellI();
+
+ const size_t count = wxImage::GetImageCount(input, type);
+ for ( size_t i = 0; i < count; ++i )
+ {
+ if ( i )
+ {
+ // the call to LoadFile() for the first sub-image updated the
+ // stream position but we need to start reading the subsequent
+ // sub-image at the image beginning too
+ input.SeekI(posOrig);
+ }
+
+ if ( !image.LoadFile(input, type, i) )
+ {
+ wxLogError(errorMessage, i);
+ continue;
+ }
+
+ if ( type == wxBITMAP_TYPE_ANY )
+ {
+ // store the type so that we don't need to try all handlers again
+ // for the subsequent images, they should all be of the same type
+ type = image.GetType();
+ }
+
+ wxIcon tmp;
+ tmp.CopyFromBitmap(wxBitmap(image));
+ bundle.AddIcon(tmp);
+ }
}
-void wxIconBundle::AddIcon(const wxString& file, long type)
+} // anonymous namespace
+
+#if wxUSE_FFILE || wxUSE_FILE
+
+void wxIconBundle::AddIcon(const wxString& file, wxBitmapType type)
{
#ifdef __WXMAC__
// Deal with standard icons
if ( type == wxBITMAP_TYPE_ICON_RESOURCE )
{
wxIcon tmp(file, type);
- if (tmp.Ok())
+ if (tmp.IsOk())
{
AddIcon(tmp);
return;
}
#endif // __WXMAC__
-#if wxUSE_IMAGE && (!defined(__WXMSW__) || wxUSE_WXDIB)
- wxImage image;
+#if wxUSE_FFILE
+ wxFFileInputStream stream(file);
+#elif wxUSE_FILE
+ wxFileInputStream stream(file);
+#endif
+ DoAddIcon
+ (
+ *this,
+ stream, type,
+ wxString::Format(_("Failed to load image %%d from file '%s'."), file)
+ );
+}
- const size_t count = wxImage::GetImageCount( file, type );
- for ( size_t i = 0; i < count; ++i )
- {
- if ( !image.LoadFile( file, type, i ) )
- {
- wxLogError( _("Failed to load image %d from file '%s'."),
- i, file.c_str() );
- continue;
- }
+#endif // wxUSE_FFILE || wxUSE_FILE
- wxIcon tmp;
- tmp.CopyFromBitmap(wxBitmap(image));
- AddIcon(tmp);
- }
-#else // !wxUSE_IMAGE
- wxUnusedVar(file);
- wxUnusedVar(type);
-#endif // wxUSE_IMAGE/!wxUSE_IMAGE
+void wxIconBundle::AddIcon(wxInputStream& stream, wxBitmapType type)
+{
+ DoAddIcon(*this, stream, type, _("Failed to load image %d from stream."));
}
-wxIcon wxIconBundle::GetIcon(const wxSize& size) const
+#endif // wxUSE_STREAMS && wxUSE_IMAGE
+
+wxIcon wxIconBundle::GetIcon(const wxSize& size, int flags) const
{
- const size_t count = GetIconCount();
+ wxASSERT( size == wxDefaultSize || (size.x >= 0 && size.y > 0) );
+
+ // We need the standard system icon size when using FALLBACK_SYSTEM.
+ wxCoord sysX = 0,
+ sysY = 0;
+ if ( flags & FALLBACK_SYSTEM )
+ {
+ sysX = wxSystemSettings::GetMetric(wxSYS_ICON_X);
+ sysY = wxSystemSettings::GetMetric(wxSYS_ICON_Y);
+ }
+
+ // If size == wxDefaultSize, we use system default icon size by convention.
+ wxCoord sizeX = size.x;
+ wxCoord sizeY = size.y;
+ if ( size == wxDefaultSize )
+ {
+ wxASSERT_MSG( flags == FALLBACK_SYSTEM,
+ wxS("Must have valid size if not using FALLBACK_SYSTEM") );
+
+ sizeX = sysX;
+ sizeY = sysY;
+ }
- // optimize for the common case of icon bundles containing one icon only
+ // Iterate over all icons searching for the exact match or the closest icon
+ // for FALLBACK_NEAREST_LARGER.
wxIcon iconBest;
- switch ( count )
+ int bestDiff = 0;
+ bool bestIsLarger = false;
+ bool bestIsSystem = false;
+
+ const size_t count = GetIconCount();
+
+ const wxIconArray& iconArray = M_ICONBUNDLEDATA->m_icons;
+ for ( size_t i = 0; i < count; i++ )
{
- case 0:
- // nothing to do, iconBest is already invalid
- break;
+ const wxIcon& icon = iconArray[i];
+ if ( !icon.IsOk() )
+ continue;
+ wxCoord sx = icon.GetWidth(),
+ sy = icon.GetHeight();
- case 1:
- iconBest = M_ICONBUNDLEDATA->m_icons[0];
+ // Exact match ends search immediately in any case.
+ if ( sx == sizeX && sy == sizeY )
+ {
+ iconBest = icon;
break;
+ }
- default:
- // there is more than one icon, find the best match:
- wxCoord sysX = wxSystemSettings::GetMetric( wxSYS_ICON_X ),
- sysY = wxSystemSettings::GetMetric( wxSYS_ICON_Y );
+ if ( flags & FALLBACK_SYSTEM )
+ {
+ if ( sx == sysX && sy == sysY )
+ {
+ iconBest = icon;
+ bestIsSystem = true;
+ continue;
+ }
+ }
- const wxIconArray& iconArray = M_ICONBUNDLEDATA->m_icons;
- for ( size_t i = 0; i < count; i++ )
+ if ( !bestIsSystem && (flags & FALLBACK_NEAREST_LARGER) )
+ {
+ bool iconLarger = (sx >= sizeX) && (sy >= sizeY);
+ int iconDiff = abs(sx - sizeX) + abs(sy - sizeY);
+
+ // Use current icon as candidate for the best icon, if either:
+ // - we have no candidate yet
+ // - we have no candidate larger than desired size and current icon is
+ // - current icon is closer to desired size than candidate
+ if ( !iconBest.IsOk() ||
+ (!bestIsLarger && iconLarger) ||
+ (iconLarger && (iconDiff < bestDiff)) )
{
- const wxIcon& icon = iconArray[i];
- wxCoord sx = icon.GetWidth(),
- sy = icon.GetHeight();
-
- // if we got an icon of exactly the requested size, we're done
- if ( sx == size.x && sy == size.y )
- {
- iconBest = icon;
- break;
- }
-
- // the best icon is by default (arbitrarily) the first one but
- // if we find a system-sized icon, take it instead
- if ( sx == sysX && sy == sysY || !iconBest.IsOk() )
- iconBest = icon;
+ iconBest = icon;
+ bestIsLarger = iconLarger;
+ bestDiff = iconDiff;
+ continue;
}
+ }
}
-#ifdef __WXMAC__
+#if defined( __WXMAC__ ) && wxOSX_USE_CARBON
+ if (!iconBest.IsOk())
+ return wxNullIcon;
+
return wxIcon(iconBest.GetHICON(), size);
#else
return iconBest;
#endif
}
+wxIcon wxIconBundle::GetIconOfExactSize(const wxSize& size) const
+{
+ return GetIcon(size, FALLBACK_NONE);
+}
+
void wxIconBundle::AddIcon(const wxIcon& icon)
{
- wxCHECK_RET( icon.IsOk(), _T("invalid icon") );
+ wxCHECK_RET( icon.IsOk(), wxT("invalid icon") );
AllocExclusive();
for ( size_t i = 0; i < count; ++i )
{
wxIcon& tmp = iconArray[i];
- if ( tmp.Ok() &&
+ if ( tmp.IsOk() &&
tmp.GetWidth() == icon.GetWidth() &&
tmp.GetHeight() == icon.GetHeight() )
{
wxIcon wxIconBundle::GetIconByIndex(size_t n) const
{
- wxCHECK_MSG( n < GetIconCount(), wxNullIcon, _T("invalid index") );
+ wxCHECK_MSG( n < GetIconCount(), wxNullIcon, wxT("invalid index") );
return M_ICONBUNDLEDATA->m_icons[n];
}
-