haiku/headers/os/interface/MultiChannelControl.h
looncraz 7f9368cae5 Set*UIColor, etc.
The inseparable changes necessary to support live color updating across the
system in a sane, safe, and performant manner.

BView gains:

HasSystemColors()
HasDefaultColors()
AdoptSystemColors()
AdoptParentColors()
AdoptViewColor(BView*)
SetViewUIColor(color_which, float tint)
SetHighUIColor(...
SetLowUIColor(...
ViewUIColor(float* tint)
HighUIColor(...
LowUIColor(...
DelayedInvalidate()

BWindow gains a simple helper method:
IsOffscreenWindow()

BMessage gains:

AddColor()
FindColor()
GetColor()
HasColor()            * allegedly this API is deprecated, but I implemented it anyway
ReplaceColor()
SetColor()

Previous private ColorTools methods are made public and moved into GraphicsDefs:

mix_color, blend_color, disable_color

These are fully compatible with BeOS dan0 R5.1 methods and are just code cleanup
of BeOS example code under the OpenTracker license.

In addition, four new colors are created:
B_LINK_TEXT_COLOR
B_LINK_HOVER_COLOR
B_LINK_ACTIVE_COLOR
B_LINK_VISITED_COLOR

These changes are documented in their proper user documentation files.

In addition, due to a history rewrite, B_FOLLOW_LEFT_TOP has been defined and
used in lieu of B_FOLLOW_TOP | B_FOLLOW_LEFT and is included in this commit.

On the app_server side, the following has changed:

Add DelayedMessage - a system by which messages can be sent at a scheduled time,
and can also be merged according to set rules.  A single thread is used to service the
message queue and multiple recipients can be set for each message.
Desktop gains the ability to add message ports to a DelayedMessage so that
said messages can target either all applications or all windows, as needed.

Desktop maintains a BMessage which is used to queue up all pending color changes
and the delayed messaging system is used to enact these changes after a short
period of time has passed.  This prevents abuse and allows the system to merge
repeated set_ui_color events into one event for client applications, improving
performance drastically.

In addition, B_COLORS_UPDATED is sent to the BApplication, which forwards the message
to each BWindow.  This is done to improve performance over having the app_server
independently informing each window.

Decorator changes are live now, which required some reworking.

Signed-off-by: Augustin Cavalier <waddlesplash@gmail.com>
2016-01-04 06:48:22 -05:00

131 lines
3.8 KiB
C++

/*
* Copyright 2015, Haiku, Inc. All rights reserved.
* Distributed under the terms of the MIT License.
*/
#ifndef _MULTI_CHANNEL_CONTROL_H
#define _MULTI_CHANNEL_CONTROL_H
#include <Control.h>
class BMultiChannelControl : public BControl {
public:
BMultiChannelControl(BRect frame,
const char* name, const char* label,
BMessage* message, int32 channelCount = 1,
uint32 resize = B_FOLLOW_LEFT_TOP,
uint32 flags = B_WILL_DRAW);
BMultiChannelControl(BMessage* archive);
virtual ~BMultiChannelControl();
virtual status_t Archive(BMessage* archive,
bool deep = true) const;
virtual void Draw(BRect updateRect) = 0;
virtual void MouseDown(BPoint where) = 0;
virtual void KeyDown(const char* bytes, int32 numBytes) = 0;
virtual void FrameResized(float width, float height);
virtual void SetFont(const BFont* font,
uint32 mask = B_FONT_ALL);
virtual void AttachedToWindow();
virtual void DetachedFromWindow();
virtual void ResizeToPreferred();
virtual void GetPreferredSize(float* _width,
float* _height) = 0;
virtual void MessageReceived(BMessage* message);
//! SetValueChannel() determines which channel
virtual void SetValue(int32 value);
virtual status_t SetCurrentChannel(int32 channel);
int32 CurrentChannel() const;
virtual int32 CountChannels() const;
virtual int32 MaxChannelCount() const = 0;
virtual status_t SetChannelCount(int32 channelCount);
int32 ValueFor(int32 channel) const;
virtual int32 GetValues(int32* _values, int32 firstChannel,
int32 channelCount) const;
status_t SetValueFor(int32 channel, int32 value);
virtual status_t SetValues(int32 firstChannel,
int32 channelCount, const int32* _values);
status_t SetAllValues(int32 values);
status_t SetLimitsFor(int32 channel, int32 minimum,
int32 maximum);
status_t GetLimitsFor(int32 channel, int32* _minimum,
int32* _maximum) const;
virtual status_t SetLimits(int32 firstChannel,
int32 channelCount, const int32* minimum,
const int32* maximum);
virtual status_t GetLimits(int32 firstChannel,
int32 channelCount, int32* _minimum,
int32* _maximum) const;
status_t SetAllLimits(int32 minimum, int32 maximum);
virtual status_t SetLimitLabels(const char* minLabel,
const char* maxLabel);
const char* MinLimitLabel() const;
const char* MaxLimitLabel() const;
private:
// FBC padding
virtual status_t _Reserverd_MultiChannelControl_0(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_1(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_2(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_3(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_4(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_5(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_6(void*, ...);
virtual status_t _Reserverd_MultiChannelControl_7(void*, ...);
// Forbidden
BMultiChannelControl(
const BMultiChannelControl&);
BMultiChannelControl& operator=(const BMultiChannelControl&);
protected:
inline int32* const& MinLimitList() const;
inline int32* const& MaxLimitList() const;
inline int32* const& ValueList() const;
private:
int32 fChannelCount;
int32 fValueChannel;
int32* fChannelMinima;
int32* fChannelMaxima;
int32* fChannelValues;
char* fMinLabel;
char* fMaxLabel;
uint32 _reserved_[16];
};
inline int32* const&
BMultiChannelControl::MinLimitList() const
{
return fChannelMinima;
}
inline int32* const&
BMultiChannelControl::MaxLimitList() const
{
return fChannelMaxima;
}
inline int32* const&
BMultiChannelControl::ValueList() const
{
return fChannelValues;
}
#endif // _MULTI_CHANNEL_CONTROL_H