qcustomplot-2.1.0+dfsg1/0000755000175000017500000000000014030601042015020 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/GPL.txt0000640000175000017500000010575513532027716016234 0ustar rusconirusconi GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. "This License" refers to version 3 of the GNU General Public License. "Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. "The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program. To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work. A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. "Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. "Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read . qcustomplot-2.1.0+dfsg1/qcustomplot.cpp0000644000175000017500000476717514030601017020153 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include "qcustomplot.h" /* including file 'src/vector2d.cpp' */ /* modified 2021-03-29T02:30:44, size 7973 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPVector2D //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPVector2D \brief Represents two doubles as a mathematical 2D vector This class acts as a replacement for QVector2D with the advantage of double precision instead of single, and some convenience methods tailored for the QCustomPlot library. */ /* start documentation of inline functions */ /*! \fn void QCPVector2D::setX(double x) Sets the x coordinate of this vector to \a x. \see setY */ /*! \fn void QCPVector2D::setY(double y) Sets the y coordinate of this vector to \a y. \see setX */ /*! \fn double QCPVector2D::length() const Returns the length of this vector. \see lengthSquared */ /*! \fn double QCPVector2D::lengthSquared() const Returns the squared length of this vector. In some situations, e.g. when just trying to find the shortest vector of a group, this is faster than calculating \ref length, because it avoids calculation of a square root. \see length */ /*! \fn double QCPVector2D::angle() const Returns the angle of the vector in radians. The angle is measured between the positive x line and the vector, counter-clockwise in a mathematical coordinate system (y axis upwards positive). In screen/widget coordinates where the y axis is inverted, the angle appears clockwise. */ /*! \fn QPoint QCPVector2D::toPoint() const Returns a QPoint which has the x and y coordinates of this vector, truncating any floating point information. \see toPointF */ /*! \fn QPointF QCPVector2D::toPointF() const Returns a QPointF which has the x and y coordinates of this vector. \see toPoint */ /*! \fn bool QCPVector2D::isNull() const Returns whether this vector is null. A vector is null if \c qIsNull returns true for both x and y coordinates, i.e. if both are binary equal to 0. */ /*! \fn QCPVector2D QCPVector2D::perpendicular() const Returns a vector perpendicular to this vector, with the same length. */ /*! \fn double QCPVector2D::dot() const Returns the dot/scalar product of this vector with the specified vector \a vec. */ /* end documentation of inline functions */ /*! Creates a QCPVector2D object and initializes the x and y coordinates to 0. */ QCPVector2D::QCPVector2D() : mX(0), mY(0) { } /*! Creates a QCPVector2D object and initializes the \a x and \a y coordinates with the specified values. */ QCPVector2D::QCPVector2D(double x, double y) : mX(x), mY(y) { } /*! Creates a QCPVector2D object and initializes the x and y coordinates respective coordinates of the specified \a point. */ QCPVector2D::QCPVector2D(const QPoint &point) : mX(point.x()), mY(point.y()) { } /*! Creates a QCPVector2D object and initializes the x and y coordinates respective coordinates of the specified \a point. */ QCPVector2D::QCPVector2D(const QPointF &point) : mX(point.x()), mY(point.y()) { } /*! Normalizes this vector. After this operation, the length of the vector is equal to 1. If the vector has both entries set to zero, this method does nothing. \see normalized, length, lengthSquared */ void QCPVector2D::normalize() { if (mX == 0.0 && mY == 0.0) return; const double lenInv = 1.0/length(); mX *= lenInv; mY *= lenInv; } /*! Returns a normalized version of this vector. The length of the returned vector is equal to 1. If the vector has both entries set to zero, this method returns the vector unmodified. \see normalize, length, lengthSquared */ QCPVector2D QCPVector2D::normalized() const { if (mX == 0.0 && mY == 0.0) return *this; const double lenInv = 1.0/length(); return QCPVector2D(mX*lenInv, mY*lenInv); } /*! \overload Returns the squared shortest distance of this vector (interpreted as a point) to the finite line segment given by \a start and \a end. \see distanceToStraightLine */ double QCPVector2D::distanceSquaredToLine(const QCPVector2D &start, const QCPVector2D &end) const { const QCPVector2D v(end-start); const double vLengthSqr = v.lengthSquared(); if (!qFuzzyIsNull(vLengthSqr)) { const double mu = v.dot(*this-start)/vLengthSqr; if (mu < 0) return (*this-start).lengthSquared(); else if (mu > 1) return (*this-end).lengthSquared(); else return ((start + mu*v)-*this).lengthSquared(); } else return (*this-start).lengthSquared(); } /*! \overload Returns the squared shortest distance of this vector (interpreted as a point) to the finite line segment given by \a line. \see distanceToStraightLine */ double QCPVector2D::distanceSquaredToLine(const QLineF &line) const { return distanceSquaredToLine(QCPVector2D(line.p1()), QCPVector2D(line.p2())); } /*! Returns the shortest distance of this vector (interpreted as a point) to the infinite straight line given by a \a base point and a \a direction vector. \see distanceSquaredToLine */ double QCPVector2D::distanceToStraightLine(const QCPVector2D &base, const QCPVector2D &direction) const { return qAbs((*this-base).dot(direction.perpendicular()))/direction.length(); } /*! Scales this vector by the given \a factor, i.e. the x and y components are multiplied by \a factor. */ QCPVector2D &QCPVector2D::operator*=(double factor) { mX *= factor; mY *= factor; return *this; } /*! Scales this vector by the given \a divisor, i.e. the x and y components are divided by \a divisor. */ QCPVector2D &QCPVector2D::operator/=(double divisor) { mX /= divisor; mY /= divisor; return *this; } /*! Adds the given \a vector to this vector component-wise. */ QCPVector2D &QCPVector2D::operator+=(const QCPVector2D &vector) { mX += vector.mX; mY += vector.mY; return *this; } /*! subtracts the given \a vector from this vector component-wise. */ QCPVector2D &QCPVector2D::operator-=(const QCPVector2D &vector) { mX -= vector.mX; mY -= vector.mY; return *this; } /* end of 'src/vector2d.cpp' */ /* including file 'src/painter.cpp' */ /* modified 2021-03-29T02:30:44, size 8656 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPainter //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPainter \brief QPainter subclass used internally This QPainter subclass is used to provide some extended functionality e.g. for tweaking position consistency between antialiased and non-antialiased painting. Further it provides workarounds for QPainter quirks. \warning This class intentionally hides non-virtual functions of QPainter, e.g. setPen, save and restore. So while it is possible to pass a QCPPainter instance to a function that expects a QPainter pointer, some of the workarounds and tweaks will be unavailable to the function (because it will call the base class implementations of the functions actually hidden by QCPPainter). */ /*! Creates a new QCPPainter instance and sets default values */ QCPPainter::QCPPainter() : mModes(pmDefault), mIsAntialiasing(false) { // don't setRenderHint(QPainter::NonCosmeticDefautPen) here, because painter isn't active yet and // a call to begin() will follow } /*! Creates a new QCPPainter instance on the specified paint \a device and sets default values. Just like the analogous QPainter constructor, begins painting on \a device immediately. Like \ref begin, this method sets QPainter::NonCosmeticDefaultPen in Qt versions before Qt5. */ QCPPainter::QCPPainter(QPaintDevice *device) : QPainter(device), mModes(pmDefault), mIsAntialiasing(false) { #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions. if (isActive()) setRenderHint(QPainter::NonCosmeticDefaultPen); #endif } /*! Sets the pen of the painter and applies certain fixes to it, depending on the mode of this QCPPainter. \note this function hides the non-virtual base class implementation. */ void QCPPainter::setPen(const QPen &pen) { QPainter::setPen(pen); if (mModes.testFlag(pmNonCosmetic)) makeNonCosmetic(); } /*! \overload Sets the pen (by color) of the painter and applies certain fixes to it, depending on the mode of this QCPPainter. \note this function hides the non-virtual base class implementation. */ void QCPPainter::setPen(const QColor &color) { QPainter::setPen(color); if (mModes.testFlag(pmNonCosmetic)) makeNonCosmetic(); } /*! \overload Sets the pen (by style) of the painter and applies certain fixes to it, depending on the mode of this QCPPainter. \note this function hides the non-virtual base class implementation. */ void QCPPainter::setPen(Qt::PenStyle penStyle) { QPainter::setPen(penStyle); if (mModes.testFlag(pmNonCosmetic)) makeNonCosmetic(); } /*! \overload Works around a Qt bug introduced with Qt 4.8 which makes drawing QLineF unpredictable when antialiasing is disabled. Thus when antialiasing is disabled, it rounds the \a line to integer coordinates and then passes it to the original drawLine. \note this function hides the non-virtual base class implementation. */ void QCPPainter::drawLine(const QLineF &line) { if (mIsAntialiasing || mModes.testFlag(pmVectorized)) QPainter::drawLine(line); else QPainter::drawLine(line.toLine()); } /*! Sets whether painting uses antialiasing or not. Use this method instead of using setRenderHint with QPainter::Antialiasing directly, as it allows QCPPainter to regain pixel exactness between antialiased and non-antialiased painting (Since Qt < 5.0 uses slightly different coordinate systems for AA/Non-AA painting). */ void QCPPainter::setAntialiasing(bool enabled) { setRenderHint(QPainter::Antialiasing, enabled); if (mIsAntialiasing != enabled) { mIsAntialiasing = enabled; if (!mModes.testFlag(pmVectorized)) // antialiasing half-pixel shift only needed for rasterized outputs { if (mIsAntialiasing) translate(0.5, 0.5); else translate(-0.5, -0.5); } } } /*! Sets the mode of the painter. This controls whether the painter shall adjust its fixes/workarounds optimized for certain output devices. */ void QCPPainter::setModes(QCPPainter::PainterModes modes) { mModes = modes; } /*! Sets the QPainter::NonCosmeticDefaultPen in Qt versions before Qt5 after beginning painting on \a device. This is necessary to get cosmetic pen consistency across Qt versions, because since Qt5, all pens are non-cosmetic by default, and in Qt4 this render hint must be set to get that behaviour. The Constructor \ref QCPPainter(QPaintDevice *device) which directly starts painting also sets the render hint as appropriate. \note this function hides the non-virtual base class implementation. */ bool QCPPainter::begin(QPaintDevice *device) { bool result = QPainter::begin(device); #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions. if (result) setRenderHint(QPainter::NonCosmeticDefaultPen); #endif return result; } /*! \overload Sets the mode of the painter. This controls whether the painter shall adjust its fixes/workarounds optimized for certain output devices. */ void QCPPainter::setMode(QCPPainter::PainterMode mode, bool enabled) { if (!enabled && mModes.testFlag(mode)) mModes &= ~mode; else if (enabled && !mModes.testFlag(mode)) mModes |= mode; } /*! Saves the painter (see QPainter::save). Since QCPPainter adds some new internal state to QPainter, the save/restore functions are reimplemented to also save/restore those members. \note this function hides the non-virtual base class implementation. \see restore */ void QCPPainter::save() { mAntialiasingStack.push(mIsAntialiasing); QPainter::save(); } /*! Restores the painter (see QPainter::restore). Since QCPPainter adds some new internal state to QPainter, the save/restore functions are reimplemented to also save/restore those members. \note this function hides the non-virtual base class implementation. \see save */ void QCPPainter::restore() { if (!mAntialiasingStack.isEmpty()) mIsAntialiasing = mAntialiasingStack.pop(); else qDebug() << Q_FUNC_INFO << "Unbalanced save/restore"; QPainter::restore(); } /*! Changes the pen width to 1 if it currently is 0. This function is called in the \ref setPen overrides when the \ref pmNonCosmetic mode is set. */ void QCPPainter::makeNonCosmetic() { if (qFuzzyIsNull(pen().widthF())) { QPen p = pen(); p.setWidth(1); QPainter::setPen(p); } } /* end of 'src/painter.cpp' */ /* including file 'src/paintbuffer.cpp' */ /* modified 2021-03-29T02:30:44, size 18915 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAbstractPaintBuffer //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAbstractPaintBuffer \brief The abstract base class for paint buffers, which define the rendering backend This abstract base class defines the basic interface that a paint buffer needs to provide in order to be usable by QCustomPlot. A paint buffer manages both a surface to draw onto, and the matching paint device. The size of the surface can be changed via \ref setSize. External classes (\ref QCustomPlot and \ref QCPLayer) request a painter via \ref startPainting and then perform the draw calls. Once the painting is complete, \ref donePainting is called, so the paint buffer implementation can do clean up if necessary. Before rendering a frame, each paint buffer is usually filled with a color using \ref clear (usually the color is \c Qt::transparent), to remove the contents of the previous frame. The simplest paint buffer implementation is \ref QCPPaintBufferPixmap which allows regular software rendering via the raster engine. Hardware accelerated rendering via pixel buffers and frame buffer objects is provided by \ref QCPPaintBufferGlPbuffer and \ref QCPPaintBufferGlFbo. They are used automatically if \ref QCustomPlot::setOpenGl is enabled. */ /* start documentation of pure virtual functions */ /*! \fn virtual QCPPainter *QCPAbstractPaintBuffer::startPainting() = 0 Returns a \ref QCPPainter which is ready to draw to this buffer. The ownership and thus the responsibility to delete the painter after the painting operations are complete is given to the caller of this method. Once you are done using the painter, delete the painter and call \ref donePainting. While a painter generated with this method is active, you must not call \ref setSize, \ref setDevicePixelRatio or \ref clear. This method may return 0, if a painter couldn't be activated on the buffer. This usually indicates a problem with the respective painting backend. */ /*! \fn virtual void QCPAbstractPaintBuffer::draw(QCPPainter *painter) const = 0 Draws the contents of this buffer with the provided \a painter. This is the method that is used to finally join all paint buffers and draw them onto the screen. */ /*! \fn virtual void QCPAbstractPaintBuffer::clear(const QColor &color) = 0 Fills the entire buffer with the provided \a color. To have an empty transparent buffer, use the named color \c Qt::transparent. This method must not be called if there is currently a painter (acquired with \ref startPainting) active. */ /*! \fn virtual void QCPAbstractPaintBuffer::reallocateBuffer() = 0 Reallocates the internal buffer with the currently configured size (\ref setSize) and device pixel ratio, if applicable (\ref setDevicePixelRatio). It is called as soon as any of those properties are changed on this paint buffer. \note Subclasses of \ref QCPAbstractPaintBuffer must call their reimplementation of this method in their constructor, to perform the first allocation (this can not be done by the base class because calling pure virtual methods in base class constructors is not possible). */ /* end documentation of pure virtual functions */ /* start documentation of inline functions */ /*! \fn virtual void QCPAbstractPaintBuffer::donePainting() If you have acquired a \ref QCPPainter to paint onto this paint buffer via \ref startPainting, call this method as soon as you are done with the painting operations and have deleted the painter. paint buffer subclasses may use this method to perform any type of cleanup that is necessary. The default implementation does nothing. */ /* end documentation of inline functions */ /*! Creates a paint buffer and initializes it with the provided \a size and \a devicePixelRatio. Subclasses must call their \ref reallocateBuffer implementation in their respective constructors. */ QCPAbstractPaintBuffer::QCPAbstractPaintBuffer(const QSize &size, double devicePixelRatio) : mSize(size), mDevicePixelRatio(devicePixelRatio), mInvalidated(true) { } QCPAbstractPaintBuffer::~QCPAbstractPaintBuffer() { } /*! Sets the paint buffer size. The buffer is reallocated (by calling \ref reallocateBuffer), so any painters that were obtained by \ref startPainting are invalidated and must not be used after calling this method. If \a size is already the current buffer size, this method does nothing. */ void QCPAbstractPaintBuffer::setSize(const QSize &size) { if (mSize != size) { mSize = size; reallocateBuffer(); } } /*! Sets the invalidated flag to \a invalidated. This mechanism is used internally in conjunction with isolated replotting of \ref QCPLayer instances (in \ref QCPLayer::lmBuffered mode). If \ref QCPLayer::replot is called on a buffered layer, i.e. an isolated repaint of only that layer (and its dedicated paint buffer) is requested, QCustomPlot will decide depending on the invalidated flags of other paint buffers whether it also replots them, instead of only the layer on which the replot was called. The invalidated flag is set to true when \ref QCPLayer association has changed, i.e. if layers were added or removed from this buffer, or if they were reordered. It is set to false as soon as all associated \ref QCPLayer instances are drawn onto the buffer. Under normal circumstances, it is not necessary to manually call this method. */ void QCPAbstractPaintBuffer::setInvalidated(bool invalidated) { mInvalidated = invalidated; } /*! Sets the device pixel ratio to \a ratio. This is useful to render on high-DPI output devices. The ratio is automatically set to the device pixel ratio used by the parent QCustomPlot instance. The buffer is reallocated (by calling \ref reallocateBuffer), so any painters that were obtained by \ref startPainting are invalidated and must not be used after calling this method. \note This method is only available for Qt versions 5.4 and higher. */ void QCPAbstractPaintBuffer::setDevicePixelRatio(double ratio) { if (!qFuzzyCompare(ratio, mDevicePixelRatio)) { #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED mDevicePixelRatio = ratio; reallocateBuffer(); #else qDebug() << Q_FUNC_INFO << "Device pixel ratios not supported for Qt versions before 5.4"; mDevicePixelRatio = 1.0; #endif } } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPaintBufferPixmap //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPaintBufferPixmap \brief A paint buffer based on QPixmap, using software raster rendering This paint buffer is the default and fall-back paint buffer which uses software rendering and QPixmap as internal buffer. It is used if \ref QCustomPlot::setOpenGl is false. */ /*! Creates a pixmap paint buffer instancen with the specified \a size and \a devicePixelRatio, if applicable. */ QCPPaintBufferPixmap::QCPPaintBufferPixmap(const QSize &size, double devicePixelRatio) : QCPAbstractPaintBuffer(size, devicePixelRatio) { QCPPaintBufferPixmap::reallocateBuffer(); } QCPPaintBufferPixmap::~QCPPaintBufferPixmap() { } /* inherits documentation from base class */ QCPPainter *QCPPaintBufferPixmap::startPainting() { QCPPainter *result = new QCPPainter(&mBuffer); #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) result->setRenderHint(QPainter::HighQualityAntialiasing); #endif return result; } /* inherits documentation from base class */ void QCPPaintBufferPixmap::draw(QCPPainter *painter) const { if (painter && painter->isActive()) painter->drawPixmap(0, 0, mBuffer); else qDebug() << Q_FUNC_INFO << "invalid or inactive painter passed"; } /* inherits documentation from base class */ void QCPPaintBufferPixmap::clear(const QColor &color) { mBuffer.fill(color); } /* inherits documentation from base class */ void QCPPaintBufferPixmap::reallocateBuffer() { setInvalidated(); if (!qFuzzyCompare(1.0, mDevicePixelRatio)) { #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED mBuffer = QPixmap(mSize*mDevicePixelRatio); mBuffer.setDevicePixelRatio(mDevicePixelRatio); #else qDebug() << Q_FUNC_INFO << "Device pixel ratios not supported for Qt versions before 5.4"; mDevicePixelRatio = 1.0; mBuffer = QPixmap(mSize); #endif } else { mBuffer = QPixmap(mSize); } } #ifdef QCP_OPENGL_PBUFFER //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPaintBufferGlPbuffer //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPaintBufferGlPbuffer \brief A paint buffer based on OpenGL pixel buffers, using hardware accelerated rendering This paint buffer is one of the OpenGL paint buffers which facilitate hardware accelerated plot rendering. It is based on OpenGL pixel buffers (pbuffer) and is used in Qt versions before 5.0. (See \ref QCPPaintBufferGlFbo used in newer Qt versions.) The OpenGL paint buffers are used if \ref QCustomPlot::setOpenGl is set to true, and if they are supported by the system. */ /*! Creates a \ref QCPPaintBufferGlPbuffer instance with the specified \a size and \a devicePixelRatio, if applicable. The parameter \a multisamples defines how many samples are used per pixel. Higher values thus result in higher quality antialiasing. If the specified \a multisamples value exceeds the capability of the graphics hardware, the highest supported multisampling is used. */ QCPPaintBufferGlPbuffer::QCPPaintBufferGlPbuffer(const QSize &size, double devicePixelRatio, int multisamples) : QCPAbstractPaintBuffer(size, devicePixelRatio), mGlPBuffer(0), mMultisamples(qMax(0, multisamples)) { QCPPaintBufferGlPbuffer::reallocateBuffer(); } QCPPaintBufferGlPbuffer::~QCPPaintBufferGlPbuffer() { if (mGlPBuffer) delete mGlPBuffer; } /* inherits documentation from base class */ QCPPainter *QCPPaintBufferGlPbuffer::startPainting() { if (!mGlPBuffer->isValid()) { qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; return 0; } QCPPainter *result = new QCPPainter(mGlPBuffer); result->setRenderHint(QPainter::HighQualityAntialiasing); return result; } /* inherits documentation from base class */ void QCPPaintBufferGlPbuffer::draw(QCPPainter *painter) const { if (!painter || !painter->isActive()) { qDebug() << Q_FUNC_INFO << "invalid or inactive painter passed"; return; } if (!mGlPBuffer->isValid()) { qDebug() << Q_FUNC_INFO << "OpenGL pbuffer isn't valid, reallocateBuffer was not called?"; return; } painter->drawImage(0, 0, mGlPBuffer->toImage()); } /* inherits documentation from base class */ void QCPPaintBufferGlPbuffer::clear(const QColor &color) { if (mGlPBuffer->isValid()) { mGlPBuffer->makeCurrent(); glClearColor(color.redF(), color.greenF(), color.blueF(), color.alphaF()); glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); mGlPBuffer->doneCurrent(); } else qDebug() << Q_FUNC_INFO << "OpenGL pbuffer invalid or context not current"; } /* inherits documentation from base class */ void QCPPaintBufferGlPbuffer::reallocateBuffer() { if (mGlPBuffer) delete mGlPBuffer; QGLFormat format; format.setAlpha(true); format.setSamples(mMultisamples); mGlPBuffer = new QGLPixelBuffer(mSize, format); } #endif // QCP_OPENGL_PBUFFER #ifdef QCP_OPENGL_FBO //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPaintBufferGlFbo //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPaintBufferGlFbo \brief A paint buffer based on OpenGL frame buffers objects, using hardware accelerated rendering This paint buffer is one of the OpenGL paint buffers which facilitate hardware accelerated plot rendering. It is based on OpenGL frame buffer objects (fbo) and is used in Qt versions 5.0 and higher. (See \ref QCPPaintBufferGlPbuffer used in older Qt versions.) The OpenGL paint buffers are used if \ref QCustomPlot::setOpenGl is set to true, and if they are supported by the system. */ /*! Creates a \ref QCPPaintBufferGlFbo instance with the specified \a size and \a devicePixelRatio, if applicable. All frame buffer objects shall share one OpenGL context and paint device, which need to be set up externally and passed via \a glContext and \a glPaintDevice. The set-up is done in \ref QCustomPlot::setupOpenGl and the context and paint device are managed by the parent QCustomPlot instance. */ QCPPaintBufferGlFbo::QCPPaintBufferGlFbo(const QSize &size, double devicePixelRatio, QWeakPointer glContext, QWeakPointer glPaintDevice) : QCPAbstractPaintBuffer(size, devicePixelRatio), mGlContext(glContext), mGlPaintDevice(glPaintDevice), mGlFrameBuffer(0) { QCPPaintBufferGlFbo::reallocateBuffer(); } QCPPaintBufferGlFbo::~QCPPaintBufferGlFbo() { if (mGlFrameBuffer) delete mGlFrameBuffer; } /* inherits documentation from base class */ QCPPainter *QCPPaintBufferGlFbo::startPainting() { QSharedPointer paintDevice = mGlPaintDevice.toStrongRef(); QSharedPointer context = mGlContext.toStrongRef(); if (!paintDevice) { qDebug() << Q_FUNC_INFO << "OpenGL paint device doesn't exist"; return 0; } if (!context) { qDebug() << Q_FUNC_INFO << "OpenGL context doesn't exist"; return 0; } if (!mGlFrameBuffer) { qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; return 0; } if (QOpenGLContext::currentContext() != context.data()) context->makeCurrent(context->surface()); mGlFrameBuffer->bind(); QCPPainter *result = new QCPPainter(paintDevice.data()); #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) result->setRenderHint(QPainter::HighQualityAntialiasing); #endif return result; } /* inherits documentation from base class */ void QCPPaintBufferGlFbo::donePainting() { if (mGlFrameBuffer && mGlFrameBuffer->isBound()) mGlFrameBuffer->release(); else qDebug() << Q_FUNC_INFO << "Either OpenGL frame buffer not valid or was not bound"; } /* inherits documentation from base class */ void QCPPaintBufferGlFbo::draw(QCPPainter *painter) const { if (!painter || !painter->isActive()) { qDebug() << Q_FUNC_INFO << "invalid or inactive painter passed"; return; } if (!mGlFrameBuffer) { qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; return; } painter->drawImage(0, 0, mGlFrameBuffer->toImage()); } /* inherits documentation from base class */ void QCPPaintBufferGlFbo::clear(const QColor &color) { QSharedPointer context = mGlContext.toStrongRef(); if (!context) { qDebug() << Q_FUNC_INFO << "OpenGL context doesn't exist"; return; } if (!mGlFrameBuffer) { qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; return; } if (QOpenGLContext::currentContext() != context.data()) context->makeCurrent(context->surface()); mGlFrameBuffer->bind(); glClearColor(color.redF(), color.greenF(), color.blueF(), color.alphaF()); glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); mGlFrameBuffer->release(); } /* inherits documentation from base class */ void QCPPaintBufferGlFbo::reallocateBuffer() { // release and delete possibly existing framebuffer: if (mGlFrameBuffer) { if (mGlFrameBuffer->isBound()) mGlFrameBuffer->release(); delete mGlFrameBuffer; mGlFrameBuffer = 0; } QSharedPointer paintDevice = mGlPaintDevice.toStrongRef(); QSharedPointer context = mGlContext.toStrongRef(); if (!paintDevice) { qDebug() << Q_FUNC_INFO << "OpenGL paint device doesn't exist"; return; } if (!context) { qDebug() << Q_FUNC_INFO << "OpenGL context doesn't exist"; return; } // create new fbo with appropriate size: context->makeCurrent(context->surface()); QOpenGLFramebufferObjectFormat frameBufferFormat; frameBufferFormat.setSamples(context->format().samples()); frameBufferFormat.setAttachment(QOpenGLFramebufferObject::CombinedDepthStencil); mGlFrameBuffer = new QOpenGLFramebufferObject(mSize*mDevicePixelRatio, frameBufferFormat); if (paintDevice->size() != mSize*mDevicePixelRatio) paintDevice->setSize(mSize*mDevicePixelRatio); #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED paintDevice->setDevicePixelRatio(mDevicePixelRatio); #endif } #endif // QCP_OPENGL_FBO /* end of 'src/paintbuffer.cpp' */ /* including file 'src/layer.cpp' */ /* modified 2021-03-29T02:30:44, size 37615 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLayer //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLayer \brief A layer that may contain objects, to control the rendering order The Layering system of QCustomPlot is the mechanism to control the rendering order of the elements inside the plot. It is based on the two classes QCPLayer and QCPLayerable. QCustomPlot holds an ordered list of one or more instances of QCPLayer (see QCustomPlot::addLayer, QCustomPlot::layer, QCustomPlot::moveLayer, etc.). When replotting, QCustomPlot goes through the list of layers bottom to top and successively draws the layerables of the layers into the paint buffer(s). A QCPLayer contains an ordered list of QCPLayerable instances. QCPLayerable is an abstract base class from which almost all visible objects derive, like axes, grids, graphs, items, etc. \section qcplayer-defaultlayers Default layers Initially, QCustomPlot has six layers: "background", "grid", "main", "axes", "legend" and "overlay" (in that order). On top is the "overlay" layer, which only contains the QCustomPlot's selection rect (\ref QCustomPlot::selectionRect). The next two layers "axes" and "legend" contain the default axes and legend, so they will be drawn above plottables. In the middle, there is the "main" layer. It is initially empty and set as the current layer (see QCustomPlot::setCurrentLayer). This means, all new plottables, items etc. are created on this layer by default. Then comes the "grid" layer which contains the QCPGrid instances (which belong tightly to QCPAxis, see \ref QCPAxis::grid). The Axis rect background shall be drawn behind everything else, thus the default QCPAxisRect instance is placed on the "background" layer. Of course, the layer affiliation of the individual objects can be changed as required (\ref QCPLayerable::setLayer). \section qcplayer-ordering Controlling the rendering order via layers Controlling the ordering of layerables in the plot is easy: Create a new layer in the position you want the layerable to be in, e.g. above "main", with \ref QCustomPlot::addLayer. Then set the current layer with \ref QCustomPlot::setCurrentLayer to that new layer and finally create the objects normally. They will be placed on the new layer automatically, due to the current layer setting. Alternatively you could have also ignored the current layer setting and just moved the objects with \ref QCPLayerable::setLayer to the desired layer after creating them. It is also possible to move whole layers. For example, If you want the grid to be shown in front of all plottables/items on the "main" layer, just move it above "main" with QCustomPlot::moveLayer. The rendering order within one layer is simply by order of creation or insertion. The item created last (or added last to the layer), is drawn on top of all other objects on that layer. When a layer is deleted, the objects on it are not deleted with it, but fall on the layer below the deleted layer, see QCustomPlot::removeLayer. \section qcplayer-buffering Replotting only a specific layer If the layer mode (\ref setMode) is set to \ref lmBuffered, you can replot only this specific layer by calling \ref replot. In certain situations this can provide better replot performance, compared with a full replot of all layers. Upon creation of a new layer, the layer mode is initialized to \ref lmLogical. The only layer that is set to \ref lmBuffered in a new \ref QCustomPlot instance is the "overlay" layer, containing the selection rect. */ /* start documentation of inline functions */ /*! \fn QList QCPLayer::children() const Returns a list of all layerables on this layer. The order corresponds to the rendering order: layerables with higher indices are drawn above layerables with lower indices. */ /*! \fn int QCPLayer::index() const Returns the index this layer has in the QCustomPlot. The index is the integer number by which this layer can be accessed via \ref QCustomPlot::layer. Layers with higher indices will be drawn above layers with lower indices. */ /* end documentation of inline functions */ /*! Creates a new QCPLayer instance. Normally you shouldn't directly instantiate layers, use \ref QCustomPlot::addLayer instead. \warning It is not checked that \a layerName is actually a unique layer name in \a parentPlot. This check is only performed by \ref QCustomPlot::addLayer. */ QCPLayer::QCPLayer(QCustomPlot *parentPlot, const QString &layerName) : QObject(parentPlot), mParentPlot(parentPlot), mName(layerName), mIndex(-1), // will be set to a proper value by the QCustomPlot layer creation function mVisible(true), mMode(lmLogical) { // Note: no need to make sure layerName is unique, because layer // management is done with QCustomPlot functions. } QCPLayer::~QCPLayer() { // If child layerables are still on this layer, detach them, so they don't try to reach back to this // then invalid layer once they get deleted/moved themselves. This only happens when layers are deleted // directly, like in the QCustomPlot destructor. (The regular layer removal procedure for the user is to // call QCustomPlot::removeLayer, which moves all layerables off this layer before deleting it.) while (!mChildren.isEmpty()) mChildren.last()->setLayer(nullptr); // removes itself from mChildren via removeChild() if (mParentPlot->currentLayer() == this) qDebug() << Q_FUNC_INFO << "The parent plot's mCurrentLayer will be a dangling pointer. Should have been set to a valid layer or nullptr beforehand."; } /*! Sets whether this layer is visible or not. If \a visible is set to false, all layerables on this layer will be invisible. This function doesn't change the visibility property of the layerables (\ref QCPLayerable::setVisible), but the \ref QCPLayerable::realVisibility of each layerable takes the visibility of the parent layer into account. */ void QCPLayer::setVisible(bool visible) { mVisible = visible; } /*! Sets the rendering mode of this layer. If \a mode is set to \ref lmBuffered for a layer, it will be given a dedicated paint buffer by the parent QCustomPlot instance. This means it may be replotted individually by calling \ref QCPLayer::replot, without needing to replot all other layers. Layers which are set to \ref lmLogical (the default) are used only to define the rendering order and can't be replotted individually. Note that each layer which is set to \ref lmBuffered requires additional paint buffers for the layers below, above and for the layer itself. This increases the memory consumption and (slightly) decreases the repainting speed because multiple paint buffers need to be joined. So you should carefully choose which layers benefit from having their own paint buffer. A typical example would be a layer which contains certain layerables (e.g. items) that need to be changed and thus replotted regularly, while all other layerables on other layers stay static. By default, only the topmost layer called "overlay" is in mode \ref lmBuffered, and contains the selection rect. \see replot */ void QCPLayer::setMode(QCPLayer::LayerMode mode) { if (mMode != mode) { mMode = mode; if (QSharedPointer pb = mPaintBuffer.toStrongRef()) pb->setInvalidated(); } } /*! \internal Draws the contents of this layer with the provided \a painter. \see replot, drawToPaintBuffer */ void QCPLayer::draw(QCPPainter *painter) { foreach (QCPLayerable *child, mChildren) { if (child->realVisibility()) { painter->save(); painter->setClipRect(child->clipRect().translated(0, -1)); child->applyDefaultAntialiasingHint(painter); child->draw(painter); painter->restore(); } } } /*! \internal Draws the contents of this layer into the paint buffer which is associated with this layer. The association is established by the parent QCustomPlot, which manages all paint buffers (see \ref QCustomPlot::setupPaintBuffers). \see draw */ void QCPLayer::drawToPaintBuffer() { if (QSharedPointer pb = mPaintBuffer.toStrongRef()) { if (QCPPainter *painter = pb->startPainting()) { if (painter->isActive()) draw(painter); else qDebug() << Q_FUNC_INFO << "paint buffer returned inactive painter"; delete painter; pb->donePainting(); } else qDebug() << Q_FUNC_INFO << "paint buffer returned nullptr painter"; } else qDebug() << Q_FUNC_INFO << "no valid paint buffer associated with this layer"; } /*! If the layer mode (\ref setMode) is set to \ref lmBuffered, this method allows replotting only the layerables on this specific layer, without the need to replot all other layers (as a call to \ref QCustomPlot::replot would do). QCustomPlot also makes sure to replot all layers instead of only this one, if the layer ordering or any layerable-layer-association has changed since the last full replot and any other paint buffers were thus invalidated. If the layer mode is \ref lmLogical however, this method simply calls \ref QCustomPlot::replot on the parent QCustomPlot instance. \see draw */ void QCPLayer::replot() { if (mMode == lmBuffered && !mParentPlot->hasInvalidatedPaintBuffers()) { if (QSharedPointer pb = mPaintBuffer.toStrongRef()) { pb->clear(Qt::transparent); drawToPaintBuffer(); pb->setInvalidated(false); // since layer is lmBuffered, we know only this layer is on buffer and we can reset invalidated flag mParentPlot->update(); } else qDebug() << Q_FUNC_INFO << "no valid paint buffer associated with this layer"; } else mParentPlot->replot(); } /*! \internal Adds the \a layerable to the list of this layer. If \a prepend is set to true, the layerable will be prepended to the list, i.e. be drawn beneath the other layerables already in the list. This function does not change the \a mLayer member of \a layerable to this layer. (Use QCPLayerable::setLayer to change the layer of an object, not this function.) \see removeChild */ void QCPLayer::addChild(QCPLayerable *layerable, bool prepend) { if (!mChildren.contains(layerable)) { if (prepend) mChildren.prepend(layerable); else mChildren.append(layerable); if (QSharedPointer pb = mPaintBuffer.toStrongRef()) pb->setInvalidated(); } else qDebug() << Q_FUNC_INFO << "layerable is already child of this layer" << reinterpret_cast(layerable); } /*! \internal Removes the \a layerable from the list of this layer. This function does not change the \a mLayer member of \a layerable. (Use QCPLayerable::setLayer to change the layer of an object, not this function.) \see addChild */ void QCPLayer::removeChild(QCPLayerable *layerable) { if (mChildren.removeOne(layerable)) { if (QSharedPointer pb = mPaintBuffer.toStrongRef()) pb->setInvalidated(); } else qDebug() << Q_FUNC_INFO << "layerable is not child of this layer" << reinterpret_cast(layerable); } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLayerable //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLayerable \brief Base class for all drawable objects This is the abstract base class most visible objects derive from, e.g. plottables, axes, grid etc. Every layerable is on a layer (QCPLayer) which allows controlling the rendering order by stacking the layers accordingly. For details about the layering mechanism, see the QCPLayer documentation. */ /* start documentation of inline functions */ /*! \fn QCPLayerable *QCPLayerable::parentLayerable() const Returns the parent layerable of this layerable. The parent layerable is used to provide visibility hierarchies in conjunction with the method \ref realVisibility. This way, layerables only get drawn if their parent layerables are visible, too. Note that a parent layerable is not necessarily also the QObject parent for memory management. Further, a layerable doesn't always have a parent layerable, so this function may return \c nullptr. A parent layerable is set implicitly when placed inside layout elements and doesn't need to be set manually by the user. */ /* end documentation of inline functions */ /* start documentation of pure virtual functions */ /*! \fn virtual void QCPLayerable::applyDefaultAntialiasingHint(QCPPainter *painter) const = 0 \internal This function applies the default antialiasing setting to the specified \a painter, using the function \ref applyAntialiasingHint. It is the antialiasing state the painter is put in, when \ref draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the \ref draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint. First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function. Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The \ref QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the \ref draw function is called, and that's the state it wants to draw the line with. */ /*! \fn virtual void QCPLayerable::draw(QCPPainter *painter) const = 0 \internal This function draws the layerable with the specified \a painter. It is only called by QCustomPlot, if the layerable is visible (\ref setVisible). Before this function is called, the painter's antialiasing state is set via \ref applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to \ref clipRect. */ /* end documentation of pure virtual functions */ /* start documentation of signals */ /*! \fn void QCPLayerable::layerChanged(QCPLayer *newLayer); This signal is emitted when the layer of this layerable changes, i.e. this layerable is moved to a different layer. \see setLayer */ /* end documentation of signals */ /*! Creates a new QCPLayerable instance. Since QCPLayerable is an abstract base class, it can't be instantiated directly. Use one of the derived classes. If \a plot is provided, it automatically places itself on the layer named \a targetLayer. If \a targetLayer is an empty string, it places itself on the current layer of the plot (see \ref QCustomPlot::setCurrentLayer). It is possible to provide \c nullptr as \a plot. In that case, you should assign a parent plot at a later time with \ref initializeParentPlot. The layerable's parent layerable is set to \a parentLayerable, if provided. Direct layerable parents are mainly used to control visibility in a hierarchy of layerables. This means a layerable is only drawn, if all its ancestor layerables are also visible. Note that \a parentLayerable does not become the QObject-parent (for memory management) of this layerable, \a plot does. It is not uncommon to set the QObject-parent to something else in the constructors of QCPLayerable subclasses, to guarantee a working destruction hierarchy. */ QCPLayerable::QCPLayerable(QCustomPlot *plot, QString targetLayer, QCPLayerable *parentLayerable) : QObject(plot), mVisible(true), mParentPlot(plot), mParentLayerable(parentLayerable), mLayer(nullptr), mAntialiased(true) { if (mParentPlot) { if (targetLayer.isEmpty()) setLayer(mParentPlot->currentLayer()); else if (!setLayer(targetLayer)) qDebug() << Q_FUNC_INFO << "setting QCPlayerable initial layer to" << targetLayer << "failed."; } } QCPLayerable::~QCPLayerable() { if (mLayer) { mLayer->removeChild(this); mLayer = nullptr; } } /*! Sets the visibility of this layerable object. If an object is not visible, it will not be drawn on the QCustomPlot surface, and user interaction with it (e.g. click and selection) is not possible. */ void QCPLayerable::setVisible(bool on) { mVisible = on; } /*! Sets the \a layer of this layerable object. The object will be placed on top of the other objects already on \a layer. If \a layer is 0, this layerable will not be on any layer and thus not appear in the plot (or interact/receive events). Returns true if the layer of this layerable was successfully changed to \a layer. */ bool QCPLayerable::setLayer(QCPLayer *layer) { return moveToLayer(layer, false); } /*! \overload Sets the layer of this layerable object by name Returns true on success, i.e. if \a layerName is a valid layer name. */ bool QCPLayerable::setLayer(const QString &layerName) { if (!mParentPlot) { qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set"; return false; } if (QCPLayer *layer = mParentPlot->layer(layerName)) { return setLayer(layer); } else { qDebug() << Q_FUNC_INFO << "there is no layer with name" << layerName; return false; } } /*! Sets whether this object will be drawn antialiased or not. Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements. */ void QCPLayerable::setAntialiased(bool enabled) { mAntialiased = enabled; } /*! Returns whether this layerable is visible, taking the visibility of the layerable parent and the visibility of this layerable's layer into account. This is the method that is consulted to decide whether a layerable shall be drawn or not. If this layerable has a direct layerable parent (usually set via hierarchies implemented in subclasses, like in the case of \ref QCPLayoutElement), this function returns true only if this layerable has its visibility set to true and the parent layerable's \ref realVisibility returns true. */ bool QCPLayerable::realVisibility() const { return mVisible && (!mLayer || mLayer->visible()) && (!mParentLayerable || mParentLayerable.data()->realVisibility()); } /*! This function is used to decide whether a click hits a layerable object or not. \a pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if \a onlySelectable is true and the object is not selectable, -1.0 is returned, too. If the object is represented not by single lines but by an area like a \ref QCPItemText or the bars of a \ref QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99). Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance). The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the \ref selectEvent/\ref deselectEvent methods. \a details is an optional output parameter. Every layerable subclass may place any information in \a details. This information will be passed to \ref selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to \ref selectEvent will carry the \a details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in \ref selectTest. The result (i.e. the actually clicked part) can then be placed in \a details. So in the subsequent \ref selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation. In the case of 1D Plottables (\ref QCPAbstractPlottable1D, like \ref QCPGraph or \ref QCPBars) \a details will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. You may pass \c nullptr as \a details to indicate that you are not interested in those selection details. \see selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect */ double QCPLayerable::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(pos) Q_UNUSED(onlySelectable) Q_UNUSED(details) return -1.0; } /*! \internal Sets the parent plot of this layerable. Use this function once to set the parent plot if you have passed \c nullptr in the constructor. It can not be used to move a layerable from one QCustomPlot to another one. Note that, unlike when passing a non \c nullptr parent plot in the constructor, this function does not make \a parentPlot the QObject-parent of this layerable. If you want this, call QObject::setParent(\a parentPlot) in addition to this function. Further, you will probably want to set a layer (\ref setLayer) after calling this function, to make the layerable appear on the QCustomPlot. The parent plot change will be propagated to subclasses via a call to \ref parentPlotInitialized so they can react accordingly (e.g. also initialize the parent plot of child layerables, like QCPLayout does). */ void QCPLayerable::initializeParentPlot(QCustomPlot *parentPlot) { if (mParentPlot) { qDebug() << Q_FUNC_INFO << "called with mParentPlot already initialized"; return; } if (!parentPlot) qDebug() << Q_FUNC_INFO << "called with parentPlot zero"; mParentPlot = parentPlot; parentPlotInitialized(mParentPlot); } /*! \internal Sets the parent layerable of this layerable to \a parentLayerable. Note that \a parentLayerable does not become the QObject-parent (for memory management) of this layerable. The parent layerable has influence on the return value of the \ref realVisibility method. Only layerables with a fully visible parent tree will return true for \ref realVisibility, and thus be drawn. \see realVisibility */ void QCPLayerable::setParentLayerable(QCPLayerable *parentLayerable) { mParentLayerable = parentLayerable; } /*! \internal Moves this layerable object to \a layer. If \a prepend is true, this object will be prepended to the new layer's list, i.e. it will be drawn below the objects already on the layer. If it is false, the object will be appended. Returns true on success, i.e. if \a layer is a valid layer. */ bool QCPLayerable::moveToLayer(QCPLayer *layer, bool prepend) { if (layer && !mParentPlot) { qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set"; return false; } if (layer && layer->parentPlot() != mParentPlot) { qDebug() << Q_FUNC_INFO << "layer" << layer->name() << "is not in same QCustomPlot as this layerable"; return false; } QCPLayer *oldLayer = mLayer; if (mLayer) mLayer->removeChild(this); mLayer = layer; if (mLayer) mLayer->addChild(this, prepend); if (mLayer != oldLayer) emit layerChanged(mLayer); return true; } /*! \internal Sets the QCPainter::setAntialiasing state on the provided \a painter, depending on the \a localAntialiased value as well as the overrides \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. Which override enum this function takes into account is controlled via \a overrideElement. */ void QCPLayerable::applyAntialiasingHint(QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const { if (mParentPlot && mParentPlot->notAntialiasedElements().testFlag(overrideElement)) painter->setAntialiasing(false); else if (mParentPlot && mParentPlot->antialiasedElements().testFlag(overrideElement)) painter->setAntialiasing(true); else painter->setAntialiasing(localAntialiased); } /*! \internal This function is called by \ref initializeParentPlot, to allow subclasses to react on the setting of a parent plot. This is the case when \c nullptr was passed as parent plot in the constructor, and the parent plot is set at a later time. For example, QCPLayoutElement/QCPLayout hierarchies may be created independently of any QCustomPlot at first. When they are then added to a layout inside the QCustomPlot, the top level element of the hierarchy gets its parent plot initialized with \ref initializeParentPlot. To propagate the parent plot to all the children of the hierarchy, the top level element then uses this function to pass the parent plot on to its child elements. The default implementation does nothing. \see initializeParentPlot */ void QCPLayerable::parentPlotInitialized(QCustomPlot *parentPlot) { Q_UNUSED(parentPlot) } /*! \internal Returns the selection category this layerable shall belong to. The selection category is used in conjunction with \ref QCustomPlot::setInteractions to control which objects are selectable and which aren't. Subclasses that don't fit any of the normal \ref QCP::Interaction values can use \ref QCP::iSelectOther. This is what the default implementation returns. \see QCustomPlot::setInteractions */ QCP::Interaction QCPLayerable::selectionCategory() const { return QCP::iSelectOther; } /*! \internal Returns the clipping rectangle of this layerable object. By default, this is the viewport of the parent QCustomPlot. Specific subclasses may reimplement this function to provide different clipping rects. The returned clipping rect is set on the painter before the draw function of the respective object is called. */ QRect QCPLayerable::clipRect() const { if (mParentPlot) return mParentPlot->viewport(); else return {}; } /*! \internal This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing. \a event is the mouse event that caused the selection. \a additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see \ref QCustomPlot::setMultiSelectModifier). if \a additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected). Every selectEvent is preceded by a call to \ref selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The \a details data you output from \ref selectTest is fed back via \a details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually \a details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked. \a selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if \a additive is true, \a selectionStateChanged must also be set to true, because the selection toggles. If \a additive is false, \a selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state. \see selectTest, deselectEvent */ void QCPLayerable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) Q_UNUSED(additive) Q_UNUSED(details) Q_UNUSED(selectionStateChanged) } /*! \internal This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to \ref QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately. just as in \ref selectEvent, the output parameter \a selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively. \see selectTest, selectEvent */ void QCPLayerable::deselectEvent(bool *selectionStateChanged) { Q_UNUSED(selectionStateChanged) } /*! This event gets called when the user presses a mouse button while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to \ref selectTest. The current pixel position of the cursor on the QCustomPlot widget is accessible via \c event->pos(). The parameter \a details contains layerable-specific details about the hit, which were generated in the previous call to \ref selectTest. For example, One-dimensional plottables like \ref QCPGraph or \ref QCPBars convey the clicked data point in the \a details parameter, as \ref QCPDataSelection packed as QVariant. Multi-part objects convey the specific \c SelectablePart that was hit (e.g. \ref QCPAxis::SelectablePart in the case of axes). QCustomPlot uses an event propagation system that works the same as Qt's system. If your layerable doesn't reimplement the \ref mousePressEvent or explicitly calls \c event->ignore() in its reimplementation, the event will be propagated to the next layerable in the stacking order. Once a layerable has accepted the \ref mousePressEvent, it is considered the mouse grabber and will receive all following calls to \ref mouseMoveEvent or \ref mouseReleaseEvent for this mouse interaction (a "mouse interaction" in this context ends with the release). The default implementation does nothing except explicitly ignoring the event with \c event->ignore(). \see mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent */ void QCPLayerable::mousePressEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) event->ignore(); } /*! This event gets called when the user moves the mouse while holding a mouse button, after this layerable has become the mouse grabber by accepting the preceding \ref mousePressEvent. The current pixel position of the cursor on the QCustomPlot widget is accessible via \c event->pos(). The parameter \a startPos indicates the position where the initial \ref mousePressEvent occurred, that started the mouse interaction. The default implementation does nothing. \see mousePressEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent */ void QCPLayerable::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(startPos) event->ignore(); } /*! This event gets called when the user releases the mouse button, after this layerable has become the mouse grabber by accepting the preceding \ref mousePressEvent. The current pixel position of the cursor on the QCustomPlot widget is accessible via \c event->pos(). The parameter \a startPos indicates the position where the initial \ref mousePressEvent occurred, that started the mouse interaction. The default implementation does nothing. \see mousePressEvent, mouseMoveEvent, mouseDoubleClickEvent, wheelEvent */ void QCPLayerable::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(startPos) event->ignore(); } /*! This event gets called when the user presses the mouse button a second time in a double-click, while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to \ref selectTest. The \ref mouseDoubleClickEvent is called instead of the second \ref mousePressEvent. So in the case of a double-click, the event succession is pressEvent – releaseEvent – doubleClickEvent – releaseEvent. The current pixel position of the cursor on the QCustomPlot widget is accessible via \c event->pos(). The parameter \a details contains layerable-specific details about the hit, which were generated in the previous call to \ref selectTest. For example, One-dimensional plottables like \ref QCPGraph or \ref QCPBars convey the clicked data point in the \a details parameter, as \ref QCPDataSelection packed as QVariant. Multi-part objects convey the specific \c SelectablePart that was hit (e.g. \ref QCPAxis::SelectablePart in the case of axes). Similarly to \ref mousePressEvent, once a layerable has accepted the \ref mouseDoubleClickEvent, it is considered the mouse grabber and will receive all following calls to \ref mouseMoveEvent and \ref mouseReleaseEvent for this mouse interaction (a "mouse interaction" in this context ends with the release). The default implementation does nothing except explicitly ignoring the event with \c event->ignore(). \see mousePressEvent, mouseMoveEvent, mouseReleaseEvent, wheelEvent */ void QCPLayerable::mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) event->ignore(); } /*! This event gets called when the user turns the mouse scroll wheel while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to \ref selectTest. The current pixel position of the cursor on the QCustomPlot widget is accessible via \c event->pos(). The \c event->angleDelta() indicates how far the mouse wheel was turned, which is usually +/- 120 for single rotation steps. However, if the mouse wheel is turned rapidly, multiple steps may accumulate to one event, making the delta larger. On the other hand, if the wheel has very smooth steps or none at all, the delta may be smaller. The default implementation does nothing. \see mousePressEvent, mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent */ void QCPLayerable::wheelEvent(QWheelEvent *event) { event->ignore(); } /* end of 'src/layer.cpp' */ /* including file 'src/axis/range.cpp' */ /* modified 2021-03-29T02:30:44, size 12221 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPRange //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPRange \brief Represents the range an axis is encompassing. contains a \a lower and \a upper double value and provides convenience input, output and modification functions. \see QCPAxis::setRange */ /* start of documentation of inline functions */ /*! \fn double QCPRange::size() const Returns the size of the range, i.e. \a upper-\a lower */ /*! \fn double QCPRange::center() const Returns the center of the range, i.e. (\a upper+\a lower)*0.5 */ /*! \fn void QCPRange::normalize() Makes sure \a lower is numerically smaller than \a upper. If this is not the case, the values are swapped. */ /*! \fn bool QCPRange::contains(double value) const Returns true when \a value lies within or exactly on the borders of the range. */ /*! \fn QCPRange &QCPRange::operator+=(const double& value) Adds \a value to both boundaries of the range. */ /*! \fn QCPRange &QCPRange::operator-=(const double& value) Subtracts \a value from both boundaries of the range. */ /*! \fn QCPRange &QCPRange::operator*=(const double& value) Multiplies both boundaries of the range by \a value. */ /*! \fn QCPRange &QCPRange::operator/=(const double& value) Divides both boundaries of the range by \a value. */ /* end of documentation of inline functions */ /*! Minimum range size (\a upper - \a lower) the range changing functions will accept. Smaller intervals would cause errors due to the 11-bit exponent of double precision numbers, corresponding to a minimum magnitude of roughly 1e-308. \warning Do not use this constant to indicate "arbitrarily small" values in plotting logic (as values that will appear in the plot)! It is intended only as a bound to compare against, e.g. to prevent axis ranges from obtaining underflowing ranges. \see validRange, maxRange */ const double QCPRange::minRange = 1e-280; /*! Maximum values (negative and positive) the range will accept in range-changing functions. Larger absolute values would cause errors due to the 11-bit exponent of double precision numbers, corresponding to a maximum magnitude of roughly 1e308. \warning Do not use this constant to indicate "arbitrarily large" values in plotting logic (as values that will appear in the plot)! It is intended only as a bound to compare against, e.g. to prevent axis ranges from obtaining overflowing ranges. \see validRange, minRange */ const double QCPRange::maxRange = 1e250; /*! Constructs a range with \a lower and \a upper set to zero. */ QCPRange::QCPRange() : lower(0), upper(0) { } /*! \overload Constructs a range with the specified \a lower and \a upper values. The resulting range will be normalized (see \ref normalize), so if \a lower is not numerically smaller than \a upper, they will be swapped. */ QCPRange::QCPRange(double lower, double upper) : lower(lower), upper(upper) { normalize(); } /*! \overload Expands this range such that \a otherRange is contained in the new range. It is assumed that both this range and \a otherRange are normalized (see \ref normalize). If this range contains NaN as lower or upper bound, it will be replaced by the respective bound of \a otherRange. If \a otherRange is already inside the current range, this function does nothing. \see expanded */ void QCPRange::expand(const QCPRange &otherRange) { if (lower > otherRange.lower || qIsNaN(lower)) lower = otherRange.lower; if (upper < otherRange.upper || qIsNaN(upper)) upper = otherRange.upper; } /*! \overload Expands this range such that \a includeCoord is contained in the new range. It is assumed that this range is normalized (see \ref normalize). If this range contains NaN as lower or upper bound, the respective bound will be set to \a includeCoord. If \a includeCoord is already inside the current range, this function does nothing. \see expand */ void QCPRange::expand(double includeCoord) { if (lower > includeCoord || qIsNaN(lower)) lower = includeCoord; if (upper < includeCoord || qIsNaN(upper)) upper = includeCoord; } /*! \overload Returns an expanded range that contains this and \a otherRange. It is assumed that both this range and \a otherRange are normalized (see \ref normalize). If this range contains NaN as lower or upper bound, the returned range's bound will be taken from \a otherRange. \see expand */ QCPRange QCPRange::expanded(const QCPRange &otherRange) const { QCPRange result = *this; result.expand(otherRange); return result; } /*! \overload Returns an expanded range that includes the specified \a includeCoord. It is assumed that this range is normalized (see \ref normalize). If this range contains NaN as lower or upper bound, the returned range's bound will be set to \a includeCoord. \see expand */ QCPRange QCPRange::expanded(double includeCoord) const { QCPRange result = *this; result.expand(includeCoord); return result; } /*! Returns this range, possibly modified to not exceed the bounds provided as \a lowerBound and \a upperBound. If possible, the size of the current range is preserved in the process. If the range shall only be bounded at the lower side, you can set \a upperBound to \ref QCPRange::maxRange. If it shall only be bounded at the upper side, set \a lowerBound to -\ref QCPRange::maxRange. */ QCPRange QCPRange::bounded(double lowerBound, double upperBound) const { if (lowerBound > upperBound) qSwap(lowerBound, upperBound); QCPRange result(lower, upper); if (result.lower < lowerBound) { result.lower = lowerBound; result.upper = lowerBound + size(); if (result.upper > upperBound || qFuzzyCompare(size(), upperBound-lowerBound)) result.upper = upperBound; } else if (result.upper > upperBound) { result.upper = upperBound; result.lower = upperBound - size(); if (result.lower < lowerBound || qFuzzyCompare(size(), upperBound-lowerBound)) result.lower = lowerBound; } return result; } /*! Returns a sanitized version of the range. Sanitized means for logarithmic scales, that the range won't span the positive and negative sign domain, i.e. contain zero. Further \a lower will always be numerically smaller (or equal) to \a upper. If the original range does span positive and negative sign domains or contains zero, the returned range will try to approximate the original range as good as possible. If the positive interval of the original range is wider than the negative interval, the returned range will only contain the positive interval, with lower bound set to \a rangeFac or \a rangeFac *\a upper, whichever is closer to zero. Same procedure is used if the negative interval is wider than the positive interval, this time by changing the \a upper bound. */ QCPRange QCPRange::sanitizedForLogScale() const { double rangeFac = 1e-3; QCPRange sanitizedRange(lower, upper); sanitizedRange.normalize(); // can't have range spanning negative and positive values in log plot, so change range to fix it //if (qFuzzyCompare(sanitizedRange.lower+1, 1) && !qFuzzyCompare(sanitizedRange.upper+1, 1)) if (sanitizedRange.lower == 0.0 && sanitizedRange.upper != 0.0) { // case lower is 0 if (rangeFac < sanitizedRange.upper*rangeFac) sanitizedRange.lower = rangeFac; else sanitizedRange.lower = sanitizedRange.upper*rangeFac; } //else if (!qFuzzyCompare(lower+1, 1) && qFuzzyCompare(upper+1, 1)) else if (sanitizedRange.lower != 0.0 && sanitizedRange.upper == 0.0) { // case upper is 0 if (-rangeFac > sanitizedRange.lower*rangeFac) sanitizedRange.upper = -rangeFac; else sanitizedRange.upper = sanitizedRange.lower*rangeFac; } else if (sanitizedRange.lower < 0 && sanitizedRange.upper > 0) { // find out whether negative or positive interval is wider to decide which sign domain will be chosen if (-sanitizedRange.lower > sanitizedRange.upper) { // negative is wider, do same as in case upper is 0 if (-rangeFac > sanitizedRange.lower*rangeFac) sanitizedRange.upper = -rangeFac; else sanitizedRange.upper = sanitizedRange.lower*rangeFac; } else { // positive is wider, do same as in case lower is 0 if (rangeFac < sanitizedRange.upper*rangeFac) sanitizedRange.lower = rangeFac; else sanitizedRange.lower = sanitizedRange.upper*rangeFac; } } // due to normalization, case lower>0 && upper<0 should never occur, because that implies upper -maxRange && upper < maxRange && qAbs(lower-upper) > minRange && qAbs(lower-upper) < maxRange && !(lower > 0 && qIsInf(upper/lower)) && !(upper < 0 && qIsInf(lower/upper))); } /*! \overload Checks, whether the specified range is within valid bounds, which are defined as QCPRange::maxRange and QCPRange::minRange. A valid range means: \li range bounds within -maxRange and maxRange \li range size above minRange \li range size below maxRange */ bool QCPRange::validRange(const QCPRange &range) { return (range.lower > -maxRange && range.upper < maxRange && qAbs(range.lower-range.upper) > minRange && qAbs(range.lower-range.upper) < maxRange && !(range.lower > 0 && qIsInf(range.upper/range.lower)) && !(range.upper < 0 && qIsInf(range.lower/range.upper))); } /* end of 'src/axis/range.cpp' */ /* including file 'src/selection.cpp' */ /* modified 2021-03-29T02:30:44, size 21837 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPDataRange //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPDataRange \brief Describes a data range given by begin and end index QCPDataRange holds two integers describing the begin (\ref setBegin) and end (\ref setEnd) index of a contiguous set of data points. The \a end index corresponds to the data point just after the last data point of the data range, like in standard iterators. Data Ranges are not bound to a certain plottable, thus they can be freely exchanged, created and modified. If a non-contiguous data set shall be described, the class \ref QCPDataSelection is used, which holds and manages multiple instances of \ref QCPDataRange. In most situations, \ref QCPDataSelection is thus used. Both \ref QCPDataRange and \ref QCPDataSelection offer convenience methods to work with them, e.g. \ref bounded, \ref expanded, \ref intersects, \ref intersection, \ref adjusted, \ref contains. Further, addition and subtraction operators (defined in \ref QCPDataSelection) can be used to join/subtract data ranges and data selections (or mixtures), to retrieve a corresponding \ref QCPDataSelection. %QCustomPlot's \ref dataselection "data selection mechanism" is based on \ref QCPDataSelection and QCPDataRange. \note Do not confuse \ref QCPDataRange with \ref QCPRange. A \ref QCPRange describes an interval in floating point plot coordinates, e.g. the current axis range. */ /* start documentation of inline functions */ /*! \fn int QCPDataRange::size() const Returns the number of data points described by this data range. This is equal to the end index minus the begin index. \see length */ /*! \fn int QCPDataRange::length() const Returns the number of data points described by this data range. Equivalent to \ref size. */ /*! \fn void QCPDataRange::setBegin(int begin) Sets the begin of this data range. The \a begin index points to the first data point that is part of the data range. No checks or corrections are made to ensure the resulting range is valid (\ref isValid). \see setEnd */ /*! \fn void QCPDataRange::setEnd(int end) Sets the end of this data range. The \a end index points to the data point just after the last data point that is part of the data range. No checks or corrections are made to ensure the resulting range is valid (\ref isValid). \see setBegin */ /*! \fn bool QCPDataRange::isValid() const Returns whether this range is valid. A valid range has a begin index greater or equal to 0, and an end index greater or equal to the begin index. \note Invalid ranges should be avoided and are never the result of any of QCustomPlot's methods (unless they are themselves fed with invalid ranges). Do not pass invalid ranges to QCustomPlot's methods. The invalid range is not inherently prevented in QCPDataRange, to allow temporary invalid begin/end values while manipulating the range. An invalid range is not necessarily empty (\ref isEmpty), since its \ref length can be negative and thus non-zero. */ /*! \fn bool QCPDataRange::isEmpty() const Returns whether this range is empty, i.e. whether its begin index equals its end index. \see size, length */ /*! \fn QCPDataRange QCPDataRange::adjusted(int changeBegin, int changeEnd) const Returns a data range where \a changeBegin and \a changeEnd were added to the begin and end indices, respectively. */ /* end documentation of inline functions */ /*! Creates an empty QCPDataRange, with begin and end set to 0. */ QCPDataRange::QCPDataRange() : mBegin(0), mEnd(0) { } /*! Creates a QCPDataRange, initialized with the specified \a begin and \a end. No checks or corrections are made to ensure the resulting range is valid (\ref isValid). */ QCPDataRange::QCPDataRange(int begin, int end) : mBegin(begin), mEnd(end) { } /*! Returns a data range that matches this data range, except that parts exceeding \a other are excluded. This method is very similar to \ref intersection, with one distinction: If this range and the \a other range share no intersection, the returned data range will be empty with begin and end set to the respective boundary side of \a other, at which this range is residing. (\ref intersection would just return a range with begin and end set to 0.) */ QCPDataRange QCPDataRange::bounded(const QCPDataRange &other) const { QCPDataRange result(intersection(other)); if (result.isEmpty()) // no intersection, preserve respective bounding side of otherRange as both begin and end of return value { if (mEnd <= other.mBegin) result = QCPDataRange(other.mBegin, other.mBegin); else result = QCPDataRange(other.mEnd, other.mEnd); } return result; } /*! Returns a data range that contains both this data range as well as \a other. */ QCPDataRange QCPDataRange::expanded(const QCPDataRange &other) const { return {qMin(mBegin, other.mBegin), qMax(mEnd, other.mEnd)}; } /*! Returns the data range which is contained in both this data range and \a other. This method is very similar to \ref bounded, with one distinction: If this range and the \a other range share no intersection, the returned data range will be empty with begin and end set to 0. (\ref bounded would return a range with begin and end set to one of the boundaries of \a other, depending on which side this range is on.) \see QCPDataSelection::intersection */ QCPDataRange QCPDataRange::intersection(const QCPDataRange &other) const { QCPDataRange result(qMax(mBegin, other.mBegin), qMin(mEnd, other.mEnd)); if (result.isValid()) return result; else return {}; } /*! Returns whether this data range and \a other share common data points. \see intersection, contains */ bool QCPDataRange::intersects(const QCPDataRange &other) const { return !( (mBegin > other.mBegin && mBegin >= other.mEnd) || (mEnd <= other.mBegin && mEnd < other.mEnd) ); } /*! Returns whether all data points of \a other are also contained inside this data range. \see intersects */ bool QCPDataRange::contains(const QCPDataRange &other) const { return mBegin <= other.mBegin && mEnd >= other.mEnd; } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPDataSelection //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPDataSelection \brief Describes a data set by holding multiple QCPDataRange instances QCPDataSelection manages multiple instances of QCPDataRange in order to represent any (possibly disjoint) set of data selection. The data selection can be modified with addition and subtraction operators which take QCPDataSelection and QCPDataRange instances, as well as methods such as \ref addDataRange and \ref clear. Read access is provided by \ref dataRange, \ref dataRanges, \ref dataRangeCount, etc. The method \ref simplify is used to join directly adjacent or even overlapping QCPDataRange instances. QCPDataSelection automatically simplifies when using the addition/subtraction operators. The only case when \ref simplify is left to the user, is when calling \ref addDataRange, with the parameter \a simplify explicitly set to false. This is useful if many data ranges will be added to the selection successively and the overhead for simplifying after each iteration shall be avoided. In this case, you should make sure to call \ref simplify after completing the operation. Use \ref enforceType to bring the data selection into a state complying with the constraints for selections defined in \ref QCP::SelectionType. %QCustomPlot's \ref dataselection "data selection mechanism" is based on QCPDataSelection and QCPDataRange. \section qcpdataselection-iterating Iterating over a data selection As an example, the following code snippet calculates the average value of a graph's data \ref QCPAbstractPlottable::selection "selection": \snippet documentation/doc-code-snippets/mainwindow.cpp qcpdataselection-iterating-1 */ /* start documentation of inline functions */ /*! \fn int QCPDataSelection::dataRangeCount() const Returns the number of ranges that make up the data selection. The ranges can be accessed by \ref dataRange via their index. \see dataRange, dataPointCount */ /*! \fn QList QCPDataSelection::dataRanges() const Returns all data ranges that make up the data selection. If the data selection is simplified (the usual state of the selection, see \ref simplify), the ranges are sorted by ascending data point index. \see dataRange */ /*! \fn bool QCPDataSelection::isEmpty() const Returns true if there are no data ranges, and thus no data points, in this QCPDataSelection instance. \see dataRangeCount */ /* end documentation of inline functions */ /*! Creates an empty QCPDataSelection. */ QCPDataSelection::QCPDataSelection() { } /*! Creates a QCPDataSelection containing the provided \a range. */ QCPDataSelection::QCPDataSelection(const QCPDataRange &range) { mDataRanges.append(range); } /*! Returns true if this selection is identical (contains the same data ranges with the same begin and end indices) to \a other. Note that both data selections must be in simplified state (the usual state of the selection, see \ref simplify) for this operator to return correct results. */ bool QCPDataSelection::operator==(const QCPDataSelection &other) const { if (mDataRanges.size() != other.mDataRanges.size()) return false; for (int i=0; i= other.end()) break; // since data ranges are sorted after the simplify() call, no ranges which contain other will come after this if (thisEnd > other.begin()) // ranges which don't fulfill this are entirely before other and can be ignored { if (thisBegin >= other.begin()) // range leading segment is encompassed { if (thisEnd <= other.end()) // range fully encompassed, remove completely { mDataRanges.removeAt(i); continue; } else // only leading segment is encompassed, trim accordingly mDataRanges[i].setBegin(other.end()); } else // leading segment is not encompassed { if (thisEnd <= other.end()) // only trailing segment is encompassed, trim accordingly { mDataRanges[i].setEnd(other.begin()); } else // other lies inside this range, so split range { mDataRanges[i].setEnd(other.begin()); mDataRanges.insert(i+1, QCPDataRange(other.end(), thisEnd)); break; // since data ranges are sorted (and don't overlap) after simplify() call, we're done here } } } ++i; } return *this; } /*! Returns the total number of data points contained in all data ranges that make up this data selection. */ int QCPDataSelection::dataPointCount() const { int result = 0; foreach (QCPDataRange dataRange, mDataRanges) result += dataRange.length(); return result; } /*! Returns the data range with the specified \a index. If the data selection is simplified (the usual state of the selection, see \ref simplify), the ranges are sorted by ascending data point index. \see dataRangeCount */ QCPDataRange QCPDataSelection::dataRange(int index) const { if (index >= 0 && index < mDataRanges.size()) { return mDataRanges.at(index); } else { qDebug() << Q_FUNC_INFO << "index out of range:" << index; return {}; } } /*! Returns a \ref QCPDataRange which spans the entire data selection, including possible intermediate segments which are not part of the original data selection. */ QCPDataRange QCPDataSelection::span() const { if (isEmpty()) return {}; else return {mDataRanges.first().begin(), mDataRanges.last().end()}; } /*! Adds the given \a dataRange to this data selection. This is equivalent to the += operator but allows disabling immediate simplification by setting \a simplify to false. This can improve performance if adding a very large amount of data ranges successively. In this case, make sure to call \ref simplify manually, after the operation. */ void QCPDataSelection::addDataRange(const QCPDataRange &dataRange, bool simplify) { mDataRanges.append(dataRange); if (simplify) this->simplify(); } /*! Removes all data ranges. The data selection then contains no data points. \ref isEmpty */ void QCPDataSelection::clear() { mDataRanges.clear(); } /*! Sorts all data ranges by range begin index in ascending order, and then joins directly adjacent or overlapping ranges. This can reduce the number of individual data ranges in the selection, and prevents possible double-counting when iterating over the data points held by the data ranges. This method is automatically called when using the addition/subtraction operators. The only case when \ref simplify is left to the user, is when calling \ref addDataRange, with the parameter \a simplify explicitly set to false. */ void QCPDataSelection::simplify() { // remove any empty ranges: for (int i=mDataRanges.size()-1; i>=0; --i) { if (mDataRanges.at(i).isEmpty()) mDataRanges.removeAt(i); } if (mDataRanges.isEmpty()) return; // sort ranges by starting value, ascending: std::sort(mDataRanges.begin(), mDataRanges.end(), lessThanDataRangeBegin); // join overlapping/contiguous ranges: int i = 1; while (i < mDataRanges.size()) { if (mDataRanges.at(i-1).end() >= mDataRanges.at(i).begin()) // range i overlaps/joins with i-1, so expand range i-1 appropriately and remove range i from list { mDataRanges[i-1].setEnd(qMax(mDataRanges.at(i-1).end(), mDataRanges.at(i).end())); mDataRanges.removeAt(i); } else ++i; } } /*! Makes sure this data selection conforms to the specified \a type selection type. Before the type is enforced, \ref simplify is called. Depending on \a type, enforcing means adding new data points that were previously not part of the selection, or removing data points from the selection. If the current selection already conforms to \a type, the data selection is not changed. \see QCP::SelectionType */ void QCPDataSelection::enforceType(QCP::SelectionType type) { simplify(); switch (type) { case QCP::stNone: { mDataRanges.clear(); break; } case QCP::stWhole: { // whole selection isn't defined by data range, so don't change anything (is handled in plottable methods) break; } case QCP::stSingleData: { // reduce all data ranges to the single first data point: if (!mDataRanges.isEmpty()) { if (mDataRanges.size() > 1) mDataRanges = QList() << mDataRanges.first(); if (mDataRanges.first().length() > 1) mDataRanges.first().setEnd(mDataRanges.first().begin()+1); } break; } case QCP::stDataRange: { if (!isEmpty()) mDataRanges = QList() << span(); break; } case QCP::stMultipleDataRanges: { // this is the selection type that allows all concievable combinations of ranges, so do nothing break; } } } /*! Returns true if the data selection \a other is contained entirely in this data selection, i.e. all data point indices that are in \a other are also in this data selection. \see QCPDataRange::contains */ bool QCPDataSelection::contains(const QCPDataSelection &other) const { if (other.isEmpty()) return false; int otherIndex = 0; int thisIndex = 0; while (thisIndex < mDataRanges.size() && otherIndex < other.mDataRanges.size()) { if (mDataRanges.at(thisIndex).contains(other.mDataRanges.at(otherIndex))) ++otherIndex; else ++thisIndex; } return thisIndex < mDataRanges.size(); // if thisIndex ran all the way to the end to find a containing range for the current otherIndex, other is not contained in this } /*! Returns a data selection containing the points which are both in this data selection and in the data range \a other. A common use case is to limit an unknown data selection to the valid range of a data container, using \ref QCPDataContainer::dataRange as \a other. One can then safely iterate over the returned data selection without exceeding the data container's bounds. */ QCPDataSelection QCPDataSelection::intersection(const QCPDataRange &other) const { QCPDataSelection result; foreach (QCPDataRange dataRange, mDataRanges) result.addDataRange(dataRange.intersection(other), false); result.simplify(); return result; } /*! Returns a data selection containing the points which are both in this data selection and in the data selection \a other. */ QCPDataSelection QCPDataSelection::intersection(const QCPDataSelection &other) const { QCPDataSelection result; for (int i=0; iorientation() == Qt::Horizontal) return {axis->pixelToCoord(mRect.left()), axis->pixelToCoord(mRect.left()+mRect.width())}; else return {axis->pixelToCoord(mRect.top()+mRect.height()), axis->pixelToCoord(mRect.top())}; } else { qDebug() << Q_FUNC_INFO << "called with axis zero"; return {}; } } /*! Sets the pen that will be used to draw the selection rect outline. \see setBrush */ void QCPSelectionRect::setPen(const QPen &pen) { mPen = pen; } /*! Sets the brush that will be used to fill the selection rect. By default the selection rect is not filled, i.e. \a brush is Qt::NoBrush. \see setPen */ void QCPSelectionRect::setBrush(const QBrush &brush) { mBrush = brush; } /*! If there is currently a selection interaction going on (\ref isActive), the interaction is canceled. The selection rect will emit the \ref canceled signal. */ void QCPSelectionRect::cancel() { if (mActive) { mActive = false; emit canceled(mRect, nullptr); } } /*! \internal This method is called by QCustomPlot to indicate that a selection rect interaction was initiated. The default implementation sets the selection rect to active, initializes the selection rect geometry and emits the \ref started signal. */ void QCPSelectionRect::startSelection(QMouseEvent *event) { mActive = true; mRect = QRect(event->pos(), event->pos()); emit started(event); } /*! \internal This method is called by QCustomPlot to indicate that an ongoing selection rect interaction needs to update its geometry. The default implementation updates the rect and emits the \ref changed signal. */ void QCPSelectionRect::moveSelection(QMouseEvent *event) { mRect.setBottomRight(event->pos()); emit changed(mRect, event); layer()->replot(); } /*! \internal This method is called by QCustomPlot to indicate that an ongoing selection rect interaction has finished by the user releasing the mouse button. The default implementation deactivates the selection rect and emits the \ref accepted signal. */ void QCPSelectionRect::endSelection(QMouseEvent *event) { mRect.setBottomRight(event->pos()); mActive = false; emit accepted(mRect, event); } /*! \internal This method is called by QCustomPlot when a key has been pressed by the user while the selection rect interaction is active. The default implementation allows to \ref cancel the interaction by hitting the escape key. */ void QCPSelectionRect::keyPressEvent(QKeyEvent *event) { if (event->key() == Qt::Key_Escape && mActive) { mActive = false; emit canceled(mRect, event); } } /* inherits documentation from base class */ void QCPSelectionRect::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeOther); } /*! \internal If the selection rect is active (\ref isActive), draws the selection rect defined by \a mRect. \seebaseclassmethod */ void QCPSelectionRect::draw(QCPPainter *painter) { if (mActive) { painter->setPen(mPen); painter->setBrush(mBrush); painter->drawRect(mRect); } } /* end of 'src/selectionrect.cpp' */ /* including file 'src/layout.cpp' */ /* modified 2021-03-29T02:30:44, size 78863 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPMarginGroup //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPMarginGroup \brief A margin group allows synchronization of margin sides if working with multiple layout elements. QCPMarginGroup allows you to tie a margin side of two or more layout elements together, such that they will all have the same size, based on the largest required margin in the group. \n \image html QCPMarginGroup.png "Demonstration of QCPMarginGroup" \n In certain situations it is desirable that margins at specific sides are synchronized across layout elements. For example, if one QCPAxisRect is below another one in a grid layout, it will provide a cleaner look to the user if the left and right margins of the two axis rects are of the same size. The left axis of the top axis rect will then be at the same horizontal position as the left axis of the lower axis rect, making them appear aligned. The same applies for the right axes. This is what QCPMarginGroup makes possible. To add/remove a specific side of a layout element to/from a margin group, use the \ref QCPLayoutElement::setMarginGroup method. To completely break apart the margin group, either call \ref clear, or just delete the margin group. \section QCPMarginGroup-example Example First create a margin group: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpmargingroup-creation-1 Then set this group on the layout element sides: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpmargingroup-creation-2 Here, we've used the first two axis rects of the plot and synchronized their left margins with each other and their right margins with each other. */ /* start documentation of inline functions */ /*! \fn QList QCPMarginGroup::elements(QCP::MarginSide side) const Returns a list of all layout elements that have their margin \a side associated with this margin group. */ /* end documentation of inline functions */ /*! Creates a new QCPMarginGroup instance in \a parentPlot. */ QCPMarginGroup::QCPMarginGroup(QCustomPlot *parentPlot) : QObject(parentPlot), mParentPlot(parentPlot) { mChildren.insert(QCP::msLeft, QList()); mChildren.insert(QCP::msRight, QList()); mChildren.insert(QCP::msTop, QList()); mChildren.insert(QCP::msBottom, QList()); } QCPMarginGroup::~QCPMarginGroup() { clear(); } /*! Returns whether this margin group is empty. If this function returns true, no layout elements use this margin group to synchronize margin sides. */ bool QCPMarginGroup::isEmpty() const { QHashIterator > it(mChildren); while (it.hasNext()) { it.next(); if (!it.value().isEmpty()) return false; } return true; } /*! Clears this margin group. The synchronization of the margin sides that use this margin group is lifted and they will use their individual margin sizes again. */ void QCPMarginGroup::clear() { // make all children remove themselves from this margin group: QHashIterator > it(mChildren); while (it.hasNext()) { it.next(); const QList elements = it.value(); for (int i=elements.size()-1; i>=0; --i) elements.at(i)->setMarginGroup(it.key(), nullptr); // removes itself from mChildren via removeChild } } /*! \internal Returns the synchronized common margin for \a side. This is the margin value that will be used by the layout element on the respective side, if it is part of this margin group. The common margin is calculated by requesting the automatic margin (\ref QCPLayoutElement::calculateAutoMargin) of each element associated with \a side in this margin group, and choosing the largest returned value. (QCPLayoutElement::minimumMargins is taken into account, too.) */ int QCPMarginGroup::commonMargin(QCP::MarginSide side) const { // query all automatic margins of the layout elements in this margin group side and find maximum: int result = 0; foreach (QCPLayoutElement *el, mChildren.value(side)) { if (!el->autoMargins().testFlag(side)) continue; int m = qMax(el->calculateAutoMargin(side), QCP::getMarginValue(el->minimumMargins(), side)); if (m > result) result = m; } return result; } /*! \internal Adds \a element to the internal list of child elements, for the margin \a side. This function does not modify the margin group property of \a element. */ void QCPMarginGroup::addChild(QCP::MarginSide side, QCPLayoutElement *element) { if (!mChildren[side].contains(element)) mChildren[side].append(element); else qDebug() << Q_FUNC_INFO << "element is already child of this margin group side" << reinterpret_cast(element); } /*! \internal Removes \a element from the internal list of child elements, for the margin \a side. This function does not modify the margin group property of \a element. */ void QCPMarginGroup::removeChild(QCP::MarginSide side, QCPLayoutElement *element) { if (!mChildren[side].removeOne(element)) qDebug() << Q_FUNC_INFO << "element is not child of this margin group side" << reinterpret_cast(element); } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLayoutElement //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLayoutElement \brief The abstract base class for all objects that form \ref thelayoutsystem "the layout system". This is an abstract base class. As such, it can't be instantiated directly, rather use one of its subclasses. A Layout element is a rectangular object which can be placed in layouts. It has an outer rect (QCPLayoutElement::outerRect) and an inner rect (\ref QCPLayoutElement::rect). The difference between outer and inner rect is called its margin. The margin can either be set to automatic or manual (\ref setAutoMargins) on a per-side basis. If a side is set to manual, that margin can be set explicitly with \ref setMargins and will stay fixed at that value. If it's set to automatic, the layout element subclass will control the value itself (via \ref calculateAutoMargin). Layout elements can be placed in layouts (base class QCPLayout) like QCPLayoutGrid. The top level layout is reachable via \ref QCustomPlot::plotLayout, and is a \ref QCPLayoutGrid. Since \ref QCPLayout itself derives from \ref QCPLayoutElement, layouts can be nested. Thus in QCustomPlot one can divide layout elements into two categories: The ones that are invisible by themselves, because they don't draw anything. Their only purpose is to manage the position and size of other layout elements. This category of layout elements usually use QCPLayout as base class. Then there is the category of layout elements which actually draw something. For example, QCPAxisRect, QCPLegend and QCPTextElement are of this category. This does not necessarily mean that the latter category can't have child layout elements. QCPLegend for instance, actually derives from QCPLayoutGrid and the individual legend items are child layout elements in the grid layout. */ /* start documentation of inline functions */ /*! \fn QCPLayout *QCPLayoutElement::layout() const Returns the parent layout of this layout element. */ /*! \fn QRect QCPLayoutElement::rect() const Returns the inner rect of this layout element. The inner rect is the outer rect (\ref outerRect, \ref setOuterRect) shrinked by the margins (\ref setMargins, \ref setAutoMargins). In some cases, the area between outer and inner rect is left blank. In other cases the margin area is used to display peripheral graphics while the main content is in the inner rect. This is where automatic margin calculation becomes interesting because it allows the layout element to adapt the margins to the peripheral graphics it wants to draw. For example, \ref QCPAxisRect draws the axis labels and tick labels in the margin area, thus needs to adjust the margins (if \ref setAutoMargins is enabled) according to the space required by the labels of the axes. \see outerRect */ /*! \fn QRect QCPLayoutElement::outerRect() const Returns the outer rect of this layout element. The outer rect is the inner rect expanded by the margins (\ref setMargins, \ref setAutoMargins). The outer rect is used (and set via \ref setOuterRect) by the parent \ref QCPLayout to control the size of this layout element. \see rect */ /* end documentation of inline functions */ /*! Creates an instance of QCPLayoutElement and sets default values. */ QCPLayoutElement::QCPLayoutElement(QCustomPlot *parentPlot) : QCPLayerable(parentPlot), // parenthood is changed as soon as layout element gets inserted into a layout (except for top level layout) mParentLayout(nullptr), mMinimumSize(), mMaximumSize(QWIDGETSIZE_MAX, QWIDGETSIZE_MAX), mSizeConstraintRect(scrInnerRect), mRect(0, 0, 0, 0), mOuterRect(0, 0, 0, 0), mMargins(0, 0, 0, 0), mMinimumMargins(0, 0, 0, 0), mAutoMargins(QCP::msAll) { } QCPLayoutElement::~QCPLayoutElement() { setMarginGroup(QCP::msAll, nullptr); // unregister at margin groups, if there are any // unregister at layout: if (qobject_cast(mParentLayout)) // the qobject_cast is just a safeguard in case the layout forgets to call clear() in its dtor and this dtor is called by QObject dtor mParentLayout->take(this); } /*! Sets the outer rect of this layout element. If the layout element is inside a layout, the layout sets the position and size of this layout element using this function. Calling this function externally has no effect, since the layout will overwrite any changes to the outer rect upon the next replot. The layout element will adapt its inner \ref rect by applying the margins inward to the outer rect. \see rect */ void QCPLayoutElement::setOuterRect(const QRect &rect) { if (mOuterRect != rect) { mOuterRect = rect; mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom()); } } /*! Sets the margins of this layout element. If \ref setAutoMargins is disabled for some or all sides, this function is used to manually set the margin on those sides. Sides that are still set to be handled automatically are ignored and may have any value in \a margins. The margin is the distance between the outer rect (controlled by the parent layout via \ref setOuterRect) and the inner \ref rect (which usually contains the main content of this layout element). \see setAutoMargins */ void QCPLayoutElement::setMargins(const QMargins &margins) { if (mMargins != margins) { mMargins = margins; mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom()); } } /*! If \ref setAutoMargins is enabled on some or all margins, this function is used to provide minimum values for those margins. The minimum values are not enforced on margin sides that were set to be under manual control via \ref setAutoMargins. \see setAutoMargins */ void QCPLayoutElement::setMinimumMargins(const QMargins &margins) { if (mMinimumMargins != margins) { mMinimumMargins = margins; } } /*! Sets on which sides the margin shall be calculated automatically. If a side is calculated automatically, a minimum margin value may be provided with \ref setMinimumMargins. If a side is set to be controlled manually, the value may be specified with \ref setMargins. Margin sides that are under automatic control may participate in a \ref QCPMarginGroup (see \ref setMarginGroup), to synchronize (align) it with other layout elements in the plot. \see setMinimumMargins, setMargins, QCP::MarginSide */ void QCPLayoutElement::setAutoMargins(QCP::MarginSides sides) { mAutoMargins = sides; } /*! Sets the minimum size of this layout element. A parent layout tries to respect the \a size here by changing row/column sizes in the layout accordingly. If the parent layout size is not sufficient to satisfy all minimum size constraints of its child layout elements, the layout may set a size that is actually smaller than \a size. QCustomPlot propagates the layout's size constraints to the outside by setting its own minimum QWidget size accordingly, so violations of \a size should be exceptions. Whether this constraint applies to the inner or the outer rect can be specified with \ref setSizeConstraintRect (see \ref rect and \ref outerRect). */ void QCPLayoutElement::setMinimumSize(const QSize &size) { if (mMinimumSize != size) { mMinimumSize = size; if (mParentLayout) mParentLayout->sizeConstraintsChanged(); } } /*! \overload Sets the minimum size of this layout element. Whether this constraint applies to the inner or the outer rect can be specified with \ref setSizeConstraintRect (see \ref rect and \ref outerRect). */ void QCPLayoutElement::setMinimumSize(int width, int height) { setMinimumSize(QSize(width, height)); } /*! Sets the maximum size of this layout element. A parent layout tries to respect the \a size here by changing row/column sizes in the layout accordingly. Whether this constraint applies to the inner or the outer rect can be specified with \ref setSizeConstraintRect (see \ref rect and \ref outerRect). */ void QCPLayoutElement::setMaximumSize(const QSize &size) { if (mMaximumSize != size) { mMaximumSize = size; if (mParentLayout) mParentLayout->sizeConstraintsChanged(); } } /*! \overload Sets the maximum size of this layout element. Whether this constraint applies to the inner or the outer rect can be specified with \ref setSizeConstraintRect (see \ref rect and \ref outerRect). */ void QCPLayoutElement::setMaximumSize(int width, int height) { setMaximumSize(QSize(width, height)); } /*! Sets to which rect of a layout element the size constraints apply. Size constraints can be set via \ref setMinimumSize and \ref setMaximumSize. The outer rect (\ref outerRect) includes the margins (e.g. in the case of a QCPAxisRect the axis labels), whereas the inner rect (\ref rect) does not. \see setMinimumSize, setMaximumSize */ void QCPLayoutElement::setSizeConstraintRect(SizeConstraintRect constraintRect) { if (mSizeConstraintRect != constraintRect) { mSizeConstraintRect = constraintRect; if (mParentLayout) mParentLayout->sizeConstraintsChanged(); } } /*! Sets the margin \a group of the specified margin \a sides. Margin groups allow synchronizing specified margins across layout elements, see the documentation of \ref QCPMarginGroup. To unset the margin group of \a sides, set \a group to \c nullptr. Note that margin groups only work for margin sides that are set to automatic (\ref setAutoMargins). \see QCP::MarginSide */ void QCPLayoutElement::setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group) { QVector sideVector; if (sides.testFlag(QCP::msLeft)) sideVector.append(QCP::msLeft); if (sides.testFlag(QCP::msRight)) sideVector.append(QCP::msRight); if (sides.testFlag(QCP::msTop)) sideVector.append(QCP::msTop); if (sides.testFlag(QCP::msBottom)) sideVector.append(QCP::msBottom); foreach (QCP::MarginSide side, sideVector) { if (marginGroup(side) != group) { QCPMarginGroup *oldGroup = marginGroup(side); if (oldGroup) // unregister at old group oldGroup->removeChild(side, this); if (!group) // if setting to 0, remove hash entry. Else set hash entry to new group and register there { mMarginGroups.remove(side); } else // setting to a new group { mMarginGroups[side] = group; group->addChild(side, this); } } } } /*! Updates the layout element and sub-elements. This function is automatically called before every replot by the parent layout element. It is called multiple times, once for every \ref UpdatePhase. The phases are run through in the order of the enum values. For details about what happens at the different phases, see the documentation of \ref UpdatePhase. Layout elements that have child elements should call the \ref update method of their child elements, and pass the current \a phase unchanged. The default implementation executes the automatic margin mechanism in the \ref upMargins phase. Subclasses should make sure to call the base class implementation. */ void QCPLayoutElement::update(UpdatePhase phase) { if (phase == upMargins) { if (mAutoMargins != QCP::msNone) { // set the margins of this layout element according to automatic margin calculation, either directly or via a margin group: QMargins newMargins = mMargins; const QList allMarginSides = QList() << QCP::msLeft << QCP::msRight << QCP::msTop << QCP::msBottom; foreach (QCP::MarginSide side, allMarginSides) { if (mAutoMargins.testFlag(side)) // this side's margin shall be calculated automatically { if (mMarginGroups.contains(side)) QCP::setMarginValue(newMargins, side, mMarginGroups[side]->commonMargin(side)); // this side is part of a margin group, so get the margin value from that group else QCP::setMarginValue(newMargins, side, calculateAutoMargin(side)); // this side is not part of a group, so calculate the value directly // apply minimum margin restrictions: if (QCP::getMarginValue(newMargins, side) < QCP::getMarginValue(mMinimumMargins, side)) QCP::setMarginValue(newMargins, side, QCP::getMarginValue(mMinimumMargins, side)); } } setMargins(newMargins); } } } /*! Returns the suggested minimum size this layout element (the \ref outerRect) may be compressed to, if no manual minimum size is set. if a minimum size (\ref setMinimumSize) was not set manually, parent layouts use the returned size (usually indirectly through \ref QCPLayout::getFinalMinimumOuterSize) to determine the minimum allowed size of this layout element. A manual minimum size is considered set if it is non-zero. The default implementation simply returns the sum of the horizontal margins for the width and the sum of the vertical margins for the height. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints. */ QSize QCPLayoutElement::minimumOuterSizeHint() const { return {mMargins.left()+mMargins.right(), mMargins.top()+mMargins.bottom()}; } /*! Returns the suggested maximum size this layout element (the \ref outerRect) may be expanded to, if no manual maximum size is set. if a maximum size (\ref setMaximumSize) was not set manually, parent layouts use the returned size (usually indirectly through \ref QCPLayout::getFinalMaximumOuterSize) to determine the maximum allowed size of this layout element. A manual maximum size is considered set if it is smaller than Qt's \c QWIDGETSIZE_MAX. The default implementation simply returns \c QWIDGETSIZE_MAX for both width and height, implying no suggested maximum size. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints. */ QSize QCPLayoutElement::maximumOuterSizeHint() const { return {QWIDGETSIZE_MAX, QWIDGETSIZE_MAX}; } /*! Returns a list of all child elements in this layout element. If \a recursive is true, all sub-child elements are included in the list, too. \warning There may be \c nullptr entries in the returned list. For example, QCPLayoutGrid may have empty cells which yield \c nullptr at the respective index. */ QList QCPLayoutElement::elements(bool recursive) const { Q_UNUSED(recursive) return QList(); } /*! Layout elements are sensitive to events inside their outer rect. If \a pos is within the outer rect, this method returns a value corresponding to 0.99 times the parent plot's selection tolerance. However, layout elements are not selectable by default. So if \a onlySelectable is true, -1.0 is returned. See \ref QCPLayerable::selectTest for a general explanation of this virtual method. QCPLayoutElement subclasses may reimplement this method to provide more specific selection test behaviour. */ double QCPLayoutElement::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable) return -1; if (QRectF(mOuterRect).contains(pos)) { if (mParentPlot) return mParentPlot->selectionTolerance()*0.99; else { qDebug() << Q_FUNC_INFO << "parent plot not defined"; return -1; } } else return -1; } /*! \internal propagates the parent plot initialization to all child elements, by calling \ref QCPLayerable::initializeParentPlot on them. */ void QCPLayoutElement::parentPlotInitialized(QCustomPlot *parentPlot) { foreach (QCPLayoutElement *el, elements(false)) { if (!el->parentPlot()) el->initializeParentPlot(parentPlot); } } /*! \internal Returns the margin size for this \a side. It is used if automatic margins is enabled for this \a side (see \ref setAutoMargins). If a minimum margin was set with \ref setMinimumMargins, the returned value will not be smaller than the specified minimum margin. The default implementation just returns the respective manual margin (\ref setMargins) or the minimum margin, whichever is larger. */ int QCPLayoutElement::calculateAutoMargin(QCP::MarginSide side) { return qMax(QCP::getMarginValue(mMargins, side), QCP::getMarginValue(mMinimumMargins, side)); } /*! \internal This virtual method is called when this layout element was moved to a different QCPLayout, or when this layout element has changed its logical position (e.g. row and/or column) within the same QCPLayout. Subclasses may use this to react accordingly. Since this method is called after the completion of the move, you can access the new parent layout via \ref layout(). The default implementation does nothing. */ void QCPLayoutElement::layoutChanged() { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLayout //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLayout \brief The abstract base class for layouts This is an abstract base class for layout elements whose main purpose is to define the position and size of other child layout elements. In most cases, layouts don't draw anything themselves (but there are exceptions to this, e.g. QCPLegend). QCPLayout derives from QCPLayoutElement, and thus can itself be nested in other layouts. QCPLayout introduces a common interface for accessing and manipulating the child elements. Those functions are most notably \ref elementCount, \ref elementAt, \ref takeAt, \ref take, \ref simplify, \ref removeAt, \ref remove and \ref clear. Individual subclasses may add more functions to this interface which are more specialized to the form of the layout. For example, \ref QCPLayoutGrid adds functions that take row and column indices to access cells of the layout grid more conveniently. Since this is an abstract base class, you can't instantiate it directly. Rather use one of its subclasses like QCPLayoutGrid or QCPLayoutInset. For a general introduction to the layout system, see the dedicated documentation page \ref thelayoutsystem "The Layout System". */ /* start documentation of pure virtual functions */ /*! \fn virtual int QCPLayout::elementCount() const = 0 Returns the number of elements/cells in the layout. \see elements, elementAt */ /*! \fn virtual QCPLayoutElement* QCPLayout::elementAt(int index) const = 0 Returns the element in the cell with the given \a index. If \a index is invalid, returns \c nullptr. Note that even if \a index is valid, the respective cell may be empty in some layouts (e.g. QCPLayoutGrid), so this function may return \c nullptr in those cases. You may use this function to check whether a cell is empty or not. \see elements, elementCount, takeAt */ /*! \fn virtual QCPLayoutElement* QCPLayout::takeAt(int index) = 0 Removes the element with the given \a index from the layout and returns it. If the \a index is invalid or the cell with that index is empty, returns \c nullptr. Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use \ref simplify. \see elementAt, take */ /*! \fn virtual bool QCPLayout::take(QCPLayoutElement* element) = 0 Removes the specified \a element from the layout and returns true on success. If the \a element isn't in this layout, returns false. Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use \ref simplify. \see takeAt */ /* end documentation of pure virtual functions */ /*! Creates an instance of QCPLayout and sets default values. Note that since QCPLayout is an abstract base class, it can't be instantiated directly. */ QCPLayout::QCPLayout() { } /*! If \a phase is \ref upLayout, calls \ref updateLayout, which subclasses may reimplement to reposition and resize their cells. Finally, the call is propagated down to all child \ref QCPLayoutElement "QCPLayoutElements". For details about this method and the update phases, see the documentation of \ref QCPLayoutElement::update. */ void QCPLayout::update(UpdatePhase phase) { QCPLayoutElement::update(phase); // set child element rects according to layout: if (phase == upLayout) updateLayout(); // propagate update call to child elements: const int elCount = elementCount(); for (int i=0; iupdate(phase); } } /* inherits documentation from base class */ QList QCPLayout::elements(bool recursive) const { const int c = elementCount(); QList result; #if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0) result.reserve(c); #endif for (int i=0; ielements(recursive); } } return result; } /*! Simplifies the layout by collapsing empty cells. The exact behavior depends on subclasses, the default implementation does nothing. Not all layouts need simplification. For example, QCPLayoutInset doesn't use explicit simplification while QCPLayoutGrid does. */ void QCPLayout::simplify() { } /*! Removes and deletes the element at the provided \a index. Returns true on success. If \a index is invalid or points to an empty cell, returns false. This function internally uses \ref takeAt to remove the element from the layout and then deletes the returned element. Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use \ref simplify. \see remove, takeAt */ bool QCPLayout::removeAt(int index) { if (QCPLayoutElement *el = takeAt(index)) { delete el; return true; } else return false; } /*! Removes and deletes the provided \a element. Returns true on success. If \a element is not in the layout, returns false. This function internally uses \ref takeAt to remove the element from the layout and then deletes the element. Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use \ref simplify. \see removeAt, take */ bool QCPLayout::remove(QCPLayoutElement *element) { if (take(element)) { delete element; return true; } else return false; } /*! Removes and deletes all layout elements in this layout. Finally calls \ref simplify to make sure all empty cells are collapsed. \see remove, removeAt */ void QCPLayout::clear() { for (int i=elementCount()-1; i>=0; --i) { if (elementAt(i)) removeAt(i); } simplify(); } /*! Subclasses call this method to report changed (minimum/maximum) size constraints. If the parent of this layout is again a QCPLayout, forwards the call to the parent's \ref sizeConstraintsChanged. If the parent is a QWidget (i.e. is the \ref QCustomPlot::plotLayout of QCustomPlot), calls QWidget::updateGeometry, so if the QCustomPlot widget is inside a Qt QLayout, it may update itself and resize cells accordingly. */ void QCPLayout::sizeConstraintsChanged() const { if (QWidget *w = qobject_cast(parent())) w->updateGeometry(); else if (QCPLayout *l = qobject_cast(parent())) l->sizeConstraintsChanged(); } /*! \internal Subclasses reimplement this method to update the position and sizes of the child elements/cells via calling their \ref QCPLayoutElement::setOuterRect. The default implementation does nothing. The geometry used as a reference is the inner \ref rect of this layout. Child elements should stay within that rect. \ref getSectionSizes may help with the reimplementation of this function. \see update */ void QCPLayout::updateLayout() { } /*! \internal Associates \a el with this layout. This is done by setting the \ref QCPLayoutElement::layout, the \ref QCPLayerable::parentLayerable and the QObject parent to this layout. Further, if \a el didn't previously have a parent plot, calls \ref QCPLayerable::initializeParentPlot on \a el to set the paret plot. This method is used by subclass specific methods that add elements to the layout. Note that this method only changes properties in \a el. The removal from the old layout and the insertion into the new layout must be done additionally. */ void QCPLayout::adoptElement(QCPLayoutElement *el) { if (el) { el->mParentLayout = this; el->setParentLayerable(this); el->setParent(this); if (!el->parentPlot()) el->initializeParentPlot(mParentPlot); el->layoutChanged(); } else qDebug() << Q_FUNC_INFO << "Null element passed"; } /*! \internal Disassociates \a el from this layout. This is done by setting the \ref QCPLayoutElement::layout and the \ref QCPLayerable::parentLayerable to zero. The QObject parent is set to the parent QCustomPlot. This method is used by subclass specific methods that remove elements from the layout (e.g. \ref take or \ref takeAt). Note that this method only changes properties in \a el. The removal from the old layout must be done additionally. */ void QCPLayout::releaseElement(QCPLayoutElement *el) { if (el) { el->mParentLayout = nullptr; el->setParentLayerable(nullptr); el->setParent(mParentPlot); // Note: Don't initializeParentPlot(0) here, because layout element will stay in same parent plot } else qDebug() << Q_FUNC_INFO << "Null element passed"; } /*! \internal This is a helper function for the implementation of \ref updateLayout in subclasses. It calculates the sizes of one-dimensional sections with provided constraints on maximum section sizes, minimum section sizes, relative stretch factors and the final total size of all sections. The QVector entries refer to the sections. Thus all QVectors must have the same size. \a maxSizes gives the maximum allowed size of each section. If there shall be no maximum size imposed, set all vector values to Qt's QWIDGETSIZE_MAX. \a minSizes gives the minimum allowed size of each section. If there shall be no minimum size imposed, set all vector values to zero. If the \a minSizes entries add up to a value greater than \a totalSize, sections will be scaled smaller than the proposed minimum sizes. (In other words, not exceeding the allowed total size is taken to be more important than not going below minimum section sizes.) \a stretchFactors give the relative proportions of the sections to each other. If all sections shall be scaled equally, set all values equal. If the first section shall be double the size of each individual other section, set the first number of \a stretchFactors to double the value of the other individual values (e.g. {2, 1, 1, 1}). \a totalSize is the value that the final section sizes will add up to. Due to rounding, the actual sum may differ slightly. If you want the section sizes to sum up to exactly that value, you could distribute the remaining difference on the sections. The return value is a QVector containing the section sizes. */ QVector QCPLayout::getSectionSizes(QVector maxSizes, QVector minSizes, QVector stretchFactors, int totalSize) const { if (maxSizes.size() != minSizes.size() || minSizes.size() != stretchFactors.size()) { qDebug() << Q_FUNC_INFO << "Passed vector sizes aren't equal:" << maxSizes << minSizes << stretchFactors; return QVector(); } if (stretchFactors.isEmpty()) return QVector(); int sectionCount = stretchFactors.size(); QVector sectionSizes(sectionCount); // if provided total size is forced smaller than total minimum size, ignore minimum sizes (squeeze sections): int minSizeSum = 0; for (int i=0; i minimumLockedSections; QList unfinishedSections; for (int i=0; i result(sectionCount); for (int i=0; iminimumOuterSizeHint(); QSize minOuter = el->minimumSize(); // depending on sizeConstraitRect this might be with respect to inner rect, so possibly add margins in next four lines (preserving unset minimum of 0) if (minOuter.width() > 0 && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) minOuter.rwidth() += el->margins().left() + el->margins().right(); if (minOuter.height() > 0 && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) minOuter.rheight() += el->margins().top() + el->margins().bottom(); return {minOuter.width() > 0 ? minOuter.width() : minOuterHint.width(), minOuter.height() > 0 ? minOuter.height() : minOuterHint.height()}; } /*! \internal This is a helper function for the implementation of subclasses. It returns the maximum size that should finally be used for the outer rect of the passed layout element \a el. It takes into account whether a manual maximum size is set (\ref QCPLayoutElement::setMaximumSize), which size constraint is set (\ref QCPLayoutElement::setSizeConstraintRect), as well as the maximum size hint, if no manual maximum size was set (\ref QCPLayoutElement::maximumOuterSizeHint). */ QSize QCPLayout::getFinalMaximumOuterSize(const QCPLayoutElement *el) { QSize maxOuterHint = el->maximumOuterSizeHint(); QSize maxOuter = el->maximumSize(); // depending on sizeConstraitRect this might be with respect to inner rect, so possibly add margins in next four lines (preserving unset maximum of QWIDGETSIZE_MAX) if (maxOuter.width() < QWIDGETSIZE_MAX && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) maxOuter.rwidth() += el->margins().left() + el->margins().right(); if (maxOuter.height() < QWIDGETSIZE_MAX && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) maxOuter.rheight() += el->margins().top() + el->margins().bottom(); return {maxOuter.width() < QWIDGETSIZE_MAX ? maxOuter.width() : maxOuterHint.width(), maxOuter.height() < QWIDGETSIZE_MAX ? maxOuter.height() : maxOuterHint.height()}; } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLayoutGrid //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLayoutGrid \brief A layout that arranges child elements in a grid Elements are laid out in a grid with configurable stretch factors (\ref setColumnStretchFactor, \ref setRowStretchFactor) and spacing (\ref setColumnSpacing, \ref setRowSpacing). Elements can be added to cells via \ref addElement. The grid is expanded if the specified row or column doesn't exist yet. Whether a cell contains a valid layout element can be checked with \ref hasElement, that element can be retrieved with \ref element. If rows and columns that only have empty cells shall be removed, call \ref simplify. Removal of elements is either done by just adding the element to a different layout or by using the QCPLayout interface \ref take or \ref remove. If you use \ref addElement(QCPLayoutElement*) without explicit parameters for \a row and \a column, the grid layout will choose the position according to the current \ref setFillOrder and the wrapping (\ref setWrap). Row and column insertion can be performed with \ref insertRow and \ref insertColumn. */ /* start documentation of inline functions */ /*! \fn int QCPLayoutGrid::rowCount() const Returns the number of rows in the layout. \see columnCount */ /*! \fn int QCPLayoutGrid::columnCount() const Returns the number of columns in the layout. \see rowCount */ /* end documentation of inline functions */ /*! Creates an instance of QCPLayoutGrid and sets default values. */ QCPLayoutGrid::QCPLayoutGrid() : mColumnSpacing(5), mRowSpacing(5), mWrap(0), mFillOrder(foColumnsFirst) { } QCPLayoutGrid::~QCPLayoutGrid() { // clear all child layout elements. This is important because only the specific layouts know how // to handle removing elements (clear calls virtual removeAt method to do that). clear(); } /*! Returns the element in the cell in \a row and \a column. Returns \c nullptr if either the row/column is invalid or if the cell is empty. In those cases, a qDebug message is printed. To check whether a cell exists and isn't empty, use \ref hasElement. \see addElement, hasElement */ QCPLayoutElement *QCPLayoutGrid::element(int row, int column) const { if (row >= 0 && row < mElements.size()) { if (column >= 0 && column < mElements.first().size()) { if (QCPLayoutElement *result = mElements.at(row).at(column)) return result; else qDebug() << Q_FUNC_INFO << "Requested cell is empty. Row:" << row << "Column:" << column; } else qDebug() << Q_FUNC_INFO << "Invalid column. Row:" << row << "Column:" << column; } else qDebug() << Q_FUNC_INFO << "Invalid row. Row:" << row << "Column:" << column; return nullptr; } /*! \overload Adds the \a element to cell with \a row and \a column. If \a element is already in a layout, it is first removed from there. If \a row or \a column don't exist yet, the layout is expanded accordingly. Returns true if the element was added successfully, i.e. if the cell at \a row and \a column didn't already have an element. Use the overload of this method without explicit row/column index to place the element according to the configured fill order and wrapping settings. \see element, hasElement, take, remove */ bool QCPLayoutGrid::addElement(int row, int column, QCPLayoutElement *element) { if (!hasElement(row, column)) { if (element && element->layout()) // remove from old layout first element->layout()->take(element); expandTo(row+1, column+1); mElements[row][column] = element; if (element) adoptElement(element); return true; } else qDebug() << Q_FUNC_INFO << "There is already an element in the specified row/column:" << row << column; return false; } /*! \overload Adds the \a element to the next empty cell according to the current fill order (\ref setFillOrder) and wrapping (\ref setWrap). If \a element is already in a layout, it is first removed from there. If necessary, the layout is expanded to hold the new element. Returns true if the element was added successfully. \see setFillOrder, setWrap, element, hasElement, take, remove */ bool QCPLayoutGrid::addElement(QCPLayoutElement *element) { int rowIndex = 0; int colIndex = 0; if (mFillOrder == foColumnsFirst) { while (hasElement(rowIndex, colIndex)) { ++colIndex; if (colIndex >= mWrap && mWrap > 0) { colIndex = 0; ++rowIndex; } } } else { while (hasElement(rowIndex, colIndex)) { ++rowIndex; if (rowIndex >= mWrap && mWrap > 0) { rowIndex = 0; ++colIndex; } } } return addElement(rowIndex, colIndex, element); } /*! Returns whether the cell at \a row and \a column exists and contains a valid element, i.e. isn't empty. \see element */ bool QCPLayoutGrid::hasElement(int row, int column) { if (row >= 0 && row < rowCount() && column >= 0 && column < columnCount()) return mElements.at(row).at(column); else return false; } /*! Sets the stretch \a factor of \a column. Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see \ref QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize, \ref QCPLayoutElement::setSizeConstraintRect.) The default stretch factor of newly created rows/columns is 1. \see setColumnStretchFactors, setRowStretchFactor */ void QCPLayoutGrid::setColumnStretchFactor(int column, double factor) { if (column >= 0 && column < columnCount()) { if (factor > 0) mColumnStretchFactors[column] = factor; else qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor; } else qDebug() << Q_FUNC_INFO << "Invalid column:" << column; } /*! Sets the stretch \a factors of all columns. \a factors must have the size \ref columnCount. Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see \ref QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize, \ref QCPLayoutElement::setSizeConstraintRect.) The default stretch factor of newly created rows/columns is 1. \see setColumnStretchFactor, setRowStretchFactors */ void QCPLayoutGrid::setColumnStretchFactors(const QList &factors) { if (factors.size() == mColumnStretchFactors.size()) { mColumnStretchFactors = factors; for (int i=0; i= 0 && row < rowCount()) { if (factor > 0) mRowStretchFactors[row] = factor; else qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor; } else qDebug() << Q_FUNC_INFO << "Invalid row:" << row; } /*! Sets the stretch \a factors of all rows. \a factors must have the size \ref rowCount. Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see \ref QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize, \ref QCPLayoutElement::setSizeConstraintRect.) The default stretch factor of newly created rows/columns is 1. \see setRowStretchFactor, setColumnStretchFactors */ void QCPLayoutGrid::setRowStretchFactors(const QList &factors) { if (factors.size() == mRowStretchFactors.size()) { mRowStretchFactors = factors; for (int i=0; i tempElements; if (rearrange) { tempElements.reserve(elCount); for (int i=0; i()); mRowStretchFactors.append(1); } // go through rows and expand columns as necessary: int newColCount = qMax(columnCount(), newColumnCount); for (int i=0; i rowCount()) newIndex = rowCount(); mRowStretchFactors.insert(newIndex, 1); QList newRow; for (int col=0; col columnCount()) newIndex = columnCount(); mColumnStretchFactors.insert(newIndex, 1); for (int row=0; row= 0 && row < rowCount()) { if (column >= 0 && column < columnCount()) { switch (mFillOrder) { case foRowsFirst: return column*rowCount() + row; case foColumnsFirst: return row*columnCount() + column; } } else qDebug() << Q_FUNC_INFO << "row index out of bounds:" << row; } else qDebug() << Q_FUNC_INFO << "column index out of bounds:" << column; return 0; } /*! Converts the linear index to row and column indices and writes the result to \a row and \a column. The way the cells are indexed depends on \ref setFillOrder. If it is \ref foRowsFirst, the indices increase left to right and then top to bottom. If it is \ref foColumnsFirst, the indices increase top to bottom and then left to right. If there are no cells (i.e. column or row count is zero), sets \a row and \a column to -1. For the retrieved \a row and \a column to be valid, the passed \a index must be valid itself, i.e. greater or equal to zero and smaller than the current \ref elementCount. \see rowColToIndex */ void QCPLayoutGrid::indexToRowCol(int index, int &row, int &column) const { row = -1; column = -1; const int nCols = columnCount(); const int nRows = rowCount(); if (nCols == 0 || nRows == 0) return; if (index < 0 || index >= elementCount()) { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return; } switch (mFillOrder) { case foRowsFirst: { column = index / nRows; row = index % nRows; break; } case foColumnsFirst: { row = index / nCols; column = index % nCols; break; } } } /* inherits documentation from base class */ void QCPLayoutGrid::updateLayout() { QVector minColWidths, minRowHeights, maxColWidths, maxRowHeights; getMinimumRowColSizes(&minColWidths, &minRowHeights); getMaximumRowColSizes(&maxColWidths, &maxRowHeights); int totalRowSpacing = (rowCount()-1) * mRowSpacing; int totalColSpacing = (columnCount()-1) * mColumnSpacing; QVector colWidths = getSectionSizes(maxColWidths, minColWidths, mColumnStretchFactors.toVector(), mRect.width()-totalColSpacing); QVector rowHeights = getSectionSizes(maxRowHeights, minRowHeights, mRowStretchFactors.toVector(), mRect.height()-totalRowSpacing); // go through cells and set rects accordingly: int yOffset = mRect.top(); for (int row=0; row 0) yOffset += rowHeights.at(row-1)+mRowSpacing; int xOffset = mRect.left(); for (int col=0; col 0) xOffset += colWidths.at(col-1)+mColumnSpacing; if (mElements.at(row).at(col)) mElements.at(row).at(col)->setOuterRect(QRect(xOffset, yOffset, colWidths.at(col), rowHeights.at(row))); } } } /*! \seebaseclassmethod Note that the association of the linear \a index to the row/column based cells depends on the current setting of \ref setFillOrder. \see rowColToIndex */ QCPLayoutElement *QCPLayoutGrid::elementAt(int index) const { if (index >= 0 && index < elementCount()) { int row, col; indexToRowCol(index, row, col); return mElements.at(row).at(col); } else return nullptr; } /*! \seebaseclassmethod Note that the association of the linear \a index to the row/column based cells depends on the current setting of \ref setFillOrder. \see rowColToIndex */ QCPLayoutElement *QCPLayoutGrid::takeAt(int index) { if (QCPLayoutElement *el = elementAt(index)) { releaseElement(el); int row, col; indexToRowCol(index, row, col); mElements[row][col] = nullptr; return el; } else { qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index; return nullptr; } } /* inherits documentation from base class */ bool QCPLayoutGrid::take(QCPLayoutElement *element) { if (element) { for (int i=0; i QCPLayoutGrid::elements(bool recursive) const { QList result; const int elCount = elementCount(); #if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0) result.reserve(elCount); #endif for (int i=0; ielements(recursive); } } return result; } /*! Simplifies the layout by collapsing rows and columns which only contain empty cells. */ void QCPLayoutGrid::simplify() { // remove rows with only empty cells: for (int row=rowCount()-1; row>=0; --row) { bool hasElements = false; for (int col=0; col=0; --col) { bool hasElements = false; for (int row=0; row minColWidths, minRowHeights; getMinimumRowColSizes(&minColWidths, &minRowHeights); QSize result(0, 0); foreach (int w, minColWidths) result.rwidth() += w; foreach (int h, minRowHeights) result.rheight() += h; result.rwidth() += qMax(0, columnCount()-1) * mColumnSpacing; result.rheight() += qMax(0, rowCount()-1) * mRowSpacing; result.rwidth() += mMargins.left()+mMargins.right(); result.rheight() += mMargins.top()+mMargins.bottom(); return result; } /* inherits documentation from base class */ QSize QCPLayoutGrid::maximumOuterSizeHint() const { QVector maxColWidths, maxRowHeights; getMaximumRowColSizes(&maxColWidths, &maxRowHeights); QSize result(0, 0); foreach (int w, maxColWidths) result.setWidth(qMin(result.width()+w, QWIDGETSIZE_MAX)); foreach (int h, maxRowHeights) result.setHeight(qMin(result.height()+h, QWIDGETSIZE_MAX)); result.rwidth() += qMax(0, columnCount()-1) * mColumnSpacing; result.rheight() += qMax(0, rowCount()-1) * mRowSpacing; result.rwidth() += mMargins.left()+mMargins.right(); result.rheight() += mMargins.top()+mMargins.bottom(); if (result.height() > QWIDGETSIZE_MAX) result.setHeight(QWIDGETSIZE_MAX); if (result.width() > QWIDGETSIZE_MAX) result.setWidth(QWIDGETSIZE_MAX); return result; } /*! \internal Places the minimum column widths and row heights into \a minColWidths and \a minRowHeights respectively. The minimum height of a row is the largest minimum height of any element's outer rect in that row. The minimum width of a column is the largest minimum width of any element's outer rect in that column. This is a helper function for \ref updateLayout. \see getMaximumRowColSizes */ void QCPLayoutGrid::getMinimumRowColSizes(QVector *minColWidths, QVector *minRowHeights) const { *minColWidths = QVector(columnCount(), 0); *minRowHeights = QVector(rowCount(), 0); for (int row=0; rowat(col) < minSize.width()) (*minColWidths)[col] = minSize.width(); if (minRowHeights->at(row) < minSize.height()) (*minRowHeights)[row] = minSize.height(); } } } } /*! \internal Places the maximum column widths and row heights into \a maxColWidths and \a maxRowHeights respectively. The maximum height of a row is the smallest maximum height of any element's outer rect in that row. The maximum width of a column is the smallest maximum width of any element's outer rect in that column. This is a helper function for \ref updateLayout. \see getMinimumRowColSizes */ void QCPLayoutGrid::getMaximumRowColSizes(QVector *maxColWidths, QVector *maxRowHeights) const { *maxColWidths = QVector(columnCount(), QWIDGETSIZE_MAX); *maxRowHeights = QVector(rowCount(), QWIDGETSIZE_MAX); for (int row=0; rowat(col) > maxSize.width()) (*maxColWidths)[col] = maxSize.width(); if (maxRowHeights->at(row) > maxSize.height()) (*maxRowHeights)[row] = maxSize.height(); } } } } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLayoutInset //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLayoutInset \brief A layout that places child elements aligned to the border or arbitrarily positioned Elements are placed either aligned to the border or at arbitrary position in the area of the layout. Which placement applies is controlled with the \ref InsetPlacement (\ref setInsetPlacement). Elements are added via \ref addElement(QCPLayoutElement *element, Qt::Alignment alignment) or addElement(QCPLayoutElement *element, const QRectF &rect). If the first method is used, the inset placement will default to \ref ipBorderAligned and the element will be aligned according to the \a alignment parameter. The second method defaults to \ref ipFree and allows placing elements at arbitrary position and size, defined by \a rect. The alignment or rect can be set via \ref setInsetAlignment or \ref setInsetRect, respectively. This is the layout that every QCPAxisRect has as \ref QCPAxisRect::insetLayout. */ /* start documentation of inline functions */ /*! \fn virtual void QCPLayoutInset::simplify() The QCPInsetLayout does not need simplification since it can never have empty cells due to its linear index structure. This method does nothing. */ /* end documentation of inline functions */ /*! Creates an instance of QCPLayoutInset and sets default values. */ QCPLayoutInset::QCPLayoutInset() { } QCPLayoutInset::~QCPLayoutInset() { // clear all child layout elements. This is important because only the specific layouts know how // to handle removing elements (clear calls virtual removeAt method to do that). clear(); } /*! Returns the placement type of the element with the specified \a index. */ QCPLayoutInset::InsetPlacement QCPLayoutInset::insetPlacement(int index) const { if (elementAt(index)) return mInsetPlacement.at(index); else { qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; return ipFree; } } /*! Returns the alignment of the element with the specified \a index. The alignment only has a meaning, if the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned. */ Qt::Alignment QCPLayoutInset::insetAlignment(int index) const { if (elementAt(index)) return mInsetAlignment.at(index); else { qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; #if QT_VERSION < QT_VERSION_CHECK(5, 2, 0) return nullptr; #else return {}; #endif } } /*! Returns the rect of the element with the specified \a index. The rect only has a meaning, if the inset placement (\ref setInsetPlacement) is \ref ipFree. */ QRectF QCPLayoutInset::insetRect(int index) const { if (elementAt(index)) return mInsetRect.at(index); else { qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; return {}; } } /*! Sets the inset placement type of the element with the specified \a index to \a placement. \see InsetPlacement */ void QCPLayoutInset::setInsetPlacement(int index, QCPLayoutInset::InsetPlacement placement) { if (elementAt(index)) mInsetPlacement[index] = placement; else qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; } /*! If the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned, this function is used to set the alignment of the element with the specified \a index to \a alignment. \a alignment is an or combination of the following alignment flags: Qt::AlignLeft, Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other alignment flags will be ignored. */ void QCPLayoutInset::setInsetAlignment(int index, Qt::Alignment alignment) { if (elementAt(index)) mInsetAlignment[index] = alignment; else qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; } /*! If the inset placement (\ref setInsetPlacement) is \ref ipFree, this function is used to set the position and size of the element with the specified \a index to \a rect. \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right corner of the layout, with 35% width and height of the parent layout. Note that the minimum and maximum sizes of the embedded element (\ref QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize) are enforced. */ void QCPLayoutInset::setInsetRect(int index, const QRectF &rect) { if (elementAt(index)) mInsetRect[index] = rect; else qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; } /* inherits documentation from base class */ void QCPLayoutInset::updateLayout() { for (int i=0; i finalMaxSize.width()) insetRect.setWidth(finalMaxSize.width()); if (insetRect.size().height() > finalMaxSize.height()) insetRect.setHeight(finalMaxSize.height()); } else if (mInsetPlacement.at(i) == ipBorderAligned) { insetRect.setSize(finalMinSize); Qt::Alignment al = mInsetAlignment.at(i); if (al.testFlag(Qt::AlignLeft)) insetRect.moveLeft(rect().x()); else if (al.testFlag(Qt::AlignRight)) insetRect.moveRight(rect().x()+rect().width()); else insetRect.moveLeft(int( rect().x()+rect().width()*0.5-finalMinSize.width()*0.5 )); // default to Qt::AlignHCenter if (al.testFlag(Qt::AlignTop)) insetRect.moveTop(rect().y()); else if (al.testFlag(Qt::AlignBottom)) insetRect.moveBottom(rect().y()+rect().height()); else insetRect.moveTop(int( rect().y()+rect().height()*0.5-finalMinSize.height()*0.5 )); // default to Qt::AlignVCenter } mElements.at(i)->setOuterRect(insetRect); } } /* inherits documentation from base class */ int QCPLayoutInset::elementCount() const { return mElements.size(); } /* inherits documentation from base class */ QCPLayoutElement *QCPLayoutInset::elementAt(int index) const { if (index >= 0 && index < mElements.size()) return mElements.at(index); else return nullptr; } /* inherits documentation from base class */ QCPLayoutElement *QCPLayoutInset::takeAt(int index) { if (QCPLayoutElement *el = elementAt(index)) { releaseElement(el); mElements.removeAt(index); mInsetPlacement.removeAt(index); mInsetAlignment.removeAt(index); mInsetRect.removeAt(index); return el; } else { qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index; return nullptr; } } /* inherits documentation from base class */ bool QCPLayoutInset::take(QCPLayoutElement *element) { if (element) { for (int i=0; irealVisibility() && el->selectTest(pos, onlySelectable) >= 0) return mParentPlot->selectionTolerance()*0.99; } return -1; } /*! Adds the specified \a element to the layout as an inset aligned at the border (\ref setInsetAlignment is initialized with \ref ipBorderAligned). The alignment is set to \a alignment. \a alignment is an or combination of the following alignment flags: Qt::AlignLeft, Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other alignment flags will be ignored. \see addElement(QCPLayoutElement *element, const QRectF &rect) */ void QCPLayoutInset::addElement(QCPLayoutElement *element, Qt::Alignment alignment) { if (element) { if (element->layout()) // remove from old layout first element->layout()->take(element); mElements.append(element); mInsetPlacement.append(ipBorderAligned); mInsetAlignment.append(alignment); mInsetRect.append(QRectF(0.6, 0.6, 0.4, 0.4)); adoptElement(element); } else qDebug() << Q_FUNC_INFO << "Can't add nullptr element"; } /*! Adds the specified \a element to the layout as an inset with free positioning/sizing (\ref setInsetAlignment is initialized with \ref ipFree). The position and size is set to \a rect. \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right corner of the layout, with 35% width and height of the parent layout. \see addElement(QCPLayoutElement *element, Qt::Alignment alignment) */ void QCPLayoutInset::addElement(QCPLayoutElement *element, const QRectF &rect) { if (element) { if (element->layout()) // remove from old layout first element->layout()->take(element); mElements.append(element); mInsetPlacement.append(ipFree); mInsetAlignment.append(Qt::AlignRight|Qt::AlignTop); mInsetRect.append(rect); adoptElement(element); } else qDebug() << Q_FUNC_INFO << "Can't add nullptr element"; } /* end of 'src/layout.cpp' */ /* including file 'src/lineending.cpp' */ /* modified 2021-03-29T02:30:44, size 11189 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLineEnding //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLineEnding \brief Handles the different ending decorations for line-like items \image html QCPLineEnding.png "The various ending styles currently supported" For every ending a line-like item has, an instance of this class exists. For example, QCPItemLine has two endings which can be set with QCPItemLine::setHead and QCPItemLine::setTail. The styles themselves are defined via the enum QCPLineEnding::EndingStyle. Most decorations can be modified regarding width and length, see \ref setWidth and \ref setLength. The direction of the ending decoration (e.g. direction an arrow is pointing) is controlled by the line-like item. For example, when both endings of a QCPItemLine are set to be arrows, they will point to opposite directions, e.g. "outward". This can be changed by \ref setInverted, which would make the respective arrow point inward. Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle where actually a QCPLineEnding is expected, e.g. \snippet documentation/doc-code-snippets/mainwindow.cpp qcplineending-sethead */ /*! Creates a QCPLineEnding instance with default values (style \ref esNone). */ QCPLineEnding::QCPLineEnding() : mStyle(esNone), mWidth(8), mLength(10), mInverted(false) { } /*! Creates a QCPLineEnding instance with the specified values. */ QCPLineEnding::QCPLineEnding(QCPLineEnding::EndingStyle style, double width, double length, bool inverted) : mStyle(style), mWidth(width), mLength(length), mInverted(inverted) { } /*! Sets the style of the ending decoration. */ void QCPLineEnding::setStyle(QCPLineEnding::EndingStyle style) { mStyle = style; } /*! Sets the width of the ending decoration, if the style supports it. On arrows, for example, the width defines the size perpendicular to the arrow's pointing direction. \see setLength */ void QCPLineEnding::setWidth(double width) { mWidth = width; } /*! Sets the length of the ending decoration, if the style supports it. On arrows, for example, the length defines the size in pointing direction. \see setWidth */ void QCPLineEnding::setLength(double length) { mLength = length; } /*! Sets whether the ending decoration shall be inverted. For example, an arrow decoration will point inward when \a inverted is set to true. Note that also the \a width direction is inverted. For symmetrical ending styles like arrows or discs, this doesn't make a difference. However, asymmetric styles like \ref esHalfBar are affected by it, which can be used to control to which side the half bar points to. */ void QCPLineEnding::setInverted(bool inverted) { mInverted = inverted; } /*! \internal Returns the maximum pixel radius the ending decoration might cover, starting from the position the decoration is drawn at (typically a line ending/\ref QCPItemPosition of an item). This is relevant for clipping. Only omit painting of the decoration when the position where the decoration is supposed to be drawn is farther away from the clipping rect than the returned distance. */ double QCPLineEnding::boundingDistance() const { switch (mStyle) { case esNone: return 0; case esFlatArrow: case esSpikeArrow: case esLineArrow: case esSkewedBar: return qSqrt(mWidth*mWidth+mLength*mLength); // items that have width and length case esDisc: case esSquare: case esDiamond: case esBar: case esHalfBar: return mWidth*1.42; // items that only have a width -> width*sqrt(2) } return 0; } /*! Starting from the origin of this line ending (which is style specific), returns the length covered by the line ending symbol, in backward direction. For example, the \ref esSpikeArrow has a shorter real length than a \ref esFlatArrow, even if both have the same \ref setLength value, because the spike arrow has an inward curved back, which reduces the length along its center axis (the drawing origin for arrows is at the tip). This function is used for precise, style specific placement of line endings, for example in QCPAxes. */ double QCPLineEnding::realLength() const { switch (mStyle) { case esNone: case esLineArrow: case esSkewedBar: case esBar: case esHalfBar: return 0; case esFlatArrow: return mLength; case esDisc: case esSquare: case esDiamond: return mWidth*0.5; case esSpikeArrow: return mLength*0.8; } return 0; } /*! \internal Draws the line ending with the specified \a painter at the position \a pos. The direction of the line ending is controlled with \a dir. */ void QCPLineEnding::draw(QCPPainter *painter, const QCPVector2D &pos, const QCPVector2D &dir) const { if (mStyle == esNone) return; QCPVector2D lengthVec = dir.normalized() * mLength*(mInverted ? -1 : 1); if (lengthVec.isNull()) lengthVec = QCPVector2D(1, 0); QCPVector2D widthVec = dir.normalized().perpendicular() * mWidth*0.5*(mInverted ? -1 : 1); QPen penBackup = painter->pen(); QBrush brushBackup = painter->brush(); QPen miterPen = penBackup; miterPen.setJoinStyle(Qt::MiterJoin); // to make arrow heads spikey QBrush brush(painter->pen().color(), Qt::SolidPattern); switch (mStyle) { case esNone: break; case esFlatArrow: { QPointF points[3] = {pos.toPointF(), (pos-lengthVec+widthVec).toPointF(), (pos-lengthVec-widthVec).toPointF() }; painter->setPen(miterPen); painter->setBrush(brush); painter->drawConvexPolygon(points, 3); painter->setBrush(brushBackup); painter->setPen(penBackup); break; } case esSpikeArrow: { QPointF points[4] = {pos.toPointF(), (pos-lengthVec+widthVec).toPointF(), (pos-lengthVec*0.8).toPointF(), (pos-lengthVec-widthVec).toPointF() }; painter->setPen(miterPen); painter->setBrush(brush); painter->drawConvexPolygon(points, 4); painter->setBrush(brushBackup); painter->setPen(penBackup); break; } case esLineArrow: { QPointF points[3] = {(pos-lengthVec+widthVec).toPointF(), pos.toPointF(), (pos-lengthVec-widthVec).toPointF() }; painter->setPen(miterPen); painter->drawPolyline(points, 3); painter->setPen(penBackup); break; } case esDisc: { painter->setBrush(brush); painter->drawEllipse(pos.toPointF(), mWidth*0.5, mWidth*0.5); painter->setBrush(brushBackup); break; } case esSquare: { QCPVector2D widthVecPerp = widthVec.perpendicular(); QPointF points[4] = {(pos-widthVecPerp+widthVec).toPointF(), (pos-widthVecPerp-widthVec).toPointF(), (pos+widthVecPerp-widthVec).toPointF(), (pos+widthVecPerp+widthVec).toPointF() }; painter->setPen(miterPen); painter->setBrush(brush); painter->drawConvexPolygon(points, 4); painter->setBrush(brushBackup); painter->setPen(penBackup); break; } case esDiamond: { QCPVector2D widthVecPerp = widthVec.perpendicular(); QPointF points[4] = {(pos-widthVecPerp).toPointF(), (pos-widthVec).toPointF(), (pos+widthVecPerp).toPointF(), (pos+widthVec).toPointF() }; painter->setPen(miterPen); painter->setBrush(brush); painter->drawConvexPolygon(points, 4); painter->setBrush(brushBackup); painter->setPen(penBackup); break; } case esBar: { painter->drawLine((pos+widthVec).toPointF(), (pos-widthVec).toPointF()); break; } case esHalfBar: { painter->drawLine((pos+widthVec).toPointF(), pos.toPointF()); break; } case esSkewedBar: { QCPVector2D shift; if (!qFuzzyIsNull(painter->pen().widthF()) || painter->modes().testFlag(QCPPainter::pmNonCosmetic)) shift = dir.normalized()*qMax(qreal(1.0), painter->pen().widthF())*qreal(0.5); // if drawing with thick (non-cosmetic) pen, shift bar a little in line direction to prevent line from sticking through bar slightly painter->drawLine((pos+widthVec+lengthVec*0.2*(mInverted?-1:1)+shift).toPointF(), (pos-widthVec-lengthVec*0.2*(mInverted?-1:1)+shift).toPointF()); break; } } } /*! \internal \overload Draws the line ending. The direction is controlled with the \a angle parameter in radians. */ void QCPLineEnding::draw(QCPPainter *painter, const QCPVector2D &pos, double angle) const { draw(painter, pos, QCPVector2D(qCos(angle), qSin(angle))); } /* end of 'src/lineending.cpp' */ /* including file 'src/axis/labelpainter.cpp' */ /* modified 2021-03-29T02:30:44, size 27296 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLabelPainterPrivate //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLabelPainterPrivate \internal \brief (Private) This is a private class and not part of the public QCustomPlot interface. */ const QChar QCPLabelPainterPrivate::SymbolDot(183); const QChar QCPLabelPainterPrivate::SymbolCross(215); /*! Constructs a QCPLabelPainterPrivate instance. Make sure to not create a new instance on every redraw, to utilize the caching mechanisms. the \a parentPlot does not take ownership of the label painter. Make sure to delete it appropriately. */ QCPLabelPainterPrivate::QCPLabelPainterPrivate(QCustomPlot *parentPlot) : mAnchorMode(amRectangular), mAnchorSide(asLeft), mAnchorReferenceType(artNormal), mColor(Qt::black), mPadding(0), mRotation(0), mSubstituteExponent(true), mMultiplicationSymbol(QChar(215)), mAbbreviateDecimalPowers(false), mParentPlot(parentPlot), mLabelCache(16) { analyzeFontMetrics(); } QCPLabelPainterPrivate::~QCPLabelPainterPrivate() { } void QCPLabelPainterPrivate::setAnchorSide(AnchorSide side) { mAnchorSide = side; } void QCPLabelPainterPrivate::setAnchorMode(AnchorMode mode) { mAnchorMode = mode; } void QCPLabelPainterPrivate::setAnchorReference(const QPointF &pixelPoint) { mAnchorReference = pixelPoint; } void QCPLabelPainterPrivate::setAnchorReferenceType(AnchorReferenceType type) { mAnchorReferenceType = type; } void QCPLabelPainterPrivate::setFont(const QFont &font) { if (mFont != font) { mFont = font; analyzeFontMetrics(); } } void QCPLabelPainterPrivate::setColor(const QColor &color) { mColor = color; } void QCPLabelPainterPrivate::setPadding(int padding) { mPadding = padding; } void QCPLabelPainterPrivate::setRotation(double rotation) { mRotation = qBound(-90.0, rotation, 90.0); } void QCPLabelPainterPrivate::setSubstituteExponent(bool enabled) { mSubstituteExponent = enabled; } void QCPLabelPainterPrivate::setMultiplicationSymbol(QChar symbol) { mMultiplicationSymbol = symbol; } void QCPLabelPainterPrivate::setAbbreviateDecimalPowers(bool enabled) { mAbbreviateDecimalPowers = enabled; } void QCPLabelPainterPrivate::setCacheSize(int labelCount) { mLabelCache.setMaxCost(labelCount); } int QCPLabelPainterPrivate::cacheSize() const { return mLabelCache.maxCost(); } void QCPLabelPainterPrivate::drawTickLabel(QCPPainter *painter, const QPointF &tickPos, const QString &text) { double realRotation = mRotation; AnchorSide realSide = mAnchorSide; // for circular axes, the anchor side is determined depending on the quadrant of tickPos with respect to mCircularReference if (mAnchorMode == amSkewedUpright) { realSide = skewedAnchorSide(tickPos, 0.2, 0.3); } else if (mAnchorMode == amSkewedRotated) // in this mode every label is individually rotated to match circle tangent { realSide = skewedAnchorSide(tickPos, 0, 0); realRotation += QCPVector2D(tickPos-mAnchorReference).angle()/M_PI*180.0; if (realRotation > 90) realRotation -= 180; else if (realRotation < -90) realRotation += 180; } realSide = rotationCorrectedSide(realSide, realRotation); // rotation angles may change the true anchor side of the label drawLabelMaybeCached(painter, mFont, mColor, getAnchorPos(tickPos), realSide, realRotation, text); } /*! \internal Returns the size ("margin" in QCPAxisRect context, so measured perpendicular to the axis backbone direction) needed to fit the axis. */ /* TODO: needed? int QCPLabelPainterPrivate::size() const { int result = 0; // get length of tick marks pointing outwards: if (!tickPositions.isEmpty()) result += qMax(0, qMax(tickLengthOut, subTickLengthOut)); // calculate size of tick labels: if (tickLabelSide == QCPAxis::lsOutside) { QSize tickLabelsSize(0, 0); if (!tickLabels.isEmpty()) { for (int i=0; ibufferDevicePixelRatio())); result.append(QByteArray::number(mRotation)); //result.append(QByteArray::number((int)tickLabelSide)); TODO: check whether this is really a cache-invalidating property result.append(QByteArray::number((int)mSubstituteExponent)); result.append(QString(mMultiplicationSymbol).toUtf8()); result.append(mColor.name().toLatin1()+QByteArray::number(mColor.alpha(), 16)); result.append(mFont.toString().toLatin1()); return result; } /*! \internal Draws a single tick label with the provided \a painter, utilizing the internal label cache to significantly speed up drawing of labels that were drawn in previous calls. The tick label is always bound to an axis, the distance to the axis is controllable via \a distanceToAxis in pixels. The pixel position in the axis direction is passed in the \a position parameter. Hence for the bottom axis, \a position would indicate the horizontal pixel position (not coordinate), at which the label should be drawn. In order to later draw the axis label in a place that doesn't overlap with the tick labels, the largest tick label size is needed. This is acquired by passing a \a tickLabelsSize to the \ref drawTickLabel calls during the process of drawing all tick labels of one axis. In every call, \a tickLabelsSize is expanded, if the drawn label exceeds the value \a tickLabelsSize currently holds. The label is drawn with the font and pen that are currently set on the \a painter. To draw superscripted powers, the font is temporarily made smaller by a fixed factor (see \ref getTickLabelData). */ void QCPLabelPainterPrivate::drawLabelMaybeCached(QCPPainter *painter, const QFont &font, const QColor &color, const QPointF &pos, AnchorSide side, double rotation, const QString &text) { // warning: if you change anything here, also adapt getMaxTickLabelSize() accordingly! if (text.isEmpty()) return; QSize finalSize; if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) // label caching enabled { QByteArray key = cacheKey(text, color, rotation, side); CachedLabel *cachedLabel = mLabelCache.take(QString::fromUtf8(key)); // attempt to take label from cache (don't use object() because we want ownership/prevent deletion during our operations, we re-insert it afterwards) if (!cachedLabel) // no cached label existed, create it { LabelData labelData = getTickLabelData(font, color, rotation, side, text); cachedLabel = createCachedLabel(labelData); } // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): bool labelClippedByBorder = false; /* if (tickLabelSide == QCPAxis::lsOutside) { if (QCPAxis::orientation(type) == Qt::Horizontal) labelClippedByBorder = labelAnchor.x()+cachedLabel->offset.x()+cachedLabel->pixmap.width()/mParentPlot->bufferDevicePixelRatio() > viewportRect.right() || labelAnchor.x()+cachedLabel->offset.x() < viewportRect.left(); else labelClippedByBorder = labelAnchor.y()+cachedLabel->offset.y()+cachedLabel->pixmap.height()/mParentPlot->bufferDevicePixelRatio() > viewportRect.bottom() || labelAnchor.y()+cachedLabel->offset.y() < viewportRect.top(); } */ if (!labelClippedByBorder) { painter->drawPixmap(pos+cachedLabel->offset, cachedLabel->pixmap); finalSize = cachedLabel->pixmap.size()/mParentPlot->bufferDevicePixelRatio(); // TODO: collect this in a member rect list? } mLabelCache.insert(QString::fromUtf8(key), cachedLabel); } else // label caching disabled, draw text directly on surface: { LabelData labelData = getTickLabelData(font, color, rotation, side, text); // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): bool labelClippedByBorder = false; /* if (tickLabelSide == QCPAxis::lsOutside) { if (QCPAxis::orientation(type) == Qt::Horizontal) labelClippedByBorder = finalPosition.x()+(labelData.rotatedTotalBounds.width()+labelData.rotatedTotalBounds.left()) > viewportRect.right() || finalPosition.x()+labelData.rotatedTotalBounds.left() < viewportRect.left(); else labelClippedByBorder = finalPosition.y()+(labelData.rotatedTotalBounds.height()+labelData.rotatedTotalBounds.top()) > viewportRect.bottom() || finalPosition.y()+labelData.rotatedTotalBounds.top() < viewportRect.top(); } */ if (!labelClippedByBorder) { drawText(painter, pos, labelData); finalSize = labelData.rotatedTotalBounds.size(); } } /* // expand passed tickLabelsSize if current tick label is larger: if (finalSize.width() > tickLabelsSize->width()) tickLabelsSize->setWidth(finalSize.width()); if (finalSize.height() > tickLabelsSize->height()) tickLabelsSize->setHeight(finalSize.height()); */ } QPointF QCPLabelPainterPrivate::getAnchorPos(const QPointF &tickPos) { switch (mAnchorMode) { case amRectangular: { switch (mAnchorSide) { case asLeft: return tickPos+QPointF(mPadding, 0); case asRight: return tickPos+QPointF(-mPadding, 0); case asTop: return tickPos+QPointF(0, mPadding); case asBottom: return tickPos+QPointF(0, -mPadding); case asTopLeft: return tickPos+QPointF(mPadding*M_SQRT1_2, mPadding*M_SQRT1_2); case asTopRight: return tickPos+QPointF(-mPadding*M_SQRT1_2, mPadding*M_SQRT1_2); case asBottomRight: return tickPos+QPointF(-mPadding*M_SQRT1_2, -mPadding*M_SQRT1_2); case asBottomLeft: return tickPos+QPointF(mPadding*M_SQRT1_2, -mPadding*M_SQRT1_2); } } case amSkewedUpright: case amSkewedRotated: { QCPVector2D anchorNormal(tickPos-mAnchorReference); if (mAnchorReferenceType == artTangent) anchorNormal = anchorNormal.perpendicular(); anchorNormal.normalize(); return tickPos+(anchorNormal*mPadding).toPointF(); } } return tickPos; } /*! \internal This is a \ref placeTickLabel helper function. Draws the tick label specified in \a labelData with \a painter at the pixel positions \a x and \a y. This function is used by \ref placeTickLabel to create new tick labels for the cache, or to directly draw the labels on the QCustomPlot surface when label caching is disabled, i.e. when QCP::phCacheLabels plotting hint is not set. */ void QCPLabelPainterPrivate::drawText(QCPPainter *painter, const QPointF &pos, const LabelData &labelData) const { // backup painter settings that we're about to change: QTransform oldTransform = painter->transform(); QFont oldFont = painter->font(); QPen oldPen = painter->pen(); // transform painter to position/rotation: painter->translate(pos); painter->setTransform(labelData.transform, true); // draw text: painter->setFont(labelData.baseFont); painter->setPen(QPen(labelData.color)); if (!labelData.expPart.isEmpty()) // use superscripted exponent typesetting { painter->drawText(0, 0, 0, 0, Qt::TextDontClip, labelData.basePart); if (!labelData.suffixPart.isEmpty()) painter->drawText(labelData.baseBounds.width()+1+labelData.expBounds.width(), 0, 0, 0, Qt::TextDontClip, labelData.suffixPart); painter->setFont(labelData.expFont); painter->drawText(labelData.baseBounds.width()+1, 0, labelData.expBounds.width(), labelData.expBounds.height(), Qt::TextDontClip, labelData.expPart); } else { painter->drawText(0, 0, labelData.totalBounds.width(), labelData.totalBounds.height(), Qt::TextDontClip | Qt::AlignHCenter, labelData.basePart); } /* Debug code to draw label bounding boxes, baseline, and capheight painter->save(); painter->setPen(QPen(QColor(0, 0, 0, 150))); painter->drawRect(labelData.totalBounds); const int baseline = labelData.totalBounds.height()-mLetterDescent; painter->setPen(QPen(QColor(255, 0, 0, 150))); painter->drawLine(QLineF(0, baseline, labelData.totalBounds.width(), baseline)); painter->setPen(QPen(QColor(0, 0, 255, 150))); painter->drawLine(QLineF(0, baseline-mLetterCapHeight, labelData.totalBounds.width(), baseline-mLetterCapHeight)); painter->restore(); */ // reset painter settings to what it was before: painter->setTransform(oldTransform); painter->setFont(oldFont); painter->setPen(oldPen); } /*! \internal This is a \ref placeTickLabel helper function. Transforms the passed \a text and \a font to a tickLabelData structure that can then be further processed by \ref getTickLabelDrawOffset and \ref drawTickLabel. It splits the text into base and exponent if necessary (member substituteExponent) and calculates appropriate bounding boxes. */ QCPLabelPainterPrivate::LabelData QCPLabelPainterPrivate::getTickLabelData(const QFont &font, const QColor &color, double rotation, AnchorSide side, const QString &text) const { LabelData result; result.rotation = rotation; result.side = side; result.color = color; // determine whether beautiful decimal powers should be used bool useBeautifulPowers = false; int ePos = -1; // first index of exponent part, text before that will be basePart, text until eLast will be expPart int eLast = -1; // last index of exponent part, rest of text after this will be suffixPart if (mSubstituteExponent) { ePos = text.indexOf(QLatin1Char('e')); if (ePos > 0 && text.at(ePos-1).isDigit()) { eLast = ePos; while (eLast+1 < text.size() && (text.at(eLast+1) == QLatin1Char('+') || text.at(eLast+1) == QLatin1Char('-') || text.at(eLast+1).isDigit())) ++eLast; if (eLast > ePos) // only if also to right of 'e' is a digit/+/- interpret it as beautifiable power useBeautifulPowers = true; } } // calculate text bounding rects and do string preparation for beautiful decimal powers: result.baseFont = font; if (result.baseFont.pointSizeF() > 0) // might return -1 if specified with setPixelSize, in that case we can't do correction in next line result.baseFont.setPointSizeF(result.baseFont.pointSizeF()+0.05); // QFontMetrics.boundingRect has a bug for exact point sizes that make the results oscillate due to internal rounding QFontMetrics baseFontMetrics(result.baseFont); if (useBeautifulPowers) { // split text into parts of number/symbol that will be drawn normally and part that will be drawn as exponent: result.basePart = text.left(ePos); result.suffixPart = text.mid(eLast+1); // also drawn normally but after exponent // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base: if (mAbbreviateDecimalPowers && result.basePart == QLatin1String("1")) result.basePart = QLatin1String("10"); else result.basePart += QString(mMultiplicationSymbol) + QLatin1String("10"); result.expPart = text.mid(ePos+1, eLast-ePos); // clip "+" and leading zeros off expPart: while (result.expPart.length() > 2 && result.expPart.at(1) == QLatin1Char('0')) // length > 2 so we leave one zero when numberFormatChar is 'e' result.expPart.remove(1, 1); if (!result.expPart.isEmpty() && result.expPart.at(0) == QLatin1Char('+')) result.expPart.remove(0, 1); // prepare smaller font for exponent: result.expFont = font; if (result.expFont.pointSize() > 0) result.expFont.setPointSize(result.expFont.pointSize()*0.75); else result.expFont.setPixelSize(result.expFont.pixelSize()*0.75); // calculate bounding rects of base part(s), exponent part and total one: result.baseBounds = baseFontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.basePart); result.expBounds = QFontMetrics(result.expFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.expPart); if (!result.suffixPart.isEmpty()) result.suffixBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.suffixPart); result.totalBounds = result.baseBounds.adjusted(0, 0, result.expBounds.width()+result.suffixBounds.width()+2, 0); // +2 consists of the 1 pixel spacing between base and exponent (see drawTickLabel) and an extra pixel to include AA } else // useBeautifulPowers == false { result.basePart = text; result.totalBounds = baseFontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, result.basePart); } result.totalBounds.moveTopLeft(QPoint(0, 0)); applyAnchorTransform(result); result.rotatedTotalBounds = result.transform.mapRect(result.totalBounds); return result; } void QCPLabelPainterPrivate::applyAnchorTransform(LabelData &labelData) const { if (!qFuzzyIsNull(labelData.rotation)) labelData.transform.rotate(labelData.rotation); // rotates effectively clockwise (due to flipped y axis of painter vs widget coordinate system) // from now on we translate in rotated label-local coordinate system. // shift origin of coordinate system to appropriate point on label: labelData.transform.translate(0, -labelData.totalBounds.height()+mLetterDescent+mLetterCapHeight); // shifts origin to true top of capital (or number) characters if (labelData.side == asLeft || labelData.side == asRight) // anchor is centered vertically labelData.transform.translate(0, -mLetterCapHeight/2.0); else if (labelData.side == asTop || labelData.side == asBottom) // anchor is centered horizontally labelData.transform.translate(-labelData.totalBounds.width()/2.0, 0); if (labelData.side == asTopRight || labelData.side == asRight || labelData.side == asBottomRight) // anchor is at right labelData.transform.translate(-labelData.totalBounds.width(), 0); if (labelData.side == asBottomLeft || labelData.side == asBottom || labelData.side == asBottomRight) // anchor is at bottom (no elseif!) labelData.transform.translate(0, -mLetterCapHeight); } /*! \internal Simulates the steps done by \ref placeTickLabel by calculating bounding boxes of the text label to be drawn, depending on number format etc. Since only the largest tick label is wanted for the margin calculation, the passed \a tickLabelsSize is only expanded, if it's currently set to a smaller width/height. */ /* void QCPLabelPainterPrivate::getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const { // note: this function must return the same tick label sizes as the placeTickLabel function. QSize finalSize; if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && mLabelCache.contains(text)) // label caching enabled and have cached label { const CachedLabel *cachedLabel = mLabelCache.object(text); finalSize = cachedLabel->pixmap.size()/mParentPlot->bufferDevicePixelRatio(); } else // label caching disabled or no label with this text cached: { // TODO: LabelData labelData = getTickLabelData(font, text); // TODO: finalSize = labelData.rotatedTotalBounds.size(); } // expand passed tickLabelsSize if current tick label is larger: if (finalSize.width() > tickLabelsSize->width()) tickLabelsSize->setWidth(finalSize.width()); if (finalSize.height() > tickLabelsSize->height()) tickLabelsSize->setHeight(finalSize.height()); } */ QCPLabelPainterPrivate::CachedLabel *QCPLabelPainterPrivate::createCachedLabel(const LabelData &labelData) const { CachedLabel *result = new CachedLabel; // allocate pixmap with the correct size and pixel ratio: if (!qFuzzyCompare(1.0, mParentPlot->bufferDevicePixelRatio())) { result->pixmap = QPixmap(labelData.rotatedTotalBounds.size()*mParentPlot->bufferDevicePixelRatio()); #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED # ifdef QCP_DEVICEPIXELRATIO_FLOAT result->pixmap.setDevicePixelRatio(mParentPlot->devicePixelRatioF()); # else result->pixmap.setDevicePixelRatio(mParentPlot->devicePixelRatio()); # endif #endif } else result->pixmap = QPixmap(labelData.rotatedTotalBounds.size()); result->pixmap.fill(Qt::transparent); // draw the label into the pixmap // offset is between label anchor and topleft of cache pixmap, so pixmap can be drawn at pos+offset to make the label anchor appear at pos. // We use rotatedTotalBounds.topLeft() because rotatedTotalBounds is in a coordinate system where the label anchor is at (0, 0) result->offset = labelData.rotatedTotalBounds.topLeft(); QCPPainter cachePainter(&result->pixmap); drawText(&cachePainter, -result->offset, labelData); return result; } QByteArray QCPLabelPainterPrivate::cacheKey(const QString &text, const QColor &color, double rotation, AnchorSide side) const { return text.toUtf8()+ QByteArray::number(color.red()+256*color.green()+65536*color.blue(), 36)+ QByteArray::number(color.alpha()+256*(int)side, 36)+ QByteArray::number((int)(rotation*100)%36000, 36); } QCPLabelPainterPrivate::AnchorSide QCPLabelPainterPrivate::skewedAnchorSide(const QPointF &tickPos, double sideExpandHorz, double sideExpandVert) const { QCPVector2D anchorNormal = QCPVector2D(tickPos-mAnchorReference); if (mAnchorReferenceType == artTangent) anchorNormal = anchorNormal.perpendicular(); const double radius = anchorNormal.length(); const double sideHorz = sideExpandHorz*radius; const double sideVert = sideExpandVert*radius; if (anchorNormal.x() > sideHorz) { if (anchorNormal.y() > sideVert) return asTopLeft; else if (anchorNormal.y() < -sideVert) return asBottomLeft; else return asLeft; } else if (anchorNormal.x() < -sideHorz) { if (anchorNormal.y() > sideVert) return asTopRight; else if (anchorNormal.y() < -sideVert) return asBottomRight; else return asRight; } else { if (anchorNormal.y() > 0) return asTop; else return asBottom; } return asBottom; // should never be reached } QCPLabelPainterPrivate::AnchorSide QCPLabelPainterPrivate::rotationCorrectedSide(AnchorSide side, double rotation) const { AnchorSide result = side; const bool rotateClockwise = rotation > 0; if (!qFuzzyIsNull(rotation)) { if (!qFuzzyCompare(qAbs(rotation), 90)) // avoid graphical collision with anchor tangent (e.g. axis line) when rotating, so change anchor side appropriately: { if (side == asTop) result = rotateClockwise ? asLeft : asRight; else if (side == asBottom) result = rotateClockwise ? asRight : asLeft; else if (side == asTopLeft) result = rotateClockwise ? asLeft : asTop; else if (side == asTopRight) result = rotateClockwise ? asTop : asRight; else if (side == asBottomLeft) result = rotateClockwise ? asBottom : asLeft; else if (side == asBottomRight) result = rotateClockwise ? asRight : asBottom; } else // for full rotation by +/-90 degrees, other sides are more appropriate for centering on anchor: { if (side == asLeft) result = rotateClockwise ? asBottom : asTop; else if (side == asRight) result = rotateClockwise ? asTop : asBottom; else if (side == asTop) result = rotateClockwise ? asLeft : asRight; else if (side == asBottom) result = rotateClockwise ? asRight : asLeft; else if (side == asTopLeft) result = rotateClockwise ? asBottomLeft : asTopRight; else if (side == asTopRight) result = rotateClockwise ? asTopLeft : asBottomRight; else if (side == asBottomLeft) result = rotateClockwise ? asBottomRight : asTopLeft; else if (side == asBottomRight) result = rotateClockwise ? asTopRight : asBottomLeft; } } return result; } void QCPLabelPainterPrivate::analyzeFontMetrics() { const QFontMetrics fm(mFont); mLetterCapHeight = fm.tightBoundingRect(QLatin1String("8")).height(); // this method is slow, that's why we query it only upon font change mLetterDescent = fm.descent(); } /* end of 'src/axis/labelpainter.cpp' */ /* including file 'src/axis/axisticker.cpp' */ /* modified 2021-03-29T02:30:44, size 18688 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTicker //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTicker \brief The base class tick generator used by QCPAxis to create tick positions and tick labels Each QCPAxis has an internal QCPAxisTicker (or a subclass) in order to generate tick positions and tick labels for the current axis range. The ticker of an axis can be set via \ref QCPAxis::setTicker. Since that method takes a QSharedPointer, multiple axes can share the same ticker instance. This base class generates normal tick coordinates and numeric labels for linear axes. It picks a reasonable tick step (the separation between ticks) which results in readable tick labels. The number of ticks that should be approximately generated can be set via \ref setTickCount. Depending on the current tick step strategy (\ref setTickStepStrategy), the algorithm either sacrifices readability to better match the specified tick count (\ref QCPAxisTicker::tssMeetTickCount) or relaxes the tick count in favor of better tick steps (\ref QCPAxisTicker::tssReadability), which is the default. The following more specialized axis ticker subclasses are available, see details in the respective class documentation:
QCPAxisTickerFixed\image html axisticker-fixed.png
QCPAxisTickerLog\image html axisticker-log.png
QCPAxisTickerPi\image html axisticker-pi.png
QCPAxisTickerText\image html axisticker-text.png
QCPAxisTickerDateTime\image html axisticker-datetime.png
QCPAxisTickerTime\image html axisticker-time.png \image html axisticker-time2.png
\section axisticker-subclassing Creating own axis tickers Creating own axis tickers can be achieved very easily by sublassing QCPAxisTicker and reimplementing some or all of the available virtual methods. In the simplest case you might wish to just generate different tick steps than the other tickers, so you only reimplement the method \ref getTickStep. If you additionally want control over the string that will be shown as tick label, reimplement \ref getTickLabel. If you wish to have complete control, you can generate the tick vectors and tick label vectors yourself by reimplementing \ref createTickVector and \ref createLabelVector. The default implementations use the previously mentioned virtual methods \ref getTickStep and \ref getTickLabel, but your reimplementations don't necessarily need to do so. For example in the case of unequal tick steps, the method \ref getTickStep loses its usefulness and can be ignored. The sub tick count between major ticks can be controlled with \ref getSubTickCount. Full sub tick placement control is obtained by reimplementing \ref createSubTickVector. See the documentation of all these virtual methods in QCPAxisTicker for detailed information about the parameters and expected return values. */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTicker::QCPAxisTicker() : mTickStepStrategy(tssReadability), mTickCount(5), mTickOrigin(0) { } QCPAxisTicker::~QCPAxisTicker() { } /*! Sets which strategy the axis ticker follows when choosing the size of the tick step. For the available strategies, see \ref TickStepStrategy. */ void QCPAxisTicker::setTickStepStrategy(QCPAxisTicker::TickStepStrategy strategy) { mTickStepStrategy = strategy; } /*! Sets how many ticks this ticker shall aim to generate across the axis range. Note that \a count is not guaranteed to be matched exactly, as generating readable tick intervals may conflict with the requested number of ticks. Whether the readability has priority over meeting the requested \a count can be specified with \ref setTickStepStrategy. */ void QCPAxisTicker::setTickCount(int count) { if (count > 0) mTickCount = count; else qDebug() << Q_FUNC_INFO << "tick count must be greater than zero:" << count; } /*! Sets the mathematical coordinate (or "offset") of the zeroth tick. This tick coordinate is just a concept and doesn't need to be inside the currently visible axis range. By default \a origin is zero, which for example yields ticks {-5, 0, 5, 10, 15,...} when the tick step is five. If \a origin is now set to 1 instead, the correspondingly generated ticks would be {-4, 1, 6, 11, 16,...}. */ void QCPAxisTicker::setTickOrigin(double origin) { mTickOrigin = origin; } /*! This is the method called by QCPAxis in order to actually generate tick coordinates (\a ticks), tick label strings (\a tickLabels) and sub tick coordinates (\a subTicks). The ticks are generated for the specified \a range. The generated labels typically follow the specified \a locale, \a formatChar and number \a precision, however this might be different (or even irrelevant) for certain QCPAxisTicker subclasses. The output parameter \a ticks is filled with the generated tick positions in axis coordinates. The output parameters \a subTicks and \a tickLabels are optional (set them to \c nullptr if not needed) and are respectively filled with sub tick coordinates, and tick label strings belonging to \a ticks by index. */ void QCPAxisTicker::generate(const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector &ticks, QVector *subTicks, QVector *tickLabels) { // generate (major) ticks: double tickStep = getTickStep(range); ticks = createTickVector(tickStep, range); trimTicks(range, ticks, true); // trim ticks to visible range plus one outer tick on each side (incase a subclass createTickVector creates more) // generate sub ticks between major ticks: if (subTicks) { if (!ticks.isEmpty()) { *subTicks = createSubTickVector(getSubTickCount(tickStep), ticks); trimTicks(range, *subTicks, false); } else *subTicks = QVector(); } // finally trim also outliers (no further clipping happens in axis drawing): trimTicks(range, ticks, false); // generate labels for visible ticks if requested: if (tickLabels) *tickLabels = createLabelVector(ticks, locale, formatChar, precision); } /*! \internal Takes the entire currently visible axis range and returns a sensible tick step in order to provide readable tick labels as well as a reasonable number of tick counts (see \ref setTickCount, \ref setTickStepStrategy). If a QCPAxisTicker subclass only wants a different tick step behaviour than the default implementation, it should reimplement this method. See \ref cleanMantissa for a possible helper function. */ double QCPAxisTicker::getTickStep(const QCPRange &range) { double exactStep = range.size()/double(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers return cleanMantissa(exactStep); } /*! \internal Takes the \a tickStep, i.e. the distance between two consecutive ticks, and returns an appropriate number of sub ticks for that specific tick step. Note that a returned sub tick count of e.g. 4 will split each tick interval into 5 sections. */ int QCPAxisTicker::getSubTickCount(double tickStep) { int result = 1; // default to 1, if no proper value can be found // separate integer and fractional part of mantissa: double epsilon = 0.01; double intPartf; int intPart; double fracPart = modf(getMantissa(tickStep), &intPartf); intPart = int(intPartf); // handle cases with (almost) integer mantissa: if (fracPart < epsilon || 1.0-fracPart < epsilon) { if (1.0-fracPart < epsilon) ++intPart; switch (intPart) { case 1: result = 4; break; // 1.0 -> 0.2 substep case 2: result = 3; break; // 2.0 -> 0.5 substep case 3: result = 2; break; // 3.0 -> 1.0 substep case 4: result = 3; break; // 4.0 -> 1.0 substep case 5: result = 4; break; // 5.0 -> 1.0 substep case 6: result = 2; break; // 6.0 -> 2.0 substep case 7: result = 6; break; // 7.0 -> 1.0 substep case 8: result = 3; break; // 8.0 -> 2.0 substep case 9: result = 2; break; // 9.0 -> 3.0 substep } } else { // handle cases with significantly fractional mantissa: if (qAbs(fracPart-0.5) < epsilon) // *.5 mantissa { switch (intPart) { case 1: result = 2; break; // 1.5 -> 0.5 substep case 2: result = 4; break; // 2.5 -> 0.5 substep case 3: result = 4; break; // 3.5 -> 0.7 substep case 4: result = 2; break; // 4.5 -> 1.5 substep case 5: result = 4; break; // 5.5 -> 1.1 substep (won't occur with default getTickStep from here on) case 6: result = 4; break; // 6.5 -> 1.3 substep case 7: result = 2; break; // 7.5 -> 2.5 substep case 8: result = 4; break; // 8.5 -> 1.7 substep case 9: result = 4; break; // 9.5 -> 1.9 substep } } // if mantissa fraction isn't 0.0 or 0.5, don't bother finding good sub tick marks, leave default } return result; } /*! \internal This method returns the tick label string as it should be printed under the \a tick coordinate. If a textual number is returned, it should respect the provided \a locale, \a formatChar and \a precision. If the returned value contains exponentials of the form "2e5" and beautifully typeset powers is enabled in the QCPAxis number format (\ref QCPAxis::setNumberFormat), the exponential part will be formatted accordingly using multiplication symbol and superscript during rendering of the label automatically. */ QString QCPAxisTicker::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) { return locale.toString(tick, formatChar.toLatin1(), precision); } /*! \internal Returns a vector containing all coordinates of sub ticks that should be drawn. It generates \a subTickCount sub ticks between each tick pair given in \a ticks. If a QCPAxisTicker subclass needs maximal control over the generated sub ticks, it should reimplement this method. Depending on the purpose of the subclass it doesn't necessarily need to base its result on \a subTickCount or \a ticks. */ QVector QCPAxisTicker::createSubTickVector(int subTickCount, const QVector &ticks) { QVector result; if (subTickCount <= 0 || ticks.size() < 2) return result; result.reserve((ticks.size()-1)*subTickCount); for (int i=1; i QCPAxisTicker::createTickVector(double tickStep, const QCPRange &range) { QVector result; // Generate tick positions according to tickStep: qint64 firstStep = qint64(floor((range.lower-mTickOrigin)/tickStep)); // do not use qFloor here, or we'll lose 64 bit precision qint64 lastStep = qint64(ceil((range.upper-mTickOrigin)/tickStep)); // do not use qCeil here, or we'll lose 64 bit precision int tickcount = int(lastStep-firstStep+1); if (tickcount < 0) tickcount = 0; result.resize(tickcount); for (int i=0; i QCPAxisTicker::createLabelVector(const QVector &ticks, const QLocale &locale, QChar formatChar, int precision) { QVector result; result.reserve(ticks.size()); foreach (double tickCoord, ticks) result.append(getTickLabel(tickCoord, locale, formatChar, precision)); return result; } /*! \internal Removes tick coordinates from \a ticks which lie outside the specified \a range. If \a keepOneOutlier is true, it preserves one tick just outside the range on both sides, if present. The passed \a ticks must be sorted in ascending order. */ void QCPAxisTicker::trimTicks(const QCPRange &range, QVector &ticks, bool keepOneOutlier) const { bool lowFound = false; bool highFound = false; int lowIndex = 0; int highIndex = -1; for (int i=0; i < ticks.size(); ++i) { if (ticks.at(i) >= range.lower) { lowFound = true; lowIndex = i; break; } } for (int i=ticks.size()-1; i >= 0; --i) { if (ticks.at(i) <= range.upper) { highFound = true; highIndex = i; break; } } if (highFound && lowFound) { int trimFront = qMax(0, lowIndex-(keepOneOutlier ? 1 : 0)); int trimBack = qMax(0, ticks.size()-(keepOneOutlier ? 2 : 1)-highIndex); if (trimFront > 0 || trimBack > 0) ticks = ticks.mid(trimFront, ticks.size()-trimFront-trimBack); } else // all ticks are either all below or all above the range ticks.clear(); } /*! \internal Returns the coordinate contained in \a candidates which is closest to the provided \a target. This method assumes \a candidates is not empty and sorted in ascending order. */ double QCPAxisTicker::pickClosest(double target, const QVector &candidates) const { if (candidates.size() == 1) return candidates.first(); QVector::const_iterator it = std::lower_bound(candidates.constBegin(), candidates.constEnd(), target); if (it == candidates.constEnd()) return *(it-1); else if (it == candidates.constBegin()) return *it; else return target-*(it-1) < *it-target ? *(it-1) : *it; } /*! \internal Returns the decimal mantissa of \a input. Optionally, if \a magnitude is not set to zero, it also returns the magnitude of \a input as a power of 10. For example, an input of 142.6 will return a mantissa of 1.426 and a magnitude of 100. */ double QCPAxisTicker::getMantissa(double input, double *magnitude) const { const double mag = qPow(10.0, qFloor(qLn(input)/qLn(10.0))); if (magnitude) *magnitude = mag; return input/mag; } /*! \internal Returns a number that is close to \a input but has a clean, easier human readable mantissa. How strongly the mantissa is altered, and thus how strong the result deviates from the original \a input, depends on the current tick step strategy (see \ref setTickStepStrategy). */ double QCPAxisTicker::cleanMantissa(double input) const { double magnitude; const double mantissa = getMantissa(input, &magnitude); switch (mTickStepStrategy) { case tssReadability: { return pickClosest(mantissa, QVector() << 1.0 << 2.0 << 2.5 << 5.0 << 10.0)*magnitude; } case tssMeetTickCount: { // this gives effectively a mantissa of 1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0, 4.5, 5.0, 6.0, 8.0, 10.0 if (mantissa <= 5.0) return int(mantissa*2)/2.0*magnitude; // round digit after decimal point to 0.5 else return int(mantissa/2.0)*2.0*magnitude; // round to first digit in multiples of 2 } } return input; } /* end of 'src/axis/axisticker.cpp' */ /* including file 'src/axis/axistickerdatetime.cpp' */ /* modified 2021-03-29T02:30:44, size 18829 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTickerDateTime //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTickerDateTime \brief Specialized axis ticker for calendar dates and times as axis ticks \image html axisticker-datetime.png This QCPAxisTicker subclass generates ticks that correspond to real calendar dates and times. The plot axis coordinate is interpreted as Unix Time, so seconds since Epoch (January 1, 1970, 00:00 UTC). This is also used for example by QDateTime in the toTime_t()/setTime_t() methods with a precision of one second. Since Qt 4.7, millisecond accuracy can be obtained from QDateTime by using QDateTime::fromMSecsSinceEpoch()/1000.0. The static methods \ref dateTimeToKey and \ref keyToDateTime conveniently perform this conversion achieving a precision of one millisecond on all Qt versions. The format of the date/time display in the tick labels is controlled with \ref setDateTimeFormat. If a different time spec or time zone shall be used for the tick label appearance, see \ref setDateTimeSpec or \ref setTimeZone, respectively. This ticker produces unequal tick spacing in order to provide intuitive date and time-of-day ticks. For example, if the axis range spans a few years such that there is one tick per year, ticks will be positioned on 1. January of every year. This is intuitive but, due to leap years, will result in slightly unequal tick intervals (visually unnoticeable). The same can be seen in the image above: even though the number of days varies month by month, this ticker generates ticks on the same day of each month. If you would like to change the date/time that is used as a (mathematical) starting date for the ticks, use the \ref setTickOrigin(const QDateTime &origin) method overload, which takes a QDateTime. If you pass 15. July, 9:45 to this method, the yearly ticks will end up on 15. July at 9:45 of every year. The ticker can be created and assigned to an axis like this: \snippet documentation/doc-image-generator/mainwindow.cpp axistickerdatetime-creation \note If you rather wish to display relative times in terms of days, hours, minutes, seconds and milliseconds, and are not interested in the intricacies of real calendar dates with months and (leap) years, have a look at QCPAxisTickerTime instead. */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTickerDateTime::QCPAxisTickerDateTime() : mDateTimeFormat(QLatin1String("hh:mm:ss\ndd.MM.yy")), mDateTimeSpec(Qt::LocalTime), mDateStrategy(dsNone) { setTickCount(4); } /*! Sets the format in which dates and times are displayed as tick labels. For details about the \a format string, see the documentation of QDateTime::toString(). Typical expressions are
\c dThe day as a number without a leading zero (1 to 31)
\c ddThe day as a number with a leading zero (01 to 31)
\c dddThe abbreviated localized day name (e.g. 'Mon' to 'Sun'). Uses the system locale to localize the name, i.e. QLocale::system().
\c ddddThe long localized day name (e.g. 'Monday' to 'Sunday'). Uses the system locale to localize the name, i.e. QLocale::system().
\c MThe month as a number without a leading zero (1 to 12)
\c MMThe month as a number with a leading zero (01 to 12)
\c MMMThe abbreviated localized month name (e.g. 'Jan' to 'Dec'). Uses the system locale to localize the name, i.e. QLocale::system().
\c MMMMThe long localized month name (e.g. 'January' to 'December'). Uses the system locale to localize the name, i.e. QLocale::system().
\c yyThe year as a two digit number (00 to 99)
\c yyyyThe year as a four digit number. If the year is negative, a minus sign is prepended, making five characters.
\c hThe hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
\c hhThe hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
\c HThe hour without a leading zero (0 to 23, even with AM/PM display)
\c HHThe hour with a leading zero (00 to 23, even with AM/PM display)
\c mThe minute without a leading zero (0 to 59)
\c mmThe minute with a leading zero (00 to 59)
\c sThe whole second, without any leading zero (0 to 59)
\c ssThe whole second, with a leading zero where applicable (00 to 59)
\c zThe fractional part of the second, to go after a decimal point, without trailing zeroes (0 to 999). Thus "s.z" reports the seconds to full available (millisecond) precision without trailing zeroes.
\c zzzThe fractional part of the second, to millisecond precision, including trailing zeroes where applicable (000 to 999).
\c AP or \c AUse AM/PM display. A/AP will be replaced by an upper-case version of either QLocale::amText() or QLocale::pmText().
\c ap or \c aUse am/pm display. a/ap will be replaced by a lower-case version of either QLocale::amText() or QLocale::pmText().
\c tThe timezone (for example "CEST")
Newlines can be inserted with \c "\n", literal strings (even when containing above expressions) by encapsulating them using single-quotes. A literal single quote can be generated by using two consecutive single quotes in the format. \see setDateTimeSpec, setTimeZone */ void QCPAxisTickerDateTime::setDateTimeFormat(const QString &format) { mDateTimeFormat = format; } /*! Sets the time spec that is used for creating the tick labels from corresponding dates/times. The default value of QDateTime objects (and also QCPAxisTickerDateTime) is Qt::LocalTime. However, if the displayed tick labels shall be given in UTC, set \a spec to Qt::UTC. Tick labels corresponding to other time zones can be achieved with \ref setTimeZone (which sets \a spec to \c Qt::TimeZone internally). Note that if \a spec is afterwards set to not be \c Qt::TimeZone again, the \ref setTimeZone setting will be ignored accordingly. \see setDateTimeFormat, setTimeZone */ void QCPAxisTickerDateTime::setDateTimeSpec(Qt::TimeSpec spec) { mDateTimeSpec = spec; } # if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) /*! Sets the time zone that is used for creating the tick labels from corresponding dates/times. The time spec (\ref setDateTimeSpec) is set to \c Qt::TimeZone. \see setDateTimeFormat, setTimeZone */ void QCPAxisTickerDateTime::setTimeZone(const QTimeZone &zone) { mTimeZone = zone; mDateTimeSpec = Qt::TimeZone; } #endif /*! Sets the tick origin (see \ref QCPAxisTicker::setTickOrigin) in seconds since Epoch (1. Jan 1970, 00:00 UTC). For the date time ticker it might be more intuitive to use the overload which directly takes a QDateTime, see \ref setTickOrigin(const QDateTime &origin). This is useful to define the month/day/time recurring at greater tick interval steps. For example, If you pass 15. July, 9:45 to this method and the tick interval happens to be one tick per year, the ticks will end up on 15. July at 9:45 of every year. */ void QCPAxisTickerDateTime::setTickOrigin(double origin) { QCPAxisTicker::setTickOrigin(origin); } /*! Sets the tick origin (see \ref QCPAxisTicker::setTickOrigin) as a QDateTime \a origin. This is useful to define the month/day/time recurring at greater tick interval steps. For example, If you pass 15. July, 9:45 to this method and the tick interval happens to be one tick per year, the ticks will end up on 15. July at 9:45 of every year. */ void QCPAxisTickerDateTime::setTickOrigin(const QDateTime &origin) { setTickOrigin(dateTimeToKey(origin)); } /*! \internal Returns a sensible tick step with intervals appropriate for a date-time-display, such as weekly, monthly, bi-monthly, etc. Note that this tick step isn't used exactly when generating the tick vector in \ref createTickVector, but only as a guiding value requiring some correction for each individual tick interval. Otherwise this would lead to unintuitive date displays, e.g. jumping between first day in the month to the last day in the previous month from tick to tick, due to the non-uniform length of months. The same problem arises with leap years. \seebaseclassmethod */ double QCPAxisTickerDateTime::getTickStep(const QCPRange &range) { double result = range.size()/double(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers mDateStrategy = dsNone; // leaving it at dsNone means tick coordinates will not be tuned in any special way in createTickVector if (result < 1) // ideal tick step is below 1 second -> use normal clean mantissa algorithm in units of seconds { result = cleanMantissa(result); } else if (result < 86400*30.4375*12) // below a year { result = pickClosest(result, QVector() << 1 << 2.5 << 5 << 10 << 15 << 30 << 60 << 2.5*60 << 5*60 << 10*60 << 15*60 << 30*60 << 60*60 // second, minute, hour range << 3600*2 << 3600*3 << 3600*6 << 3600*12 << 3600*24 // hour to day range << 86400*2 << 86400*5 << 86400*7 << 86400*14 << 86400*30.4375 << 86400*30.4375*2 << 86400*30.4375*3 << 86400*30.4375*6 << 86400*30.4375*12); // day, week, month range (avg. days per month includes leap years) if (result > 86400*30.4375-1) // month tick intervals or larger mDateStrategy = dsUniformDayInMonth; else if (result > 3600*24-1) // day tick intervals or larger mDateStrategy = dsUniformTimeInDay; } else // more than a year, go back to normal clean mantissa algorithm but in units of years { const double secondsPerYear = 86400*30.4375*12; // average including leap years result = cleanMantissa(result/secondsPerYear)*secondsPerYear; mDateStrategy = dsUniformDayInMonth; } return result; } /*! \internal Returns a sensible sub tick count with intervals appropriate for a date-time-display, such as weekly, monthly, bi-monthly, etc. \seebaseclassmethod */ int QCPAxisTickerDateTime::getSubTickCount(double tickStep) { int result = QCPAxisTicker::getSubTickCount(tickStep); switch (qRound(tickStep)) // hand chosen subticks for specific minute/hour/day/week/month range (as specified in getTickStep) { case 5*60: result = 4; break; case 10*60: result = 1; break; case 15*60: result = 2; break; case 30*60: result = 1; break; case 60*60: result = 3; break; case 3600*2: result = 3; break; case 3600*3: result = 2; break; case 3600*6: result = 1; break; case 3600*12: result = 3; break; case 3600*24: result = 3; break; case 86400*2: result = 1; break; case 86400*5: result = 4; break; case 86400*7: result = 6; break; case 86400*14: result = 1; break; case int(86400*30.4375+0.5): result = 3; break; case int(86400*30.4375*2+0.5): result = 1; break; case int(86400*30.4375*3+0.5): result = 2; break; case int(86400*30.4375*6+0.5): result = 5; break; case int(86400*30.4375*12+0.5): result = 3; break; } return result; } /*! \internal Generates a date/time tick label for tick coordinate \a tick, based on the currently set format (\ref setDateTimeFormat), time spec (\ref setDateTimeSpec), and possibly time zone (\ref setTimeZone). \seebaseclassmethod */ QString QCPAxisTickerDateTime::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) { Q_UNUSED(precision) Q_UNUSED(formatChar) # if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) if (mDateTimeSpec == Qt::TimeZone) return locale.toString(keyToDateTime(tick).toTimeZone(mTimeZone), mDateTimeFormat); else return locale.toString(keyToDateTime(tick).toTimeSpec(mDateTimeSpec), mDateTimeFormat); # else return locale.toString(keyToDateTime(tick).toTimeSpec(mDateTimeSpec), mDateTimeFormat); # endif } /*! \internal Uses the passed \a tickStep as a guiding value and applies corrections in order to obtain non-uniform tick intervals but intuitive tick labels, e.g. falling on the same day of each month. \seebaseclassmethod */ QVector QCPAxisTickerDateTime::createTickVector(double tickStep, const QCPRange &range) { QVector result = QCPAxisTicker::createTickVector(tickStep, range); if (!result.isEmpty()) { if (mDateStrategy == dsUniformTimeInDay) { QDateTime uniformDateTime = keyToDateTime(mTickOrigin); // the time of this datetime will be set for all other ticks, if possible QDateTime tickDateTime; for (int i=0; i 15) // with leap years involved, date month may jump backwards or forwards, and needs to be corrected before setting day tickDateTime = tickDateTime.addMonths(-1); tickDateTime.setDate(QDate(tickDateTime.date().year(), tickDateTime.date().month(), thisUniformDay)); result[i] = dateTimeToKey(tickDateTime); } } } return result; } /*! A convenience method which turns \a key (in seconds since Epoch 1. Jan 1970, 00:00 UTC) into a QDateTime object. This can be used to turn axis coordinates to actual QDateTimes. The accuracy achieved by this method is one millisecond, irrespective of the used Qt version (it works around the lack of a QDateTime::fromMSecsSinceEpoch in Qt 4.6) \see dateTimeToKey */ QDateTime QCPAxisTickerDateTime::keyToDateTime(double key) { # if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) return QDateTime::fromTime_t(key).addMSecs((key-(qint64)key)*1000); # else return QDateTime::fromMSecsSinceEpoch(qint64(key*1000.0)); # endif } /*! \overload A convenience method which turns a QDateTime object into a double value that corresponds to seconds since Epoch (1. Jan 1970, 00:00 UTC). This is the format used as axis coordinates by QCPAxisTickerDateTime. The accuracy achieved by this method is one millisecond, irrespective of the used Qt version (it works around the lack of a QDateTime::toMSecsSinceEpoch in Qt 4.6) \see keyToDateTime */ double QCPAxisTickerDateTime::dateTimeToKey(const QDateTime &dateTime) { # if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) return dateTime.toTime_t()+dateTime.time().msec()/1000.0; # else return dateTime.toMSecsSinceEpoch()/1000.0; # endif } /*! \overload A convenience method which turns a QDate object into a double value that corresponds to seconds since Epoch (1. Jan 1970, 00:00 UTC). This is the format used as axis coordinates by QCPAxisTickerDateTime. The returned value will be the start of the passed day of \a date, interpreted in the given \a timeSpec. \see keyToDateTime */ double QCPAxisTickerDateTime::dateTimeToKey(const QDate &date, Qt::TimeSpec timeSpec) { # if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) return QDateTime(date, QTime(0, 0), timeSpec).toTime_t(); # elif QT_VERSION < QT_VERSION_CHECK(5, 14, 0) return QDateTime(date, QTime(0, 0), timeSpec).toMSecsSinceEpoch()/1000.0; # else return date.startOfDay(timeSpec).toMSecsSinceEpoch()/1000.0; # endif } /* end of 'src/axis/axistickerdatetime.cpp' */ /* including file 'src/axis/axistickertime.cpp' */ /* modified 2021-03-29T02:30:44, size 11745 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTickerTime //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTickerTime \brief Specialized axis ticker for time spans in units of milliseconds to days \image html axisticker-time.png This QCPAxisTicker subclass generates ticks that corresponds to time intervals. The format of the time display in the tick labels is controlled with \ref setTimeFormat and \ref setFieldWidth. The time coordinate is in the unit of seconds with respect to the time coordinate zero. Unlike with QCPAxisTickerDateTime, the ticks don't correspond to a specific calendar date and time. The time can be displayed in milliseconds, seconds, minutes, hours and days. Depending on the largest available unit in the format specified with \ref setTimeFormat, any time spans above will be carried in that largest unit. So for example if the format string is "%m:%s" and a tick at coordinate value 7815 (being 2 hours, 10 minutes and 15 seconds) is created, the resulting tick label will show "130:15" (130 minutes, 15 seconds). If the format string is "%h:%m:%s", the hour unit will be used and the label will thus be "02:10:15". Negative times with respect to the axis zero will carry a leading minus sign. The ticker can be created and assigned to an axis like this: \snippet documentation/doc-image-generator/mainwindow.cpp axistickertime-creation Here is an example of a time axis providing time information in days, hours and minutes. Due to the axis range spanning a few days and the wanted tick count (\ref setTickCount), the ticker decided to use tick steps of 12 hours: \image html axisticker-time2.png The format string for this example is \snippet documentation/doc-image-generator/mainwindow.cpp axistickertime-creation-2 \note If you rather wish to display calendar dates and times, have a look at QCPAxisTickerDateTime instead. */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTickerTime::QCPAxisTickerTime() : mTimeFormat(QLatin1String("%h:%m:%s")), mSmallestUnit(tuSeconds), mBiggestUnit(tuHours) { setTickCount(4); mFieldWidth[tuMilliseconds] = 3; mFieldWidth[tuSeconds] = 2; mFieldWidth[tuMinutes] = 2; mFieldWidth[tuHours] = 2; mFieldWidth[tuDays] = 1; mFormatPattern[tuMilliseconds] = QLatin1String("%z"); mFormatPattern[tuSeconds] = QLatin1String("%s"); mFormatPattern[tuMinutes] = QLatin1String("%m"); mFormatPattern[tuHours] = QLatin1String("%h"); mFormatPattern[tuDays] = QLatin1String("%d"); } /*! Sets the format that will be used to display time in the tick labels. The available patterns are: - %%z for milliseconds - %%s for seconds - %%m for minutes - %%h for hours - %%d for days The field width (zero padding) can be controlled for each unit with \ref setFieldWidth. The largest unit that appears in \a format will carry all the remaining time of a certain tick coordinate, even if it overflows the natural limit of the unit. For example, if %%m is the largest unit it might become larger than 59 in order to consume larger time values. If on the other hand %%h is available, the minutes will wrap around to zero after 59 and the time will carry to the hour digit. */ void QCPAxisTickerTime::setTimeFormat(const QString &format) { mTimeFormat = format; // determine smallest and biggest unit in format, to optimize unit replacement and allow biggest // unit to consume remaining time of a tick value and grow beyond its modulo (e.g. min > 59) mSmallestUnit = tuMilliseconds; mBiggestUnit = tuMilliseconds; bool hasSmallest = false; for (int i = tuMilliseconds; i <= tuDays; ++i) { TimeUnit unit = static_cast(i); if (mTimeFormat.contains(mFormatPattern.value(unit))) { if (!hasSmallest) { mSmallestUnit = unit; hasSmallest = true; } mBiggestUnit = unit; } } } /*! Sets the field widh of the specified \a unit to be \a width digits, when displayed in the tick label. If the number for the specific unit is shorter than \a width, it will be padded with an according number of zeros to the left in order to reach the field width. \see setTimeFormat */ void QCPAxisTickerTime::setFieldWidth(QCPAxisTickerTime::TimeUnit unit, int width) { mFieldWidth[unit] = qMax(width, 1); } /*! \internal Returns the tick step appropriate for time displays, depending on the provided \a range and the smallest available time unit in the current format (\ref setTimeFormat). For example if the unit of seconds isn't available in the format, this method will not generate steps (like 2.5 minutes) that require sub-minute precision to be displayed correctly. \seebaseclassmethod */ double QCPAxisTickerTime::getTickStep(const QCPRange &range) { double result = range.size()/double(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers if (result < 1) // ideal tick step is below 1 second -> use normal clean mantissa algorithm in units of seconds { if (mSmallestUnit == tuMilliseconds) result = qMax(cleanMantissa(result), 0.001); // smallest tick step is 1 millisecond else // have no milliseconds available in format, so stick with 1 second tickstep result = 1.0; } else if (result < 3600*24) // below a day { // the filling of availableSteps seems a bit contorted but it fills in a sorted fashion and thus saves a post-fill sorting run QVector availableSteps; // seconds range: if (mSmallestUnit <= tuSeconds) availableSteps << 1; if (mSmallestUnit == tuMilliseconds) availableSteps << 2.5; // only allow half second steps if milliseconds are there to display it else if (mSmallestUnit == tuSeconds) availableSteps << 2; if (mSmallestUnit <= tuSeconds) availableSteps << 5 << 10 << 15 << 30; // minutes range: if (mSmallestUnit <= tuMinutes) availableSteps << 1*60; if (mSmallestUnit <= tuSeconds) availableSteps << 2.5*60; // only allow half minute steps if seconds are there to display it else if (mSmallestUnit == tuMinutes) availableSteps << 2*60; if (mSmallestUnit <= tuMinutes) availableSteps << 5*60 << 10*60 << 15*60 << 30*60; // hours range: if (mSmallestUnit <= tuHours) availableSteps << 1*3600 << 2*3600 << 3*3600 << 6*3600 << 12*3600 << 24*3600; // pick available step that is most appropriate to approximate ideal step: result = pickClosest(result, availableSteps); } else // more than a day, go back to normal clean mantissa algorithm but in units of days { const double secondsPerDay = 3600*24; result = cleanMantissa(result/secondsPerDay)*secondsPerDay; } return result; } /*! \internal Returns the sub tick count appropriate for the provided \a tickStep and time displays. \seebaseclassmethod */ int QCPAxisTickerTime::getSubTickCount(double tickStep) { int result = QCPAxisTicker::getSubTickCount(tickStep); switch (qRound(tickStep)) // hand chosen subticks for specific minute/hour/day range (as specified in getTickStep) { case 5*60: result = 4; break; case 10*60: result = 1; break; case 15*60: result = 2; break; case 30*60: result = 1; break; case 60*60: result = 3; break; case 3600*2: result = 3; break; case 3600*3: result = 2; break; case 3600*6: result = 1; break; case 3600*12: result = 3; break; case 3600*24: result = 3; break; } return result; } /*! \internal Returns the tick label corresponding to the provided \a tick and the configured format and field widths (\ref setTimeFormat, \ref setFieldWidth). \seebaseclassmethod */ QString QCPAxisTickerTime::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) { Q_UNUSED(precision) Q_UNUSED(formatChar) Q_UNUSED(locale) bool negative = tick < 0; if (negative) tick *= -1; double values[tuDays+1]; // contains the msec/sec/min/... value with its respective modulo (e.g. minute 0..59) double restValues[tuDays+1]; // contains the msec/sec/min/... value as if it's the largest available unit and thus consumes the remaining time restValues[tuMilliseconds] = tick*1000; values[tuMilliseconds] = modf(restValues[tuMilliseconds]/1000, &restValues[tuSeconds])*1000; values[tuSeconds] = modf(restValues[tuSeconds]/60, &restValues[tuMinutes])*60; values[tuMinutes] = modf(restValues[tuMinutes]/60, &restValues[tuHours])*60; values[tuHours] = modf(restValues[tuHours]/24, &restValues[tuDays])*24; // no need to set values[tuDays] because days are always a rest value (there is no higher unit so it consumes all remaining time) QString result = mTimeFormat; for (int i = mSmallestUnit; i <= mBiggestUnit; ++i) { TimeUnit iUnit = static_cast(i); replaceUnit(result, iUnit, qRound(iUnit == mBiggestUnit ? restValues[iUnit] : values[iUnit])); } if (negative) result.prepend(QLatin1Char('-')); return result; } /*! \internal Replaces all occurrences of the format pattern belonging to \a unit in \a text with the specified \a value, using the field width as specified with \ref setFieldWidth for the \a unit. */ void QCPAxisTickerTime::replaceUnit(QString &text, QCPAxisTickerTime::TimeUnit unit, int value) const { QString valueStr = QString::number(value); while (valueStr.size() < mFieldWidth.value(unit)) valueStr.prepend(QLatin1Char('0')); text.replace(mFormatPattern.value(unit), valueStr); } /* end of 'src/axis/axistickertime.cpp' */ /* including file 'src/axis/axistickerfixed.cpp' */ /* modified 2021-03-29T02:30:44, size 5575 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTickerFixed //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTickerFixed \brief Specialized axis ticker with a fixed tick step \image html axisticker-fixed.png This QCPAxisTicker subclass generates ticks with a fixed tick step set with \ref setTickStep. It is also possible to allow integer multiples and integer powers of the specified tick step with \ref setScaleStrategy. A typical application of this ticker is to make an axis only display integers, by setting the tick step of the ticker to 1.0 and the scale strategy to \ref ssMultiples. Another case is when a certain number has a special meaning and axis ticks should only appear at multiples of that value. In this case you might also want to consider \ref QCPAxisTickerPi because despite the name it is not limited to only pi symbols/values. The ticker can be created and assigned to an axis like this: \snippet documentation/doc-image-generator/mainwindow.cpp axistickerfixed-creation */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTickerFixed::QCPAxisTickerFixed() : mTickStep(1.0), mScaleStrategy(ssNone) { } /*! Sets the fixed tick interval to \a step. The axis ticker will only use this tick step when generating axis ticks. This might cause a very high tick density and overlapping labels if the axis range is zoomed out. Using \ref setScaleStrategy it is possible to relax the fixed step and also allow multiples or powers of \a step. This will enable the ticker to reduce the number of ticks to a reasonable amount (see \ref setTickCount). */ void QCPAxisTickerFixed::setTickStep(double step) { if (step > 0) mTickStep = step; else qDebug() << Q_FUNC_INFO << "tick step must be greater than zero:" << step; } /*! Sets whether the specified tick step (\ref setTickStep) is absolutely fixed or whether modifications may be applied to it before calculating the finally used tick step, such as permitting multiples or powers. See \ref ScaleStrategy for details. The default strategy is \ref ssNone, which means the tick step is absolutely fixed. */ void QCPAxisTickerFixed::setScaleStrategy(QCPAxisTickerFixed::ScaleStrategy strategy) { mScaleStrategy = strategy; } /*! \internal Determines the actually used tick step from the specified tick step and scale strategy (\ref setTickStep, \ref setScaleStrategy). This method either returns the specified tick step exactly, or, if the scale strategy is not \ref ssNone, a modification of it to allow varying the number of ticks in the current axis range. \seebaseclassmethod */ double QCPAxisTickerFixed::getTickStep(const QCPRange &range) { switch (mScaleStrategy) { case ssNone: { return mTickStep; } case ssMultiples: { double exactStep = range.size()/double(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers if (exactStep < mTickStep) return mTickStep; else return qint64(cleanMantissa(exactStep/mTickStep)+0.5)*mTickStep; } case ssPowers: { double exactStep = range.size()/double(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers return qPow(mTickStep, int(qLn(exactStep)/qLn(mTickStep)+0.5)); } } return mTickStep; } /* end of 'src/axis/axistickerfixed.cpp' */ /* including file 'src/axis/axistickertext.cpp' */ /* modified 2021-03-29T02:30:44, size 8742 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTickerText //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTickerText \brief Specialized axis ticker which allows arbitrary labels at specified coordinates \image html axisticker-text.png This QCPAxisTicker subclass generates ticks which can be directly specified by the user as coordinates and associated strings. They can be passed as a whole with \ref setTicks or one at a time with \ref addTick. Alternatively you can directly access the internal storage via \ref ticks and modify the tick/label data there. This is useful for cases where the axis represents categories rather than numerical values. If you are updating the ticks of this ticker regularly and in a dynamic fasion (e.g. dependent on the axis range), it is a sign that you should probably create an own ticker by subclassing QCPAxisTicker, instead of using this one. The ticker can be created and assigned to an axis like this: \snippet documentation/doc-image-generator/mainwindow.cpp axistickertext-creation */ /* start of documentation of inline functions */ /*! \fn QMap &QCPAxisTickerText::ticks() Returns a non-const reference to the internal map which stores the tick coordinates and their labels. You can access the map directly in order to add, remove or manipulate ticks, as an alternative to using the methods provided by QCPAxisTickerText, such as \ref setTicks and \ref addTick. */ /* end of documentation of inline functions */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTickerText::QCPAxisTickerText() : mSubTickCount(0) { } /*! \overload Sets the ticks that shall appear on the axis. The map key of \a ticks corresponds to the axis coordinate, and the map value is the string that will appear as tick label. An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks getter. \see addTicks, addTick, clear */ void QCPAxisTickerText::setTicks(const QMap &ticks) { mTicks = ticks; } /*! \overload Sets the ticks that shall appear on the axis. The entries of \a positions correspond to the axis coordinates, and the entries of \a labels are the respective strings that will appear as tick labels. \see addTicks, addTick, clear */ void QCPAxisTickerText::setTicks(const QVector &positions, const QVector &labels) { clear(); addTicks(positions, labels); } /*! Sets the number of sub ticks that shall appear between ticks. For QCPAxisTickerText, there is no automatic sub tick count calculation. So if sub ticks are needed, they must be configured with this method. */ void QCPAxisTickerText::setSubTickCount(int subTicks) { if (subTicks >= 0) mSubTickCount = subTicks; else qDebug() << Q_FUNC_INFO << "sub tick count can't be negative:" << subTicks; } /*! Clears all ticks. An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks getter. \see setTicks, addTicks, addTick */ void QCPAxisTickerText::clear() { mTicks.clear(); } /*! Adds a single tick to the axis at the given axis coordinate \a position, with the provided tick \a label. \see addTicks, setTicks, clear */ void QCPAxisTickerText::addTick(double position, const QString &label) { mTicks.insert(position, label); } /*! \overload Adds the provided \a ticks to the ones already existing. The map key of \a ticks corresponds to the axis coordinate, and the map value is the string that will appear as tick label. An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks getter. \see addTick, setTicks, clear */ void QCPAxisTickerText::addTicks(const QMap &ticks) { #if QT_VERSION < QT_VERSION_CHECK(5, 15, 0) mTicks.unite(ticks); #else mTicks.insert(ticks); #endif } /*! \overload Adds the provided ticks to the ones already existing. The entries of \a positions correspond to the axis coordinates, and the entries of \a labels are the respective strings that will appear as tick labels. An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks getter. \see addTick, setTicks, clear */ void QCPAxisTickerText::addTicks(const QVector &positions, const QVector &labels) { if (positions.size() != labels.size()) qDebug() << Q_FUNC_INFO << "passed unequal length vectors for positions and labels:" << positions.size() << labels.size(); int n = qMin(positions.size(), labels.size()); for (int i=0; i QCPAxisTickerText::createTickVector(double tickStep, const QCPRange &range) { Q_UNUSED(tickStep) QVector result; if (mTicks.isEmpty()) return result; QMap::const_iterator start = mTicks.lowerBound(range.lower); QMap::const_iterator end = mTicks.upperBound(range.upper); // this method should try to give one tick outside of range so proper subticks can be generated: if (start != mTicks.constBegin()) --start; if (end != mTicks.constEnd()) ++end; for (QMap::const_iterator it = start; it != end; ++it) result.append(it.key()); return result; } /* end of 'src/axis/axistickertext.cpp' */ /* including file 'src/axis/axistickerpi.cpp' */ /* modified 2021-03-29T02:30:44, size 11177 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTickerPi //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTickerPi \brief Specialized axis ticker to display ticks in units of an arbitrary constant, for example pi \image html axisticker-pi.png This QCPAxisTicker subclass generates ticks that are expressed with respect to a given symbolic constant with a numerical value specified with \ref setPiValue and an appearance in the tick labels specified with \ref setPiSymbol. Ticks may be generated at fractions of the symbolic constant. How these fractions appear in the tick label can be configured with \ref setFractionStyle. The ticker can be created and assigned to an axis like this: \snippet documentation/doc-image-generator/mainwindow.cpp axistickerpi-creation */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTickerPi::QCPAxisTickerPi() : mPiSymbol(QLatin1String(" ")+QChar(0x03C0)), mPiValue(M_PI), mPeriodicity(0), mFractionStyle(fsUnicodeFractions), mPiTickStep(0) { setTickCount(4); } /*! Sets how the symbol part (which is always a suffix to the number) shall appear in the axis tick label. If a space shall appear between the number and the symbol, make sure the space is contained in \a symbol. */ void QCPAxisTickerPi::setPiSymbol(QString symbol) { mPiSymbol = symbol; } /*! Sets the numerical value that the symbolic constant has. This will be used to place the appropriate fractions of the symbol at the respective axis coordinates. */ void QCPAxisTickerPi::setPiValue(double pi) { mPiValue = pi; } /*! Sets whether the axis labels shall appear periodicly and if so, at which multiplicity of the symbolic constant. To disable periodicity, set \a multiplesOfPi to zero. For example, an axis that identifies 0 with 2pi would set \a multiplesOfPi to two. */ void QCPAxisTickerPi::setPeriodicity(int multiplesOfPi) { mPeriodicity = qAbs(multiplesOfPi); } /*! Sets how the numerical/fractional part preceding the symbolic constant is displayed in tick labels. See \ref FractionStyle for the various options. */ void QCPAxisTickerPi::setFractionStyle(QCPAxisTickerPi::FractionStyle style) { mFractionStyle = style; } /*! \internal Returns the tick step, using the constant's value (\ref setPiValue) as base unit. In consequence the numerical/fractional part preceding the symbolic constant is made to have a readable mantissa. \seebaseclassmethod */ double QCPAxisTickerPi::getTickStep(const QCPRange &range) { mPiTickStep = range.size()/mPiValue/double(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers mPiTickStep = cleanMantissa(mPiTickStep); return mPiTickStep*mPiValue; } /*! \internal Returns the sub tick count, using the constant's value (\ref setPiValue) as base unit. In consequence the sub ticks divide the numerical/fractional part preceding the symbolic constant reasonably, and not the total tick coordinate. \seebaseclassmethod */ int QCPAxisTickerPi::getSubTickCount(double tickStep) { return QCPAxisTicker::getSubTickCount(tickStep/mPiValue); } /*! \internal Returns the tick label as a fractional/numerical part and a symbolic string as suffix. The formatting of the fraction is done according to the specified \ref setFractionStyle. The appended symbol is specified with \ref setPiSymbol. \seebaseclassmethod */ QString QCPAxisTickerPi::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) { double tickInPis = tick/mPiValue; if (mPeriodicity > 0) tickInPis = fmod(tickInPis, mPeriodicity); if (mFractionStyle != fsFloatingPoint && mPiTickStep > 0.09 && mPiTickStep < 50) { // simply construct fraction from decimal like 1.234 -> 1234/1000 and then simplify fraction, smaller digits are irrelevant due to mPiTickStep conditional above int denominator = 1000; int numerator = qRound(tickInPis*denominator); simplifyFraction(numerator, denominator); if (qAbs(numerator) == 1 && denominator == 1) return (numerator < 0 ? QLatin1String("-") : QLatin1String("")) + mPiSymbol.trimmed(); else if (numerator == 0) return QLatin1String("0"); else return fractionToString(numerator, denominator) + mPiSymbol; } else { if (qFuzzyIsNull(tickInPis)) return QLatin1String("0"); else if (qFuzzyCompare(qAbs(tickInPis), 1.0)) return (tickInPis < 0 ? QLatin1String("-") : QLatin1String("")) + mPiSymbol.trimmed(); else return QCPAxisTicker::getTickLabel(tickInPis, locale, formatChar, precision) + mPiSymbol; } } /*! \internal Takes the fraction given by \a numerator and \a denominator and modifies the values to make sure the fraction is in irreducible form, i.e. numerator and denominator don't share any common factors which could be cancelled. */ void QCPAxisTickerPi::simplifyFraction(int &numerator, int &denominator) const { if (numerator == 0 || denominator == 0) return; int num = numerator; int denom = denominator; while (denom != 0) // euclidean gcd algorithm { int oldDenom = denom; denom = num % denom; num = oldDenom; } // num is now gcd of numerator and denominator numerator /= num; denominator /= num; } /*! \internal Takes the fraction given by \a numerator and \a denominator and returns a string representation. The result depends on the configured fraction style (\ref setFractionStyle). This method is used to format the numerical/fractional part when generating tick labels. It simplifies the passed fraction to an irreducible form using \ref simplifyFraction and factors out any integer parts of the fraction (e.g. "10/4" becomes "2 1/2"). */ QString QCPAxisTickerPi::fractionToString(int numerator, int denominator) const { if (denominator == 0) { qDebug() << Q_FUNC_INFO << "called with zero denominator"; return QString(); } if (mFractionStyle == fsFloatingPoint) // should never be the case when calling this function { qDebug() << Q_FUNC_INFO << "shouldn't be called with fraction style fsDecimal"; return QString::number(numerator/double(denominator)); // failsafe } int sign = numerator*denominator < 0 ? -1 : 1; numerator = qAbs(numerator); denominator = qAbs(denominator); if (denominator == 1) { return QString::number(sign*numerator); } else { int integerPart = numerator/denominator; int remainder = numerator%denominator; if (remainder == 0) { return QString::number(sign*integerPart); } else { if (mFractionStyle == fsAsciiFractions) { return QString(QLatin1String("%1%2%3/%4")) .arg(sign == -1 ? QLatin1String("-") : QLatin1String("")) .arg(integerPart > 0 ? QString::number(integerPart)+QLatin1String(" ") : QString(QLatin1String(""))) .arg(remainder) .arg(denominator); } else if (mFractionStyle == fsUnicodeFractions) { return QString(QLatin1String("%1%2%3")) .arg(sign == -1 ? QLatin1String("-") : QLatin1String("")) .arg(integerPart > 0 ? QString::number(integerPart) : QLatin1String("")) .arg(unicodeFraction(remainder, denominator)); } } } return QString(); } /*! \internal Returns the unicode string representation of the fraction given by \a numerator and \a denominator. This is the representation used in \ref fractionToString when the fraction style (\ref setFractionStyle) is \ref fsUnicodeFractions. This method doesn't use the single-character common fractions but builds each fraction from a superscript unicode number, the unicode fraction character, and a subscript unicode number. */ QString QCPAxisTickerPi::unicodeFraction(int numerator, int denominator) const { return unicodeSuperscript(numerator)+QChar(0x2044)+unicodeSubscript(denominator); } /*! \internal Returns the unicode string representing \a number as superscript. This is used to build unicode fractions in \ref unicodeFraction. */ QString QCPAxisTickerPi::unicodeSuperscript(int number) const { if (number == 0) return QString(QChar(0x2070)); QString result; while (number > 0) { const int digit = number%10; switch (digit) { case 1: { result.prepend(QChar(0x00B9)); break; } case 2: { result.prepend(QChar(0x00B2)); break; } case 3: { result.prepend(QChar(0x00B3)); break; } default: { result.prepend(QChar(0x2070+digit)); break; } } number /= 10; } return result; } /*! \internal Returns the unicode string representing \a number as subscript. This is used to build unicode fractions in \ref unicodeFraction. */ QString QCPAxisTickerPi::unicodeSubscript(int number) const { if (number == 0) return QString(QChar(0x2080)); QString result; while (number > 0) { result.prepend(QChar(0x2080+number%10)); number /= 10; } return result; } /* end of 'src/axis/axistickerpi.cpp' */ /* including file 'src/axis/axistickerlog.cpp' */ /* modified 2021-03-29T02:30:44, size 7890 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisTickerLog //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisTickerLog \brief Specialized axis ticker suited for logarithmic axes \image html axisticker-log.png This QCPAxisTicker subclass generates ticks with unequal tick intervals suited for logarithmic axis scales. The ticks are placed at powers of the specified log base (\ref setLogBase). Especially in the case of a log base equal to 10 (the default), it might be desirable to have tick labels in the form of powers of ten without mantissa display. To achieve this, set the number precision (\ref QCPAxis::setNumberPrecision) to zero and the number format (\ref QCPAxis::setNumberFormat) to scientific (exponential) display with beautifully typeset decimal powers, so a format string of "eb". This will result in the following axis tick labels: \image html axisticker-log-powers.png The ticker can be created and assigned to an axis like this: \snippet documentation/doc-image-generator/mainwindow.cpp axistickerlog-creation Note that the nature of logarithmic ticks imply that there exists a smallest possible tick step, corresponding to one multiplication by the log base. If the user zooms in further than that, no new ticks would appear, leading to very sparse or even no axis ticks on the axis. To prevent this situation, this ticker falls back to regular tick generation if the axis range would be covered by too few logarithmically placed ticks. */ /*! Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. */ QCPAxisTickerLog::QCPAxisTickerLog() : mLogBase(10.0), mSubTickCount(8), // generates 10 intervals mLogBaseLnInv(1.0/qLn(mLogBase)) { } /*! Sets the logarithm base used for tick coordinate generation. The ticks will be placed at integer powers of \a base. */ void QCPAxisTickerLog::setLogBase(double base) { if (base > 0) { mLogBase = base; mLogBaseLnInv = 1.0/qLn(mLogBase); } else qDebug() << Q_FUNC_INFO << "log base has to be greater than zero:" << base; } /*! Sets the number of sub ticks in a tick interval. Within each interval, the sub ticks are spaced linearly to provide a better visual guide, so the sub tick density increases toward the higher tick. Note that \a subTicks is the number of sub ticks (not sub intervals) in one tick interval. So in the case of logarithm base 10 an intuitive sub tick spacing would be achieved with eight sub ticks (the default). This means e.g. between the ticks 10 and 100 there will be eight ticks, namely at 20, 30, 40, 50, 60, 70, 80 and 90. */ void QCPAxisTickerLog::setSubTickCount(int subTicks) { if (subTicks >= 0) mSubTickCount = subTicks; else qDebug() << Q_FUNC_INFO << "sub tick count can't be negative:" << subTicks; } /*! \internal Returns the sub tick count specified in \ref setSubTickCount. For QCPAxisTickerLog, there is no automatic sub tick count calculation necessary. \seebaseclassmethod */ int QCPAxisTickerLog::getSubTickCount(double tickStep) { Q_UNUSED(tickStep) return mSubTickCount; } /*! \internal Creates ticks with a spacing given by the logarithm base and an increasing integer power in the provided \a range. The step in which the power increases tick by tick is chosen in order to keep the total number of ticks as close as possible to the tick count (\ref setTickCount). The parameter \a tickStep is ignored for the normal logarithmic ticker generation. Only when zoomed in very far such that not enough logarithmically placed ticks would be visible, this function falls back to the regular QCPAxisTicker::createTickVector, which then uses \a tickStep. \seebaseclassmethod */ QVector QCPAxisTickerLog::createTickVector(double tickStep, const QCPRange &range) { QVector result; if (range.lower > 0 && range.upper > 0) // positive range { const double baseTickCount = qLn(range.upper/range.lower)*mLogBaseLnInv; if (baseTickCount < 1.6) // if too few log ticks would be visible in axis range, fall back to regular tick vector generation return QCPAxisTicker::createTickVector(tickStep, range); const double exactPowerStep = baseTickCount/double(mTickCount+1e-10); const double newLogBase = qPow(mLogBase, qMax(int(cleanMantissa(exactPowerStep)), 1)); double currentTick = qPow(newLogBase, qFloor(qLn(range.lower)/qLn(newLogBase))); result.append(currentTick); while (currentTick < range.upper && currentTick > 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case { currentTick *= newLogBase; result.append(currentTick); } } else if (range.lower < 0 && range.upper < 0) // negative range { const double baseTickCount = qLn(range.lower/range.upper)*mLogBaseLnInv; if (baseTickCount < 1.6) // if too few log ticks would be visible in axis range, fall back to regular tick vector generation return QCPAxisTicker::createTickVector(tickStep, range); const double exactPowerStep = baseTickCount/double(mTickCount+1e-10); const double newLogBase = qPow(mLogBase, qMax(int(cleanMantissa(exactPowerStep)), 1)); double currentTick = -qPow(newLogBase, qCeil(qLn(-range.lower)/qLn(newLogBase))); result.append(currentTick); while (currentTick < range.upper && currentTick < 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case { currentTick /= newLogBase; result.append(currentTick); } } else // invalid range for logarithmic scale, because lower and upper have different sign { qDebug() << Q_FUNC_INFO << "Invalid range for logarithmic plot: " << range.lower << ".." << range.upper; } return result; } /* end of 'src/axis/axistickerlog.cpp' */ /* including file 'src/axis/axis.cpp' */ /* modified 2021-03-29T02:30:44, size 99883 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPGrid //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPGrid \brief Responsible for drawing the grid of a QCPAxis. This class is tightly bound to QCPAxis. Every axis owns a grid instance and uses it to draw the grid lines, sub grid lines and zero-line. You can interact with the grid of an axis via \ref QCPAxis::grid. Normally, you don't need to create an instance of QCPGrid yourself. The axis and grid drawing was split into two classes to allow them to be placed on different layers (both QCPAxis and QCPGrid inherit from QCPLayerable). Thus it is possible to have the grid in the background and the axes in the foreground, and any plottables/items in between. This described situation is the default setup, see the QCPLayer documentation. */ /*! Creates a QCPGrid instance and sets default values. You shouldn't instantiate grids on their own, since every QCPAxis brings its own QCPGrid. */ QCPGrid::QCPGrid(QCPAxis *parentAxis) : QCPLayerable(parentAxis->parentPlot(), QString(), parentAxis), mSubGridVisible{}, mAntialiasedSubGrid{}, mAntialiasedZeroLine{}, mParentAxis(parentAxis) { // warning: this is called in QCPAxis constructor, so parentAxis members should not be accessed/called setParent(parentAxis); setPen(QPen(QColor(200,200,200), 0, Qt::DotLine)); setSubGridPen(QPen(QColor(220,220,220), 0, Qt::DotLine)); setZeroLinePen(QPen(QColor(200,200,200), 0, Qt::SolidLine)); setSubGridVisible(false); setAntialiased(false); setAntialiasedSubGrid(false); setAntialiasedZeroLine(false); } /*! Sets whether grid lines at sub tick marks are drawn. \see setSubGridPen */ void QCPGrid::setSubGridVisible(bool visible) { mSubGridVisible = visible; } /*! Sets whether sub grid lines are drawn antialiased. */ void QCPGrid::setAntialiasedSubGrid(bool enabled) { mAntialiasedSubGrid = enabled; } /*! Sets whether zero lines are drawn antialiased. */ void QCPGrid::setAntialiasedZeroLine(bool enabled) { mAntialiasedZeroLine = enabled; } /*! Sets the pen with which (major) grid lines are drawn. */ void QCPGrid::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen with which sub grid lines are drawn. */ void QCPGrid::setSubGridPen(const QPen &pen) { mSubGridPen = pen; } /*! Sets the pen with which zero lines are drawn. Zero lines are lines at value coordinate 0 which may be drawn with a different pen than other grid lines. To disable zero lines and just draw normal grid lines at zero, set \a pen to Qt::NoPen. */ void QCPGrid::setZeroLinePen(const QPen &pen) { mZeroLinePen = pen; } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing the major grid lines. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \see setAntialiased */ void QCPGrid::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeGrid); } /*! \internal Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning over the complete axis rect. Also draws the zero line, if appropriate (\ref setZeroLinePen). */ void QCPGrid::draw(QCPPainter *painter) { if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } if (mParentAxis->subTicks() && mSubGridVisible) drawSubGridLines(painter); drawGridLines(painter); } /*! \internal Draws the main grid lines and possibly a zero line with the specified painter. This is a helper function called by \ref draw. */ void QCPGrid::drawGridLines(QCPPainter *painter) const { if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } const int tickCount = mParentAxis->mTickVector.size(); double t; // helper variable, result of coordinate-to-pixel transforms if (mParentAxis->orientation() == Qt::Horizontal) { // draw zeroline: int zeroLineIndex = -1; if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0) { applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); painter->setPen(mZeroLinePen); double epsilon = mParentAxis->range().size()*1E-6; // for comparing double to zero for (int i=0; imTickVector.at(i)) < epsilon) { zeroLineIndex = i; t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // x painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); break; } } } // draw grid lines: applyDefaultAntialiasingHint(painter); painter->setPen(mPen); for (int i=0; icoordToPixel(mParentAxis->mTickVector.at(i)); // x painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); } } else { // draw zeroline: int zeroLineIndex = -1; if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0) { applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); painter->setPen(mZeroLinePen); double epsilon = mParentAxis->mRange.size()*1E-6; // for comparing double to zero for (int i=0; imTickVector.at(i)) < epsilon) { zeroLineIndex = i; t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // y painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); break; } } } // draw grid lines: applyDefaultAntialiasingHint(painter); painter->setPen(mPen); for (int i=0; icoordToPixel(mParentAxis->mTickVector.at(i)); // y painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); } } } /*! \internal Draws the sub grid lines with the specified painter. This is a helper function called by \ref draw. */ void QCPGrid::drawSubGridLines(QCPPainter *painter) const { if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } applyAntialiasingHint(painter, mAntialiasedSubGrid, QCP::aeSubGrid); double t; // helper variable, result of coordinate-to-pixel transforms painter->setPen(mSubGridPen); if (mParentAxis->orientation() == Qt::Horizontal) { foreach (double tickCoord, mParentAxis->mSubTickVector) { t = mParentAxis->coordToPixel(tickCoord); // x painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); } } else { foreach (double tickCoord, mParentAxis->mSubTickVector) { t = mParentAxis->coordToPixel(tickCoord); // y painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); } } } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxis //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxis \brief Manages a single axis inside a QCustomPlot. Usually doesn't need to be instantiated externally. Access %QCustomPlot's default four axes via QCustomPlot::xAxis (bottom), QCustomPlot::yAxis (left), QCustomPlot::xAxis2 (top) and QCustomPlot::yAxis2 (right). Axes are always part of an axis rect, see QCPAxisRect. \image html AxisNamesOverview.png
Naming convention of axis parts
\n \image html AxisRectSpacingOverview.png
Overview of the spacings and paddings that define the geometry of an axis. The dashed gray line on the left represents the QCustomPlot widget border.
Each axis holds an instance of QCPAxisTicker which is used to generate the tick coordinates and tick labels. You can access the currently installed \ref ticker or set a new one (possibly one of the specialized subclasses, or your own subclass) via \ref setTicker. For details, see the documentation of QCPAxisTicker. */ /* start of documentation of inline functions */ /*! \fn Qt::Orientation QCPAxis::orientation() const Returns the orientation of this axis. The axis orientation (horizontal or vertical) is deduced from the axis type (left, top, right or bottom). \see orientation(AxisType type), pixelOrientation */ /*! \fn QCPGrid *QCPAxis::grid() const Returns the \ref QCPGrid instance belonging to this axis. Access it to set details about the way the grid is displayed. */ /*! \fn static Qt::Orientation QCPAxis::orientation(AxisType type) Returns the orientation of the specified axis type \see orientation(), pixelOrientation */ /*! \fn int QCPAxis::pixelOrientation() const Returns which direction points towards higher coordinate values/keys, in pixel space. This method returns either 1 or -1. If it returns 1, then going in the positive direction along the orientation of the axis in pixels corresponds to going from lower to higher axis coordinates. On the other hand, if this method returns -1, going to smaller pixel values corresponds to going from lower to higher axis coordinates. For example, this is useful to easily shift axis coordinates by a certain amount given in pixels, without having to care about reversed or vertically aligned axes: \code double newKey = keyAxis->pixelToCoord(keyAxis->coordToPixel(oldKey)+10*keyAxis->pixelOrientation()); \endcode \a newKey will then contain a key that is ten pixels towards higher keys, starting from \a oldKey. */ /*! \fn QSharedPointer QCPAxis::ticker() const Returns a modifiable shared pointer to the currently installed axis ticker. The axis ticker is responsible for generating the tick positions and tick labels of this axis. You can access the \ref QCPAxisTicker with this method and modify basic properties such as the approximate tick count (\ref QCPAxisTicker::setTickCount). You can gain more control over the axis ticks by setting a different \ref QCPAxisTicker subclass, see the documentation there. A new axis ticker can be set with \ref setTicker. Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes. \see setTicker */ /* end of documentation of inline functions */ /* start of documentation of signals */ /*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange) This signal is emitted when the range of this axis has changed. You can connect it to the \ref setRange slot of another axis to communicate the new range to the other axis, in order for it to be synchronized. You may also manipulate/correct the range with \ref setRange in a slot connected to this signal. This is useful if for example a maximum range span shall not be exceeded, or if the lower/upper range shouldn't go beyond certain values (see \ref QCPRange::bounded). For example, the following slot would limit the x axis to ranges between 0 and 10: \code customPlot->xAxis->setRange(newRange.bounded(0, 10)) \endcode */ /*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange, const QCPRange &oldRange) \overload Additionally to the new range, this signal also provides the previous range held by the axis as \a oldRange. */ /*! \fn void QCPAxis::scaleTypeChanged(QCPAxis::ScaleType scaleType); This signal is emitted when the scale type changes, by calls to \ref setScaleType */ /*! \fn void QCPAxis::selectionChanged(QCPAxis::SelectableParts selection) This signal is emitted when the selection state of this axis has changed, either by user interaction or by a direct call to \ref setSelectedParts. */ /*! \fn void QCPAxis::selectableChanged(const QCPAxis::SelectableParts &parts); This signal is emitted when the selectability changes, by calls to \ref setSelectableParts */ /* end of documentation of signals */ /*! Constructs an Axis instance of Type \a type for the axis rect \a parent. Usually it isn't necessary to instantiate axes directly, because you can let QCustomPlot create them for you with \ref QCPAxisRect::addAxis. If you want to use own QCPAxis-subclasses however, create them manually and then inject them also via \ref QCPAxisRect::addAxis. */ QCPAxis::QCPAxis(QCPAxisRect *parent, AxisType type) : QCPLayerable(parent->parentPlot(), QString(), parent), // axis base: mAxisType(type), mAxisRect(parent), mPadding(5), mOrientation(orientation(type)), mSelectableParts(spAxis | spTickLabels | spAxisLabel), mSelectedParts(spNone), mBasePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedBasePen(QPen(Qt::blue, 2)), // axis label: mLabel(), mLabelFont(mParentPlot->font()), mSelectedLabelFont(QFont(mLabelFont.family(), mLabelFont.pointSize(), QFont::Bold)), mLabelColor(Qt::black), mSelectedLabelColor(Qt::blue), // tick labels: mTickLabels(true), mTickLabelFont(mParentPlot->font()), mSelectedTickLabelFont(QFont(mTickLabelFont.family(), mTickLabelFont.pointSize(), QFont::Bold)), mTickLabelColor(Qt::black), mSelectedTickLabelColor(Qt::blue), mNumberPrecision(6), mNumberFormatChar('g'), mNumberBeautifulPowers(true), // ticks and subticks: mTicks(true), mSubTicks(true), mTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedTickPen(QPen(Qt::blue, 2)), mSubTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedSubTickPen(QPen(Qt::blue, 2)), // scale and range: mRange(0, 5), mRangeReversed(false), mScaleType(stLinear), // internal members: mGrid(new QCPGrid(this)), mAxisPainter(new QCPAxisPainterPrivate(parent->parentPlot())), mTicker(new QCPAxisTicker), mCachedMarginValid(false), mCachedMargin(0), mDragging(false) { setParent(parent); mGrid->setVisible(false); setAntialiased(false); setLayer(mParentPlot->currentLayer()); // it's actually on that layer already, but we want it in front of the grid, so we place it on there again if (type == atTop) { setTickLabelPadding(3); setLabelPadding(6); } else if (type == atRight) { setTickLabelPadding(7); setLabelPadding(12); } else if (type == atBottom) { setTickLabelPadding(3); setLabelPadding(3); } else if (type == atLeft) { setTickLabelPadding(5); setLabelPadding(10); } } QCPAxis::~QCPAxis() { delete mAxisPainter; delete mGrid; // delete grid here instead of via parent ~QObject for better defined deletion order } /* No documentation as it is a property getter */ int QCPAxis::tickLabelPadding() const { return mAxisPainter->tickLabelPadding; } /* No documentation as it is a property getter */ double QCPAxis::tickLabelRotation() const { return mAxisPainter->tickLabelRotation; } /* No documentation as it is a property getter */ QCPAxis::LabelSide QCPAxis::tickLabelSide() const { return mAxisPainter->tickLabelSide; } /* No documentation as it is a property getter */ QString QCPAxis::numberFormat() const { QString result; result.append(mNumberFormatChar); if (mNumberBeautifulPowers) { result.append(QLatin1Char('b')); if (mAxisPainter->numberMultiplyCross) result.append(QLatin1Char('c')); } return result; } /* No documentation as it is a property getter */ int QCPAxis::tickLengthIn() const { return mAxisPainter->tickLengthIn; } /* No documentation as it is a property getter */ int QCPAxis::tickLengthOut() const { return mAxisPainter->tickLengthOut; } /* No documentation as it is a property getter */ int QCPAxis::subTickLengthIn() const { return mAxisPainter->subTickLengthIn; } /* No documentation as it is a property getter */ int QCPAxis::subTickLengthOut() const { return mAxisPainter->subTickLengthOut; } /* No documentation as it is a property getter */ int QCPAxis::labelPadding() const { return mAxisPainter->labelPadding; } /* No documentation as it is a property getter */ int QCPAxis::offset() const { return mAxisPainter->offset; } /* No documentation as it is a property getter */ QCPLineEnding QCPAxis::lowerEnding() const { return mAxisPainter->lowerEnding; } /* No documentation as it is a property getter */ QCPLineEnding QCPAxis::upperEnding() const { return mAxisPainter->upperEnding; } /*! Sets whether the axis uses a linear scale or a logarithmic scale. Note that this method controls the coordinate transformation. For logarithmic scales, you will likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting the axis ticker to an instance of \ref QCPAxisTickerLog : \snippet documentation/doc-code-snippets/mainwindow.cpp qcpaxisticker-log-creation See the documentation of \ref QCPAxisTickerLog about the details of logarithmic axis tick creation. \ref setNumberPrecision */ void QCPAxis::setScaleType(QCPAxis::ScaleType type) { if (mScaleType != type) { mScaleType = type; if (mScaleType == stLogarithmic) setRange(mRange.sanitizedForLogScale()); mCachedMarginValid = false; emit scaleTypeChanged(mScaleType); } } /*! Sets the range of the axis. This slot may be connected with the \ref rangeChanged signal of another axis so this axis is always synchronized with the other axis range, when it changes. To invert the direction of an axis, use \ref setRangeReversed. */ void QCPAxis::setRange(const QCPRange &range) { if (range.lower == mRange.lower && range.upper == mRange.upper) return; if (!QCPRange::validRange(range)) return; QCPRange oldRange = mRange; if (mScaleType == stLogarithmic) { mRange = range.sanitizedForLogScale(); } else { mRange = range.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. (When \ref QCustomPlot::setInteractions contains iSelectAxes.) However, even when \a selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling \ref setSelectedParts directly. \see SelectablePart, setSelectedParts */ void QCPAxis::setSelectableParts(const SelectableParts &selectable) { if (mSelectableParts != selectable) { mSelectableParts = selectable; emit selectableChanged(mSelectableParts); } } /*! Sets the selected state of the respective axis parts described by \ref SelectablePart. When a part is selected, it uses a different pen/font. The entire selection mechanism for axes is handled automatically when \ref QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you wish to change the selection state manually. This function can change the selection state of a part, independent of the \ref setSelectableParts setting. emits the \ref selectionChanged signal when \a selected is different from the previous selection state. \see SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor */ void QCPAxis::setSelectedParts(const SelectableParts &selected) { if (mSelectedParts != selected) { mSelectedParts = selected; emit selectionChanged(mSelectedParts); } } /*! \overload Sets the lower and upper bound of the axis range. To invert the direction of an axis, use \ref setRangeReversed. There is also a slot to set a range, see \ref setRange(const QCPRange &range). */ void QCPAxis::setRange(double lower, double upper) { if (lower == mRange.lower && upper == mRange.upper) return; if (!QCPRange::validRange(lower, upper)) return; QCPRange oldRange = mRange; mRange.lower = lower; mRange.upper = upper; if (mScaleType == stLogarithmic) { mRange = mRange.sanitizedForLogScale(); } else { mRange = mRange.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! \overload Sets the range of the axis. The \a position coordinate indicates together with the \a alignment parameter, where the new range will be positioned. \a size defines the size of the new axis range. \a alignment may be Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, or center of the range to be aligned with \a position. Any other values of \a alignment will default to Qt::AlignCenter. */ void QCPAxis::setRange(double position, double size, Qt::AlignmentFlag alignment) { if (alignment == Qt::AlignLeft) setRange(position, position+size); else if (alignment == Qt::AlignRight) setRange(position-size, position); else // alignment == Qt::AlignCenter setRange(position-size/2.0, position+size/2.0); } /*! Sets the lower bound of the axis range. The upper bound is not changed. \see setRange */ void QCPAxis::setRangeLower(double lower) { if (mRange.lower == lower) return; QCPRange oldRange = mRange; mRange.lower = lower; if (mScaleType == stLogarithmic) { mRange = mRange.sanitizedForLogScale(); } else { mRange = mRange.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets the upper bound of the axis range. The lower bound is not changed. \see setRange */ void QCPAxis::setRangeUpper(double upper) { if (mRange.upper == upper) return; QCPRange oldRange = mRange; mRange.upper = upper; if (mScaleType == stLogarithmic) { mRange = mRange.sanitizedForLogScale(); } else { mRange = mRange.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When \a reversed is set to true, the direction of increasing values is inverted. Note that the range and data interface stays the same for reversed axes, e.g. the \a lower part of the \ref setRange interface will still reference the mathematically smaller number than the \a upper part. */ void QCPAxis::setRangeReversed(bool reversed) { mRangeReversed = reversed; } /*! The axis ticker is responsible for generating the tick positions and tick labels. See the documentation of QCPAxisTicker for details on how to work with axis tickers. You can change the tick positioning/labeling behaviour of this axis by setting a different QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis ticker, access it via \ref ticker. Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes. \see ticker */ void QCPAxis::setTicker(QSharedPointer ticker) { if (ticker) mTicker = ticker; else qDebug() << Q_FUNC_INFO << "can not set nullptr as axis ticker"; // no need to invalidate margin cache here because produced tick labels are checked for changes in setupTickVector } /*! Sets whether tick marks are displayed. Note that setting \a show to false does not imply that tick labels are invisible, too. To achieve that, see \ref setTickLabels. \see setSubTicks */ void QCPAxis::setTicks(bool show) { if (mTicks != show) { mTicks = show; mCachedMarginValid = false; } } /*! Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks. */ void QCPAxis::setTickLabels(bool show) { if (mTickLabels != show) { mTickLabels = show; mCachedMarginValid = false; if (!mTickLabels) mTickVectorLabels.clear(); } } /*! Sets the distance between the axis base line (including any outward ticks) and the tick labels. \see setLabelPadding, setPadding */ void QCPAxis::setTickLabelPadding(int padding) { if (mAxisPainter->tickLabelPadding != padding) { mAxisPainter->tickLabelPadding = padding; mCachedMarginValid = false; } } /*! Sets the font of the tick labels. \see setTickLabels, setTickLabelColor */ void QCPAxis::setTickLabelFont(const QFont &font) { if (font != mTickLabelFont) { mTickLabelFont = font; mCachedMarginValid = false; } } /*! Sets the color of the tick labels. \see setTickLabels, setTickLabelFont */ void QCPAxis::setTickLabelColor(const QColor &color) { mTickLabelColor = color; } /*! Sets the rotation of the tick labels. If \a degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by \a degrees clockwise. The specified angle is bound to values from -90 to 90 degrees. If \a degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For other angles, the label is drawn with an offset such that it seems to point toward or away from the tick mark. */ void QCPAxis::setTickLabelRotation(double degrees) { if (!qFuzzyIsNull(degrees-mAxisPainter->tickLabelRotation)) { mAxisPainter->tickLabelRotation = qBound(-90.0, degrees, 90.0); mCachedMarginValid = false; } } /*! Sets whether the tick labels (numbers) shall appear inside or outside the axis rect. The usual and default setting is \ref lsOutside. Very compact plots sometimes require tick labels to be inside the axis rect, to save space. If \a side is set to \ref lsInside, the tick labels appear on the inside are additionally clipped to the axis rect. */ void QCPAxis::setTickLabelSide(LabelSide side) { mAxisPainter->tickLabelSide = side; mCachedMarginValid = false; } /*! Sets the number format for the numbers in tick labels. This \a formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class. \a formatCode is a string of one, two or three characters. The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter. For the 'e', 'E', and 'f' formats, the precision set by \ref setNumberPrecision represents the number of digits after the decimal point. For the 'g' and 'G' formats, the precision represents the maximum number of significant digits, trailing zeroes are omitted. The second and third characters are optional and specific to QCustomPlot:\n If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which is ugly in a plot. So when the second char of \a formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of \a formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot. Examples for \a formatCode: \li \c g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used \li \c gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign \li \c ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign \li \c fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'. \li \c hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed. */ void QCPAxis::setNumberFormat(const QString &formatCode) { if (formatCode.isEmpty()) { qDebug() << Q_FUNC_INFO << "Passed formatCode is empty"; return; } mCachedMarginValid = false; // interpret first char as number format char: QString allowedFormatChars(QLatin1String("eEfgG")); if (allowedFormatChars.contains(formatCode.at(0))) { mNumberFormatChar = QLatin1Char(formatCode.at(0).toLatin1()); } else { qDebug() << Q_FUNC_INFO << "Invalid number format code (first char not in 'eEfgG'):" << formatCode; return; } if (formatCode.length() < 2) { mNumberBeautifulPowers = false; mAxisPainter->numberMultiplyCross = false; return; } // interpret second char as indicator for beautiful decimal powers: if (formatCode.at(1) == QLatin1Char('b') && (mNumberFormatChar == QLatin1Char('e') || mNumberFormatChar == QLatin1Char('g'))) { mNumberBeautifulPowers = true; } else { qDebug() << Q_FUNC_INFO << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode; return; } if (formatCode.length() < 3) { mAxisPainter->numberMultiplyCross = false; return; } // interpret third char as indicator for dot or cross multiplication symbol: if (formatCode.at(2) == QLatin1Char('c')) { mAxisPainter->numberMultiplyCross = true; } else if (formatCode.at(2) == QLatin1Char('d')) { mAxisPainter->numberMultiplyCross = false; } else { qDebug() << Q_FUNC_INFO << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode; return; } } /*! Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Formats starting with 'e', see \ref setNumberFormat */ void QCPAxis::setNumberPrecision(int precision) { if (mNumberPrecision != precision) { mNumberPrecision = precision; mCachedMarginValid = false; } } /*! Sets the length of the ticks in pixels. \a inside is the length the ticks will reach inside the plot and \a outside is the length they will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setSubTickLength, setTickLengthIn, setTickLengthOut */ void QCPAxis::setTickLength(int inside, int outside) { setTickLengthIn(inside); setTickLengthOut(outside); } /*! Sets the length of the inward ticks in pixels. \a inside is the length the ticks will reach inside the plot. \see setTickLengthOut, setTickLength, setSubTickLength */ void QCPAxis::setTickLengthIn(int inside) { if (mAxisPainter->tickLengthIn != inside) { mAxisPainter->tickLengthIn = inside; } } /*! Sets the length of the outward ticks in pixels. \a outside is the length the ticks will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setTickLengthIn, setTickLength, setSubTickLength */ void QCPAxis::setTickLengthOut(int outside) { if (mAxisPainter->tickLengthOut != outside) { mAxisPainter->tickLengthOut = outside; mCachedMarginValid = false; // only outside tick length can change margin } } /*! Sets whether sub tick marks are displayed. Sub ticks are only potentially visible if (major) ticks are also visible (see \ref setTicks) \see setTicks */ void QCPAxis::setSubTicks(bool show) { if (mSubTicks != show) { mSubTicks = show; mCachedMarginValid = false; } } /*! Sets the length of the subticks in pixels. \a inside is the length the subticks will reach inside the plot and \a outside is the length they will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setTickLength, setSubTickLengthIn, setSubTickLengthOut */ void QCPAxis::setSubTickLength(int inside, int outside) { setSubTickLengthIn(inside); setSubTickLengthOut(outside); } /*! Sets the length of the inward subticks in pixels. \a inside is the length the subticks will reach inside the plot. \see setSubTickLengthOut, setSubTickLength, setTickLength */ void QCPAxis::setSubTickLengthIn(int inside) { if (mAxisPainter->subTickLengthIn != inside) { mAxisPainter->subTickLengthIn = inside; } } /*! Sets the length of the outward subticks in pixels. \a outside is the length the subticks will reach outside the plot. If \a outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setSubTickLengthIn, setSubTickLength, setTickLength */ void QCPAxis::setSubTickLengthOut(int outside) { if (mAxisPainter->subTickLengthOut != outside) { mAxisPainter->subTickLengthOut = outside; mCachedMarginValid = false; // only outside tick length can change margin } } /*! Sets the pen, the axis base line is drawn with. \see setTickPen, setSubTickPen */ void QCPAxis::setBasePen(const QPen &pen) { mBasePen = pen; } /*! Sets the pen, tick marks will be drawn with. \see setTickLength, setBasePen */ void QCPAxis::setTickPen(const QPen &pen) { mTickPen = pen; } /*! Sets the pen, subtick marks will be drawn with. \see setSubTickCount, setSubTickLength, setBasePen */ void QCPAxis::setSubTickPen(const QPen &pen) { mSubTickPen = pen; } /*! Sets the font of the axis label. \see setLabelColor */ void QCPAxis::setLabelFont(const QFont &font) { if (mLabelFont != font) { mLabelFont = font; mCachedMarginValid = false; } } /*! Sets the color of the axis label. \see setLabelFont */ void QCPAxis::setLabelColor(const QColor &color) { mLabelColor = color; } /*! Sets the text of the axis label that will be shown below/above or next to the axis, depending on its orientation. To disable axis labels, pass an empty string as \a str. */ void QCPAxis::setLabel(const QString &str) { if (mLabel != str) { mLabel = str; mCachedMarginValid = false; } } /*! Sets the distance between the tick labels and the axis label. \see setTickLabelPadding, setPadding */ void QCPAxis::setLabelPadding(int padding) { if (mAxisPainter->labelPadding != padding) { mAxisPainter->labelPadding = padding; mCachedMarginValid = false; } } /*! Sets the padding of the axis. When \ref QCPAxisRect::setAutoMargins is enabled, the padding is the additional outer most space, that is left blank. The axis padding has no meaning if \ref QCPAxisRect::setAutoMargins is disabled. \see setLabelPadding, setTickLabelPadding */ void QCPAxis::setPadding(int padding) { if (mPadding != padding) { mPadding = padding; mCachedMarginValid = false; } } /*! Sets the offset the axis has to its axis rect side. If an axis rect side has multiple axes and automatic margin calculation is enabled for that side, only the offset of the inner most axis has meaning (even if it is set to be invisible). The offset of the other, outer axes is controlled automatically, to place them at appropriate positions. */ void QCPAxis::setOffset(int offset) { mAxisPainter->offset = offset; } /*! Sets the font that is used for tick labels when they are selected. \see setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedTickLabelFont(const QFont &font) { if (font != mSelectedTickLabelFont) { mSelectedTickLabelFont = font; // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts } } /*! Sets the font that is used for the axis label when it is selected. \see setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedLabelFont(const QFont &font) { mSelectedLabelFont = font; // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts } /*! Sets the color that is used for tick labels when they are selected. \see setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedTickLabelColor(const QColor &color) { if (color != mSelectedTickLabelColor) { mSelectedTickLabelColor = color; } } /*! Sets the color that is used for the axis label when it is selected. \see setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedLabelColor(const QColor &color) { mSelectedLabelColor = color; } /*! Sets the pen that is used to draw the axis base line when selected. \see setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedBasePen(const QPen &pen) { mSelectedBasePen = pen; } /*! Sets the pen that is used to draw the (major) ticks when selected. \see setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedTickPen(const QPen &pen) { mSelectedTickPen = pen; } /*! Sets the pen that is used to draw the subticks when selected. \see setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPAxis::setSelectedSubTickPen(const QPen &pen) { mSelectedSubTickPen = pen; } /*! Sets the style for the lower axis ending. See the documentation of QCPLineEnding for available styles. For horizontal axes, this method refers to the left ending, for vertical axes the bottom ending. Note that this meaning does not change when the axis range is reversed with \ref setRangeReversed. \see setUpperEnding */ void QCPAxis::setLowerEnding(const QCPLineEnding &ending) { mAxisPainter->lowerEnding = ending; } /*! Sets the style for the upper axis ending. See the documentation of QCPLineEnding for available styles. For horizontal axes, this method refers to the right ending, for vertical axes the top ending. Note that this meaning does not change when the axis range is reversed with \ref setRangeReversed. \see setLowerEnding */ void QCPAxis::setUpperEnding(const QCPLineEnding &ending) { mAxisPainter->upperEnding = ending; } /*! If the scale type (\ref setScaleType) is \ref stLinear, \a diff is added to the lower and upper bounds of the range. The range is simply moved by \a diff. If the scale type is \ref stLogarithmic, the range bounds are multiplied by \a diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff). */ void QCPAxis::moveRange(double diff) { QCPRange oldRange = mRange; if (mScaleType == stLinear) { mRange.lower += diff; mRange.upper += diff; } else // mScaleType == stLogarithmic { mRange.lower *= diff; mRange.upper *= diff; } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Scales the range of this axis by \a factor around the center of the current axis range. For example, if \a factor is 2.0, then the axis range will double its size, and the point at the axis range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around the center will have moved symmetrically closer). If you wish to scale around a different coordinate than the current axis range center, use the overload \ref scaleRange(double factor, double center). */ void QCPAxis::scaleRange(double factor) { scaleRange(factor, range().center()); } /*! \overload Scales the range of this axis by \a factor around the coordinate \a center. For example, if \a factor is 2.0, \a center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0). \see scaleRange(double factor) */ void QCPAxis::scaleRange(double factor, double center) { QCPRange oldRange = mRange; if (mScaleType == stLinear) { QCPRange newRange; newRange.lower = (mRange.lower-center)*factor + center; newRange.upper = (mRange.upper-center)*factor + center; if (QCPRange::validRange(newRange)) mRange = newRange.sanitizedForLinScale(); } else // mScaleType == stLogarithmic { if ((mRange.upper < 0 && center < 0) || (mRange.upper > 0 && center > 0)) // make sure center has same sign as range { QCPRange newRange; newRange.lower = qPow(mRange.lower/center, factor)*center; newRange.upper = qPow(mRange.upper/center, factor)*center; if (QCPRange::validRange(newRange)) mRange = newRange.sanitizedForLogScale(); } else qDebug() << Q_FUNC_INFO << "Center of scaling operation doesn't lie in same logarithmic sign domain as range:" << center; } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Scales the range of this axis to have a certain scale \a ratio to \a otherAxis. The scaling will be done around the center of the current axis range. For example, if \a ratio is 1, this axis is the \a yAxis and \a otherAxis is \a xAxis, graphs plotted with those axes will appear in a 1:1 aspect ratio, independent of the aspect ratio the axis rect has. This is an operation that changes the range of this axis once, it doesn't fix the scale ratio indefinitely. Note that calling this function in the constructor of the QCustomPlot's parent won't have the desired effect, since the widget dimensions aren't defined yet, and a resizeEvent will follow. */ void QCPAxis::setScaleRatio(const QCPAxis *otherAxis, double ratio) { int otherPixelSize, ownPixelSize; if (otherAxis->orientation() == Qt::Horizontal) otherPixelSize = otherAxis->axisRect()->width(); else otherPixelSize = otherAxis->axisRect()->height(); if (orientation() == Qt::Horizontal) ownPixelSize = axisRect()->width(); else ownPixelSize = axisRect()->height(); double newRangeSize = ratio*otherAxis->range().size()*ownPixelSize/double(otherPixelSize); setRange(range().center(), newRangeSize, Qt::AlignCenter); } /*! Changes the axis range such that all plottables associated with this axis are fully visible in that dimension. \see QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes */ void QCPAxis::rescale(bool onlyVisiblePlottables) { QCPRange newRange; bool haveRange = false; foreach (QCPAbstractPlottable *plottable, plottables()) { if (!plottable->realVisibility() && onlyVisiblePlottables) continue; QCPRange plottableRange; bool currentFoundRange; QCP::SignDomain signDomain = QCP::sdBoth; if (mScaleType == stLogarithmic) signDomain = (mRange.upper < 0 ? QCP::sdNegative : QCP::sdPositive); if (plottable->keyAxis() == this) plottableRange = plottable->getKeyRange(currentFoundRange, signDomain); else plottableRange = plottable->getValueRange(currentFoundRange, signDomain); if (currentFoundRange) { if (!haveRange) newRange = plottableRange; else newRange.expand(plottableRange); haveRange = true; } } if (haveRange) { if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason if (mScaleType == stLinear) { newRange.lower = center-mRange.size()/2.0; newRange.upper = center+mRange.size()/2.0; } else // mScaleType == stLogarithmic { newRange.lower = center/qSqrt(mRange.upper/mRange.lower); newRange.upper = center*qSqrt(mRange.upper/mRange.lower); } } setRange(newRange); } } /*! Transforms \a value, in pixel coordinates of the QCustomPlot widget, to axis coordinates. */ double QCPAxis::pixelToCoord(double value) const { if (orientation() == Qt::Horizontal) { if (mScaleType == stLinear) { if (!mRangeReversed) return (value-mAxisRect->left())/double(mAxisRect->width())*mRange.size()+mRange.lower; else return -(value-mAxisRect->left())/double(mAxisRect->width())*mRange.size()+mRange.upper; } else // mScaleType == stLogarithmic { if (!mRangeReversed) return qPow(mRange.upper/mRange.lower, (value-mAxisRect->left())/double(mAxisRect->width()))*mRange.lower; else return qPow(mRange.upper/mRange.lower, (mAxisRect->left()-value)/double(mAxisRect->width()))*mRange.upper; } } else // orientation() == Qt::Vertical { if (mScaleType == stLinear) { if (!mRangeReversed) return (mAxisRect->bottom()-value)/double(mAxisRect->height())*mRange.size()+mRange.lower; else return -(mAxisRect->bottom()-value)/double(mAxisRect->height())*mRange.size()+mRange.upper; } else // mScaleType == stLogarithmic { if (!mRangeReversed) return qPow(mRange.upper/mRange.lower, (mAxisRect->bottom()-value)/double(mAxisRect->height()))*mRange.lower; else return qPow(mRange.upper/mRange.lower, (value-mAxisRect->bottom())/double(mAxisRect->height()))*mRange.upper; } } } /*! Transforms \a value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget. */ double QCPAxis::coordToPixel(double value) const { if (orientation() == Qt::Horizontal) { if (mScaleType == stLinear) { if (!mRangeReversed) return (value-mRange.lower)/mRange.size()*mAxisRect->width()+mAxisRect->left(); else return (mRange.upper-value)/mRange.size()*mAxisRect->width()+mAxisRect->left(); } else // mScaleType == stLogarithmic { if (value >= 0.0 && mRange.upper < 0.0) // invalid value for logarithmic scale, just draw it outside visible range return !mRangeReversed ? mAxisRect->right()+200 : mAxisRect->left()-200; else if (value <= 0.0 && mRange.upper >= 0.0) // invalid value for logarithmic scale, just draw it outside visible range return !mRangeReversed ? mAxisRect->left()-200 : mAxisRect->right()+200; else { if (!mRangeReversed) return qLn(value/mRange.lower)/qLn(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left(); else return qLn(mRange.upper/value)/qLn(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left(); } } } else // orientation() == Qt::Vertical { if (mScaleType == stLinear) { if (!mRangeReversed) return mAxisRect->bottom()-(value-mRange.lower)/mRange.size()*mAxisRect->height(); else return mAxisRect->bottom()-(mRange.upper-value)/mRange.size()*mAxisRect->height(); } else // mScaleType == stLogarithmic { if (value >= 0.0 && mRange.upper < 0.0) // invalid value for logarithmic scale, just draw it outside visible range return !mRangeReversed ? mAxisRect->top()-200 : mAxisRect->bottom()+200; else if (value <= 0.0 && mRange.upper >= 0.0) // invalid value for logarithmic scale, just draw it outside visible range return !mRangeReversed ? mAxisRect->bottom()+200 : mAxisRect->top()-200; else { if (!mRangeReversed) return mAxisRect->bottom()-qLn(value/mRange.lower)/qLn(mRange.upper/mRange.lower)*mAxisRect->height(); else return mAxisRect->bottom()-qLn(mRange.upper/value)/qLn(mRange.upper/mRange.lower)*mAxisRect->height(); } } } } /*! Returns the part of the axis that is hit by \a pos (in pixels). The return value of this function is independent of the user-selectable parts defined with \ref setSelectableParts. Further, this function does not change the current selection state of the axis. If the axis is not visible (\ref setVisible), this function always returns \ref spNone. \see setSelectedParts, setSelectableParts, QCustomPlot::setInteractions */ QCPAxis::SelectablePart QCPAxis::getPartAt(const QPointF &pos) const { if (!mVisible) return spNone; if (mAxisPainter->axisSelectionBox().contains(pos.toPoint())) return spAxis; else if (mAxisPainter->tickLabelsSelectionBox().contains(pos.toPoint())) return spTickLabels; else if (mAxisPainter->labelSelectionBox().contains(pos.toPoint())) return spAxisLabel; else return spNone; } /* inherits documentation from base class */ double QCPAxis::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if (!mParentPlot) return -1; SelectablePart part = getPartAt(pos); if ((onlySelectable && !mSelectableParts.testFlag(part)) || part == spNone) return -1; if (details) details->setValue(part); return mParentPlot->selectionTolerance()*0.99; } /*! Returns a list of all the plottables that have this axis as key or value axis. If you are only interested in plottables of type QCPGraph, see \ref graphs. \see graphs, items */ QList QCPAxis::plottables() const { QList result; if (!mParentPlot) return result; foreach (QCPAbstractPlottable *plottable, mParentPlot->mPlottables) { if (plottable->keyAxis() == this || plottable->valueAxis() == this) result.append(plottable); } return result; } /*! Returns a list of all the graphs that have this axis as key or value axis. \see plottables, items */ QList QCPAxis::graphs() const { QList result; if (!mParentPlot) return result; foreach (QCPGraph *graph, mParentPlot->mGraphs) { if (graph->keyAxis() == this || graph->valueAxis() == this) result.append(graph); } return result; } /*! Returns a list of all the items that are associated with this axis. An item is considered associated with an axis if at least one of its positions uses the axis as key or value axis. \see plottables, graphs */ QList QCPAxis::items() const { QList result; if (!mParentPlot) return result; foreach (QCPAbstractItem *item, mParentPlot->mItems) { foreach (QCPItemPosition *position, item->positions()) { if (position->keyAxis() == this || position->valueAxis() == this) { result.append(item); break; } } } return result; } /*! Transforms a margin side to the logically corresponding axis type. (QCP::msLeft to QCPAxis::atLeft, QCP::msRight to QCPAxis::atRight, etc.) */ QCPAxis::AxisType QCPAxis::marginSideToAxisType(QCP::MarginSide side) { switch (side) { case QCP::msLeft: return atLeft; case QCP::msRight: return atRight; case QCP::msTop: return atTop; case QCP::msBottom: return atBottom; default: break; } qDebug() << Q_FUNC_INFO << "Invalid margin side passed:" << static_cast(side); return atLeft; } /*! Returns the axis type that describes the opposite axis of an axis with the specified \a type. */ QCPAxis::AxisType QCPAxis::opposite(QCPAxis::AxisType type) { switch (type) { case atLeft: return atRight; case atRight: return atLeft; case atBottom: return atTop; case atTop: return atBottom; } qDebug() << Q_FUNC_INFO << "invalid axis type"; return atLeft; } /* inherits documentation from base class */ void QCPAxis::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) SelectablePart part = details.value(); if (mSelectableParts.testFlag(part)) { SelectableParts selBefore = mSelectedParts; setSelectedParts(additive ? mSelectedParts^part : part); if (selectionStateChanged) *selectionStateChanged = mSelectedParts != selBefore; } } /* inherits documentation from base class */ void QCPAxis::deselectEvent(bool *selectionStateChanged) { SelectableParts selBefore = mSelectedParts; setSelectedParts(mSelectedParts & ~mSelectableParts); if (selectionStateChanged) *selectionStateChanged = mSelectedParts != selBefore; } /*! \internal This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis. For the axis to accept this event and perform the single axis drag, the parent \ref QCPAxisRect must be configured accordingly, i.e. it must allow range dragging in the orientation of this axis (\ref QCPAxisRect::setRangeDrag) and this axis must be a draggable axis (\ref QCPAxisRect::setRangeDragAxes) \seebaseclassmethod \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. */ void QCPAxis::mousePressEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) if (!mParentPlot->interactions().testFlag(QCP::iRangeDrag) || !mAxisRect->rangeDrag().testFlag(orientation()) || !mAxisRect->rangeDragAxes(orientation()).contains(this)) { event->ignore(); return; } if (event->buttons() & Qt::LeftButton) { mDragging = true; // initialize antialiasing backup in case we start dragging: if (mParentPlot->noAntialiasingOnDrag()) { mAADragBackup = mParentPlot->antialiasedElements(); mNotAADragBackup = mParentPlot->notAntialiasedElements(); } // Mouse range dragging interaction: if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) mDragStartRange = mRange; } } /*! \internal This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis. \seebaseclassmethod \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. \see QCPAxis::mousePressEvent */ void QCPAxis::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) { if (mDragging) { const double startPixel = orientation() == Qt::Horizontal ? startPos.x() : startPos.y(); const double currentPixel = orientation() == Qt::Horizontal ? event->pos().x() : event->pos().y(); if (mScaleType == QCPAxis::stLinear) { const double diff = pixelToCoord(startPixel) - pixelToCoord(currentPixel); setRange(mDragStartRange.lower+diff, mDragStartRange.upper+diff); } else if (mScaleType == QCPAxis::stLogarithmic) { const double diff = pixelToCoord(startPixel) / pixelToCoord(currentPixel); setRange(mDragStartRange.lower*diff, mDragStartRange.upper*diff); } if (mParentPlot->noAntialiasingOnDrag()) mParentPlot->setNotAntialiasedElements(QCP::aeAll); mParentPlot->replot(QCustomPlot::rpQueuedReplot); } } /*! \internal This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis. \seebaseclassmethod \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. \see QCPAxis::mousePressEvent */ void QCPAxis::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(event) Q_UNUSED(startPos) mDragging = false; if (mParentPlot->noAntialiasingOnDrag()) { mParentPlot->setAntialiasedElements(mAADragBackup); mParentPlot->setNotAntialiasedElements(mNotAADragBackup); } } /*! \internal This mouse event reimplementation provides the functionality to let the user zoom individual axes exclusively, by performing the wheel event on top of the axis. For the axis to accept this event and perform the single axis zoom, the parent \ref QCPAxisRect must be configured accordingly, i.e. it must allow range zooming in the orientation of this axis (\ref QCPAxisRect::setRangeZoom) and this axis must be a zoomable axis (\ref QCPAxisRect::setRangeZoomAxes) \seebaseclassmethod \note The zooming of possibly multiple axes at once by performing the wheel event anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::wheelEvent. */ void QCPAxis::wheelEvent(QWheelEvent *event) { // Mouse range zooming interaction: if (!mParentPlot->interactions().testFlag(QCP::iRangeZoom) || !mAxisRect->rangeZoom().testFlag(orientation()) || !mAxisRect->rangeZoomAxes(orientation()).contains(this)) { event->ignore(); return; } #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) const double delta = event->delta(); #else const double delta = event->angleDelta().y(); #endif #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0) const QPointF pos = event->pos(); #else const QPointF pos = event->position(); #endif const double wheelSteps = delta/120.0; // a single step delta is +/-120 usually const double factor = qPow(mAxisRect->rangeZoomFactor(orientation()), wheelSteps); scaleRange(factor, pixelToCoord(orientation() == Qt::Horizontal ? pos.x() : pos.y())); mParentPlot->replot(); } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing axis lines. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \seebaseclassmethod \see setAntialiased */ void QCPAxis::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeAxes); } /*! \internal Draws the axis with the specified \a painter, using the internal QCPAxisPainterPrivate instance. \seebaseclassmethod */ void QCPAxis::draw(QCPPainter *painter) { QVector subTickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter QVector tickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter QVector tickLabels; // the final vector passed to QCPAxisPainter tickPositions.reserve(mTickVector.size()); tickLabels.reserve(mTickVector.size()); subTickPositions.reserve(mSubTickVector.size()); if (mTicks) { for (int i=0; itype = mAxisType; mAxisPainter->basePen = getBasePen(); mAxisPainter->labelFont = getLabelFont(); mAxisPainter->labelColor = getLabelColor(); mAxisPainter->label = mLabel; mAxisPainter->substituteExponent = mNumberBeautifulPowers; mAxisPainter->tickPen = getTickPen(); mAxisPainter->subTickPen = getSubTickPen(); mAxisPainter->tickLabelFont = getTickLabelFont(); mAxisPainter->tickLabelColor = getTickLabelColor(); mAxisPainter->axisRect = mAxisRect->rect(); mAxisPainter->viewportRect = mParentPlot->viewport(); mAxisPainter->abbreviateDecimalPowers = mScaleType == stLogarithmic; mAxisPainter->reversedEndings = mRangeReversed; mAxisPainter->tickPositions = tickPositions; mAxisPainter->tickLabels = tickLabels; mAxisPainter->subTickPositions = subTickPositions; mAxisPainter->draw(painter); } /*! \internal Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling QCPAxisTicker::generate on the currently installed ticker. If a change in the label text/count is detected, the cached axis margin is invalidated to make sure the next margin calculation recalculates the label sizes and returns an up-to-date value. */ void QCPAxis::setupTickVectors() { if (!mParentPlot) return; if ((!mTicks && !mTickLabels && !mGrid->visible()) || mRange.size() <= 0) return; QVector oldLabels = mTickVectorLabels; mTicker->generate(mRange, mParentPlot->locale(), mNumberFormatChar, mNumberPrecision, mTickVector, mSubTicks ? &mSubTickVector : nullptr, mTickLabels ? &mTickVectorLabels : nullptr); mCachedMarginValid &= mTickVectorLabels == oldLabels; // if labels have changed, margin might have changed, too } /*! \internal Returns the pen that is used to draw the axis base line. Depending on the selection state, this is either mSelectedBasePen or mBasePen. */ QPen QCPAxis::getBasePen() const { return mSelectedParts.testFlag(spAxis) ? mSelectedBasePen : mBasePen; } /*! \internal Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this is either mSelectedTickPen or mTickPen. */ QPen QCPAxis::getTickPen() const { return mSelectedParts.testFlag(spAxis) ? mSelectedTickPen : mTickPen; } /*! \internal Returns the pen that is used to draw the subticks. Depending on the selection state, this is either mSelectedSubTickPen or mSubTickPen. */ QPen QCPAxis::getSubTickPen() const { return mSelectedParts.testFlag(spAxis) ? mSelectedSubTickPen : mSubTickPen; } /*! \internal Returns the font that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelFont or mTickLabelFont. */ QFont QCPAxis::getTickLabelFont() const { return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelFont : mTickLabelFont; } /*! \internal Returns the font that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelFont or mLabelFont. */ QFont QCPAxis::getLabelFont() const { return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelFont : mLabelFont; } /*! \internal Returns the color that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelColor or mTickLabelColor. */ QColor QCPAxis::getTickLabelColor() const { return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelColor : mTickLabelColor; } /*! \internal Returns the color that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelColor or mLabelColor. */ QColor QCPAxis::getLabelColor() const { return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelColor : mLabelColor; } /*! \internal Returns the appropriate outward margin for this axis. It is needed if \ref QCPAxisRect::setAutoMargins is set to true on the parent axis rect. An axis with axis type \ref atLeft will return an appropriate left margin, \ref atBottom will return an appropriate bottom margin and so forth. For the calculation, this function goes through similar steps as \ref draw, so changing one function likely requires the modification of the other one as well. The margin consists of the outward tick length, tick label padding, tick label size, label padding, label size, and padding. The margin is cached internally, so repeated calls while leaving the axis range, fonts, etc. unchanged are very fast. */ int QCPAxis::calculateMargin() { if (!mVisible) // if not visible, directly return 0, don't cache 0 because we can't react to setVisible in QCPAxis return 0; if (mCachedMarginValid) return mCachedMargin; // run through similar steps as QCPAxis::draw, and calculate margin needed to fit axis and its labels int margin = 0; QVector tickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter QVector tickLabels; // the final vector passed to QCPAxisPainter tickPositions.reserve(mTickVector.size()); tickLabels.reserve(mTickVector.size()); if (mTicks) { for (int i=0; itype = mAxisType; mAxisPainter->labelFont = getLabelFont(); mAxisPainter->label = mLabel; mAxisPainter->tickLabelFont = mTickLabelFont; mAxisPainter->axisRect = mAxisRect->rect(); mAxisPainter->viewportRect = mParentPlot->viewport(); mAxisPainter->tickPositions = tickPositions; mAxisPainter->tickLabels = tickLabels; margin += mAxisPainter->size(); margin += mPadding; mCachedMargin = margin; mCachedMarginValid = true; return margin; } /* inherits documentation from base class */ QCP::Interaction QCPAxis::selectionCategory() const { return QCP::iSelectAxes; } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisPainterPrivate //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisPainterPrivate \internal \brief (Private) This is a private class and not part of the public QCustomPlot interface. It is used by QCPAxis to do the low-level drawing of axis backbone, tick marks, tick labels and axis label. It also buffers the labels to reduce replot times. The parameters are configured by directly accessing the public member variables. */ /*! Constructs a QCPAxisPainterPrivate instance. Make sure to not create a new instance on every redraw, to utilize the caching mechanisms. */ QCPAxisPainterPrivate::QCPAxisPainterPrivate(QCustomPlot *parentPlot) : type(QCPAxis::atLeft), basePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), lowerEnding(QCPLineEnding::esNone), upperEnding(QCPLineEnding::esNone), labelPadding(0), tickLabelPadding(0), tickLabelRotation(0), tickLabelSide(QCPAxis::lsOutside), substituteExponent(true), numberMultiplyCross(false), tickLengthIn(5), tickLengthOut(0), subTickLengthIn(2), subTickLengthOut(0), tickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), subTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), offset(0), abbreviateDecimalPowers(false), reversedEndings(false), mParentPlot(parentPlot), mLabelCache(16) // cache at most 16 (tick) labels { } QCPAxisPainterPrivate::~QCPAxisPainterPrivate() { } /*! \internal Draws the axis with the specified \a painter. The selection boxes (mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox) are set here, too. */ void QCPAxisPainterPrivate::draw(QCPPainter *painter) { QByteArray newHash = generateLabelParameterHash(); if (newHash != mLabelParameterHash) { mLabelCache.clear(); mLabelParameterHash = newHash; } QPoint origin; switch (type) { case QCPAxis::atLeft: origin = axisRect.bottomLeft() +QPoint(-offset, 0); break; case QCPAxis::atRight: origin = axisRect.bottomRight()+QPoint(+offset, 0); break; case QCPAxis::atTop: origin = axisRect.topLeft() +QPoint(0, -offset); break; case QCPAxis::atBottom: origin = axisRect.bottomLeft() +QPoint(0, +offset); break; } double xCor = 0, yCor = 0; // paint system correction, for pixel exact matches (affects baselines and ticks of top/right axes) switch (type) { case QCPAxis::atTop: yCor = -1; break; case QCPAxis::atRight: xCor = 1; break; default: break; } int margin = 0; // draw baseline: QLineF baseLine; painter->setPen(basePen); if (QCPAxis::orientation(type) == Qt::Horizontal) baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(axisRect.width()+xCor, yCor)); else baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(xCor, -axisRect.height()+yCor)); if (reversedEndings) baseLine = QLineF(baseLine.p2(), baseLine.p1()); // won't make a difference for line itself, but for line endings later painter->drawLine(baseLine); // draw ticks: if (!tickPositions.isEmpty()) { painter->setPen(tickPen); int tickDir = (type == QCPAxis::atBottom || type == QCPAxis::atRight) ? -1 : 1; // direction of ticks ("inward" is right for left axis and left for right axis) if (QCPAxis::orientation(type) == Qt::Horizontal) { foreach (double tickPos, tickPositions) painter->drawLine(QLineF(tickPos+xCor, origin.y()-tickLengthOut*tickDir+yCor, tickPos+xCor, origin.y()+tickLengthIn*tickDir+yCor)); } else { foreach (double tickPos, tickPositions) painter->drawLine(QLineF(origin.x()-tickLengthOut*tickDir+xCor, tickPos+yCor, origin.x()+tickLengthIn*tickDir+xCor, tickPos+yCor)); } } // draw subticks: if (!subTickPositions.isEmpty()) { painter->setPen(subTickPen); // direction of ticks ("inward" is right for left axis and left for right axis) int tickDir = (type == QCPAxis::atBottom || type == QCPAxis::atRight) ? -1 : 1; if (QCPAxis::orientation(type) == Qt::Horizontal) { foreach (double subTickPos, subTickPositions) painter->drawLine(QLineF(subTickPos+xCor, origin.y()-subTickLengthOut*tickDir+yCor, subTickPos+xCor, origin.y()+subTickLengthIn*tickDir+yCor)); } else { foreach (double subTickPos, subTickPositions) painter->drawLine(QLineF(origin.x()-subTickLengthOut*tickDir+xCor, subTickPos+yCor, origin.x()+subTickLengthIn*tickDir+xCor, subTickPos+yCor)); } } margin += qMax(0, qMax(tickLengthOut, subTickLengthOut)); // draw axis base endings: bool antialiasingBackup = painter->antialiasing(); painter->setAntialiasing(true); // always want endings to be antialiased, even if base and ticks themselves aren't painter->setBrush(QBrush(basePen.color())); QCPVector2D baseLineVector(baseLine.dx(), baseLine.dy()); if (lowerEnding.style() != QCPLineEnding::esNone) lowerEnding.draw(painter, QCPVector2D(baseLine.p1())-baseLineVector.normalized()*lowerEnding.realLength()*(lowerEnding.inverted()?-1:1), -baseLineVector); if (upperEnding.style() != QCPLineEnding::esNone) upperEnding.draw(painter, QCPVector2D(baseLine.p2())+baseLineVector.normalized()*upperEnding.realLength()*(upperEnding.inverted()?-1:1), baseLineVector); painter->setAntialiasing(antialiasingBackup); // tick labels: QRect oldClipRect; if (tickLabelSide == QCPAxis::lsInside) // if using inside labels, clip them to the axis rect { oldClipRect = painter->clipRegion().boundingRect(); painter->setClipRect(axisRect); } QSize tickLabelsSize(0, 0); // size of largest tick label, for offset calculation of axis label if (!tickLabels.isEmpty()) { if (tickLabelSide == QCPAxis::lsOutside) margin += tickLabelPadding; painter->setFont(tickLabelFont); painter->setPen(QPen(tickLabelColor)); const int maxLabelIndex = qMin(tickPositions.size(), tickLabels.size()); int distanceToAxis = margin; if (tickLabelSide == QCPAxis::lsInside) distanceToAxis = -(qMax(tickLengthIn, subTickLengthIn)+tickLabelPadding); for (int i=0; isetClipRect(oldClipRect); // axis label: QRect labelBounds; if (!label.isEmpty()) { margin += labelPadding; painter->setFont(labelFont); painter->setPen(QPen(labelColor)); labelBounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip, label); if (type == QCPAxis::atLeft) { QTransform oldTransform = painter->transform(); painter->translate((origin.x()-margin-labelBounds.height()), origin.y()); painter->rotate(-90); painter->drawText(0, 0, axisRect.height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); painter->setTransform(oldTransform); } else if (type == QCPAxis::atRight) { QTransform oldTransform = painter->transform(); painter->translate((origin.x()+margin+labelBounds.height()), origin.y()-axisRect.height()); painter->rotate(90); painter->drawText(0, 0, axisRect.height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); painter->setTransform(oldTransform); } else if (type == QCPAxis::atTop) painter->drawText(origin.x(), origin.y()-margin-labelBounds.height(), axisRect.width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); else if (type == QCPAxis::atBottom) painter->drawText(origin.x(), origin.y()+margin, axisRect.width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); } // set selection boxes: int selectionTolerance = 0; if (mParentPlot) selectionTolerance = mParentPlot->selectionTolerance(); else qDebug() << Q_FUNC_INFO << "mParentPlot is null"; int selAxisOutSize = qMax(qMax(tickLengthOut, subTickLengthOut), selectionTolerance); int selAxisInSize = selectionTolerance; int selTickLabelSize; int selTickLabelOffset; if (tickLabelSide == QCPAxis::lsOutside) { selTickLabelSize = (QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width()); selTickLabelOffset = qMax(tickLengthOut, subTickLengthOut)+tickLabelPadding; } else { selTickLabelSize = -(QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width()); selTickLabelOffset = -(qMax(tickLengthIn, subTickLengthIn)+tickLabelPadding); } int selLabelSize = labelBounds.height(); int selLabelOffset = qMax(tickLengthOut, subTickLengthOut)+(!tickLabels.isEmpty() && tickLabelSide == QCPAxis::lsOutside ? tickLabelPadding+selTickLabelSize : 0)+labelPadding; if (type == QCPAxis::atLeft) { mAxisSelectionBox.setCoords(origin.x()-selAxisOutSize, axisRect.top(), origin.x()+selAxisInSize, axisRect.bottom()); mTickLabelsSelectionBox.setCoords(origin.x()-selTickLabelOffset-selTickLabelSize, axisRect.top(), origin.x()-selTickLabelOffset, axisRect.bottom()); mLabelSelectionBox.setCoords(origin.x()-selLabelOffset-selLabelSize, axisRect.top(), origin.x()-selLabelOffset, axisRect.bottom()); } else if (type == QCPAxis::atRight) { mAxisSelectionBox.setCoords(origin.x()-selAxisInSize, axisRect.top(), origin.x()+selAxisOutSize, axisRect.bottom()); mTickLabelsSelectionBox.setCoords(origin.x()+selTickLabelOffset+selTickLabelSize, axisRect.top(), origin.x()+selTickLabelOffset, axisRect.bottom()); mLabelSelectionBox.setCoords(origin.x()+selLabelOffset+selLabelSize, axisRect.top(), origin.x()+selLabelOffset, axisRect.bottom()); } else if (type == QCPAxis::atTop) { mAxisSelectionBox.setCoords(axisRect.left(), origin.y()-selAxisOutSize, axisRect.right(), origin.y()+selAxisInSize); mTickLabelsSelectionBox.setCoords(axisRect.left(), origin.y()-selTickLabelOffset-selTickLabelSize, axisRect.right(), origin.y()-selTickLabelOffset); mLabelSelectionBox.setCoords(axisRect.left(), origin.y()-selLabelOffset-selLabelSize, axisRect.right(), origin.y()-selLabelOffset); } else if (type == QCPAxis::atBottom) { mAxisSelectionBox.setCoords(axisRect.left(), origin.y()-selAxisInSize, axisRect.right(), origin.y()+selAxisOutSize); mTickLabelsSelectionBox.setCoords(axisRect.left(), origin.y()+selTickLabelOffset+selTickLabelSize, axisRect.right(), origin.y()+selTickLabelOffset); mLabelSelectionBox.setCoords(axisRect.left(), origin.y()+selLabelOffset+selLabelSize, axisRect.right(), origin.y()+selLabelOffset); } mAxisSelectionBox = mAxisSelectionBox.normalized(); mTickLabelsSelectionBox = mTickLabelsSelectionBox.normalized(); mLabelSelectionBox = mLabelSelectionBox.normalized(); // draw hitboxes for debug purposes: //painter->setBrush(Qt::NoBrush); //painter->drawRects(QVector() << mAxisSelectionBox << mTickLabelsSelectionBox << mLabelSelectionBox); } /*! \internal Returns the size ("margin" in QCPAxisRect context, so measured perpendicular to the axis backbone direction) needed to fit the axis. */ int QCPAxisPainterPrivate::size() { int result = 0; QByteArray newHash = generateLabelParameterHash(); if (newHash != mLabelParameterHash) { mLabelCache.clear(); mLabelParameterHash = newHash; } // get length of tick marks pointing outwards: if (!tickPositions.isEmpty()) result += qMax(0, qMax(tickLengthOut, subTickLengthOut)); // calculate size of tick labels: if (tickLabelSide == QCPAxis::lsOutside) { QSize tickLabelsSize(0, 0); if (!tickLabels.isEmpty()) { foreach (const QString &tickLabel, tickLabels) getMaxTickLabelSize(tickLabelFont, tickLabel, &tickLabelsSize); result += QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width(); result += tickLabelPadding; } } // calculate size of axis label (only height needed, because left/right labels are rotated by 90 degrees): if (!label.isEmpty()) { QFontMetrics fontMetrics(labelFont); QRect bounds; bounds = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter | Qt::AlignVCenter, label); result += bounds.height() + labelPadding; } return result; } /*! \internal Clears the internal label cache. Upon the next \ref draw, all labels will be created new. This method is called automatically in \ref draw, if any parameters have changed that invalidate the cached labels, such as font, color, etc. */ void QCPAxisPainterPrivate::clearCache() { mLabelCache.clear(); } /*! \internal Returns a hash that allows uniquely identifying whether the label parameters have changed such that the cached labels must be refreshed (\ref clearCache). It is used in \ref draw. If the return value of this method hasn't changed since the last redraw, the respective label parameters haven't changed and cached labels may be used. */ QByteArray QCPAxisPainterPrivate::generateLabelParameterHash() const { QByteArray result; result.append(QByteArray::number(mParentPlot->bufferDevicePixelRatio())); result.append(QByteArray::number(tickLabelRotation)); result.append(QByteArray::number(int(tickLabelSide))); result.append(QByteArray::number(int(substituteExponent))); result.append(QByteArray::number(int(numberMultiplyCross))); result.append(tickLabelColor.name().toLatin1()+QByteArray::number(tickLabelColor.alpha(), 16)); result.append(tickLabelFont.toString().toLatin1()); return result; } /*! \internal Draws a single tick label with the provided \a painter, utilizing the internal label cache to significantly speed up drawing of labels that were drawn in previous calls. The tick label is always bound to an axis, the distance to the axis is controllable via \a distanceToAxis in pixels. The pixel position in the axis direction is passed in the \a position parameter. Hence for the bottom axis, \a position would indicate the horizontal pixel position (not coordinate), at which the label should be drawn. In order to later draw the axis label in a place that doesn't overlap with the tick labels, the largest tick label size is needed. This is acquired by passing a \a tickLabelsSize to the \ref drawTickLabel calls during the process of drawing all tick labels of one axis. In every call, \a tickLabelsSize is expanded, if the drawn label exceeds the value \a tickLabelsSize currently holds. The label is drawn with the font and pen that are currently set on the \a painter. To draw superscripted powers, the font is temporarily made smaller by a fixed factor (see \ref getTickLabelData). */ void QCPAxisPainterPrivate::placeTickLabel(QCPPainter *painter, double position, int distanceToAxis, const QString &text, QSize *tickLabelsSize) { // warning: if you change anything here, also adapt getMaxTickLabelSize() accordingly! if (text.isEmpty()) return; QSize finalSize; QPointF labelAnchor; switch (type) { case QCPAxis::atLeft: labelAnchor = QPointF(axisRect.left()-distanceToAxis-offset, position); break; case QCPAxis::atRight: labelAnchor = QPointF(axisRect.right()+distanceToAxis+offset, position); break; case QCPAxis::atTop: labelAnchor = QPointF(position, axisRect.top()-distanceToAxis-offset); break; case QCPAxis::atBottom: labelAnchor = QPointF(position, axisRect.bottom()+distanceToAxis+offset); break; } if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) // label caching enabled { CachedLabel *cachedLabel = mLabelCache.take(text); // attempt to get label from cache if (!cachedLabel) // no cached label existed, create it { cachedLabel = new CachedLabel; TickLabelData labelData = getTickLabelData(painter->font(), text); cachedLabel->offset = getTickLabelDrawOffset(labelData)+labelData.rotatedTotalBounds.topLeft(); if (!qFuzzyCompare(1.0, mParentPlot->bufferDevicePixelRatio())) { cachedLabel->pixmap = QPixmap(labelData.rotatedTotalBounds.size()*mParentPlot->bufferDevicePixelRatio()); #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED # ifdef QCP_DEVICEPIXELRATIO_FLOAT cachedLabel->pixmap.setDevicePixelRatio(mParentPlot->devicePixelRatioF()); # else cachedLabel->pixmap.setDevicePixelRatio(mParentPlot->devicePixelRatio()); # endif #endif } else cachedLabel->pixmap = QPixmap(labelData.rotatedTotalBounds.size()); cachedLabel->pixmap.fill(Qt::transparent); QCPPainter cachePainter(&cachedLabel->pixmap); cachePainter.setPen(painter->pen()); drawTickLabel(&cachePainter, -labelData.rotatedTotalBounds.topLeft().x(), -labelData.rotatedTotalBounds.topLeft().y(), labelData); } // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): bool labelClippedByBorder = false; if (tickLabelSide == QCPAxis::lsOutside) { if (QCPAxis::orientation(type) == Qt::Horizontal) labelClippedByBorder = labelAnchor.x()+cachedLabel->offset.x()+cachedLabel->pixmap.width()/mParentPlot->bufferDevicePixelRatio() > viewportRect.right() || labelAnchor.x()+cachedLabel->offset.x() < viewportRect.left(); else labelClippedByBorder = labelAnchor.y()+cachedLabel->offset.y()+cachedLabel->pixmap.height()/mParentPlot->bufferDevicePixelRatio() > viewportRect.bottom() || labelAnchor.y()+cachedLabel->offset.y() < viewportRect.top(); } if (!labelClippedByBorder) { painter->drawPixmap(labelAnchor+cachedLabel->offset, cachedLabel->pixmap); finalSize = cachedLabel->pixmap.size()/mParentPlot->bufferDevicePixelRatio(); } mLabelCache.insert(text, cachedLabel); // return label to cache or insert for the first time if newly created } else // label caching disabled, draw text directly on surface: { TickLabelData labelData = getTickLabelData(painter->font(), text); QPointF finalPosition = labelAnchor + getTickLabelDrawOffset(labelData); // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): bool labelClippedByBorder = false; if (tickLabelSide == QCPAxis::lsOutside) { if (QCPAxis::orientation(type) == Qt::Horizontal) labelClippedByBorder = finalPosition.x()+(labelData.rotatedTotalBounds.width()+labelData.rotatedTotalBounds.left()) > viewportRect.right() || finalPosition.x()+labelData.rotatedTotalBounds.left() < viewportRect.left(); else labelClippedByBorder = finalPosition.y()+(labelData.rotatedTotalBounds.height()+labelData.rotatedTotalBounds.top()) > viewportRect.bottom() || finalPosition.y()+labelData.rotatedTotalBounds.top() < viewportRect.top(); } if (!labelClippedByBorder) { drawTickLabel(painter, finalPosition.x(), finalPosition.y(), labelData); finalSize = labelData.rotatedTotalBounds.size(); } } // expand passed tickLabelsSize if current tick label is larger: if (finalSize.width() > tickLabelsSize->width()) tickLabelsSize->setWidth(finalSize.width()); if (finalSize.height() > tickLabelsSize->height()) tickLabelsSize->setHeight(finalSize.height()); } /*! \internal This is a \ref placeTickLabel helper function. Draws the tick label specified in \a labelData with \a painter at the pixel positions \a x and \a y. This function is used by \ref placeTickLabel to create new tick labels for the cache, or to directly draw the labels on the QCustomPlot surface when label caching is disabled, i.e. when QCP::phCacheLabels plotting hint is not set. */ void QCPAxisPainterPrivate::drawTickLabel(QCPPainter *painter, double x, double y, const TickLabelData &labelData) const { // backup painter settings that we're about to change: QTransform oldTransform = painter->transform(); QFont oldFont = painter->font(); // transform painter to position/rotation: painter->translate(x, y); if (!qFuzzyIsNull(tickLabelRotation)) painter->rotate(tickLabelRotation); // draw text: if (!labelData.expPart.isEmpty()) // indicator that beautiful powers must be used { painter->setFont(labelData.baseFont); painter->drawText(0, 0, 0, 0, Qt::TextDontClip, labelData.basePart); if (!labelData.suffixPart.isEmpty()) painter->drawText(labelData.baseBounds.width()+1+labelData.expBounds.width(), 0, 0, 0, Qt::TextDontClip, labelData.suffixPart); painter->setFont(labelData.expFont); painter->drawText(labelData.baseBounds.width()+1, 0, labelData.expBounds.width(), labelData.expBounds.height(), Qt::TextDontClip, labelData.expPart); } else { painter->setFont(labelData.baseFont); painter->drawText(0, 0, labelData.totalBounds.width(), labelData.totalBounds.height(), Qt::TextDontClip | Qt::AlignHCenter, labelData.basePart); } // reset painter settings to what it was before: painter->setTransform(oldTransform); painter->setFont(oldFont); } /*! \internal This is a \ref placeTickLabel helper function. Transforms the passed \a text and \a font to a tickLabelData structure that can then be further processed by \ref getTickLabelDrawOffset and \ref drawTickLabel. It splits the text into base and exponent if necessary (member substituteExponent) and calculates appropriate bounding boxes. */ QCPAxisPainterPrivate::TickLabelData QCPAxisPainterPrivate::getTickLabelData(const QFont &font, const QString &text) const { TickLabelData result; // determine whether beautiful decimal powers should be used bool useBeautifulPowers = false; int ePos = -1; // first index of exponent part, text before that will be basePart, text until eLast will be expPart int eLast = -1; // last index of exponent part, rest of text after this will be suffixPart if (substituteExponent) { ePos = text.indexOf(QLatin1Char('e')); if (ePos > 0 && text.at(ePos-1).isDigit()) { eLast = ePos; while (eLast+1 < text.size() && (text.at(eLast+1) == QLatin1Char('+') || text.at(eLast+1) == QLatin1Char('-') || text.at(eLast+1).isDigit())) ++eLast; if (eLast > ePos) // only if also to right of 'e' is a digit/+/- interpret it as beautifiable power useBeautifulPowers = true; } } // calculate text bounding rects and do string preparation for beautiful decimal powers: result.baseFont = font; if (result.baseFont.pointSizeF() > 0) // might return -1 if specified with setPixelSize, in that case we can't do correction in next line result.baseFont.setPointSizeF(result.baseFont.pointSizeF()+0.05); // QFontMetrics.boundingRect has a bug for exact point sizes that make the results oscillate due to internal rounding if (useBeautifulPowers) { // split text into parts of number/symbol that will be drawn normally and part that will be drawn as exponent: result.basePart = text.left(ePos); result.suffixPart = text.mid(eLast+1); // also drawn normally but after exponent // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base: if (abbreviateDecimalPowers && result.basePart == QLatin1String("1")) result.basePart = QLatin1String("10"); else result.basePart += (numberMultiplyCross ? QString(QChar(215)) : QString(QChar(183))) + QLatin1String("10"); result.expPart = text.mid(ePos+1, eLast-ePos); // clip "+" and leading zeros off expPart: while (result.expPart.length() > 2 && result.expPart.at(1) == QLatin1Char('0')) // length > 2 so we leave one zero when numberFormatChar is 'e' result.expPart.remove(1, 1); if (!result.expPart.isEmpty() && result.expPart.at(0) == QLatin1Char('+')) result.expPart.remove(0, 1); // prepare smaller font for exponent: result.expFont = font; if (result.expFont.pointSize() > 0) result.expFont.setPointSize(int(result.expFont.pointSize()*0.75)); else result.expFont.setPixelSize(int(result.expFont.pixelSize()*0.75)); // calculate bounding rects of base part(s), exponent part and total one: result.baseBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.basePart); result.expBounds = QFontMetrics(result.expFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.expPart); if (!result.suffixPart.isEmpty()) result.suffixBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.suffixPart); result.totalBounds = result.baseBounds.adjusted(0, 0, result.expBounds.width()+result.suffixBounds.width()+2, 0); // +2 consists of the 1 pixel spacing between base and exponent (see drawTickLabel) and an extra pixel to include AA } else // useBeautifulPowers == false { result.basePart = text; result.totalBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, result.basePart); } result.totalBounds.moveTopLeft(QPoint(0, 0)); // want bounding box aligned top left at origin, independent of how it was created, to make further processing simpler // calculate possibly different bounding rect after rotation: result.rotatedTotalBounds = result.totalBounds; if (!qFuzzyIsNull(tickLabelRotation)) { QTransform transform; transform.rotate(tickLabelRotation); result.rotatedTotalBounds = transform.mapRect(result.rotatedTotalBounds); } return result; } /*! \internal This is a \ref placeTickLabel helper function. Calculates the offset at which the top left corner of the specified tick label shall be drawn. The offset is relative to a point right next to the tick the label belongs to. This function is thus responsible for e.g. centering tick labels under ticks and positioning them appropriately when they are rotated. */ QPointF QCPAxisPainterPrivate::getTickLabelDrawOffset(const TickLabelData &labelData) const { /* calculate label offset from base point at tick (non-trivial, for best visual appearance): short explanation for bottom axis: The anchor, i.e. the point in the label that is placed horizontally under the corresponding tick is always on the label side that is closer to the axis (e.g. the left side of the text when we're rotating clockwise). On that side, the height is halved and the resulting point is defined the anchor. This way, a 90 degree rotated text will be centered under the tick (i.e. displaced horizontally by half its height). At the same time, a 45 degree rotated text will "point toward" its tick, as is typical for rotated tick labels. */ bool doRotation = !qFuzzyIsNull(tickLabelRotation); bool flip = qFuzzyCompare(qAbs(tickLabelRotation), 90.0); // perfect +/-90 degree flip. Indicates vertical label centering on vertical axes. double radians = tickLabelRotation/180.0*M_PI; double x = 0; double y = 0; if ((type == QCPAxis::atLeft && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atRight && tickLabelSide == QCPAxis::lsInside)) // Anchor at right side of tick label { if (doRotation) { if (tickLabelRotation > 0) { x = -qCos(radians)*labelData.totalBounds.width(); y = flip ? -labelData.totalBounds.width()/2.0 : -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height()/2.0; } else { x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height(); y = flip ? +labelData.totalBounds.width()/2.0 : +qSin(-radians)*labelData.totalBounds.width()-qCos(-radians)*labelData.totalBounds.height()/2.0; } } else { x = -labelData.totalBounds.width(); y = -labelData.totalBounds.height()/2.0; } } else if ((type == QCPAxis::atRight && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atLeft && tickLabelSide == QCPAxis::lsInside)) // Anchor at left side of tick label { if (doRotation) { if (tickLabelRotation > 0) { x = +qSin(radians)*labelData.totalBounds.height(); y = flip ? -labelData.totalBounds.width()/2.0 : -qCos(radians)*labelData.totalBounds.height()/2.0; } else { x = 0; y = flip ? +labelData.totalBounds.width()/2.0 : -qCos(-radians)*labelData.totalBounds.height()/2.0; } } else { x = 0; y = -labelData.totalBounds.height()/2.0; } } else if ((type == QCPAxis::atTop && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atBottom && tickLabelSide == QCPAxis::lsInside)) // Anchor at bottom side of tick label { if (doRotation) { if (tickLabelRotation > 0) { x = -qCos(radians)*labelData.totalBounds.width()+qSin(radians)*labelData.totalBounds.height()/2.0; y = -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height(); } else { x = -qSin(-radians)*labelData.totalBounds.height()/2.0; y = -qCos(-radians)*labelData.totalBounds.height(); } } else { x = -labelData.totalBounds.width()/2.0; y = -labelData.totalBounds.height(); } } else if ((type == QCPAxis::atBottom && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atTop && tickLabelSide == QCPAxis::lsInside)) // Anchor at top side of tick label { if (doRotation) { if (tickLabelRotation > 0) { x = +qSin(radians)*labelData.totalBounds.height()/2.0; y = 0; } else { x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height()/2.0; y = +qSin(-radians)*labelData.totalBounds.width(); } } else { x = -labelData.totalBounds.width()/2.0; y = 0; } } return {x, y}; } /*! \internal Simulates the steps done by \ref placeTickLabel by calculating bounding boxes of the text label to be drawn, depending on number format etc. Since only the largest tick label is wanted for the margin calculation, the passed \a tickLabelsSize is only expanded, if it's currently set to a smaller width/height. */ void QCPAxisPainterPrivate::getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const { // note: this function must return the same tick label sizes as the placeTickLabel function. QSize finalSize; if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && mLabelCache.contains(text)) // label caching enabled and have cached label { const CachedLabel *cachedLabel = mLabelCache.object(text); finalSize = cachedLabel->pixmap.size()/mParentPlot->bufferDevicePixelRatio(); } else // label caching disabled or no label with this text cached: { TickLabelData labelData = getTickLabelData(font, text); finalSize = labelData.rotatedTotalBounds.size(); } // expand passed tickLabelsSize if current tick label is larger: if (finalSize.width() > tickLabelsSize->width()) tickLabelsSize->setWidth(finalSize.width()); if (finalSize.height() > tickLabelsSize->height()) tickLabelsSize->setHeight(finalSize.height()); } /* end of 'src/axis/axis.cpp' */ /* including file 'src/scatterstyle.cpp' */ /* modified 2021-03-29T02:30:44, size 17466 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPScatterStyle //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPScatterStyle \brief Represents the visual appearance of scatter points This class holds information about shape, color and size of scatter points. In plottables like QCPGraph it is used to store how scatter points shall be drawn. For example, \ref QCPGraph::setScatterStyle takes a QCPScatterStyle instance. A scatter style consists of a shape (\ref setShape), a line color (\ref setPen) and possibly a fill (\ref setBrush), if the shape provides a fillable area. Further, the size of the shape can be controlled with \ref setSize. \section QCPScatterStyle-defining Specifying a scatter style You can set all these configurations either by calling the respective functions on an instance: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-creation-1 Or you can use one of the various constructors that take different parameter combinations, making it easy to specify a scatter style in a single call, like so: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-creation-2 \section QCPScatterStyle-undefinedpen Leaving the color/pen up to the plottable There are two constructors which leave the pen undefined: \ref QCPScatterStyle() and \ref QCPScatterStyle(ScatterShape shape, double size). If those constructors are used, a call to \ref isPenDefined will return false. It leads to scatter points that inherit the pen from the plottable that uses the scatter style. Thus, if such a scatter style is passed to QCPGraph, the line color of the graph (\ref QCPGraph::setPen) will be used by the scatter points. This makes it very convenient to set up typical scatter settings: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-shortcreation Notice that it wasn't even necessary to explicitly call a QCPScatterStyle constructor. This works because QCPScatterStyle provides a constructor that can transform a \ref ScatterShape directly into a QCPScatterStyle instance (that's the \ref QCPScatterStyle(ScatterShape shape, double size) constructor with a default for \a size). In those cases, C++ allows directly supplying a \ref ScatterShape, where actually a QCPScatterStyle is expected. \section QCPScatterStyle-custompath-and-pixmap Custom shapes and pixmaps QCPScatterStyle supports drawing custom shapes and arbitrary pixmaps as scatter points. For custom shapes, you can provide a QPainterPath with the desired shape to the \ref setCustomPath function or call the constructor that takes a painter path. The scatter shape will automatically be set to \ref ssCustom. For pixmaps, you call \ref setPixmap with the desired QPixmap. Alternatively you can use the constructor that takes a QPixmap. The scatter shape will automatically be set to \ref ssPixmap. Note that \ref setSize does not influence the appearance of the pixmap. */ /* start documentation of inline functions */ /*! \fn bool QCPScatterStyle::isNone() const Returns whether the scatter shape is \ref ssNone. \see setShape */ /*! \fn bool QCPScatterStyle::isPenDefined() const Returns whether a pen has been defined for this scatter style. The pen is undefined if a constructor is called that does not carry \a pen as parameter. Those are \ref QCPScatterStyle() and \ref QCPScatterStyle(ScatterShape shape, double size). If the pen is undefined, the pen of the respective plottable will be used for drawing scatters. If a pen was defined for this scatter style instance, and you now wish to undefine the pen, call \ref undefinePen. \see setPen */ /* end documentation of inline functions */ /*! Creates a new QCPScatterStyle instance with size set to 6. No shape, pen or brush is defined. Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited from the plottable that uses this scatter style. */ QCPScatterStyle::QCPScatterStyle() : mSize(6), mShape(ssNone), mPen(Qt::NoPen), mBrush(Qt::NoBrush), mPenDefined(false) { } /*! Creates a new QCPScatterStyle instance with shape set to \a shape and size to \a size. No pen or brush is defined. Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited from the plottable that uses this scatter style. */ QCPScatterStyle::QCPScatterStyle(ScatterShape shape, double size) : mSize(size), mShape(shape), mPen(Qt::NoPen), mBrush(Qt::NoBrush), mPenDefined(false) { } /*! Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color, and size to \a size. No brush is defined, i.e. the scatter point will not be filled. */ QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, double size) : mSize(size), mShape(shape), mPen(QPen(color)), mBrush(Qt::NoBrush), mPenDefined(true) { } /*! Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color, the brush color to \a fill (with a solid pattern), and size to \a size. */ QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) : mSize(size), mShape(shape), mPen(QPen(color)), mBrush(QBrush(fill)), mPenDefined(true) { } /*! Creates a new QCPScatterStyle instance with shape set to \a shape, the pen set to \a pen, the brush to \a brush, and size to \a size. \warning In some cases it might be tempting to directly use a pen style like Qt::NoPen as \a pen and a color like Qt::blue as \a brush. Notice however, that the corresponding call\n QCPScatterStyle(QCPScatterShape::ssCircle, Qt::NoPen, Qt::blue, 5)\n doesn't necessarily lead C++ to use this constructor in some cases, but might mistake Qt::NoPen for a QColor and use the \ref QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) constructor instead (which will lead to an unexpected look of the scatter points). To prevent this, be more explicit with the parameter types. For example, use QBrush(Qt::blue) instead of just Qt::blue, to clearly point out to the compiler that this constructor is wanted. */ QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QPen &pen, const QBrush &brush, double size) : mSize(size), mShape(shape), mPen(pen), mBrush(brush), mPenDefined(pen.style() != Qt::NoPen) { } /*! Creates a new QCPScatterStyle instance which will show the specified \a pixmap. The scatter shape is set to \ref ssPixmap. */ QCPScatterStyle::QCPScatterStyle(const QPixmap &pixmap) : mSize(5), mShape(ssPixmap), mPen(Qt::NoPen), mBrush(Qt::NoBrush), mPixmap(pixmap), mPenDefined(false) { } /*! Creates a new QCPScatterStyle instance with a custom shape that is defined via \a customPath. The scatter shape is set to \ref ssCustom. The custom shape line will be drawn with \a pen and filled with \a brush. The size has a slightly different meaning than for built-in scatter points: The custom path will be drawn scaled by a factor of \a size/6.0. Since the default \a size is 6, the custom path will appear in its original size by default. To for example double the size of the path, set \a size to 12. */ QCPScatterStyle::QCPScatterStyle(const QPainterPath &customPath, const QPen &pen, const QBrush &brush, double size) : mSize(size), mShape(ssCustom), mPen(pen), mBrush(brush), mCustomPath(customPath), mPenDefined(pen.style() != Qt::NoPen) { } /*! Copies the specified \a properties from the \a other scatter style to this scatter style. */ void QCPScatterStyle::setFromOther(const QCPScatterStyle &other, ScatterProperties properties) { if (properties.testFlag(spPen)) { setPen(other.pen()); if (!other.isPenDefined()) undefinePen(); } if (properties.testFlag(spBrush)) setBrush(other.brush()); if (properties.testFlag(spSize)) setSize(other.size()); if (properties.testFlag(spShape)) { setShape(other.shape()); if (other.shape() == ssPixmap) setPixmap(other.pixmap()); else if (other.shape() == ssCustom) setCustomPath(other.customPath()); } } /*! Sets the size (pixel diameter) of the drawn scatter points to \a size. \see setShape */ void QCPScatterStyle::setSize(double size) { mSize = size; } /*! Sets the shape to \a shape. Note that the calls \ref setPixmap and \ref setCustomPath automatically set the shape to \ref ssPixmap and \ref ssCustom, respectively. \see setSize */ void QCPScatterStyle::setShape(QCPScatterStyle::ScatterShape shape) { mShape = shape; } /*! Sets the pen that will be used to draw scatter points to \a pen. If the pen was previously undefined (see \ref isPenDefined), the pen is considered defined after a call to this function, even if \a pen is Qt::NoPen. If you have defined a pen previously by calling this function and now wish to undefine the pen, call \ref undefinePen. \see setBrush */ void QCPScatterStyle::setPen(const QPen &pen) { mPenDefined = true; mPen = pen; } /*! Sets the brush that will be used to fill scatter points to \a brush. Note that not all scatter shapes have fillable areas. For example, \ref ssPlus does not while \ref ssCircle does. \see setPen */ void QCPScatterStyle::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the pixmap that will be drawn as scatter point to \a pixmap. Note that \ref setSize does not influence the appearance of the pixmap. The scatter shape is automatically set to \ref ssPixmap. */ void QCPScatterStyle::setPixmap(const QPixmap &pixmap) { setShape(ssPixmap); mPixmap = pixmap; } /*! Sets the custom shape that will be drawn as scatter point to \a customPath. The scatter shape is automatically set to \ref ssCustom. */ void QCPScatterStyle::setCustomPath(const QPainterPath &customPath) { setShape(ssCustom); mCustomPath = customPath; } /*! Sets this scatter style to have an undefined pen (see \ref isPenDefined for what an undefined pen implies). A call to \ref setPen will define a pen. */ void QCPScatterStyle::undefinePen() { mPenDefined = false; } /*! Applies the pen and the brush of this scatter style to \a painter. If this scatter style has an undefined pen (\ref isPenDefined), sets the pen of \a painter to \a defaultPen instead. This function is used by plottables (or any class that wants to draw scatters) just before a number of scatters with this style shall be drawn with the \a painter. \see drawShape */ void QCPScatterStyle::applyTo(QCPPainter *painter, const QPen &defaultPen) const { painter->setPen(mPenDefined ? mPen : defaultPen); painter->setBrush(mBrush); } /*! Draws the scatter shape with \a painter at position \a pos. This function does not modify the pen or the brush on the painter, as \ref applyTo is meant to be called before scatter points are drawn with \ref drawShape. \see applyTo */ void QCPScatterStyle::drawShape(QCPPainter *painter, const QPointF &pos) const { drawShape(painter, pos.x(), pos.y()); } /*! \overload Draws the scatter shape with \a painter at position \a x and \a y. */ void QCPScatterStyle::drawShape(QCPPainter *painter, double x, double y) const { double w = mSize/2.0; switch (mShape) { case ssNone: break; case ssDot: { painter->drawLine(QPointF(x, y), QPointF(x+0.0001, y)); break; } case ssCross: { painter->drawLine(QLineF(x-w, y-w, x+w, y+w)); painter->drawLine(QLineF(x-w, y+w, x+w, y-w)); break; } case ssPlus: { painter->drawLine(QLineF(x-w, y, x+w, y)); painter->drawLine(QLineF( x, y+w, x, y-w)); break; } case ssCircle: { painter->drawEllipse(QPointF(x , y), w, w); break; } case ssDisc: { QBrush b = painter->brush(); painter->setBrush(painter->pen().color()); painter->drawEllipse(QPointF(x , y), w, w); painter->setBrush(b); break; } case ssSquare: { painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); break; } case ssDiamond: { QPointF lineArray[4] = {QPointF(x-w, y), QPointF( x, y-w), QPointF(x+w, y), QPointF( x, y+w)}; painter->drawPolygon(lineArray, 4); break; } case ssStar: { painter->drawLine(QLineF(x-w, y, x+w, y)); painter->drawLine(QLineF( x, y+w, x, y-w)); painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.707, y+w*0.707)); painter->drawLine(QLineF(x-w*0.707, y+w*0.707, x+w*0.707, y-w*0.707)); break; } case ssTriangle: { QPointF lineArray[3] = {QPointF(x-w, y+0.755*w), QPointF(x+w, y+0.755*w), QPointF( x, y-0.977*w)}; painter->drawPolygon(lineArray, 3); break; } case ssTriangleInverted: { QPointF lineArray[3] = {QPointF(x-w, y-0.755*w), QPointF(x+w, y-0.755*w), QPointF( x, y+0.977*w)}; painter->drawPolygon(lineArray, 3); break; } case ssCrossSquare: { painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); painter->drawLine(QLineF(x-w, y-w, x+w*0.95, y+w*0.95)); painter->drawLine(QLineF(x-w, y+w*0.95, x+w*0.95, y-w)); break; } case ssPlusSquare: { painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); painter->drawLine(QLineF(x-w, y, x+w*0.95, y)); painter->drawLine(QLineF( x, y+w, x, y-w)); break; } case ssCrossCircle: { painter->drawEllipse(QPointF(x, y), w, w); painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.670, y+w*0.670)); painter->drawLine(QLineF(x-w*0.707, y+w*0.670, x+w*0.670, y-w*0.707)); break; } case ssPlusCircle: { painter->drawEllipse(QPointF(x, y), w, w); painter->drawLine(QLineF(x-w, y, x+w, y)); painter->drawLine(QLineF( x, y+w, x, y-w)); break; } case ssPeace: { painter->drawEllipse(QPointF(x, y), w, w); painter->drawLine(QLineF(x, y-w, x, y+w)); painter->drawLine(QLineF(x, y, x-w*0.707, y+w*0.707)); painter->drawLine(QLineF(x, y, x+w*0.707, y+w*0.707)); break; } case ssPixmap: { const double widthHalf = mPixmap.width()*0.5; const double heightHalf = mPixmap.height()*0.5; #if QT_VERSION < QT_VERSION_CHECK(4, 8, 0) const QRectF clipRect = painter->clipRegion().boundingRect().adjusted(-widthHalf, -heightHalf, widthHalf, heightHalf); #else const QRectF clipRect = painter->clipBoundingRect().adjusted(-widthHalf, -heightHalf, widthHalf, heightHalf); #endif if (clipRect.contains(x, y)) painter->drawPixmap(qRound(x-widthHalf), qRound(y-heightHalf), mPixmap); break; } case ssCustom: { QTransform oldTransform = painter->transform(); painter->translate(x, y); painter->scale(mSize/6.0, mSize/6.0); painter->drawPath(mCustomPath); painter->setTransform(oldTransform); break; } } } /* end of 'src/scatterstyle.cpp' */ /* including file 'src/plottable.cpp' */ /* modified 2021-03-29T02:30:44, size 38818 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPSelectionDecorator //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPSelectionDecorator \brief Controls how a plottable's data selection is drawn Each \ref QCPAbstractPlottable instance has one \ref QCPSelectionDecorator (accessible via \ref QCPAbstractPlottable::selectionDecorator) and uses it when drawing selected segments of its data. The selection decorator controls both pen (\ref setPen) and brush (\ref setBrush), as well as the scatter style (\ref setScatterStyle) if the plottable draws scatters. Since a \ref QCPScatterStyle is itself composed of different properties such as color shape and size, the decorator allows specifying exactly which of those properties shall be used for the selected data point, via \ref setUsedScatterProperties. A \ref QCPSelectionDecorator subclass instance can be passed to a plottable via \ref QCPAbstractPlottable::setSelectionDecorator, allowing greater customizability of the appearance of selected segments. Use \ref copyFrom to easily transfer the settings of one decorator to another one. This is especially useful since plottables take ownership of the passed selection decorator, and thus the same decorator instance can not be passed to multiple plottables. Selection decorators can also themselves perform drawing operations by reimplementing \ref drawDecoration, which is called by the plottable's draw method. The base class \ref QCPSelectionDecorator does not make use of this however. For example, \ref QCPSelectionDecoratorBracket draws brackets around selected data segments. */ /*! Creates a new QCPSelectionDecorator instance with default values */ QCPSelectionDecorator::QCPSelectionDecorator() : mPen(QColor(80, 80, 255), 2.5), mBrush(Qt::NoBrush), mUsedScatterProperties(QCPScatterStyle::spNone), mPlottable(nullptr) { } QCPSelectionDecorator::~QCPSelectionDecorator() { } /*! Sets the pen that will be used by the parent plottable to draw selected data segments. */ void QCPSelectionDecorator::setPen(const QPen &pen) { mPen = pen; } /*! Sets the brush that will be used by the parent plottable to draw selected data segments. */ void QCPSelectionDecorator::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the scatter style that will be used by the parent plottable to draw scatters in selected data segments. \a usedProperties specifies which parts of the passed \a scatterStyle will be used by the plottable. The used properties can also be changed via \ref setUsedScatterProperties. */ void QCPSelectionDecorator::setScatterStyle(const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties) { mScatterStyle = scatterStyle; setUsedScatterProperties(usedProperties); } /*! Use this method to define which properties of the scatter style (set via \ref setScatterStyle) will be used for selected data segments. All properties of the scatter style that are not specified in \a properties will remain as specified in the plottable's original scatter style. \see QCPScatterStyle::ScatterProperty */ void QCPSelectionDecorator::setUsedScatterProperties(const QCPScatterStyle::ScatterProperties &properties) { mUsedScatterProperties = properties; } /*! Sets the pen of \a painter to the pen of this selection decorator. \see applyBrush, getFinalScatterStyle */ void QCPSelectionDecorator::applyPen(QCPPainter *painter) const { painter->setPen(mPen); } /*! Sets the brush of \a painter to the brush of this selection decorator. \see applyPen, getFinalScatterStyle */ void QCPSelectionDecorator::applyBrush(QCPPainter *painter) const { painter->setBrush(mBrush); } /*! Returns the scatter style that the parent plottable shall use for selected scatter points. The plottable's original (unselected) scatter style must be passed as \a unselectedStyle. Depending on the setting of \ref setUsedScatterProperties, the returned scatter style is a mixture of this selecion decorator's scatter style (\ref setScatterStyle), and \a unselectedStyle. \see applyPen, applyBrush, setScatterStyle */ QCPScatterStyle QCPSelectionDecorator::getFinalScatterStyle(const QCPScatterStyle &unselectedStyle) const { QCPScatterStyle result(unselectedStyle); result.setFromOther(mScatterStyle, mUsedScatterProperties); // if style shall inherit pen from plottable (has no own pen defined), give it the selected // plottable pen explicitly, so it doesn't use the unselected plottable pen when used in the // plottable: if (!result.isPenDefined()) result.setPen(mPen); return result; } /*! Copies all properties (e.g. color, fill, scatter style) of the \a other selection decorator to this selection decorator. */ void QCPSelectionDecorator::copyFrom(const QCPSelectionDecorator *other) { setPen(other->pen()); setBrush(other->brush()); setScatterStyle(other->scatterStyle(), other->usedScatterProperties()); } /*! This method is called by all plottables' draw methods to allow custom selection decorations to be drawn. Use the passed \a painter to perform the drawing operations. \a selection carries the data selection for which the decoration shall be drawn. The default base class implementation of \ref QCPSelectionDecorator has no special decoration, so this method does nothing. */ void QCPSelectionDecorator::drawDecoration(QCPPainter *painter, QCPDataSelection selection) { Q_UNUSED(painter) Q_UNUSED(selection) } /*! \internal This method is called as soon as a selection decorator is associated with a plottable, by a call to \ref QCPAbstractPlottable::setSelectionDecorator. This way the selection decorator can obtain a pointer to the plottable that uses it (e.g. to access data points via the \ref QCPAbstractPlottable::interface1D interface). If the selection decorator was already added to a different plottable before, this method aborts the registration and returns false. */ bool QCPSelectionDecorator::registerWithPlottable(QCPAbstractPlottable *plottable) { if (!mPlottable) { mPlottable = plottable; return true; } else { qDebug() << Q_FUNC_INFO << "This selection decorator is already registered with plottable:" << reinterpret_cast(mPlottable); return false; } } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAbstractPlottable //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAbstractPlottable \brief The abstract base class for all data representing objects in a plot. It defines a very basic interface like name, pen, brush, visibility etc. Since this class is abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to create new ways of displaying data (see "Creating own plottables" below). Plottables that display one-dimensional data (i.e. data points have a single key dimension and one or multiple values at each key) are based off of the template subclass \ref QCPAbstractPlottable1D, see details there. All further specifics are in the subclasses, for example: \li A normal graph with possibly a line and/or scatter points \ref QCPGraph (typically created with \ref QCustomPlot::addGraph) \li A parametric curve: \ref QCPCurve \li A bar chart: \ref QCPBars \li A statistical box plot: \ref QCPStatisticalBox \li A color encoded two-dimensional map: \ref QCPColorMap \li An OHLC/Candlestick chart: \ref QCPFinancial \section plottables-subclassing Creating own plottables Subclassing directly from QCPAbstractPlottable is only recommended if you wish to display two-dimensional data like \ref QCPColorMap, i.e. two logical key dimensions and one (or more) data dimensions. If you want to display data with only one logical key dimension, you should rather derive from \ref QCPAbstractPlottable1D. If subclassing QCPAbstractPlottable directly, these are the pure virtual functions you must implement: \li \ref selectTest \li \ref draw \li \ref drawLegendIcon \li \ref getKeyRange \li \ref getValueRange See the documentation of those functions for what they need to do. For drawing your plot, you can use the \ref coordsToPixels functions to translate a point in plot coordinates to pixel coordinates. This function is quite convenient, because it takes the orientation of the key and value axes into account for you (x and y are swapped when the key axis is vertical and the value axis horizontal). If you are worried about performance (i.e. you need to translate many points in a loop like QCPGraph), you can directly use \ref QCPAxis::coordToPixel. However, you must then take care about the orientation of the axis yourself. Here are some important members you inherit from QCPAbstractPlottable:
QCustomPlot *\b mParentPlot A pointer to the parent QCustomPlot instance. The parent plot is inferred from the axes that are passed in the constructor.
QString \b mName The name of the plottable.
QPen \b mPen The generic pen of the plottable. You should use this pen for the most prominent data representing lines in the plottable (e.g QCPGraph uses this pen for its graph lines and scatters)
QBrush \b mBrush The generic brush of the plottable. You should use this brush for the most prominent fillable structures in the plottable (e.g. QCPGraph uses this brush to control filling under the graph)
QPointer<\ref QCPAxis> \b mKeyAxis, \b mValueAxis The key and value axes this plottable is attached to. Call their QCPAxis::coordToPixel functions to translate coordinates to pixels in either the key or value dimension. Make sure to check whether the pointer is \c nullptr before using it. If one of the axes is null, don't draw the plottable.
\ref QCPSelectionDecorator \b mSelectionDecorator The currently set selection decorator which specifies how selected data of the plottable shall be drawn and decorated. When drawing your data, you must consult this decorator for the appropriate pen/brush before drawing unselected/selected data segments. Finally, you should call its \ref QCPSelectionDecorator::drawDecoration method at the end of your \ref draw implementation.
\ref QCP::SelectionType \b mSelectable In which composition, if at all, this plottable's data may be selected. Enforcing this setting on the data selection is done by QCPAbstractPlottable automatically.
\ref QCPDataSelection \b mSelection Holds the current selection state of the plottable's data, i.e. the selected data ranges (\ref QCPDataRange).
*/ /* start of documentation of inline functions */ /*! \fn QCPSelectionDecorator *QCPAbstractPlottable::selectionDecorator() const Provides access to the selection decorator of this plottable. The selection decorator controls how selected data ranges are drawn (e.g. their pen color and fill), see \ref QCPSelectionDecorator for details. If you wish to use an own \ref QCPSelectionDecorator subclass, pass an instance of it to \ref setSelectionDecorator. */ /*! \fn bool QCPAbstractPlottable::selected() const Returns true if there are any data points of the plottable currently selected. Use \ref selection to retrieve the current \ref QCPDataSelection. */ /*! \fn QCPDataSelection QCPAbstractPlottable::selection() const Returns a \ref QCPDataSelection encompassing all the data points that are currently selected on this plottable. \see selected, setSelection, setSelectable */ /*! \fn virtual QCPPlottableInterface1D *QCPAbstractPlottable::interface1D() If this plottable is a one-dimensional plottable, i.e. it implements the \ref QCPPlottableInterface1D, returns the \a this pointer with that type. Otherwise (e.g. in the case of a \ref QCPColorMap) returns zero. You can use this method to gain read access to data coordinates while holding a pointer to the abstract base class only. */ /* end of documentation of inline functions */ /* start of documentation of pure virtual functions */ /*! \fn void QCPAbstractPlottable::drawLegendIcon(QCPPainter *painter, const QRect &rect) const = 0 \internal called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside \a rect, next to the plottable name. The passed \a painter has its cliprect set to \a rect, so painting outside of \a rect won't appear outside the legend icon border. */ /*! \fn QCPRange QCPAbstractPlottable::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const = 0 Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set \a inSignDomain to either \ref QCP::sdNegative or \ref QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set \a inSignDomain to \ref QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set \a inSignDomain to \ref QCP::sdBoth (default). \a foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data). Note that \a foundRange is not the same as \ref QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case \a foundRange would return true, but the returned range is not a valid range in terms of \ref QCPRange::validRange. \see rescaleAxes, getValueRange */ /*! \fn QCPRange QCPAbstractPlottable::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const = 0 Returns the coordinate range that the data points in the specified key range (\a inKeyRange) span in the value axis dimension. For logarithmic plots, one can set \a inSignDomain to either \ref QCP::sdNegative or \ref QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set \a inSignDomain to \ref QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set \a inSignDomain to \ref QCP::sdBoth (default). \a foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data). If \a inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys. Note that \a foundRange is not the same as \ref QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case \a foundRange would return true, but the returned range is not a valid range in terms of \ref QCPRange::validRange. \see rescaleAxes, getKeyRange */ /* end of documentation of pure virtual functions */ /* start of documentation of signals */ /*! \fn void QCPAbstractPlottable::selectionChanged(bool selected) This signal is emitted when the selection state of this plottable has changed, either by user interaction or by a direct call to \ref setSelection. The parameter \a selected indicates whether there are any points selected or not. \see selectionChanged(const QCPDataSelection &selection) */ /*! \fn void QCPAbstractPlottable::selectionChanged(const QCPDataSelection &selection) This signal is emitted when the selection state of this plottable has changed, either by user interaction or by a direct call to \ref setSelection. The parameter \a selection holds the currently selected data ranges. \see selectionChanged(bool selected) */ /*! \fn void QCPAbstractPlottable::selectableChanged(QCP::SelectionType selectable); This signal is emitted when the selectability of this plottable has changed. \see setSelectable */ /* end of documentation of signals */ /*! Constructs an abstract plottable which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and have perpendicular orientations. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. Since QCPAbstractPlottable is an abstract class that defines the basic interface to plottables, it can't be directly instantiated. You probably want one of the subclasses like \ref QCPGraph or \ref QCPCurve instead. */ QCPAbstractPlottable::QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPLayerable(keyAxis->parentPlot(), QString(), keyAxis->axisRect()), mName(), mAntialiasedFill(true), mAntialiasedScatters(true), mPen(Qt::black), mBrush(Qt::NoBrush), mKeyAxis(keyAxis), mValueAxis(valueAxis), mSelectable(QCP::stWhole), mSelectionDecorator(nullptr) { if (keyAxis->parentPlot() != valueAxis->parentPlot()) qDebug() << Q_FUNC_INFO << "Parent plot of keyAxis is not the same as that of valueAxis."; if (keyAxis->orientation() == valueAxis->orientation()) qDebug() << Q_FUNC_INFO << "keyAxis and valueAxis must be orthogonal to each other."; mParentPlot->registerPlottable(this); setSelectionDecorator(new QCPSelectionDecorator); } QCPAbstractPlottable::~QCPAbstractPlottable() { if (mSelectionDecorator) { delete mSelectionDecorator; mSelectionDecorator = nullptr; } } /*! The name is the textual representation of this plottable as it is displayed in the legend (\ref QCPLegend). It may contain any UTF-8 characters, including newlines. */ void QCPAbstractPlottable::setName(const QString &name) { mName = name; } /*! Sets whether fills of this plottable are drawn antialiased or not. Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. */ void QCPAbstractPlottable::setAntialiasedFill(bool enabled) { mAntialiasedFill = enabled; } /*! Sets whether the scatter symbols of this plottable are drawn antialiased or not. Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. */ void QCPAbstractPlottable::setAntialiasedScatters(bool enabled) { mAntialiasedScatters = enabled; } /*! The pen is used to draw basic lines that make up the plottable representation in the plot. For example, the \ref QCPGraph subclass draws its graph lines with this pen. \see setBrush */ void QCPAbstractPlottable::setPen(const QPen &pen) { mPen = pen; } /*! The brush is used to draw basic fills of the plottable representation in the plot. The Fill can be a color, gradient or texture, see the usage of QBrush. For example, the \ref QCPGraph subclass draws the fill under the graph with this brush, when it's not set to Qt::NoBrush. \see setPen */ void QCPAbstractPlottable::setBrush(const QBrush &brush) { mBrush = brush; } /*! The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's value axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis. Normally, the key and value axes are set in the constructor of the plottable (or \ref QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). \see setValueAxis */ void QCPAbstractPlottable::setKeyAxis(QCPAxis *axis) { mKeyAxis = axis; } /*! The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's key axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis. Normally, the key and value axes are set in the constructor of the plottable (or \ref QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). \see setKeyAxis */ void QCPAbstractPlottable::setValueAxis(QCPAxis *axis) { mValueAxis = axis; } /*! Sets which data ranges of this plottable are selected. Selected data ranges are drawn differently (e.g. color) in the plot. This can be controlled via the selection decorator (see \ref selectionDecorator). The entire selection mechanism for plottables is handled automatically when \ref QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when you wish to change the selection state programmatically. Using \ref setSelectable you can further specify for each plottable whether and to which granularity it is selectable. If \a selection is not compatible with the current \ref QCP::SelectionType set via \ref setSelectable, the resulting selection will be adjusted accordingly (see \ref QCPDataSelection::enforceType). emits the \ref selectionChanged signal when \a selected is different from the previous selection state. \see setSelectable, selectTest */ void QCPAbstractPlottable::setSelection(QCPDataSelection selection) { selection.enforceType(mSelectable); if (mSelection != selection) { mSelection = selection; emit selectionChanged(selected()); emit selectionChanged(mSelection); } } /*! Use this method to set an own QCPSelectionDecorator (subclass) instance. This allows you to customize the visual representation of selected data ranges further than by using the default QCPSelectionDecorator. The plottable takes ownership of the \a decorator. The currently set decorator can be accessed via \ref selectionDecorator. */ void QCPAbstractPlottable::setSelectionDecorator(QCPSelectionDecorator *decorator) { if (decorator) { if (decorator->registerWithPlottable(this)) { delete mSelectionDecorator; // delete old decorator if necessary mSelectionDecorator = decorator; } } else if (mSelectionDecorator) // just clear decorator { delete mSelectionDecorator; mSelectionDecorator = nullptr; } } /*! Sets whether and to which granularity this plottable can be selected. A selection can happen by clicking on the QCustomPlot surface (When \ref QCustomPlot::setInteractions contains \ref QCP::iSelectPlottables), by dragging a selection rect (When \ref QCustomPlot::setSelectionRectMode is \ref QCP::srmSelect), or programmatically by calling \ref setSelection. \see setSelection, QCP::SelectionType */ void QCPAbstractPlottable::setSelectable(QCP::SelectionType selectable) { if (mSelectable != selectable) { mSelectable = selectable; QCPDataSelection oldSelection = mSelection; mSelection.enforceType(mSelectable); emit selectableChanged(mSelectable); if (mSelection != oldSelection) { emit selectionChanged(selected()); emit selectionChanged(mSelection); } } } /*! Convenience function for transforming a key/value pair to pixels on the QCustomPlot surface, taking the orientations of the axes associated with this plottable into account (e.g. whether key represents x or y). \a key and \a value are transformed to the coodinates in pixels and are written to \a x and \a y. \see pixelsToCoords, QCPAxis::coordToPixel */ void QCPAbstractPlottable::coordsToPixels(double key, double value, double &x, double &y) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (keyAxis->orientation() == Qt::Horizontal) { x = keyAxis->coordToPixel(key); y = valueAxis->coordToPixel(value); } else { y = keyAxis->coordToPixel(key); x = valueAxis->coordToPixel(value); } } /*! \overload Transforms the given \a key and \a value to pixel coordinates and returns them in a QPointF. */ const QPointF QCPAbstractPlottable::coordsToPixels(double key, double value) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } if (keyAxis->orientation() == Qt::Horizontal) return QPointF(keyAxis->coordToPixel(key), valueAxis->coordToPixel(value)); else return QPointF(valueAxis->coordToPixel(value), keyAxis->coordToPixel(key)); } /*! Convenience function for transforming a x/y pixel pair on the QCustomPlot surface to plot coordinates, taking the orientations of the axes associated with this plottable into account (e.g. whether key represents x or y). \a x and \a y are transformed to the plot coodinates and are written to \a key and \a value. \see coordsToPixels, QCPAxis::coordToPixel */ void QCPAbstractPlottable::pixelsToCoords(double x, double y, double &key, double &value) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (keyAxis->orientation() == Qt::Horizontal) { key = keyAxis->pixelToCoord(x); value = valueAxis->pixelToCoord(y); } else { key = keyAxis->pixelToCoord(y); value = valueAxis->pixelToCoord(x); } } /*! \overload Returns the pixel input \a pixelPos as plot coordinates \a key and \a value. */ void QCPAbstractPlottable::pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const { pixelsToCoords(pixelPos.x(), pixelPos.y(), key, value); } /*! Rescales the key and value axes associated with this plottable to contain all displayed data, so the whole plottable is visible. If the scaling of an axis is logarithmic, rescaleAxes will make sure not to rescale to an illegal range i.e. a range containing different signs and/or zero. Instead it will stay in the current sign domain and ignore all parts of the plottable that lie outside of that domain. \a onlyEnlarge makes sure the ranges are only expanded, never reduced. So it's possible to show multiple plottables in their entirety by multiple calls to rescaleAxes where the first call has \a onlyEnlarge set to false (the default), and all subsequent set to true. \see rescaleKeyAxis, rescaleValueAxis, QCustomPlot::rescaleAxes, QCPAxis::rescale */ void QCPAbstractPlottable::rescaleAxes(bool onlyEnlarge) const { rescaleKeyAxis(onlyEnlarge); rescaleValueAxis(onlyEnlarge); } /*! Rescales the key axis of the plottable so the whole plottable is visible. See \ref rescaleAxes for detailed behaviour. */ void QCPAbstractPlottable::rescaleKeyAxis(bool onlyEnlarge) const { QCPAxis *keyAxis = mKeyAxis.data(); if (!keyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } QCP::SignDomain signDomain = QCP::sdBoth; if (keyAxis->scaleType() == QCPAxis::stLogarithmic) signDomain = (keyAxis->range().upper < 0 ? QCP::sdNegative : QCP::sdPositive); bool foundRange; QCPRange newRange = getKeyRange(foundRange, signDomain); if (foundRange) { if (onlyEnlarge) newRange.expand(keyAxis->range()); if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason if (keyAxis->scaleType() == QCPAxis::stLinear) { newRange.lower = center-keyAxis->range().size()/2.0; newRange.upper = center+keyAxis->range().size()/2.0; } else // scaleType() == stLogarithmic { newRange.lower = center/qSqrt(keyAxis->range().upper/keyAxis->range().lower); newRange.upper = center*qSqrt(keyAxis->range().upper/keyAxis->range().lower); } } keyAxis->setRange(newRange); } } /*! Rescales the value axis of the plottable so the whole plottable is visible. If \a inKeyRange is set to true, only the data points which are in the currently visible key axis range are considered. Returns true if the axis was actually scaled. This might not be the case if this plottable has an invalid range, e.g. because it has no data points. See \ref rescaleAxes for detailed behaviour. */ void QCPAbstractPlottable::rescaleValueAxis(bool onlyEnlarge, bool inKeyRange) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } QCP::SignDomain signDomain = QCP::sdBoth; if (valueAxis->scaleType() == QCPAxis::stLogarithmic) signDomain = (valueAxis->range().upper < 0 ? QCP::sdNegative : QCP::sdPositive); bool foundRange; QCPRange newRange = getValueRange(foundRange, signDomain, inKeyRange ? keyAxis->range() : QCPRange()); if (foundRange) { if (onlyEnlarge) newRange.expand(valueAxis->range()); if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason if (valueAxis->scaleType() == QCPAxis::stLinear) { newRange.lower = center-valueAxis->range().size()/2.0; newRange.upper = center+valueAxis->range().size()/2.0; } else // scaleType() == stLogarithmic { newRange.lower = center/qSqrt(valueAxis->range().upper/valueAxis->range().lower); newRange.upper = center*qSqrt(valueAxis->range().upper/valueAxis->range().lower); } } valueAxis->setRange(newRange); } } /*! \overload Adds this plottable to the specified \a legend. Creates a QCPPlottableLegendItem which is inserted into the legend. Returns true on success, i.e. when the legend exists and a legend item associated with this plottable isn't already in the legend. If the plottable needs a more specialized representation in the legend, you can create a corresponding subclass of \ref QCPPlottableLegendItem and add it to the legend manually instead of calling this method. \see removeFromLegend, QCPLegend::addItem */ bool QCPAbstractPlottable::addToLegend(QCPLegend *legend) { if (!legend) { qDebug() << Q_FUNC_INFO << "passed legend is null"; return false; } if (legend->parentPlot() != mParentPlot) { qDebug() << Q_FUNC_INFO << "passed legend isn't in the same QCustomPlot as this plottable"; return false; } if (!legend->hasItemWithPlottable(this)) { legend->addItem(new QCPPlottableLegendItem(legend, this)); return true; } else return false; } /*! \overload Adds this plottable to the legend of the parent QCustomPlot (\ref QCustomPlot::legend). \see removeFromLegend */ bool QCPAbstractPlottable::addToLegend() { if (!mParentPlot || !mParentPlot->legend) return false; else return addToLegend(mParentPlot->legend); } /*! \overload Removes the plottable from the specifed \a legend. This means the \ref QCPPlottableLegendItem that is associated with this plottable is removed. Returns true on success, i.e. if the legend exists and a legend item associated with this plottable was found and removed. \see addToLegend, QCPLegend::removeItem */ bool QCPAbstractPlottable::removeFromLegend(QCPLegend *legend) const { if (!legend) { qDebug() << Q_FUNC_INFO << "passed legend is null"; return false; } if (QCPPlottableLegendItem *lip = legend->itemWithPlottable(this)) return legend->removeItem(lip); else return false; } /*! \overload Removes the plottable from the legend of the parent QCustomPlot. \see addToLegend */ bool QCPAbstractPlottable::removeFromLegend() const { if (!mParentPlot || !mParentPlot->legend) return false; else return removeFromLegend(mParentPlot->legend); } /* inherits documentation from base class */ QRect QCPAbstractPlottable::clipRect() const { if (mKeyAxis && mValueAxis) return mKeyAxis.data()->axisRect()->rect() & mValueAxis.data()->axisRect()->rect(); else return {}; } /* inherits documentation from base class */ QCP::Interaction QCPAbstractPlottable::selectionCategory() const { return QCP::iSelectPlottables; } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing plottable lines. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \seebaseclassmethod \see setAntialiased, applyFillAntialiasingHint, applyScattersAntialiasingHint */ void QCPAbstractPlottable::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aePlottables); } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing plottable fills. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \see setAntialiased, applyDefaultAntialiasingHint, applyScattersAntialiasingHint */ void QCPAbstractPlottable::applyFillAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiasedFill, QCP::aeFills); } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing plottable scatter points. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \see setAntialiased, applyFillAntialiasingHint, applyDefaultAntialiasingHint */ void QCPAbstractPlottable::applyScattersAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiasedScatters, QCP::aeScatters); } /* inherits documentation from base class */ void QCPAbstractPlottable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) if (mSelectable != QCP::stNone) { QCPDataSelection newSelection = details.value(); QCPDataSelection selectionBefore = mSelection; if (additive) { if (mSelectable == QCP::stWhole) // in whole selection mode, we toggle to no selection even if currently unselected point was hit { if (selected()) setSelection(QCPDataSelection()); else setSelection(newSelection); } else // in all other selection modes we toggle selections of homogeneously selected/unselected segments { if (mSelection.contains(newSelection)) // if entire newSelection is already selected, toggle selection setSelection(mSelection-newSelection); else setSelection(mSelection+newSelection); } } else setSelection(newSelection); if (selectionStateChanged) *selectionStateChanged = mSelection != selectionBefore; } } /* inherits documentation from base class */ void QCPAbstractPlottable::deselectEvent(bool *selectionStateChanged) { if (mSelectable != QCP::stNone) { QCPDataSelection selectionBefore = mSelection; setSelection(QCPDataSelection()); if (selectionStateChanged) *selectionStateChanged = mSelection != selectionBefore; } } /* end of 'src/plottable.cpp' */ /* including file 'src/item.cpp' */ /* modified 2021-03-29T02:30:44, size 49486 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemAnchor //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemAnchor \brief An anchor of an item to which positions can be attached to. An item (QCPAbstractItem) may have one or more anchors. Unlike QCPItemPosition, an anchor doesn't control anything on its item, but provides a way to tie other items via their positions to the anchor. For example, a QCPItemRect is defined by its positions \a topLeft and \a bottomRight. Additionally it has various anchors like \a top, \a topRight or \a bottomLeft etc. So you can attach the \a start (which is a QCPItemPosition) of a QCPItemLine to one of the anchors by calling QCPItemPosition::setParentAnchor on \a start, passing the wanted anchor of the QCPItemRect. This way the start of the line will now always follow the respective anchor location on the rect item. Note that QCPItemPosition derives from QCPItemAnchor, so every position can also serve as an anchor to other positions. To learn how to provide anchors in your own item subclasses, see the subclassing section of the QCPAbstractItem documentation. */ /* start documentation of inline functions */ /*! \fn virtual QCPItemPosition *QCPItemAnchor::toQCPItemPosition() Returns \c nullptr if this instance is merely a QCPItemAnchor, and a valid pointer of type QCPItemPosition* if it actually is a QCPItemPosition (which is a subclass of QCPItemAnchor). This safe downcast functionality could also be achieved with a dynamic_cast. However, QCustomPlot avoids dynamic_cast to work with projects that don't have RTTI support enabled (e.g. -fno-rtti flag with gcc compiler). */ /* end documentation of inline functions */ /*! Creates a new QCPItemAnchor. You shouldn't create QCPItemAnchor instances directly, even if you want to make a new item subclass. Use \ref QCPAbstractItem::createAnchor instead, as explained in the subclassing section of the QCPAbstractItem documentation. */ QCPItemAnchor::QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId) : mName(name), mParentPlot(parentPlot), mParentItem(parentItem), mAnchorId(anchorId) { } QCPItemAnchor::~QCPItemAnchor() { // unregister as parent at children: foreach (QCPItemPosition *child, mChildrenX.values()) { if (child->parentAnchorX() == this) child->setParentAnchorX(nullptr); // this acts back on this anchor and child removes itself from mChildrenX } foreach (QCPItemPosition *child, mChildrenY.values()) { if (child->parentAnchorY() == this) child->setParentAnchorY(nullptr); // this acts back on this anchor and child removes itself from mChildrenY } } /*! Returns the final absolute pixel position of the QCPItemAnchor on the QCustomPlot surface. The pixel information is internally retrieved via QCPAbstractItem::anchorPixelPosition of the parent item, QCPItemAnchor is just an intermediary. */ QPointF QCPItemAnchor::pixelPosition() const { if (mParentItem) { if (mAnchorId > -1) { return mParentItem->anchorPixelPosition(mAnchorId); } else { qDebug() << Q_FUNC_INFO << "no valid anchor id set:" << mAnchorId; return {}; } } else { qDebug() << Q_FUNC_INFO << "no parent item set"; return {}; } } /*! \internal Adds \a pos to the childX list of this anchor, which keeps track of which children use this anchor as parent anchor for the respective coordinate. This is necessary to notify the children prior to destruction of the anchor. Note that this function does not change the parent setting in \a pos. */ void QCPItemAnchor::addChildX(QCPItemPosition *pos) { if (!mChildrenX.contains(pos)) mChildrenX.insert(pos); else qDebug() << Q_FUNC_INFO << "provided pos is child already" << reinterpret_cast(pos); } /*! \internal Removes \a pos from the childX list of this anchor. Note that this function does not change the parent setting in \a pos. */ void QCPItemAnchor::removeChildX(QCPItemPosition *pos) { if (!mChildrenX.remove(pos)) qDebug() << Q_FUNC_INFO << "provided pos isn't child" << reinterpret_cast(pos); } /*! \internal Adds \a pos to the childY list of this anchor, which keeps track of which children use this anchor as parent anchor for the respective coordinate. This is necessary to notify the children prior to destruction of the anchor. Note that this function does not change the parent setting in \a pos. */ void QCPItemAnchor::addChildY(QCPItemPosition *pos) { if (!mChildrenY.contains(pos)) mChildrenY.insert(pos); else qDebug() << Q_FUNC_INFO << "provided pos is child already" << reinterpret_cast(pos); } /*! \internal Removes \a pos from the childY list of this anchor. Note that this function does not change the parent setting in \a pos. */ void QCPItemAnchor::removeChildY(QCPItemPosition *pos) { if (!mChildrenY.remove(pos)) qDebug() << Q_FUNC_INFO << "provided pos isn't child" << reinterpret_cast(pos); } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemPosition //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemPosition \brief Manages the position of an item. Every item has at least one public QCPItemPosition member pointer which provides ways to position the item on the QCustomPlot surface. Some items have multiple positions, for example QCPItemRect has two: \a topLeft and \a bottomRight. QCPItemPosition has a type (\ref PositionType) that can be set with \ref setType. This type defines how coordinates passed to \ref setCoords are to be interpreted, e.g. as absolute pixel coordinates, as plot coordinates of certain axes (\ref QCPItemPosition::setAxes), as fractions of the axis rect (\ref QCPItemPosition::setAxisRect), etc. For more advanced plots it is also possible to assign different types per X/Y coordinate of the position (see \ref setTypeX, \ref setTypeY). This way an item could be positioned for example at a fixed pixel distance from the top in the Y direction, while following a plot coordinate in the X direction. A QCPItemPosition may have a parent QCPItemAnchor, see \ref setParentAnchor. This way you can tie multiple items together. If the QCPItemPosition has a parent, its coordinates (\ref setCoords) are considered to be absolute pixels in the reference frame of the parent anchor, where (0, 0) means directly ontop of the parent anchor. For example, You could attach the \a start position of a QCPItemLine to the \a bottom anchor of a QCPItemText to make the starting point of the line always be centered under the text label, no matter where the text is moved to. For more advanced plots, it is possible to assign different parent anchors per X/Y coordinate of the position, see \ref setParentAnchorX, \ref setParentAnchorY. This way an item could follow another item in the X direction but stay at a fixed position in the Y direction. Or even follow item A in X, and item B in Y. Note that every QCPItemPosition inherits from QCPItemAnchor and thus can itself be used as parent anchor for other positions. To set the apparent pixel position on the QCustomPlot surface directly, use \ref setPixelPosition. This works no matter what type this QCPItemPosition is or what parent-child situation it is in, as \ref setPixelPosition transforms the coordinates appropriately, to make the position appear at the specified pixel values. */ /* start documentation of inline functions */ /*! \fn QCPItemPosition::PositionType *QCPItemPosition::type() const Returns the current position type. If different types were set for X and Y (\ref setTypeX, \ref setTypeY), this method returns the type of the X coordinate. In that case rather use \a typeX() and \a typeY(). \see setType */ /*! \fn QCPItemAnchor *QCPItemPosition::parentAnchor() const Returns the current parent anchor. If different parent anchors were set for X and Y (\ref setParentAnchorX, \ref setParentAnchorY), this method returns the parent anchor of the Y coordinate. In that case rather use \a parentAnchorX() and \a parentAnchorY(). \see setParentAnchor */ /* end documentation of inline functions */ /*! Creates a new QCPItemPosition. You shouldn't create QCPItemPosition instances directly, even if you want to make a new item subclass. Use \ref QCPAbstractItem::createPosition instead, as explained in the subclassing section of the QCPAbstractItem documentation. */ QCPItemPosition::QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name) : QCPItemAnchor(parentPlot, parentItem, name), mPositionTypeX(ptAbsolute), mPositionTypeY(ptAbsolute), mKey(0), mValue(0), mParentAnchorX(nullptr), mParentAnchorY(nullptr) { } QCPItemPosition::~QCPItemPosition() { // unregister as parent at children: // Note: this is done in ~QCPItemAnchor again, but it's important QCPItemPosition does it itself, because only then // the setParentAnchor(0) call the correct QCPItemPosition::pixelPosition function instead of QCPItemAnchor::pixelPosition foreach (QCPItemPosition *child, mChildrenX.values()) { if (child->parentAnchorX() == this) child->setParentAnchorX(nullptr); // this acts back on this anchor and child removes itself from mChildrenX } foreach (QCPItemPosition *child, mChildrenY.values()) { if (child->parentAnchorY() == this) child->setParentAnchorY(nullptr); // this acts back on this anchor and child removes itself from mChildrenY } // unregister as child in parent: if (mParentAnchorX) mParentAnchorX->removeChildX(this); if (mParentAnchorY) mParentAnchorY->removeChildY(this); } /* can't make this a header inline function, because QPointer breaks with forward declared types, see QTBUG-29588 */ QCPAxisRect *QCPItemPosition::axisRect() const { return mAxisRect.data(); } /*! Sets the type of the position. The type defines how the coordinates passed to \ref setCoords should be handled and how the QCPItemPosition should behave in the plot. The possible values for \a type can be separated in two main categories: \li The position is regarded as a point in plot coordinates. This corresponds to \ref ptPlotCoords and requires two axes that define the plot coordinate system. They can be specified with \ref setAxes. By default, the QCustomPlot's x- and yAxis are used. \li The position is fixed on the QCustomPlot surface, i.e. independent of axis ranges. This corresponds to all other types, i.e. \ref ptAbsolute, \ref ptViewportRatio and \ref ptAxisRectRatio. They differ only in the way the absolute position is described, see the documentation of \ref PositionType for details. For \ref ptAxisRectRatio, note that you can specify the axis rect with \ref setAxisRect. By default this is set to the main axis rect. Note that the position type \ref ptPlotCoords is only available (and sensible) when the position has no parent anchor (\ref setParentAnchor). If the type is changed, the apparent pixel position on the plot is preserved. This means the coordinates as retrieved with coords() and set with \ref setCoords may change in the process. This method sets the type for both X and Y directions. It is also possible to set different types for X and Y, see \ref setTypeX, \ref setTypeY. */ void QCPItemPosition::setType(QCPItemPosition::PositionType type) { setTypeX(type); setTypeY(type); } /*! This method sets the position type of the X coordinate to \a type. For a detailed description of what a position type is, see the documentation of \ref setType. \see setType, setTypeY */ void QCPItemPosition::setTypeX(QCPItemPosition::PositionType type) { if (mPositionTypeX != type) { // if switching from or to coordinate type that isn't valid (e.g. because axes or axis rect // were deleted), don't try to recover the pixelPosition() because it would output a qDebug warning. bool retainPixelPosition = true; if ((mPositionTypeX == ptPlotCoords || type == ptPlotCoords) && (!mKeyAxis || !mValueAxis)) retainPixelPosition = false; if ((mPositionTypeX == ptAxisRectRatio || type == ptAxisRectRatio) && (!mAxisRect)) retainPixelPosition = false; QPointF pixel; if (retainPixelPosition) pixel = pixelPosition(); mPositionTypeX = type; if (retainPixelPosition) setPixelPosition(pixel); } } /*! This method sets the position type of the Y coordinate to \a type. For a detailed description of what a position type is, see the documentation of \ref setType. \see setType, setTypeX */ void QCPItemPosition::setTypeY(QCPItemPosition::PositionType type) { if (mPositionTypeY != type) { // if switching from or to coordinate type that isn't valid (e.g. because axes or axis rect // were deleted), don't try to recover the pixelPosition() because it would output a qDebug warning. bool retainPixelPosition = true; if ((mPositionTypeY == ptPlotCoords || type == ptPlotCoords) && (!mKeyAxis || !mValueAxis)) retainPixelPosition = false; if ((mPositionTypeY == ptAxisRectRatio || type == ptAxisRectRatio) && (!mAxisRect)) retainPixelPosition = false; QPointF pixel; if (retainPixelPosition) pixel = pixelPosition(); mPositionTypeY = type; if (retainPixelPosition) setPixelPosition(pixel); } } /*! Sets the parent of this QCPItemPosition to \a parentAnchor. This means the position will now follow any position changes of the anchor. The local coordinate system of positions with a parent anchor always is absolute pixels, with (0, 0) being exactly on top of the parent anchor. (Hence the type shouldn't be set to \ref ptPlotCoords for positions with parent anchors.) if \a keepPixelPosition is true, the current pixel position of the QCPItemPosition is preserved during reparenting. If it's set to false, the coordinates are set to (0, 0), i.e. the position will be exactly on top of the parent anchor. To remove this QCPItemPosition from any parent anchor, set \a parentAnchor to \c nullptr. If the QCPItemPosition previously had no parent and the type is \ref ptPlotCoords, the type is set to \ref ptAbsolute, to keep the position in a valid state. This method sets the parent anchor for both X and Y directions. It is also possible to set different parents for X and Y, see \ref setParentAnchorX, \ref setParentAnchorY. */ bool QCPItemPosition::setParentAnchor(QCPItemAnchor *parentAnchor, bool keepPixelPosition) { bool successX = setParentAnchorX(parentAnchor, keepPixelPosition); bool successY = setParentAnchorY(parentAnchor, keepPixelPosition); return successX && successY; } /*! This method sets the parent anchor of the X coordinate to \a parentAnchor. For a detailed description of what a parent anchor is, see the documentation of \ref setParentAnchor. \see setParentAnchor, setParentAnchorY */ bool QCPItemPosition::setParentAnchorX(QCPItemAnchor *parentAnchor, bool keepPixelPosition) { // make sure self is not assigned as parent: if (parentAnchor == this) { qDebug() << Q_FUNC_INFO << "can't set self as parent anchor" << reinterpret_cast(parentAnchor); return false; } // make sure no recursive parent-child-relationships are created: QCPItemAnchor *currentParent = parentAnchor; while (currentParent) { if (QCPItemPosition *currentParentPos = currentParent->toQCPItemPosition()) { // is a QCPItemPosition, might have further parent, so keep iterating if (currentParentPos == this) { qDebug() << Q_FUNC_INFO << "can't create recursive parent-child-relationship" << reinterpret_cast(parentAnchor); return false; } currentParent = currentParentPos->parentAnchorX(); } else { // is a QCPItemAnchor, can't have further parent. Now make sure the parent items aren't the // same, to prevent a position being child of an anchor which itself depends on the position, // because they're both on the same item: if (currentParent->mParentItem == mParentItem) { qDebug() << Q_FUNC_INFO << "can't set parent to be an anchor which itself depends on this position" << reinterpret_cast(parentAnchor); return false; } break; } } // if previously no parent set and PosType is still ptPlotCoords, set to ptAbsolute: if (!mParentAnchorX && mPositionTypeX == ptPlotCoords) setTypeX(ptAbsolute); // save pixel position: QPointF pixelP; if (keepPixelPosition) pixelP = pixelPosition(); // unregister at current parent anchor: if (mParentAnchorX) mParentAnchorX->removeChildX(this); // register at new parent anchor: if (parentAnchor) parentAnchor->addChildX(this); mParentAnchorX = parentAnchor; // restore pixel position under new parent: if (keepPixelPosition) setPixelPosition(pixelP); else setCoords(0, coords().y()); return true; } /*! This method sets the parent anchor of the Y coordinate to \a parentAnchor. For a detailed description of what a parent anchor is, see the documentation of \ref setParentAnchor. \see setParentAnchor, setParentAnchorX */ bool QCPItemPosition::setParentAnchorY(QCPItemAnchor *parentAnchor, bool keepPixelPosition) { // make sure self is not assigned as parent: if (parentAnchor == this) { qDebug() << Q_FUNC_INFO << "can't set self as parent anchor" << reinterpret_cast(parentAnchor); return false; } // make sure no recursive parent-child-relationships are created: QCPItemAnchor *currentParent = parentAnchor; while (currentParent) { if (QCPItemPosition *currentParentPos = currentParent->toQCPItemPosition()) { // is a QCPItemPosition, might have further parent, so keep iterating if (currentParentPos == this) { qDebug() << Q_FUNC_INFO << "can't create recursive parent-child-relationship" << reinterpret_cast(parentAnchor); return false; } currentParent = currentParentPos->parentAnchorY(); } else { // is a QCPItemAnchor, can't have further parent. Now make sure the parent items aren't the // same, to prevent a position being child of an anchor which itself depends on the position, // because they're both on the same item: if (currentParent->mParentItem == mParentItem) { qDebug() << Q_FUNC_INFO << "can't set parent to be an anchor which itself depends on this position" << reinterpret_cast(parentAnchor); return false; } break; } } // if previously no parent set and PosType is still ptPlotCoords, set to ptAbsolute: if (!mParentAnchorY && mPositionTypeY == ptPlotCoords) setTypeY(ptAbsolute); // save pixel position: QPointF pixelP; if (keepPixelPosition) pixelP = pixelPosition(); // unregister at current parent anchor: if (mParentAnchorY) mParentAnchorY->removeChildY(this); // register at new parent anchor: if (parentAnchor) parentAnchor->addChildY(this); mParentAnchorY = parentAnchor; // restore pixel position under new parent: if (keepPixelPosition) setPixelPosition(pixelP); else setCoords(coords().x(), 0); return true; } /*! Sets the coordinates of this QCPItemPosition. What the coordinates mean, is defined by the type (\ref setType, \ref setTypeX, \ref setTypeY). For example, if the type is \ref ptAbsolute, \a key and \a value mean the x and y pixel position on the QCustomPlot surface. In that case the origin (0, 0) is in the top left corner of the QCustomPlot viewport. If the type is \ref ptPlotCoords, \a key and \a value mean a point in the plot coordinate system defined by the axes set by \ref setAxes. By default those are the QCustomPlot's xAxis and yAxis. See the documentation of \ref setType for other available coordinate types and their meaning. If different types were configured for X and Y (\ref setTypeX, \ref setTypeY), \a key and \a value must also be provided in the different coordinate systems. Here, the X type refers to \a key, and the Y type refers to \a value. \see setPixelPosition */ void QCPItemPosition::setCoords(double key, double value) { mKey = key; mValue = value; } /*! \overload Sets the coordinates as a QPointF \a pos where pos.x has the meaning of \a key and pos.y the meaning of \a value of the \ref setCoords(double key, double value) method. */ void QCPItemPosition::setCoords(const QPointF &pos) { setCoords(pos.x(), pos.y()); } /*! Returns the final absolute pixel position of the QCPItemPosition on the QCustomPlot surface. It includes all effects of type (\ref setType) and possible parent anchors (\ref setParentAnchor). \see setPixelPosition */ QPointF QCPItemPosition::pixelPosition() const { QPointF result; // determine X: switch (mPositionTypeX) { case ptAbsolute: { result.rx() = mKey; if (mParentAnchorX) result.rx() += mParentAnchorX->pixelPosition().x(); break; } case ptViewportRatio: { result.rx() = mKey*mParentPlot->viewport().width(); if (mParentAnchorX) result.rx() += mParentAnchorX->pixelPosition().x(); else result.rx() += mParentPlot->viewport().left(); break; } case ptAxisRectRatio: { if (mAxisRect) { result.rx() = mKey*mAxisRect.data()->width(); if (mParentAnchorX) result.rx() += mParentAnchorX->pixelPosition().x(); else result.rx() += mAxisRect.data()->left(); } else qDebug() << Q_FUNC_INFO << "Item position type x is ptAxisRectRatio, but no axis rect was defined"; break; } case ptPlotCoords: { if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Horizontal) result.rx() = mKeyAxis.data()->coordToPixel(mKey); else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Horizontal) result.rx() = mValueAxis.data()->coordToPixel(mValue); else qDebug() << Q_FUNC_INFO << "Item position type x is ptPlotCoords, but no axes were defined"; break; } } // determine Y: switch (mPositionTypeY) { case ptAbsolute: { result.ry() = mValue; if (mParentAnchorY) result.ry() += mParentAnchorY->pixelPosition().y(); break; } case ptViewportRatio: { result.ry() = mValue*mParentPlot->viewport().height(); if (mParentAnchorY) result.ry() += mParentAnchorY->pixelPosition().y(); else result.ry() += mParentPlot->viewport().top(); break; } case ptAxisRectRatio: { if (mAxisRect) { result.ry() = mValue*mAxisRect.data()->height(); if (mParentAnchorY) result.ry() += mParentAnchorY->pixelPosition().y(); else result.ry() += mAxisRect.data()->top(); } else qDebug() << Q_FUNC_INFO << "Item position type y is ptAxisRectRatio, but no axis rect was defined"; break; } case ptPlotCoords: { if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Vertical) result.ry() = mKeyAxis.data()->coordToPixel(mKey); else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Vertical) result.ry() = mValueAxis.data()->coordToPixel(mValue); else qDebug() << Q_FUNC_INFO << "Item position type y is ptPlotCoords, but no axes were defined"; break; } } return result; } /*! When \ref setType is \ref ptPlotCoords, this function may be used to specify the axes the coordinates set with \ref setCoords relate to. By default they are set to the initial xAxis and yAxis of the QCustomPlot. */ void QCPItemPosition::setAxes(QCPAxis *keyAxis, QCPAxis *valueAxis) { mKeyAxis = keyAxis; mValueAxis = valueAxis; } /*! When \ref setType is \ref ptAxisRectRatio, this function may be used to specify the axis rect the coordinates set with \ref setCoords relate to. By default this is set to the main axis rect of the QCustomPlot. */ void QCPItemPosition::setAxisRect(QCPAxisRect *axisRect) { mAxisRect = axisRect; } /*! Sets the apparent pixel position. This works no matter what type (\ref setType) this QCPItemPosition is or what parent-child situation it is in, as coordinates are transformed appropriately, to make the position finally appear at the specified pixel values. Only if the type is \ref ptAbsolute and no parent anchor is set, this function's effect is identical to that of \ref setCoords. \see pixelPosition, setCoords */ void QCPItemPosition::setPixelPosition(const QPointF &pixelPosition) { double x = pixelPosition.x(); double y = pixelPosition.y(); switch (mPositionTypeX) { case ptAbsolute: { if (mParentAnchorX) x -= mParentAnchorX->pixelPosition().x(); break; } case ptViewportRatio: { if (mParentAnchorX) x -= mParentAnchorX->pixelPosition().x(); else x -= mParentPlot->viewport().left(); x /= double(mParentPlot->viewport().width()); break; } case ptAxisRectRatio: { if (mAxisRect) { if (mParentAnchorX) x -= mParentAnchorX->pixelPosition().x(); else x -= mAxisRect.data()->left(); x /= double(mAxisRect.data()->width()); } else qDebug() << Q_FUNC_INFO << "Item position type x is ptAxisRectRatio, but no axis rect was defined"; break; } case ptPlotCoords: { if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Horizontal) x = mKeyAxis.data()->pixelToCoord(x); else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Horizontal) y = mValueAxis.data()->pixelToCoord(x); else qDebug() << Q_FUNC_INFO << "Item position type x is ptPlotCoords, but no axes were defined"; break; } } switch (mPositionTypeY) { case ptAbsolute: { if (mParentAnchorY) y -= mParentAnchorY->pixelPosition().y(); break; } case ptViewportRatio: { if (mParentAnchorY) y -= mParentAnchorY->pixelPosition().y(); else y -= mParentPlot->viewport().top(); y /= double(mParentPlot->viewport().height()); break; } case ptAxisRectRatio: { if (mAxisRect) { if (mParentAnchorY) y -= mParentAnchorY->pixelPosition().y(); else y -= mAxisRect.data()->top(); y /= double(mAxisRect.data()->height()); } else qDebug() << Q_FUNC_INFO << "Item position type y is ptAxisRectRatio, but no axis rect was defined"; break; } case ptPlotCoords: { if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Vertical) x = mKeyAxis.data()->pixelToCoord(y); else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Vertical) y = mValueAxis.data()->pixelToCoord(y); else qDebug() << Q_FUNC_INFO << "Item position type y is ptPlotCoords, but no axes were defined"; break; } } setCoords(x, y); } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAbstractItem //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAbstractItem \brief The abstract base class for all items in a plot. In QCustomPlot, items are supplemental graphical elements that are neither plottables (QCPAbstractPlottable) nor axes (QCPAxis). While plottables are always tied to two axes and thus plot coordinates, items can also be placed in absolute coordinates independent of any axes. Each specific item has at least one QCPItemPosition member which controls the positioning. Some items are defined by more than one coordinate and thus have two or more QCPItemPosition members (For example, QCPItemRect has \a topLeft and \a bottomRight). This abstract base class defines a very basic interface like visibility and clipping. Since this class is abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to create new items. The built-in items are:
QCPItemLineA line defined by a start and an end point. May have different ending styles on each side (e.g. arrows).
QCPItemStraightLineA straight line defined by a start and a direction point. Unlike QCPItemLine, the straight line is infinitely long and has no endings.
QCPItemCurveA curve defined by start, end and two intermediate control points. May have different ending styles on each side (e.g. arrows).
QCPItemRectA rectangle
QCPItemEllipseAn ellipse
QCPItemPixmapAn arbitrary pixmap
QCPItemTextA text label
QCPItemBracketA bracket which may be used to reference/highlight certain parts in the plot.
QCPItemTracerAn item that can be attached to a QCPGraph and sticks to its data points, given a key coordinate.
\section items-clipping Clipping Items are by default clipped to the main axis rect (they are only visible inside the axis rect). To make an item visible outside that axis rect, disable clipping via \ref setClipToAxisRect "setClipToAxisRect(false)". On the other hand if you want the item to be clipped to a different axis rect, specify it via \ref setClipAxisRect. This clipAxisRect property of an item is only used for clipping behaviour, and in principle is independent of the coordinate axes the item might be tied to via its position members (\ref QCPItemPosition::setAxes). However, it is common that the axis rect for clipping also contains the axes used for the item positions. \section items-using Using items First you instantiate the item you want to use and add it to the plot: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-1 by default, the positions of the item are bound to the x- and y-Axis of the plot. So we can just set the plot coordinates where the line should start/end: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-2 If we don't want the line to be positioned in plot coordinates but a different coordinate system, e.g. absolute pixel positions on the QCustomPlot surface, we need to change the position type like this: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-3 Then we can set the coordinates, this time in pixels: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-4 and make the line visible on the entire QCustomPlot, by disabling clipping to the axis rect: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-5 For more advanced plots, it is even possible to set different types and parent anchors per X/Y coordinate of an item position, using for example \ref QCPItemPosition::setTypeX or \ref QCPItemPosition::setParentAnchorX. For details, see the documentation of \ref QCPItemPosition. \section items-subclassing Creating own items To create an own item, you implement a subclass of QCPAbstractItem. These are the pure virtual functions, you must implement: \li \ref selectTest \li \ref draw See the documentation of those functions for what they need to do. \subsection items-positioning Allowing the item to be positioned As mentioned, item positions are represented by QCPItemPosition members. Let's assume the new item shall have only one point as its position (as opposed to two like a rect or multiple like a polygon). You then add a public member of type QCPItemPosition like so: \code QCPItemPosition * const myPosition;\endcode the const makes sure the pointer itself can't be modified from the user of your new item (the QCPItemPosition instance it points to, can be modified, of course). The initialization of this pointer is made easy with the \ref createPosition function. Just assign the return value of this function to each QCPItemPosition in the constructor of your item. \ref createPosition takes a string which is the name of the position, typically this is identical to the variable name. For example, the constructor of QCPItemExample could look like this: \code QCPItemExample::QCPItemExample(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), myPosition(createPosition("myPosition")) { // other constructor code } \endcode \subsection items-drawing The draw function To give your item a visual representation, reimplement the \ref draw function and use the passed QCPPainter to draw the item. You can retrieve the item position in pixel coordinates from the position member(s) via \ref QCPItemPosition::pixelPosition. To optimize performance you should calculate a bounding rect first (don't forget to take the pen width into account), check whether it intersects the \ref clipRect, and only draw the item at all if this is the case. \subsection items-selection The selectTest function Your implementation of the \ref selectTest function may use the helpers \ref QCPVector2D::distanceSquaredToLine and \ref rectDistance. With these, the implementation of the selection test becomes significantly simpler for most items. See the documentation of \ref selectTest for what the function parameters mean and what the function should return. \subsection anchors Providing anchors Providing anchors (QCPItemAnchor) starts off like adding a position. First you create a public member, e.g. \code QCPItemAnchor * const bottom;\endcode and create it in the constructor with the \ref createAnchor function, assigning it a name and an anchor id (an integer enumerating all anchors on the item, you may create an own enum for this). Since anchors can be placed anywhere, relative to the item's position(s), your item needs to provide the position of every anchor with the reimplementation of the \ref anchorPixelPosition(int anchorId) function. In essence the QCPItemAnchor is merely an intermediary that itself asks your item for the pixel position when anything attached to the anchor needs to know the coordinates. */ /* start of documentation of inline functions */ /*! \fn QList QCPAbstractItem::positions() const Returns all positions of the item in a list. \see anchors, position */ /*! \fn QList QCPAbstractItem::anchors() const Returns all anchors of the item in a list. Note that since a position (QCPItemPosition) is always also an anchor, the list will also contain the positions of this item. \see positions, anchor */ /* end of documentation of inline functions */ /* start documentation of pure virtual functions */ /*! \fn void QCPAbstractItem::draw(QCPPainter *painter) = 0 \internal Draws this item with the provided \a painter. The cliprect of the provided painter is set to the rect returned by \ref clipRect before this function is called. The clipRect depends on the clipping settings defined by \ref setClipToAxisRect and \ref setClipAxisRect. */ /* end documentation of pure virtual functions */ /* start documentation of signals */ /*! \fn void QCPAbstractItem::selectionChanged(bool selected) This signal is emitted when the selection state of this item has changed, either by user interaction or by a direct call to \ref setSelected. */ /* end documentation of signals */ /*! Base class constructor which initializes base class members. */ QCPAbstractItem::QCPAbstractItem(QCustomPlot *parentPlot) : QCPLayerable(parentPlot), mClipToAxisRect(false), mSelectable(true), mSelected(false) { parentPlot->registerItem(this); QList rects = parentPlot->axisRects(); if (!rects.isEmpty()) { setClipToAxisRect(true); setClipAxisRect(rects.first()); } } QCPAbstractItem::~QCPAbstractItem() { // don't delete mPositions because every position is also an anchor and thus in mAnchors qDeleteAll(mAnchors); } /* can't make this a header inline function, because QPointer breaks with forward declared types, see QTBUG-29588 */ QCPAxisRect *QCPAbstractItem::clipAxisRect() const { return mClipAxisRect.data(); } /*! Sets whether the item shall be clipped to an axis rect or whether it shall be visible on the entire QCustomPlot. The axis rect can be set with \ref setClipAxisRect. \see setClipAxisRect */ void QCPAbstractItem::setClipToAxisRect(bool clip) { mClipToAxisRect = clip; if (mClipToAxisRect) setParentLayerable(mClipAxisRect.data()); } /*! Sets the clip axis rect. It defines the rect that will be used to clip the item when \ref setClipToAxisRect is set to true. \see setClipToAxisRect */ void QCPAbstractItem::setClipAxisRect(QCPAxisRect *rect) { mClipAxisRect = rect; if (mClipToAxisRect) setParentLayerable(mClipAxisRect.data()); } /*! Sets whether the user can (de-)select this item by clicking on the QCustomPlot surface. (When \ref QCustomPlot::setInteractions contains QCustomPlot::iSelectItems.) However, even when \a selectable was set to false, it is possible to set the selection manually, by calling \ref setSelected. \see QCustomPlot::setInteractions, setSelected */ void QCPAbstractItem::setSelectable(bool selectable) { if (mSelectable != selectable) { mSelectable = selectable; emit selectableChanged(mSelectable); } } /*! Sets whether this item is selected or not. When selected, it might use a different visual appearance (e.g. pen and brush), this depends on the specific item though. The entire selection mechanism for items is handled automatically when \ref QCustomPlot::setInteractions contains QCustomPlot::iSelectItems. You only need to call this function when you wish to change the selection state manually. This function can change the selection state even when \ref setSelectable was set to false. emits the \ref selectionChanged signal when \a selected is different from the previous selection state. \see setSelectable, selectTest */ void QCPAbstractItem::setSelected(bool selected) { if (mSelected != selected) { mSelected = selected; emit selectionChanged(mSelected); } } /*! Returns the QCPItemPosition with the specified \a name. If this item doesn't have a position by that name, returns \c nullptr. This function provides an alternative way to access item positions. Normally, you access positions direcly by their member pointers (which typically have the same variable name as \a name). \see positions, anchor */ QCPItemPosition *QCPAbstractItem::position(const QString &name) const { foreach (QCPItemPosition *position, mPositions) { if (position->name() == name) return position; } qDebug() << Q_FUNC_INFO << "position with name not found:" << name; return nullptr; } /*! Returns the QCPItemAnchor with the specified \a name. If this item doesn't have an anchor by that name, returns \c nullptr. This function provides an alternative way to access item anchors. Normally, you access anchors direcly by their member pointers (which typically have the same variable name as \a name). \see anchors, position */ QCPItemAnchor *QCPAbstractItem::anchor(const QString &name) const { foreach (QCPItemAnchor *anchor, mAnchors) { if (anchor->name() == name) return anchor; } qDebug() << Q_FUNC_INFO << "anchor with name not found:" << name; return nullptr; } /*! Returns whether this item has an anchor with the specified \a name. Note that you can check for positions with this function, too. This is because every position is also an anchor (QCPItemPosition inherits from QCPItemAnchor). \see anchor, position */ bool QCPAbstractItem::hasAnchor(const QString &name) const { foreach (QCPItemAnchor *anchor, mAnchors) { if (anchor->name() == name) return true; } return false; } /*! \internal Returns the rect the visual representation of this item is clipped to. This depends on the current setting of \ref setClipToAxisRect as well as the axis rect set with \ref setClipAxisRect. If the item is not clipped to an axis rect, QCustomPlot's viewport rect is returned. \see draw */ QRect QCPAbstractItem::clipRect() const { if (mClipToAxisRect && mClipAxisRect) return mClipAxisRect.data()->rect(); else return mParentPlot->viewport(); } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing item lines. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \see setAntialiased */ void QCPAbstractItem::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeItems); } /*! \internal A convenience function which returns the selectTest value for a specified \a rect and a specified click position \a pos. \a filledRect defines whether a click inside the rect should also be considered a hit or whether only the rect border is sensitive to hits. This function may be used to help with the implementation of the \ref selectTest function for specific items. For example, if your item consists of four rects, call this function four times, once for each rect, in your \ref selectTest reimplementation. Finally, return the minimum (non -1) of all four returned values. */ double QCPAbstractItem::rectDistance(const QRectF &rect, const QPointF &pos, bool filledRect) const { double result = -1; // distance to border: const QList lines = QList() << QLineF(rect.topLeft(), rect.topRight()) << QLineF(rect.bottomLeft(), rect.bottomRight()) << QLineF(rect.topLeft(), rect.bottomLeft()) << QLineF(rect.topRight(), rect.bottomRight()); const QCPVector2D posVec(pos); double minDistSqr = (std::numeric_limits::max)(); foreach (const QLineF &line, lines) { double distSqr = posVec.distanceSquaredToLine(line.p1(), line.p2()); if (distSqr < minDistSqr) minDistSqr = distSqr; } result = qSqrt(minDistSqr); // filled rect, allow click inside to count as hit: if (filledRect && result > mParentPlot->selectionTolerance()*0.99) { if (rect.contains(pos)) result = mParentPlot->selectionTolerance()*0.99; } return result; } /*! \internal Returns the pixel position of the anchor with Id \a anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor). For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor. \see createAnchor */ QPointF QCPAbstractItem::anchorPixelPosition(int anchorId) const { qDebug() << Q_FUNC_INFO << "called on item which shouldn't have any anchors (this method not reimplemented). anchorId" << anchorId; return {}; } /*! \internal Creates a QCPItemPosition, registers it with this item and returns a pointer to it. The specified \a name must be a unique string that is usually identical to the variable name of the position member (This is needed to provide the name-based \ref position access to positions). Don't delete positions created by this function manually, as the item will take care of it. Use this function in the constructor (initialization list) of the specific item subclass to create each position member. Don't create QCPItemPositions with \b new yourself, because they won't be registered with the item properly. \see createAnchor */ QCPItemPosition *QCPAbstractItem::createPosition(const QString &name) { if (hasAnchor(name)) qDebug() << Q_FUNC_INFO << "anchor/position with name exists already:" << name; QCPItemPosition *newPosition = new QCPItemPosition(mParentPlot, this, name); mPositions.append(newPosition); mAnchors.append(newPosition); // every position is also an anchor newPosition->setAxes(mParentPlot->xAxis, mParentPlot->yAxis); newPosition->setType(QCPItemPosition::ptPlotCoords); if (mParentPlot->axisRect()) newPosition->setAxisRect(mParentPlot->axisRect()); newPosition->setCoords(0, 0); return newPosition; } /*! \internal Creates a QCPItemAnchor, registers it with this item and returns a pointer to it. The specified \a name must be a unique string that is usually identical to the variable name of the anchor member (This is needed to provide the name based \ref anchor access to anchors). The \a anchorId must be a number identifying the created anchor. It is recommended to create an enum (e.g. "AnchorIndex") for this on each item that uses anchors. This id is used by the anchor to identify itself when it calls QCPAbstractItem::anchorPixelPosition. That function then returns the correct pixel coordinates for the passed anchor id. Don't delete anchors created by this function manually, as the item will take care of it. Use this function in the constructor (initialization list) of the specific item subclass to create each anchor member. Don't create QCPItemAnchors with \b new yourself, because then they won't be registered with the item properly. \see createPosition */ QCPItemAnchor *QCPAbstractItem::createAnchor(const QString &name, int anchorId) { if (hasAnchor(name)) qDebug() << Q_FUNC_INFO << "anchor/position with name exists already:" << name; QCPItemAnchor *newAnchor = new QCPItemAnchor(mParentPlot, this, name, anchorId); mAnchors.append(newAnchor); return newAnchor; } /* inherits documentation from base class */ void QCPAbstractItem::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) Q_UNUSED(details) if (mSelectable) { bool selBefore = mSelected; setSelected(additive ? !mSelected : true); if (selectionStateChanged) *selectionStateChanged = mSelected != selBefore; } } /* inherits documentation from base class */ void QCPAbstractItem::deselectEvent(bool *selectionStateChanged) { if (mSelectable) { bool selBefore = mSelected; setSelected(false); if (selectionStateChanged) *selectionStateChanged = mSelected != selBefore; } } /* inherits documentation from base class */ QCP::Interaction QCPAbstractItem::selectionCategory() const { return QCP::iSelectItems; } /* end of 'src/item.cpp' */ /* including file 'src/core.cpp' */ /* modified 2021-03-29T02:30:44, size 127198 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCustomPlot //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCustomPlot \brief The central class of the library. This is the QWidget which displays the plot and interacts with the user. For tutorials on how to use QCustomPlot, see the website\n http://www.qcustomplot.com/ */ /* start of documentation of inline functions */ /*! \fn QCPSelectionRect *QCustomPlot::selectionRect() const Allows access to the currently used QCPSelectionRect instance (or subclass thereof), that is used to handle and draw selection rect interactions (see \ref setSelectionRectMode). \see setSelectionRect */ /*! \fn QCPLayoutGrid *QCustomPlot::plotLayout() const Returns the top level layout of this QCustomPlot instance. It is a \ref QCPLayoutGrid, initially containing just one cell with the main QCPAxisRect inside. */ /* end of documentation of inline functions */ /* start of documentation of signals */ /*! \fn void QCustomPlot::mouseDoubleClick(QMouseEvent *event) This signal is emitted when the QCustomPlot receives a mouse double click event. */ /*! \fn void QCustomPlot::mousePress(QMouseEvent *event) This signal is emitted when the QCustomPlot receives a mouse press event. It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeDrag or \ref QCPAxisRect::setRangeDragAxes. */ /*! \fn void QCustomPlot::mouseMove(QMouseEvent *event) This signal is emitted when the QCustomPlot receives a mouse move event. It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeDrag or \ref QCPAxisRect::setRangeDragAxes. \warning It is discouraged to change the drag-axes with \ref QCPAxisRect::setRangeDragAxes here, because the dragging starting point was saved the moment the mouse was pressed. Thus it only has a meaning for the range drag axes that were set at that moment. If you want to change the drag axes, consider doing this in the \ref mousePress signal instead. */ /*! \fn void QCustomPlot::mouseRelease(QMouseEvent *event) This signal is emitted when the QCustomPlot receives a mouse release event. It is emitted before QCustomPlot handles any other mechanisms like object selection. So a slot connected to this signal can still influence the behaviour e.g. with \ref setInteractions or \ref QCPAbstractPlottable::setSelectable. */ /*! \fn void QCustomPlot::mouseWheel(QMouseEvent *event) This signal is emitted when the QCustomPlot receives a mouse wheel event. It is emitted before QCustomPlot handles any other mechanisms like range zooming. So a slot connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeZoomAxes or \ref QCPAxisRect::setRangeZoomFactor. */ /*! \fn void QCustomPlot::plottableClick(QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event) This signal is emitted when a plottable is clicked. \a event is the mouse event that caused the click and \a plottable is the plottable that received the click. The parameter \a dataIndex indicates the data point that was closest to the click position. \see plottableDoubleClick */ /*! \fn void QCustomPlot::plottableDoubleClick(QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event) This signal is emitted when a plottable is double clicked. \a event is the mouse event that caused the click and \a plottable is the plottable that received the click. The parameter \a dataIndex indicates the data point that was closest to the click position. \see plottableClick */ /*! \fn void QCustomPlot::itemClick(QCPAbstractItem *item, QMouseEvent *event) This signal is emitted when an item is clicked. \a event is the mouse event that caused the click and \a item is the item that received the click. \see itemDoubleClick */ /*! \fn void QCustomPlot::itemDoubleClick(QCPAbstractItem *item, QMouseEvent *event) This signal is emitted when an item is double clicked. \a event is the mouse event that caused the click and \a item is the item that received the click. \see itemClick */ /*! \fn void QCustomPlot::axisClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event) This signal is emitted when an axis is clicked. \a event is the mouse event that caused the click, \a axis is the axis that received the click and \a part indicates the part of the axis that was clicked. \see axisDoubleClick */ /*! \fn void QCustomPlot::axisDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event) This signal is emitted when an axis is double clicked. \a event is the mouse event that caused the click, \a axis is the axis that received the click and \a part indicates the part of the axis that was clicked. \see axisClick */ /*! \fn void QCustomPlot::legendClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event) This signal is emitted when a legend (item) is clicked. \a event is the mouse event that caused the click, \a legend is the legend that received the click and \a item is the legend item that received the click. If only the legend and no item is clicked, \a item is \c nullptr. This happens for a click inside the legend padding or the space between two items. \see legendDoubleClick */ /*! \fn void QCustomPlot::legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event) This signal is emitted when a legend (item) is double clicked. \a event is the mouse event that caused the click, \a legend is the legend that received the click and \a item is the legend item that received the click. If only the legend and no item is clicked, \a item is \c nullptr. This happens for a click inside the legend padding or the space between two items. \see legendClick */ /*! \fn void QCustomPlot::selectionChangedByUser() This signal is emitted after the user has changed the selection in the QCustomPlot, e.g. by clicking. It is not emitted when the selection state of an object has changed programmatically by a direct call to setSelected()/setSelection() on an object or by calling \ref deselectAll. In addition to this signal, selectable objects also provide individual signals, for example \ref QCPAxis::selectionChanged or \ref QCPAbstractPlottable::selectionChanged. Note that those signals are emitted even if the selection state is changed programmatically. See the documentation of \ref setInteractions for details about the selection mechanism. \see selectedPlottables, selectedGraphs, selectedItems, selectedAxes, selectedLegends */ /*! \fn void QCustomPlot::beforeReplot() This signal is emitted immediately before a replot takes place (caused by a call to the slot \ref replot). It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them replot synchronously, it won't cause an infinite recursion. \see replot, afterReplot, afterLayout */ /*! \fn void QCustomPlot::afterLayout() This signal is emitted immediately after the layout step has been completed, which occurs right before drawing the plot. This is typically during a call to \ref replot, and in such cases this signal is emitted in between the signals \ref beforeReplot and \ref afterReplot. Unlike those signals however, this signal is also emitted during off-screen painting, such as when calling \ref toPixmap or \ref savePdf. The layout step queries all layouts and layout elements in the plot for their proposed size and arranges the objects accordingly as preparation for the subsequent drawing step. Through this signal, you have the opportunity to update certain things in your plot that depend crucially on the exact dimensions/positioning of layout elements such as axes and axis rects. \warning However, changing any parameters of this QCustomPlot instance which would normally affect the layouting (e.g. axis range order of magnitudes, tick label sizes, etc.) will not issue a second run of the layout step. It will propagate directly to the draw step and may cause graphical inconsistencies such as overlapping objects, if sizes or positions have changed. \see updateLayout, beforeReplot, afterReplot */ /*! \fn void QCustomPlot::afterReplot() This signal is emitted immediately after a replot has taken place (caused by a call to the slot \ref replot). It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them replot synchronously, it won't cause an infinite recursion. \see replot, beforeReplot, afterLayout */ /* end of documentation of signals */ /* start of documentation of public members */ /*! \var QCPAxis *QCustomPlot::xAxis A pointer to the primary x Axis (bottom) of the main axis rect of the plot. QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref yAxis2) and the \ref legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become \c nullptr. If an axis convenience pointer is currently \c nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is added after the main legend was removed before. */ /*! \var QCPAxis *QCustomPlot::yAxis A pointer to the primary y Axis (left) of the main axis rect of the plot. QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref yAxis2) and the \ref legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become \c nullptr. If an axis convenience pointer is currently \c nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is added after the main legend was removed before. */ /*! \var QCPAxis *QCustomPlot::xAxis2 A pointer to the secondary x Axis (top) of the main axis rect of the plot. Secondary axes are invisible by default. Use QCPAxis::setVisible to change this (or use \ref QCPAxisRect::setupFullAxesBox). QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref yAxis2) and the \ref legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become \c nullptr. If an axis convenience pointer is currently \c nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is added after the main legend was removed before. */ /*! \var QCPAxis *QCustomPlot::yAxis2 A pointer to the secondary y Axis (right) of the main axis rect of the plot. Secondary axes are invisible by default. Use QCPAxis::setVisible to change this (or use \ref QCPAxisRect::setupFullAxesBox). QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref yAxis2) and the \ref legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become \c nullptr. If an axis convenience pointer is currently \c nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is added after the main legend was removed before. */ /*! \var QCPLegend *QCustomPlot::legend A pointer to the default legend of the main axis rect. The legend is invisible by default. Use QCPLegend::setVisible to change this. QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref yAxis2) and the \ref legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the layout system\endlink to add multiple legends to the plot, use the layout system interface to access the new legend. For example, legends can be placed inside an axis rect's \ref QCPAxisRect::insetLayout "inset layout", and must then also be accessed via the inset layout. If the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointer becomes \c nullptr. If an axis convenience pointer is currently \c nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is added after the main legend was removed before. */ /* end of documentation of public members */ /*! Constructs a QCustomPlot and sets reasonable default values. */ QCustomPlot::QCustomPlot(QWidget *parent) : QWidget(parent), xAxis(nullptr), yAxis(nullptr), xAxis2(nullptr), yAxis2(nullptr), legend(nullptr), mBufferDevicePixelRatio(1.0), // will be adapted to primary screen below mPlotLayout(nullptr), mAutoAddPlottableToLegend(true), mAntialiasedElements(QCP::aeNone), mNotAntialiasedElements(QCP::aeNone), mInteractions(QCP::iNone), mSelectionTolerance(8), mNoAntialiasingOnDrag(false), mBackgroundBrush(Qt::white, Qt::SolidPattern), mBackgroundScaled(true), mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), mCurrentLayer(nullptr), mPlottingHints(QCP::phCacheLabels|QCP::phImmediateRefresh), mMultiSelectModifier(Qt::ControlModifier), mSelectionRectMode(QCP::srmNone), mSelectionRect(nullptr), mOpenGl(false), mMouseHasMoved(false), mMouseEventLayerable(nullptr), mMouseSignalLayerable(nullptr), mReplotting(false), mReplotQueued(false), mReplotTime(0), mReplotTimeAverage(0), mOpenGlMultisamples(16), mOpenGlAntialiasedElementsBackup(QCP::aeNone), mOpenGlCacheLabelsBackup(true) { setAttribute(Qt::WA_NoMousePropagation); setAttribute(Qt::WA_OpaquePaintEvent); setFocusPolicy(Qt::ClickFocus); setMouseTracking(true); QLocale currentLocale = locale(); currentLocale.setNumberOptions(QLocale::OmitGroupSeparator); setLocale(currentLocale); #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED # ifdef QCP_DEVICEPIXELRATIO_FLOAT setBufferDevicePixelRatio(QWidget::devicePixelRatioF()); # else setBufferDevicePixelRatio(QWidget::devicePixelRatio()); # endif #endif mOpenGlAntialiasedElementsBackup = mAntialiasedElements; mOpenGlCacheLabelsBackup = mPlottingHints.testFlag(QCP::phCacheLabels); // create initial layers: mLayers.append(new QCPLayer(this, QLatin1String("background"))); mLayers.append(new QCPLayer(this, QLatin1String("grid"))); mLayers.append(new QCPLayer(this, QLatin1String("main"))); mLayers.append(new QCPLayer(this, QLatin1String("axes"))); mLayers.append(new QCPLayer(this, QLatin1String("legend"))); mLayers.append(new QCPLayer(this, QLatin1String("overlay"))); updateLayerIndices(); setCurrentLayer(QLatin1String("main")); layer(QLatin1String("overlay"))->setMode(QCPLayer::lmBuffered); // create initial layout, axis rect and legend: mPlotLayout = new QCPLayoutGrid; mPlotLayout->initializeParentPlot(this); mPlotLayout->setParent(this); // important because if parent is QWidget, QCPLayout::sizeConstraintsChanged will call QWidget::updateGeometry mPlotLayout->setLayer(QLatin1String("main")); QCPAxisRect *defaultAxisRect = new QCPAxisRect(this, true); mPlotLayout->addElement(0, 0, defaultAxisRect); xAxis = defaultAxisRect->axis(QCPAxis::atBottom); yAxis = defaultAxisRect->axis(QCPAxis::atLeft); xAxis2 = defaultAxisRect->axis(QCPAxis::atTop); yAxis2 = defaultAxisRect->axis(QCPAxis::atRight); legend = new QCPLegend; legend->setVisible(false); defaultAxisRect->insetLayout()->addElement(legend, Qt::AlignRight|Qt::AlignTop); defaultAxisRect->insetLayout()->setMargins(QMargins(12, 12, 12, 12)); defaultAxisRect->setLayer(QLatin1String("background")); xAxis->setLayer(QLatin1String("axes")); yAxis->setLayer(QLatin1String("axes")); xAxis2->setLayer(QLatin1String("axes")); yAxis2->setLayer(QLatin1String("axes")); xAxis->grid()->setLayer(QLatin1String("grid")); yAxis->grid()->setLayer(QLatin1String("grid")); xAxis2->grid()->setLayer(QLatin1String("grid")); yAxis2->grid()->setLayer(QLatin1String("grid")); legend->setLayer(QLatin1String("legend")); // create selection rect instance: mSelectionRect = new QCPSelectionRect(this); mSelectionRect->setLayer(QLatin1String("overlay")); setViewport(rect()); // needs to be called after mPlotLayout has been created replot(rpQueuedReplot); } QCustomPlot::~QCustomPlot() { clearPlottables(); clearItems(); if (mPlotLayout) { delete mPlotLayout; mPlotLayout = nullptr; } mCurrentLayer = nullptr; qDeleteAll(mLayers); // don't use removeLayer, because it would prevent the last layer to be removed mLayers.clear(); } /*! Sets which elements are forcibly drawn antialiased as an \a or combination of QCP::AntialiasedElement. This overrides the antialiasing settings for whole element groups, normally controlled with the \a setAntialiasing function on the individual elements. If an element is neither specified in \ref setAntialiasedElements nor in \ref setNotAntialiasedElements, the antialiasing setting on each individual element instance is used. For example, if \a antialiasedElements contains \ref QCP::aePlottables, all plottables will be drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set to. if an element in \a antialiasedElements is already set in \ref setNotAntialiasedElements, it is removed from there. \see setNotAntialiasedElements */ void QCustomPlot::setAntialiasedElements(const QCP::AntialiasedElements &antialiasedElements) { mAntialiasedElements = antialiasedElements; // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: if ((mNotAntialiasedElements & mAntialiasedElements) != 0) mNotAntialiasedElements |= ~mAntialiasedElements; } /*! Sets whether the specified \a antialiasedElement is forcibly drawn antialiased. See \ref setAntialiasedElements for details. \see setNotAntialiasedElement */ void QCustomPlot::setAntialiasedElement(QCP::AntialiasedElement antialiasedElement, bool enabled) { if (!enabled && mAntialiasedElements.testFlag(antialiasedElement)) mAntialiasedElements &= ~antialiasedElement; else if (enabled && !mAntialiasedElements.testFlag(antialiasedElement)) mAntialiasedElements |= antialiasedElement; // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: if ((mNotAntialiasedElements & mAntialiasedElements) != 0) mNotAntialiasedElements |= ~mAntialiasedElements; } /*! Sets which elements are forcibly drawn not antialiased as an \a or combination of QCP::AntialiasedElement. This overrides the antialiasing settings for whole element groups, normally controlled with the \a setAntialiasing function on the individual elements. If an element is neither specified in \ref setAntialiasedElements nor in \ref setNotAntialiasedElements, the antialiasing setting on each individual element instance is used. For example, if \a notAntialiasedElements contains \ref QCP::aePlottables, no plottables will be drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set to. if an element in \a notAntialiasedElements is already set in \ref setAntialiasedElements, it is removed from there. \see setAntialiasedElements */ void QCustomPlot::setNotAntialiasedElements(const QCP::AntialiasedElements ¬AntialiasedElements) { mNotAntialiasedElements = notAntialiasedElements; // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: if ((mNotAntialiasedElements & mAntialiasedElements) != 0) mAntialiasedElements |= ~mNotAntialiasedElements; } /*! Sets whether the specified \a notAntialiasedElement is forcibly drawn not antialiased. See \ref setNotAntialiasedElements for details. \see setAntialiasedElement */ void QCustomPlot::setNotAntialiasedElement(QCP::AntialiasedElement notAntialiasedElement, bool enabled) { if (!enabled && mNotAntialiasedElements.testFlag(notAntialiasedElement)) mNotAntialiasedElements &= ~notAntialiasedElement; else if (enabled && !mNotAntialiasedElements.testFlag(notAntialiasedElement)) mNotAntialiasedElements |= notAntialiasedElement; // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: if ((mNotAntialiasedElements & mAntialiasedElements) != 0) mAntialiasedElements |= ~mNotAntialiasedElements; } /*! If set to true, adding a plottable (e.g. a graph) to the QCustomPlot automatically also adds the plottable to the legend (QCustomPlot::legend). \see addGraph, QCPLegend::addItem */ void QCustomPlot::setAutoAddPlottableToLegend(bool on) { mAutoAddPlottableToLegend = on; } /*! Sets the possible interactions of this QCustomPlot as an or-combination of \ref QCP::Interaction enums. There are the following types of interactions: Axis range manipulation is controlled via \ref QCP::iRangeDrag and \ref QCP::iRangeZoom. When the respective interaction is enabled, the user may drag axes ranges and zoom with the mouse wheel. For details how to control which axes the user may drag/zoom and in what orientations, see \ref QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeDragAxes, \ref QCPAxisRect::setRangeZoomAxes. Plottable data selection is controlled by \ref QCP::iSelectPlottables. If \ref QCP::iSelectPlottables is set, the user may select plottables (graphs, curves, bars,...) and their data by clicking on them or in their vicinity (\ref setSelectionTolerance). Whether the user can actually select a plottable and its data can further be restricted with the \ref QCPAbstractPlottable::setSelectable method on the specific plottable. For details, see the special page about the \ref dataselection "data selection mechanism". To retrieve a list of all currently selected plottables, call \ref selectedPlottables. If you're only interested in QCPGraphs, you may use the convenience function \ref selectedGraphs. Item selection is controlled by \ref QCP::iSelectItems. If \ref QCP::iSelectItems is set, the user may select items (QCPItemLine, QCPItemText,...) by clicking on them or in their vicinity. To find out whether a specific item is selected, call QCPAbstractItem::selected(). To retrieve a list of all currently selected items, call \ref selectedItems. Axis selection is controlled with \ref QCP::iSelectAxes. If \ref QCP::iSelectAxes is set, the user may select parts of the axes by clicking on them. What parts exactly (e.g. Axis base line, tick labels, axis label) are selectable can be controlled via \ref QCPAxis::setSelectableParts for each axis. To retrieve a list of all axes that currently contain selected parts, call \ref selectedAxes. Which parts of an axis are selected, can be retrieved with QCPAxis::selectedParts(). Legend selection is controlled with \ref QCP::iSelectLegend. If this is set, the user may select the legend itself or individual items by clicking on them. What parts exactly are selectable can be controlled via \ref QCPLegend::setSelectableParts. To find out whether the legend or any of its child items are selected, check the value of QCPLegend::selectedParts. To find out which child items are selected, call \ref QCPLegend::selectedItems. All other selectable elements The selection of all other selectable objects (e.g. QCPTextElement, or your own layerable subclasses) is controlled with \ref QCP::iSelectOther. If set, the user may select those objects by clicking on them. To find out which are currently selected, you need to check their selected state explicitly. If the selection state has changed by user interaction, the \ref selectionChangedByUser signal is emitted. Each selectable object additionally emits an individual selectionChanged signal whenever their selection state has changed, i.e. not only by user interaction. To allow multiple objects to be selected by holding the selection modifier (\ref setMultiSelectModifier), set the flag \ref QCP::iMultiSelect. \note In addition to the selection mechanism presented here, QCustomPlot always emits corresponding signals, when an object is clicked or double clicked. see \ref plottableClick and \ref plottableDoubleClick for example. \see setInteraction, setSelectionTolerance */ void QCustomPlot::setInteractions(const QCP::Interactions &interactions) { mInteractions = interactions; } /*! Sets the single \a interaction of this QCustomPlot to \a enabled. For details about the interaction system, see \ref setInteractions. \see setInteractions */ void QCustomPlot::setInteraction(const QCP::Interaction &interaction, bool enabled) { if (!enabled && mInteractions.testFlag(interaction)) mInteractions &= ~interaction; else if (enabled && !mInteractions.testFlag(interaction)) mInteractions |= interaction; } /*! Sets the tolerance that is used to decide whether a click selects an object (e.g. a plottable) or not. If the user clicks in the vicinity of the line of e.g. a QCPGraph, it's only regarded as a potential selection when the minimum distance between the click position and the graph line is smaller than \a pixels. Objects that are defined by an area (e.g. QCPBars) only react to clicks directly inside the area and ignore this selection tolerance. In other words, it only has meaning for parts of objects that are too thin to exactly hit with a click and thus need such a tolerance. \see setInteractions, QCPLayerable::selectTest */ void QCustomPlot::setSelectionTolerance(int pixels) { mSelectionTolerance = pixels; } /*! Sets whether antialiasing is disabled for this QCustomPlot while the user is dragging axes ranges. If many objects, especially plottables, are drawn antialiased, this greatly improves performance during dragging. Thus it creates a more responsive user experience. As soon as the user stops dragging, the last replot is done with normal antialiasing, to restore high image quality. \see setAntialiasedElements, setNotAntialiasedElements */ void QCustomPlot::setNoAntialiasingOnDrag(bool enabled) { mNoAntialiasingOnDrag = enabled; } /*! Sets the plotting hints for this QCustomPlot instance as an \a or combination of QCP::PlottingHint. \see setPlottingHint */ void QCustomPlot::setPlottingHints(const QCP::PlottingHints &hints) { mPlottingHints = hints; } /*! Sets the specified plotting \a hint to \a enabled. \see setPlottingHints */ void QCustomPlot::setPlottingHint(QCP::PlottingHint hint, bool enabled) { QCP::PlottingHints newHints = mPlottingHints; if (!enabled) newHints &= ~hint; else newHints |= hint; if (newHints != mPlottingHints) setPlottingHints(newHints); } /*! Sets the keyboard modifier that will be recognized as multi-select-modifier. If \ref QCP::iMultiSelect is specified in \ref setInteractions, the user may select multiple objects (or data points) by clicking on them one after the other while holding down \a modifier. By default the multi-select-modifier is set to Qt::ControlModifier. \see setInteractions */ void QCustomPlot::setMultiSelectModifier(Qt::KeyboardModifier modifier) { mMultiSelectModifier = modifier; } /*! Sets how QCustomPlot processes mouse click-and-drag interactions by the user. If \a mode is \ref QCP::srmNone, the mouse drag is forwarded to the underlying objects. For example, QCPAxisRect may process a mouse drag by dragging axis ranges, see \ref QCPAxisRect::setRangeDrag. If \a mode is not \ref QCP::srmNone, the current selection rect (\ref selectionRect) becomes activated and allows e.g. rect zooming and data point selection. If you wish to provide your user both with axis range dragging and data selection/range zooming, use this method to switch between the modes just before the interaction is processed, e.g. in reaction to the \ref mousePress or \ref mouseMove signals. For example you could check whether the user is holding a certain keyboard modifier, and then decide which \a mode shall be set. If a selection rect interaction is currently active, and \a mode is set to \ref QCP::srmNone, the interaction is canceled (\ref QCPSelectionRect::cancel). Switching between any of the other modes will keep the selection rect active. Upon completion of the interaction, the behaviour is as defined by the currently set \a mode, not the mode that was set when the interaction started. \see setInteractions, setSelectionRect, QCPSelectionRect */ void QCustomPlot::setSelectionRectMode(QCP::SelectionRectMode mode) { if (mSelectionRect) { if (mode == QCP::srmNone) mSelectionRect->cancel(); // when switching to none, we immediately want to abort a potentially active selection rect // disconnect old connections: if (mSelectionRectMode == QCP::srmSelect) disconnect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectSelection(QRect,QMouseEvent*))); else if (mSelectionRectMode == QCP::srmZoom) disconnect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectZoom(QRect,QMouseEvent*))); // establish new ones: if (mode == QCP::srmSelect) connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectSelection(QRect,QMouseEvent*))); else if (mode == QCP::srmZoom) connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectZoom(QRect,QMouseEvent*))); } mSelectionRectMode = mode; } /*! Sets the \ref QCPSelectionRect instance that QCustomPlot will use if \a mode is not \ref QCP::srmNone and the user performs a click-and-drag interaction. QCustomPlot takes ownership of the passed \a selectionRect. It can be accessed later via \ref selectionRect. This method is useful if you wish to replace the default QCPSelectionRect instance with an instance of a QCPSelectionRect subclass, to introduce custom behaviour of the selection rect. \see setSelectionRectMode */ void QCustomPlot::setSelectionRect(QCPSelectionRect *selectionRect) { delete mSelectionRect; mSelectionRect = selectionRect; if (mSelectionRect) { // establish connections with new selection rect: if (mSelectionRectMode == QCP::srmSelect) connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectSelection(QRect,QMouseEvent*))); else if (mSelectionRectMode == QCP::srmZoom) connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectZoom(QRect,QMouseEvent*))); } } /*! \warning This is still an experimental feature and its performance depends on the system that it runs on. Having multiple QCustomPlot widgets in one application with enabled OpenGL rendering might cause context conflicts on some systems. This method allows to enable OpenGL plot rendering, for increased plotting performance of graphically demanding plots (thick lines, translucent fills, etc.). If \a enabled is set to true, QCustomPlot will try to initialize OpenGL and, if successful, continue plotting with hardware acceleration. The parameter \a multisampling controls how many samples will be used per pixel, it essentially controls the antialiasing quality. If \a multisampling is set too high for the current graphics hardware, the maximum allowed value will be used. You can test whether switching to OpenGL rendering was successful by checking whether the according getter \a QCustomPlot::openGl() returns true. If the OpenGL initialization fails, rendering continues with the regular software rasterizer, and an according qDebug output is generated. If switching to OpenGL was successful, this method disables label caching (\ref setPlottingHint "setPlottingHint(QCP::phCacheLabels, false)") and turns on QCustomPlot's antialiasing override for all elements (\ref setAntialiasedElements "setAntialiasedElements(QCP::aeAll)"), leading to a higher quality output. The antialiasing override allows for pixel-grid aligned drawing in the OpenGL paint device. As stated before, in OpenGL rendering the actual antialiasing of the plot is controlled with \a multisampling. If \a enabled is set to false, the antialiasing/label caching settings are restored to what they were before OpenGL was enabled, if they weren't altered in the meantime. \note OpenGL support is only enabled if QCustomPlot is compiled with the macro \c QCUSTOMPLOT_USE_OPENGL defined. This define must be set before including the QCustomPlot header both during compilation of the QCustomPlot library as well as when compiling your application. It is best to just include the line DEFINES += QCUSTOMPLOT_USE_OPENGL in the respective qmake project files. \note If you are using a Qt version before 5.0, you must also add the module "opengl" to your \c QT variable in the qmake project files. For Qt versions 5.0 and higher, QCustomPlot switches to a newer OpenGL interface which is already in the "gui" module. */ void QCustomPlot::setOpenGl(bool enabled, int multisampling) { mOpenGlMultisamples = qMax(0, multisampling); #ifdef QCUSTOMPLOT_USE_OPENGL mOpenGl = enabled; if (mOpenGl) { if (setupOpenGl()) { // backup antialiasing override and labelcaching setting so we can restore upon disabling OpenGL mOpenGlAntialiasedElementsBackup = mAntialiasedElements; mOpenGlCacheLabelsBackup = mPlottingHints.testFlag(QCP::phCacheLabels); // set antialiasing override to antialias all (aligns gl pixel grid properly), and disable label caching (would use software rasterizer for pixmap caches): setAntialiasedElements(QCP::aeAll); setPlottingHint(QCP::phCacheLabels, false); } else { qDebug() << Q_FUNC_INFO << "Failed to enable OpenGL, continuing plotting without hardware acceleration."; mOpenGl = false; } } else { // restore antialiasing override and labelcaching to what it was before enabling OpenGL, if nobody changed it in the meantime: if (mAntialiasedElements == QCP::aeAll) setAntialiasedElements(mOpenGlAntialiasedElementsBackup); if (!mPlottingHints.testFlag(QCP::phCacheLabels)) setPlottingHint(QCP::phCacheLabels, mOpenGlCacheLabelsBackup); freeOpenGl(); } // recreate all paint buffers: mPaintBuffers.clear(); setupPaintBuffers(); #else Q_UNUSED(enabled) qDebug() << Q_FUNC_INFO << "QCustomPlot can't use OpenGL because QCUSTOMPLOT_USE_OPENGL was not defined during compilation (add 'DEFINES += QCUSTOMPLOT_USE_OPENGL' to your qmake .pro file)"; #endif } /*! Sets the viewport of this QCustomPlot. Usually users of QCustomPlot don't need to change the viewport manually. The viewport is the area in which the plot is drawn. All mechanisms, e.g. margin calculation take the viewport to be the outer border of the plot. The viewport normally is the rect() of the QCustomPlot widget, i.e. a rect with top left (0, 0) and size of the QCustomPlot widget. Don't confuse the viewport with the axis rect (QCustomPlot::axisRect). An axis rect is typically an area enclosed by four axes, where the graphs/plottables are drawn in. The viewport is larger and contains also the axes themselves, their tick numbers, their labels, or even additional axis rects, color scales and other layout elements. This function is used to allow arbitrary size exports with \ref toPixmap, \ref savePng, \ref savePdf, etc. by temporarily changing the viewport size. */ void QCustomPlot::setViewport(const QRect &rect) { mViewport = rect; if (mPlotLayout) mPlotLayout->setOuterRect(mViewport); } /*! Sets the device pixel ratio used by the paint buffers of this QCustomPlot instance. Normally, this doesn't need to be set manually, because it is initialized with the regular \a QWidget::devicePixelRatio which is configured by Qt to fit the display device (e.g. 1 for normal displays, 2 for High-DPI displays). Device pixel ratios are supported by Qt only for Qt versions since 5.4. If this method is called when QCustomPlot is being used with older Qt versions, outputs an according qDebug message and leaves the internal buffer device pixel ratio at 1.0. */ void QCustomPlot::setBufferDevicePixelRatio(double ratio) { if (!qFuzzyCompare(ratio, mBufferDevicePixelRatio)) { #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED mBufferDevicePixelRatio = ratio; foreach (QSharedPointer buffer, mPaintBuffers) buffer->setDevicePixelRatio(mBufferDevicePixelRatio); // Note: axis label cache has devicePixelRatio as part of cache hash, so no need to manually clear cache here #else qDebug() << Q_FUNC_INFO << "Device pixel ratios not supported for Qt versions before 5.4"; mBufferDevicePixelRatio = 1.0; #endif } } /*! Sets \a pm as the viewport background pixmap (see \ref setViewport). The pixmap is always drawn below all other objects in the plot. For cases where the provided pixmap doesn't have the same size as the viewport, scaling can be enabled with \ref setBackgroundScaled and the scaling mode (whether and how the aspect ratio is preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, consider using the overloaded version of this function. If a background brush was set with \ref setBackground(const QBrush &brush), the viewport will first be filled with that brush, before drawing the background pixmap. This can be useful for background pixmaps with translucent areas. \see setBackgroundScaled, setBackgroundScaledMode */ void QCustomPlot::setBackground(const QPixmap &pm) { mBackgroundPixmap = pm; mScaledBackgroundPixmap = QPixmap(); } /*! Sets the background brush of the viewport (see \ref setViewport). Before drawing everything else, the background is filled with \a brush. If a background pixmap was set with \ref setBackground(const QPixmap &pm), this brush will be used to fill the viewport before the background pixmap is drawn. This can be useful for background pixmaps with translucent areas. Set \a brush to Qt::NoBrush or Qt::Transparent to leave background transparent. This can be useful for exporting to image formats which support transparency, e.g. \ref savePng. \see setBackgroundScaled, setBackgroundScaledMode */ void QCustomPlot::setBackground(const QBrush &brush) { mBackgroundBrush = brush; } /*! \overload Allows setting the background pixmap of the viewport, whether it shall be scaled and how it shall be scaled in one call. \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode */ void QCustomPlot::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) { mBackgroundPixmap = pm; mScaledBackgroundPixmap = QPixmap(); mBackgroundScaled = scaled; mBackgroundScaledMode = mode; } /*! Sets whether the viewport background pixmap shall be scaled to fit the viewport. If \a scaled is set to true, control whether and how the aspect ratio of the original pixmap is preserved with \ref setBackgroundScaledMode. Note that the scaled version of the original pixmap is buffered, so there is no performance penalty on replots. (Except when the viewport dimensions are changed continuously.) \see setBackground, setBackgroundScaledMode */ void QCustomPlot::setBackgroundScaled(bool scaled) { mBackgroundScaled = scaled; } /*! If scaling of the viewport background pixmap is enabled (\ref setBackgroundScaled), use this function to define whether and how the aspect ratio of the original pixmap is preserved. \see setBackground, setBackgroundScaled */ void QCustomPlot::setBackgroundScaledMode(Qt::AspectRatioMode mode) { mBackgroundScaledMode = mode; } /*! Returns the plottable with \a index. If the index is invalid, returns \c nullptr. There is an overloaded version of this function with no parameter which returns the last added plottable, see QCustomPlot::plottable() \see plottableCount */ QCPAbstractPlottable *QCustomPlot::plottable(int index) { if (index >= 0 && index < mPlottables.size()) { return mPlottables.at(index); } else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return nullptr; } } /*! \overload Returns the last plottable that was added to the plot. If there are no plottables in the plot, returns \c nullptr. \see plottableCount */ QCPAbstractPlottable *QCustomPlot::plottable() { if (!mPlottables.isEmpty()) { return mPlottables.last(); } else return nullptr; } /*! Removes the specified plottable from the plot and deletes it. If necessary, the corresponding legend item is also removed from the default legend (QCustomPlot::legend). Returns true on success. \see clearPlottables */ bool QCustomPlot::removePlottable(QCPAbstractPlottable *plottable) { if (!mPlottables.contains(plottable)) { qDebug() << Q_FUNC_INFO << "plottable not in list:" << reinterpret_cast(plottable); return false; } // remove plottable from legend: plottable->removeFromLegend(); // special handling for QCPGraphs to maintain the simple graph interface: if (QCPGraph *graph = qobject_cast(plottable)) mGraphs.removeOne(graph); // remove plottable: delete plottable; mPlottables.removeOne(plottable); return true; } /*! \overload Removes and deletes the plottable by its \a index. */ bool QCustomPlot::removePlottable(int index) { if (index >= 0 && index < mPlottables.size()) return removePlottable(mPlottables[index]); else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return false; } } /*! Removes all plottables from the plot and deletes them. Corresponding legend items are also removed from the default legend (QCustomPlot::legend). Returns the number of plottables removed. \see removePlottable */ int QCustomPlot::clearPlottables() { int c = mPlottables.size(); for (int i=c-1; i >= 0; --i) removePlottable(mPlottables[i]); return c; } /*! Returns the number of currently existing plottables in the plot \see plottable */ int QCustomPlot::plottableCount() const { return mPlottables.size(); } /*! Returns a list of the selected plottables. If no plottables are currently selected, the list is empty. There is a convenience function if you're only interested in selected graphs, see \ref selectedGraphs. \see setInteractions, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelection */ QList QCustomPlot::selectedPlottables() const { QList result; foreach (QCPAbstractPlottable *plottable, mPlottables) { if (plottable->selected()) result.append(plottable); } return result; } /*! Returns any plottable at the pixel position \a pos. Since it can capture all plottables, the return type is the abstract base class of all plottables, QCPAbstractPlottable. For details, and if you wish to specify a certain plottable type (e.g. QCPGraph), see the template method plottableAt() \see plottableAt(), itemAt, layoutElementAt */ QCPAbstractPlottable *QCustomPlot::plottableAt(const QPointF &pos, bool onlySelectable, int *dataIndex) const { return plottableAt(pos, onlySelectable, dataIndex); } /*! Returns whether this QCustomPlot instance contains the \a plottable. */ bool QCustomPlot::hasPlottable(QCPAbstractPlottable *plottable) const { return mPlottables.contains(plottable); } /*! Returns the graph with \a index. If the index is invalid, returns \c nullptr. There is an overloaded version of this function with no parameter which returns the last created graph, see QCustomPlot::graph() \see graphCount, addGraph */ QCPGraph *QCustomPlot::graph(int index) const { if (index >= 0 && index < mGraphs.size()) { return mGraphs.at(index); } else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return nullptr; } } /*! \overload Returns the last graph, that was created with \ref addGraph. If there are no graphs in the plot, returns \c nullptr. \see graphCount, addGraph */ QCPGraph *QCustomPlot::graph() const { if (!mGraphs.isEmpty()) { return mGraphs.last(); } else return nullptr; } /*! Creates a new graph inside the plot. If \a keyAxis and \a valueAxis are left unspecified (0), the bottom (xAxis) is used as key and the left (yAxis) is used as value axis. If specified, \a keyAxis and \a valueAxis must reside in this QCustomPlot. \a keyAxis will be used as key axis (typically "x") and \a valueAxis as value axis (typically "y") for the graph. Returns a pointer to the newly created graph, or \c nullptr if adding the graph failed. \see graph, graphCount, removeGraph, clearGraphs */ QCPGraph *QCustomPlot::addGraph(QCPAxis *keyAxis, QCPAxis *valueAxis) { if (!keyAxis) keyAxis = xAxis; if (!valueAxis) valueAxis = yAxis; if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "can't use default QCustomPlot xAxis or yAxis, because at least one is invalid (has been deleted)"; return nullptr; } if (keyAxis->parentPlot() != this || valueAxis->parentPlot() != this) { qDebug() << Q_FUNC_INFO << "passed keyAxis or valueAxis doesn't have this QCustomPlot as parent"; return nullptr; } QCPGraph *newGraph = new QCPGraph(keyAxis, valueAxis); newGraph->setName(QLatin1String("Graph ")+QString::number(mGraphs.size())); return newGraph; } /*! Removes the specified \a graph from the plot and deletes it. If necessary, the corresponding legend item is also removed from the default legend (QCustomPlot::legend). If any other graphs in the plot have a channel fill set towards the removed graph, the channel fill property of those graphs is reset to \c nullptr (no channel fill). Returns true on success. \see clearGraphs */ bool QCustomPlot::removeGraph(QCPGraph *graph) { return removePlottable(graph); } /*! \overload Removes and deletes the graph by its \a index. */ bool QCustomPlot::removeGraph(int index) { if (index >= 0 && index < mGraphs.size()) return removeGraph(mGraphs[index]); else return false; } /*! Removes all graphs from the plot and deletes them. Corresponding legend items are also removed from the default legend (QCustomPlot::legend). Returns the number of graphs removed. \see removeGraph */ int QCustomPlot::clearGraphs() { int c = mGraphs.size(); for (int i=c-1; i >= 0; --i) removeGraph(mGraphs[i]); return c; } /*! Returns the number of currently existing graphs in the plot \see graph, addGraph */ int QCustomPlot::graphCount() const { return mGraphs.size(); } /*! Returns a list of the selected graphs. If no graphs are currently selected, the list is empty. If you are not only interested in selected graphs but other plottables like QCPCurve, QCPBars, etc., use \ref selectedPlottables. \see setInteractions, selectedPlottables, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelection */ QList QCustomPlot::selectedGraphs() const { QList result; foreach (QCPGraph *graph, mGraphs) { if (graph->selected()) result.append(graph); } return result; } /*! Returns the item with \a index. If the index is invalid, returns \c nullptr. There is an overloaded version of this function with no parameter which returns the last added item, see QCustomPlot::item() \see itemCount */ QCPAbstractItem *QCustomPlot::item(int index) const { if (index >= 0 && index < mItems.size()) { return mItems.at(index); } else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return nullptr; } } /*! \overload Returns the last item that was added to this plot. If there are no items in the plot, returns \c nullptr. \see itemCount */ QCPAbstractItem *QCustomPlot::item() const { if (!mItems.isEmpty()) { return mItems.last(); } else return nullptr; } /*! Removes the specified item from the plot and deletes it. Returns true on success. \see clearItems */ bool QCustomPlot::removeItem(QCPAbstractItem *item) { if (mItems.contains(item)) { delete item; mItems.removeOne(item); return true; } else { qDebug() << Q_FUNC_INFO << "item not in list:" << reinterpret_cast(item); return false; } } /*! \overload Removes and deletes the item by its \a index. */ bool QCustomPlot::removeItem(int index) { if (index >= 0 && index < mItems.size()) return removeItem(mItems[index]); else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return false; } } /*! Removes all items from the plot and deletes them. Returns the number of items removed. \see removeItem */ int QCustomPlot::clearItems() { int c = mItems.size(); for (int i=c-1; i >= 0; --i) removeItem(mItems[i]); return c; } /*! Returns the number of currently existing items in the plot \see item */ int QCustomPlot::itemCount() const { return mItems.size(); } /*! Returns a list of the selected items. If no items are currently selected, the list is empty. \see setInteractions, QCPAbstractItem::setSelectable, QCPAbstractItem::setSelected */ QList QCustomPlot::selectedItems() const { QList result; foreach (QCPAbstractItem *item, mItems) { if (item->selected()) result.append(item); } return result; } /*! Returns the item at the pixel position \a pos. Since it can capture all items, the return type is the abstract base class of all items, QCPAbstractItem. For details, and if you wish to specify a certain item type (e.g. QCPItemLine), see the template method itemAt() \see itemAt(), plottableAt, layoutElementAt */ QCPAbstractItem *QCustomPlot::itemAt(const QPointF &pos, bool onlySelectable) const { return itemAt(pos, onlySelectable); } /*! Returns whether this QCustomPlot contains the \a item. \see item */ bool QCustomPlot::hasItem(QCPAbstractItem *item) const { return mItems.contains(item); } /*! Returns the layer with the specified \a name. If there is no layer with the specified name, \c nullptr is returned. Layer names are case-sensitive. \see addLayer, moveLayer, removeLayer */ QCPLayer *QCustomPlot::layer(const QString &name) const { foreach (QCPLayer *layer, mLayers) { if (layer->name() == name) return layer; } return nullptr; } /*! \overload Returns the layer by \a index. If the index is invalid, \c nullptr is returned. \see addLayer, moveLayer, removeLayer */ QCPLayer *QCustomPlot::layer(int index) const { if (index >= 0 && index < mLayers.size()) { return mLayers.at(index); } else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return nullptr; } } /*! Returns the layer that is set as current layer (see \ref setCurrentLayer). */ QCPLayer *QCustomPlot::currentLayer() const { return mCurrentLayer; } /*! Sets the layer with the specified \a name to be the current layer. All layerables (\ref QCPLayerable), e.g. plottables and items, are created on the current layer. Returns true on success, i.e. if there is a layer with the specified \a name in the QCustomPlot. Layer names are case-sensitive. \see addLayer, moveLayer, removeLayer, QCPLayerable::setLayer */ bool QCustomPlot::setCurrentLayer(const QString &name) { if (QCPLayer *newCurrentLayer = layer(name)) { return setCurrentLayer(newCurrentLayer); } else { qDebug() << Q_FUNC_INFO << "layer with name doesn't exist:" << name; return false; } } /*! \overload Sets the provided \a layer to be the current layer. Returns true on success, i.e. when \a layer is a valid layer in the QCustomPlot. \see addLayer, moveLayer, removeLayer */ bool QCustomPlot::setCurrentLayer(QCPLayer *layer) { if (!mLayers.contains(layer)) { qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); return false; } mCurrentLayer = layer; return true; } /*! Returns the number of currently existing layers in the plot \see layer, addLayer */ int QCustomPlot::layerCount() const { return mLayers.size(); } /*! Adds a new layer to this QCustomPlot instance. The new layer will have the name \a name, which must be unique. Depending on \a insertMode, it is positioned either below or above \a otherLayer. Returns true on success, i.e. if there is no other layer named \a name and \a otherLayer is a valid layer inside this QCustomPlot. If \a otherLayer is 0, the highest layer in the QCustomPlot will be used. For an explanation of what layers are in QCustomPlot, see the documentation of \ref QCPLayer. \see layer, moveLayer, removeLayer */ bool QCustomPlot::addLayer(const QString &name, QCPLayer *otherLayer, QCustomPlot::LayerInsertMode insertMode) { if (!otherLayer) otherLayer = mLayers.last(); if (!mLayers.contains(otherLayer)) { qDebug() << Q_FUNC_INFO << "otherLayer not a layer of this QCustomPlot:" << reinterpret_cast(otherLayer); return false; } if (layer(name)) { qDebug() << Q_FUNC_INFO << "A layer exists already with the name" << name; return false; } QCPLayer *newLayer = new QCPLayer(this, name); mLayers.insert(otherLayer->index() + (insertMode==limAbove ? 1:0), newLayer); updateLayerIndices(); setupPaintBuffers(); // associates new layer with the appropriate paint buffer return true; } /*! Removes the specified \a layer and returns true on success. All layerables (e.g. plottables and items) on the removed layer will be moved to the layer below \a layer. If \a layer is the bottom layer, the layerables are moved to the layer above. In both cases, the total rendering order of all layerables in the QCustomPlot is preserved. If \a layer is the current layer (\ref setCurrentLayer), the layer below (or above, if bottom layer) becomes the new current layer. It is not possible to remove the last layer of the plot. \see layer, addLayer, moveLayer */ bool QCustomPlot::removeLayer(QCPLayer *layer) { if (!mLayers.contains(layer)) { qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); return false; } if (mLayers.size() < 2) { qDebug() << Q_FUNC_INFO << "can't remove last layer"; return false; } // append all children of this layer to layer below (if this is lowest layer, prepend to layer above) int removedIndex = layer->index(); bool isFirstLayer = removedIndex==0; QCPLayer *targetLayer = isFirstLayer ? mLayers.at(removedIndex+1) : mLayers.at(removedIndex-1); QList children = layer->children(); if (isFirstLayer) // prepend in reverse order (such that relative order stays the same) std::reverse(children.begin(), children.end()); foreach (QCPLayerable *child, children) child->moveToLayer(targetLayer, isFirstLayer); // prepend if isFirstLayer, otherwise append // if removed layer is current layer, change current layer to layer below/above: if (layer == mCurrentLayer) setCurrentLayer(targetLayer); // invalidate the paint buffer that was responsible for this layer: if (QSharedPointer pb = layer->mPaintBuffer.toStrongRef()) pb->setInvalidated(); // remove layer: delete layer; mLayers.removeOne(layer); updateLayerIndices(); return true; } /*! Moves the specified \a layer either above or below \a otherLayer. Whether it's placed above or below is controlled with \a insertMode. Returns true on success, i.e. when both \a layer and \a otherLayer are valid layers in the QCustomPlot. \see layer, addLayer, moveLayer */ bool QCustomPlot::moveLayer(QCPLayer *layer, QCPLayer *otherLayer, QCustomPlot::LayerInsertMode insertMode) { if (!mLayers.contains(layer)) { qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); return false; } if (!mLayers.contains(otherLayer)) { qDebug() << Q_FUNC_INFO << "otherLayer not a layer of this QCustomPlot:" << reinterpret_cast(otherLayer); return false; } if (layer->index() > otherLayer->index()) mLayers.move(layer->index(), otherLayer->index() + (insertMode==limAbove ? 1:0)); else if (layer->index() < otherLayer->index()) mLayers.move(layer->index(), otherLayer->index() + (insertMode==limAbove ? 0:-1)); // invalidate the paint buffers that are responsible for the layers: if (QSharedPointer pb = layer->mPaintBuffer.toStrongRef()) pb->setInvalidated(); if (QSharedPointer pb = otherLayer->mPaintBuffer.toStrongRef()) pb->setInvalidated(); updateLayerIndices(); return true; } /*! Returns the number of axis rects in the plot. All axis rects can be accessed via QCustomPlot::axisRect(). Initially, only one axis rect exists in the plot. \see axisRect, axisRects */ int QCustomPlot::axisRectCount() const { return axisRects().size(); } /*! Returns the axis rect with \a index. Initially, only one axis rect (with index 0) exists in the plot. If multiple axis rects were added, all of them may be accessed with this function in a linear fashion (even when they are nested in a layout hierarchy or inside other axis rects via QCPAxisRect::insetLayout). The order of the axis rects is given by the fill order of the \ref QCPLayout that is holding them. For example, if the axis rects are in the top level grid layout (accessible via \ref QCustomPlot::plotLayout), they are ordered from left to right, top to bottom, if the layout's default \ref QCPLayoutGrid::setFillOrder "setFillOrder" of \ref QCPLayoutGrid::foColumnsFirst "foColumnsFirst" wasn't changed. If you want to access axis rects by their row and column index, use the layout interface. For example, use \ref QCPLayoutGrid::element of the top level grid layout, and \c qobject_cast the returned layout element to \ref QCPAxisRect. (See also \ref thelayoutsystem.) \see axisRectCount, axisRects, QCPLayoutGrid::setFillOrder */ QCPAxisRect *QCustomPlot::axisRect(int index) const { const QList rectList = axisRects(); if (index >= 0 && index < rectList.size()) { return rectList.at(index); } else { qDebug() << Q_FUNC_INFO << "invalid axis rect index" << index; return nullptr; } } /*! Returns all axis rects in the plot. The order of the axis rects is given by the fill order of the \ref QCPLayout that is holding them. For example, if the axis rects are in the top level grid layout (accessible via \ref QCustomPlot::plotLayout), they are ordered from left to right, top to bottom, if the layout's default \ref QCPLayoutGrid::setFillOrder "setFillOrder" of \ref QCPLayoutGrid::foColumnsFirst "foColumnsFirst" wasn't changed. \see axisRectCount, axisRect, QCPLayoutGrid::setFillOrder */ QList QCustomPlot::axisRects() const { QList result; QStack elementStack; if (mPlotLayout) elementStack.push(mPlotLayout); while (!elementStack.isEmpty()) { foreach (QCPLayoutElement *element, elementStack.pop()->elements(false)) { if (element) { elementStack.push(element); if (QCPAxisRect *ar = qobject_cast(element)) result.append(ar); } } } return result; } /*! Returns the layout element at pixel position \a pos. If there is no element at that position, returns \c nullptr. Only visible elements are used. If \ref QCPLayoutElement::setVisible on the element itself or on any of its parent elements is set to false, it will not be considered. \see itemAt, plottableAt */ QCPLayoutElement *QCustomPlot::layoutElementAt(const QPointF &pos) const { QCPLayoutElement *currentElement = mPlotLayout; bool searchSubElements = true; while (searchSubElements && currentElement) { searchSubElements = false; foreach (QCPLayoutElement *subElement, currentElement->elements(false)) { if (subElement && subElement->realVisibility() && subElement->selectTest(pos, false) >= 0) { currentElement = subElement; searchSubElements = true; break; } } } return currentElement; } /*! Returns the layout element of type \ref QCPAxisRect at pixel position \a pos. This method ignores other layout elements even if they are visually in front of the axis rect (e.g. a \ref QCPLegend). If there is no axis rect at that position, returns \c nullptr. Only visible axis rects are used. If \ref QCPLayoutElement::setVisible on the axis rect itself or on any of its parent elements is set to false, it will not be considered. \see layoutElementAt */ QCPAxisRect *QCustomPlot::axisRectAt(const QPointF &pos) const { QCPAxisRect *result = nullptr; QCPLayoutElement *currentElement = mPlotLayout; bool searchSubElements = true; while (searchSubElements && currentElement) { searchSubElements = false; foreach (QCPLayoutElement *subElement, currentElement->elements(false)) { if (subElement && subElement->realVisibility() && subElement->selectTest(pos, false) >= 0) { currentElement = subElement; searchSubElements = true; if (QCPAxisRect *ar = qobject_cast(currentElement)) result = ar; break; } } } return result; } /*! Returns the axes that currently have selected parts, i.e. whose selection state is not \ref QCPAxis::spNone. \see selectedPlottables, selectedLegends, setInteractions, QCPAxis::setSelectedParts, QCPAxis::setSelectableParts */ QList QCustomPlot::selectedAxes() const { QList result, allAxes; foreach (QCPAxisRect *rect, axisRects()) allAxes << rect->axes(); foreach (QCPAxis *axis, allAxes) { if (axis->selectedParts() != QCPAxis::spNone) result.append(axis); } return result; } /*! Returns the legends that currently have selected parts, i.e. whose selection state is not \ref QCPLegend::spNone. \see selectedPlottables, selectedAxes, setInteractions, QCPLegend::setSelectedParts, QCPLegend::setSelectableParts, QCPLegend::selectedItems */ QList QCustomPlot::selectedLegends() const { QList result; QStack elementStack; if (mPlotLayout) elementStack.push(mPlotLayout); while (!elementStack.isEmpty()) { foreach (QCPLayoutElement *subElement, elementStack.pop()->elements(false)) { if (subElement) { elementStack.push(subElement); if (QCPLegend *leg = qobject_cast(subElement)) { if (leg->selectedParts() != QCPLegend::spNone) result.append(leg); } } } } return result; } /*! Deselects all layerables (plottables, items, axes, legends,...) of the QCustomPlot. Since calling this function is not a user interaction, this does not emit the \ref selectionChangedByUser signal. The individual selectionChanged signals are emitted though, if the objects were previously selected. \see setInteractions, selectedPlottables, selectedItems, selectedAxes, selectedLegends */ void QCustomPlot::deselectAll() { foreach (QCPLayer *layer, mLayers) { foreach (QCPLayerable *layerable, layer->children()) layerable->deselectEvent(nullptr); } } /*! Causes a complete replot into the internal paint buffer(s). Finally, the widget surface is refreshed with the new buffer contents. This is the method that must be called to make changes to the plot, e.g. on the axis ranges or data points of graphs, visible. The parameter \a refreshPriority can be used to fine-tune the timing of the replot. For example if your application calls \ref replot very quickly in succession (e.g. multiple independent functions change some aspects of the plot and each wants to make sure the change gets replotted), it is advisable to set \a refreshPriority to \ref QCustomPlot::rpQueuedReplot. This way, the actual replotting is deferred to the next event loop iteration. Multiple successive calls of \ref replot with this priority will only cause a single replot, avoiding redundant replots and improving performance. Under a few circumstances, QCustomPlot causes a replot by itself. Those are resize events of the QCustomPlot widget and user interactions (object selection and range dragging/zooming). Before the replot happens, the signal \ref beforeReplot is emitted. After the replot, \ref afterReplot is emitted. It is safe to mutually connect the replot slot with any of those two signals on two QCustomPlots to make them replot synchronously, it won't cause an infinite recursion. If a layer is in mode \ref QCPLayer::lmBuffered (\ref QCPLayer::setMode), it is also possible to replot only that specific layer via \ref QCPLayer::replot. See the documentation there for details. \see replotTime */ void QCustomPlot::replot(QCustomPlot::RefreshPriority refreshPriority) { if (refreshPriority == QCustomPlot::rpQueuedReplot) { if (!mReplotQueued) { mReplotQueued = true; QTimer::singleShot(0, this, SLOT(replot())); } return; } if (mReplotting) // incase signals loop back to replot slot return; mReplotting = true; mReplotQueued = false; emit beforeReplot(); # if QT_VERSION < QT_VERSION_CHECK(4, 8, 0) QTime replotTimer; replotTimer.start(); # else QElapsedTimer replotTimer; replotTimer.start(); # endif updateLayout(); // draw all layered objects (grid, axes, plottables, items, legend,...) into their buffers: setupPaintBuffers(); foreach (QCPLayer *layer, mLayers) layer->drawToPaintBuffer(); foreach (QSharedPointer buffer, mPaintBuffers) buffer->setInvalidated(false); if ((refreshPriority == rpRefreshHint && mPlottingHints.testFlag(QCP::phImmediateRefresh)) || refreshPriority==rpImmediateRefresh) repaint(); else update(); # if QT_VERSION < QT_VERSION_CHECK(4, 8, 0) mReplotTime = replotTimer.elapsed(); # else mReplotTime = replotTimer.nsecsElapsed()*1e-6; # endif if (!qFuzzyIsNull(mReplotTimeAverage)) mReplotTimeAverage = mReplotTimeAverage*0.9 + mReplotTime*0.1; // exponential moving average with a time constant of 10 last replots else mReplotTimeAverage = mReplotTime; // no previous replots to average with, so initialize with replot time emit afterReplot(); mReplotting = false; } /*! Returns the time in milliseconds that the last replot took. If \a average is set to true, an exponential moving average over the last couple of replots is returned. \see replot */ double QCustomPlot::replotTime(bool average) const { return average ? mReplotTimeAverage : mReplotTime; } /*! Rescales the axes such that all plottables (like graphs) in the plot are fully visible. if \a onlyVisiblePlottables is set to true, only the plottables that have their visibility set to true (QCPLayerable::setVisible), will be used to rescale the axes. \see QCPAbstractPlottable::rescaleAxes, QCPAxis::rescale */ void QCustomPlot::rescaleAxes(bool onlyVisiblePlottables) { QList allAxes; foreach (QCPAxisRect *rect, axisRects()) allAxes << rect->axes(); foreach (QCPAxis *axis, allAxes) axis->rescale(onlyVisiblePlottables); } /*! Saves a PDF with the vectorized plot to the file \a fileName. The axis ratio as well as the scale of texts and lines will be derived from the specified \a width and \a height. This means, the output will look like the normal on-screen output of a QCustomPlot widget with the corresponding pixel width and height. If either \a width or \a height is zero, the exported image will have the same dimensions as the QCustomPlot widget currently has. Setting \a exportPen to \ref QCP::epNoCosmetic allows to disable the use of cosmetic pens when drawing to the PDF file. Cosmetic pens are pens with numerical width 0, which are always drawn as a one pixel wide line, no matter what zoom factor is set in the PDF-Viewer. For more information about cosmetic pens, see the QPainter and QPen documentation. The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with \ref deselectAll before calling this function. Returns true on success. \warning \li If you plan on editing the exported PDF file with a vector graphics editor like Inkscape, it is advised to set \a exportPen to \ref QCP::epNoCosmetic to avoid losing those cosmetic lines (which might be quite many, because cosmetic pens are the default for e.g. axes and tick marks). \li If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights. \a pdfCreator and \a pdfTitle may be used to set the according metadata fields in the resulting PDF file. \note On Android systems, this method does nothing and issues an according qDebug warning message. This is also the case if for other reasons the define flag \c QT_NO_PRINTER is set. \see savePng, saveBmp, saveJpg, saveRastered */ bool QCustomPlot::savePdf(const QString &fileName, int width, int height, QCP::ExportPen exportPen, const QString &pdfCreator, const QString &pdfTitle) { bool success = false; #ifdef QT_NO_PRINTER Q_UNUSED(fileName) Q_UNUSED(exportPen) Q_UNUSED(width) Q_UNUSED(height) Q_UNUSED(pdfCreator) Q_UNUSED(pdfTitle) qDebug() << Q_FUNC_INFO << "Qt was built without printer support (QT_NO_PRINTER). PDF not created."; #else int newWidth, newHeight; if (width == 0 || height == 0) { newWidth = this->width(); newHeight = this->height(); } else { newWidth = width; newHeight = height; } QPrinter printer(QPrinter::ScreenResolution); printer.setOutputFileName(fileName); printer.setOutputFormat(QPrinter::PdfFormat); printer.setColorMode(QPrinter::Color); printer.printEngine()->setProperty(QPrintEngine::PPK_Creator, pdfCreator); printer.printEngine()->setProperty(QPrintEngine::PPK_DocumentName, pdfTitle); QRect oldViewport = viewport(); setViewport(QRect(0, 0, newWidth, newHeight)); #if QT_VERSION < QT_VERSION_CHECK(5, 3, 0) printer.setFullPage(true); printer.setPaperSize(viewport().size(), QPrinter::DevicePixel); #else QPageLayout pageLayout; pageLayout.setMode(QPageLayout::FullPageMode); pageLayout.setOrientation(QPageLayout::Portrait); pageLayout.setMargins(QMarginsF(0, 0, 0, 0)); pageLayout.setPageSize(QPageSize(viewport().size(), QPageSize::Point, QString(), QPageSize::ExactMatch)); printer.setPageLayout(pageLayout); #endif QCPPainter printpainter; if (printpainter.begin(&printer)) { printpainter.setMode(QCPPainter::pmVectorized); printpainter.setMode(QCPPainter::pmNoCaching); printpainter.setMode(QCPPainter::pmNonCosmetic, exportPen==QCP::epNoCosmetic); printpainter.setWindow(mViewport); if (mBackgroundBrush.style() != Qt::NoBrush && mBackgroundBrush.color() != Qt::white && mBackgroundBrush.color() != Qt::transparent && mBackgroundBrush.color().alpha() > 0) // draw pdf background color if not white/transparent printpainter.fillRect(viewport(), mBackgroundBrush); draw(&printpainter); printpainter.end(); success = true; } setViewport(oldViewport); #endif // QT_NO_PRINTER return success; } /*! Saves a PNG image file to \a fileName on disc. The output plot will have the dimensions \a width and \a height in pixels, multiplied by \a scale. If either \a width or \a height is zero, the current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. are not scaled up when larger widths/heights are used. If you want that effect, use the \a scale parameter. For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full 200*200 pixel resolution. If you use a high scaling factor, it is recommended to enable antialiasing for all elements by temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows QCustomPlot to place objects with sub-pixel accuracy. image compression can be controlled with the \a quality parameter which must be between 0 and 100 or -1 to use the default setting. The \a resolution will be written to the image file header and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected resolution unit internally. Returns true on success. If this function fails, most likely the PNG format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats(). The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with \ref deselectAll before calling this function. If you want the PNG to have a transparent background, call \ref setBackground(const QBrush &brush) with no brush (Qt::NoBrush) or a transparent color (Qt::transparent), before saving. \warning If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights. \see savePdf, saveBmp, saveJpg, saveRastered */ bool QCustomPlot::savePng(const QString &fileName, int width, int height, double scale, int quality, int resolution, QCP::ResolutionUnit resolutionUnit) { return saveRastered(fileName, width, height, scale, "PNG", quality, resolution, resolutionUnit); } /*! Saves a JPEG image file to \a fileName on disc. The output plot will have the dimensions \a width and \a height in pixels, multiplied by \a scale. If either \a width or \a height is zero, the current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. are not scaled up when larger widths/heights are used. If you want that effect, use the \a scale parameter. For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full 200*200 pixel resolution. If you use a high scaling factor, it is recommended to enable antialiasing for all elements by temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows QCustomPlot to place objects with sub-pixel accuracy. image compression can be controlled with the \a quality parameter which must be between 0 and 100 or -1 to use the default setting. The \a resolution will be written to the image file header and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected resolution unit internally. Returns true on success. If this function fails, most likely the JPEG format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats(). The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with \ref deselectAll before calling this function. \warning If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights. \see savePdf, savePng, saveBmp, saveRastered */ bool QCustomPlot::saveJpg(const QString &fileName, int width, int height, double scale, int quality, int resolution, QCP::ResolutionUnit resolutionUnit) { return saveRastered(fileName, width, height, scale, "JPG", quality, resolution, resolutionUnit); } /*! Saves a BMP image file to \a fileName on disc. The output plot will have the dimensions \a width and \a height in pixels, multiplied by \a scale. If either \a width or \a height is zero, the current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. are not scaled up when larger widths/heights are used. If you want that effect, use the \a scale parameter. For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full 200*200 pixel resolution. If you use a high scaling factor, it is recommended to enable antialiasing for all elements by temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows QCustomPlot to place objects with sub-pixel accuracy. The \a resolution will be written to the image file header and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected resolution unit internally. Returns true on success. If this function fails, most likely the BMP format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats(). The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with \ref deselectAll before calling this function. \warning If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights. \see savePdf, savePng, saveJpg, saveRastered */ bool QCustomPlot::saveBmp(const QString &fileName, int width, int height, double scale, int resolution, QCP::ResolutionUnit resolutionUnit) { return saveRastered(fileName, width, height, scale, "BMP", -1, resolution, resolutionUnit); } /*! \internal Returns a minimum size hint that corresponds to the minimum size of the top level layout (\ref plotLayout). To prevent QCustomPlot from being collapsed to size/width zero, set a minimum size (setMinimumSize) either on the whole QCustomPlot or on any layout elements inside the plot. This is especially important, when placed in a QLayout where other components try to take in as much space as possible (e.g. QMdiArea). */ QSize QCustomPlot::minimumSizeHint() const { return mPlotLayout->minimumOuterSizeHint(); } /*! \internal Returns a size hint that is the same as \ref minimumSizeHint. */ QSize QCustomPlot::sizeHint() const { return mPlotLayout->minimumOuterSizeHint(); } /*! \internal Event handler for when the QCustomPlot widget needs repainting. This does not cause a \ref replot, but draws the internal buffer on the widget surface. */ void QCustomPlot::paintEvent(QPaintEvent *event) { Q_UNUSED(event) QCPPainter painter(this); if (painter.isActive()) { #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) painter.setRenderHint(QPainter::HighQualityAntialiasing); // to make Antialiasing look good if using the OpenGL graphicssystem #endif if (mBackgroundBrush.style() != Qt::NoBrush) painter.fillRect(mViewport, mBackgroundBrush); drawBackground(&painter); foreach (QSharedPointer buffer, mPaintBuffers) buffer->draw(&painter); } } /*! \internal Event handler for a resize of the QCustomPlot widget. The viewport (which becomes the outer rect of mPlotLayout) is resized appropriately. Finally a \ref replot is performed. */ void QCustomPlot::resizeEvent(QResizeEvent *event) { Q_UNUSED(event) // resize and repaint the buffer: setViewport(rect()); replot(rpQueuedRefresh); // queued refresh is important here, to prevent painting issues in some contexts (e.g. MDI subwindow) } /*! \internal Event handler for when a double click occurs. Emits the \ref mouseDoubleClick signal, then determines the layerable under the cursor and forwards the event to it. Finally, emits the specialized signals when certain objecs are clicked (e.g. \ref plottableDoubleClick, \ref axisDoubleClick, etc.). \see mousePressEvent, mouseReleaseEvent */ void QCustomPlot::mouseDoubleClickEvent(QMouseEvent *event) { emit mouseDoubleClick(event); mMouseHasMoved = false; mMousePressPos = event->pos(); // determine layerable under the cursor (this event is called instead of the second press event in a double-click): QList details; QList candidates = layerableListAt(mMousePressPos, false, &details); for (int i=0; iaccept(); // default impl of QCPLayerable's mouse events ignore the event, in that case propagate to next candidate in list candidates.at(i)->mouseDoubleClickEvent(event, details.at(i)); if (event->isAccepted()) { mMouseEventLayerable = candidates.at(i); mMouseEventLayerableDetails = details.at(i); break; } } // emit specialized object double click signals: if (!candidates.isEmpty()) { if (QCPAbstractPlottable *ap = qobject_cast(candidates.first())) { int dataIndex = 0; if (!details.first().value().isEmpty()) dataIndex = details.first().value().dataRange().begin(); emit plottableDoubleClick(ap, dataIndex, event); } else if (QCPAxis *ax = qobject_cast(candidates.first())) emit axisDoubleClick(ax, details.first().value(), event); else if (QCPAbstractItem *ai = qobject_cast(candidates.first())) emit itemDoubleClick(ai, event); else if (QCPLegend *lg = qobject_cast(candidates.first())) emit legendDoubleClick(lg, nullptr, event); else if (QCPAbstractLegendItem *li = qobject_cast(candidates.first())) emit legendDoubleClick(li->parentLegend(), li, event); } event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. } /*! \internal Event handler for when a mouse button is pressed. Emits the mousePress signal. If the current \ref setSelectionRectMode is not \ref QCP::srmNone, passes the event to the selection rect. Otherwise determines the layerable under the cursor and forwards the event to it. \see mouseMoveEvent, mouseReleaseEvent */ void QCustomPlot::mousePressEvent(QMouseEvent *event) { emit mousePress(event); // save some state to tell in releaseEvent whether it was a click: mMouseHasMoved = false; mMousePressPos = event->pos(); if (mSelectionRect && mSelectionRectMode != QCP::srmNone) { if (mSelectionRectMode != QCP::srmZoom || qobject_cast(axisRectAt(mMousePressPos))) // in zoom mode only activate selection rect if on an axis rect mSelectionRect->startSelection(event); } else { // no selection rect interaction, prepare for click signal emission and forward event to layerable under the cursor: QList details; QList candidates = layerableListAt(mMousePressPos, false, &details); if (!candidates.isEmpty()) { mMouseSignalLayerable = candidates.first(); // candidate for signal emission is always topmost hit layerable (signal emitted in release event) mMouseSignalLayerableDetails = details.first(); } // forward event to topmost candidate which accepts the event: for (int i=0; iaccept(); // default impl of QCPLayerable's mouse events call ignore() on the event, in that case propagate to next candidate in list candidates.at(i)->mousePressEvent(event, details.at(i)); if (event->isAccepted()) { mMouseEventLayerable = candidates.at(i); mMouseEventLayerableDetails = details.at(i); break; } } } event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. } /*! \internal Event handler for when the cursor is moved. Emits the \ref mouseMove signal. If the selection rect (\ref setSelectionRect) is currently active, the event is forwarded to it in order to update the rect geometry. Otherwise, if a layout element has mouse capture focus (a mousePressEvent happened on top of the layout element before), the mouseMoveEvent is forwarded to that element. \see mousePressEvent, mouseReleaseEvent */ void QCustomPlot::mouseMoveEvent(QMouseEvent *event) { emit mouseMove(event); if (!mMouseHasMoved && (mMousePressPos-event->pos()).manhattanLength() > 3) mMouseHasMoved = true; // moved too far from mouse press position, don't handle as click on mouse release if (mSelectionRect && mSelectionRect->isActive()) mSelectionRect->moveSelection(event); else if (mMouseEventLayerable) // call event of affected layerable: mMouseEventLayerable->mouseMoveEvent(event, mMousePressPos); event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. } /*! \internal Event handler for when a mouse button is released. Emits the \ref mouseRelease signal. If the mouse was moved less than a certain threshold in any direction since the \ref mousePressEvent, it is considered a click which causes the selection mechanism (if activated via \ref setInteractions) to possibly change selection states accordingly. Further, specialized mouse click signals are emitted (e.g. \ref plottableClick, \ref axisClick, etc.) If a layerable is the mouse capturer (a \ref mousePressEvent happened on top of the layerable before), the \ref mouseReleaseEvent is forwarded to that element. \see mousePressEvent, mouseMoveEvent */ void QCustomPlot::mouseReleaseEvent(QMouseEvent *event) { emit mouseRelease(event); if (!mMouseHasMoved) // mouse hasn't moved (much) between press and release, so handle as click { if (mSelectionRect && mSelectionRect->isActive()) // a simple click shouldn't successfully finish a selection rect, so cancel it here mSelectionRect->cancel(); if (event->button() == Qt::LeftButton) processPointSelection(event); // emit specialized click signals of QCustomPlot instance: if (QCPAbstractPlottable *ap = qobject_cast(mMouseSignalLayerable)) { int dataIndex = 0; if (!mMouseSignalLayerableDetails.value().isEmpty()) dataIndex = mMouseSignalLayerableDetails.value().dataRange().begin(); emit plottableClick(ap, dataIndex, event); } else if (QCPAxis *ax = qobject_cast(mMouseSignalLayerable)) emit axisClick(ax, mMouseSignalLayerableDetails.value(), event); else if (QCPAbstractItem *ai = qobject_cast(mMouseSignalLayerable)) emit itemClick(ai, event); else if (QCPLegend *lg = qobject_cast(mMouseSignalLayerable)) emit legendClick(lg, nullptr, event); else if (QCPAbstractLegendItem *li = qobject_cast(mMouseSignalLayerable)) emit legendClick(li->parentLegend(), li, event); mMouseSignalLayerable = nullptr; } if (mSelectionRect && mSelectionRect->isActive()) // Note: if a click was detected above, the selection rect is canceled there { // finish selection rect, the appropriate action will be taken via signal-slot connection: mSelectionRect->endSelection(event); } else { // call event of affected layerable: if (mMouseEventLayerable) { mMouseEventLayerable->mouseReleaseEvent(event, mMousePressPos); mMouseEventLayerable = nullptr; } } if (noAntialiasingOnDrag()) replot(rpQueuedReplot); event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. } /*! \internal Event handler for mouse wheel events. First, the \ref mouseWheel signal is emitted. Then determines the affected layerable and forwards the event to it. */ void QCustomPlot::wheelEvent(QWheelEvent *event) { emit mouseWheel(event); #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0) const QPointF pos = event->pos(); #else const QPointF pos = event->position(); #endif // forward event to layerable under cursor: foreach (QCPLayerable *candidate, layerableListAt(pos, false)) { event->accept(); // default impl of QCPLayerable's mouse events ignore the event, in that case propagate to next candidate in list candidate->wheelEvent(event); if (event->isAccepted()) break; } event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. } /*! \internal This function draws the entire plot, including background pixmap, with the specified \a painter. It does not make use of the paint buffers like \ref replot, so this is the function typically used by saving/exporting methods such as \ref savePdf or \ref toPainter. Note that it does not fill the background with the background brush (as the user may specify with \ref setBackground(const QBrush &brush)), this is up to the respective functions calling this method. */ void QCustomPlot::draw(QCPPainter *painter) { updateLayout(); // draw viewport background pixmap: drawBackground(painter); // draw all layered objects (grid, axes, plottables, items, legend,...): foreach (QCPLayer *layer, mLayers) layer->draw(painter); /* Debug code to draw all layout element rects foreach (QCPLayoutElement *el, findChildren()) { painter->setBrush(Qt::NoBrush); painter->setPen(QPen(QColor(0, 0, 0, 100), 0, Qt::DashLine)); painter->drawRect(el->rect()); painter->setPen(QPen(QColor(255, 0, 0, 100), 0, Qt::DashLine)); painter->drawRect(el->outerRect()); } */ } /*! \internal Performs the layout update steps defined by \ref QCPLayoutElement::UpdatePhase, by calling \ref QCPLayoutElement::update on the main plot layout. Here, the layout elements calculate their positions and margins, and prepare for the following draw call. */ void QCustomPlot::updateLayout() { // run through layout phases: mPlotLayout->update(QCPLayoutElement::upPreparation); mPlotLayout->update(QCPLayoutElement::upMargins); mPlotLayout->update(QCPLayoutElement::upLayout); emit afterLayout(); } /*! \internal Draws the viewport background pixmap of the plot. If a pixmap was provided via \ref setBackground, this function buffers the scaled version depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside the viewport with the provided \a painter. The scaled version is buffered in mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when the axis rect has changed in a way that requires a rescale of the background pixmap (this is dependent on the \ref setBackgroundScaledMode), or when a differend axis background pixmap was set. Note that this function does not draw a fill with the background brush (\ref setBackground(const QBrush &brush)) beneath the pixmap. \see setBackground, setBackgroundScaled, setBackgroundScaledMode */ void QCustomPlot::drawBackground(QCPPainter *painter) { // Note: background color is handled in individual replot/save functions // draw background pixmap (on top of fill, if brush specified): if (!mBackgroundPixmap.isNull()) { if (mBackgroundScaled) { // check whether mScaledBackground needs to be updated: QSize scaledSize(mBackgroundPixmap.size()); scaledSize.scale(mViewport.size(), mBackgroundScaledMode); if (mScaledBackgroundPixmap.size() != scaledSize) mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mViewport.size(), mBackgroundScaledMode, Qt::SmoothTransformation); painter->drawPixmap(mViewport.topLeft(), mScaledBackgroundPixmap, QRect(0, 0, mViewport.width(), mViewport.height()) & mScaledBackgroundPixmap.rect()); } else { painter->drawPixmap(mViewport.topLeft(), mBackgroundPixmap, QRect(0, 0, mViewport.width(), mViewport.height())); } } } /*! \internal Goes through the layers and makes sure this QCustomPlot instance holds the correct number of paint buffers and that they have the correct configuration (size, pixel ratio, etc.). Allocations, reallocations and deletions of paint buffers are performed as necessary. It also associates the paint buffers with the layers, so they draw themselves into the right buffer when \ref QCPLayer::drawToPaintBuffer is called. This means it associates adjacent \ref QCPLayer::lmLogical layers to a mutual paint buffer and creates dedicated paint buffers for layers in \ref QCPLayer::lmBuffered mode. This method uses \ref createPaintBuffer to create new paint buffers. After this method, the paint buffers are empty (filled with \c Qt::transparent) and invalidated (so an attempt to replot only a single buffered layer causes a full replot). This method is called in every \ref replot call, prior to actually drawing the layers (into their associated paint buffer). If the paint buffers don't need changing/reallocating, this method basically leaves them alone and thus finishes very fast. */ void QCustomPlot::setupPaintBuffers() { int bufferIndex = 0; if (mPaintBuffers.isEmpty()) mPaintBuffers.append(QSharedPointer(createPaintBuffer())); for (int layerIndex = 0; layerIndex < mLayers.size(); ++layerIndex) { QCPLayer *layer = mLayers.at(layerIndex); if (layer->mode() == QCPLayer::lmLogical) { layer->mPaintBuffer = mPaintBuffers.at(bufferIndex).toWeakRef(); } else if (layer->mode() == QCPLayer::lmBuffered) { ++bufferIndex; if (bufferIndex >= mPaintBuffers.size()) mPaintBuffers.append(QSharedPointer(createPaintBuffer())); layer->mPaintBuffer = mPaintBuffers.at(bufferIndex).toWeakRef(); if (layerIndex < mLayers.size()-1 && mLayers.at(layerIndex+1)->mode() == QCPLayer::lmLogical) // not last layer, and next one is logical, so prepare another buffer for next layerables { ++bufferIndex; if (bufferIndex >= mPaintBuffers.size()) mPaintBuffers.append(QSharedPointer(createPaintBuffer())); } } } // remove unneeded buffers: while (mPaintBuffers.size()-1 > bufferIndex) mPaintBuffers.removeLast(); // resize buffers to viewport size and clear contents: foreach (QSharedPointer buffer, mPaintBuffers) { buffer->setSize(viewport().size()); // won't do anything if already correct size buffer->clear(Qt::transparent); buffer->setInvalidated(); } } /*! \internal This method is used by \ref setupPaintBuffers when it needs to create new paint buffers. Depending on the current setting of \ref setOpenGl, and the current Qt version, different backends (subclasses of \ref QCPAbstractPaintBuffer) are created, initialized with the proper size and device pixel ratio, and returned. */ QCPAbstractPaintBuffer *QCustomPlot::createPaintBuffer() { if (mOpenGl) { #if defined(QCP_OPENGL_FBO) return new QCPPaintBufferGlFbo(viewport().size(), mBufferDevicePixelRatio, mGlContext, mGlPaintDevice); #elif defined(QCP_OPENGL_PBUFFER) return new QCPPaintBufferGlPbuffer(viewport().size(), mBufferDevicePixelRatio, mOpenGlMultisamples); #else qDebug() << Q_FUNC_INFO << "OpenGL enabled even though no support for it compiled in, this shouldn't have happened. Falling back to pixmap paint buffer."; return new QCPPaintBufferPixmap(viewport().size(), mBufferDevicePixelRatio); #endif } else return new QCPPaintBufferPixmap(viewport().size(), mBufferDevicePixelRatio); } /*! This method returns whether any of the paint buffers held by this QCustomPlot instance are invalidated. If any buffer is invalidated, a partial replot (\ref QCPLayer::replot) is not allowed and always causes a full replot (\ref QCustomPlot::replot) of all layers. This is the case when for example the layer order has changed, new layers were added or removed, layer modes were changed (\ref QCPLayer::setMode), or layerables were added or removed. \see QCPAbstractPaintBuffer::setInvalidated */ bool QCustomPlot::hasInvalidatedPaintBuffers() { foreach (QSharedPointer buffer, mPaintBuffers) { if (buffer->invalidated()) return true; } return false; } /*! \internal When \ref setOpenGl is set to true, this method is used to initialize OpenGL (create a context, surface, paint device). Returns true on success. If this method is successful, all paint buffers should be deleted and then reallocated by calling \ref setupPaintBuffers, so the OpenGL-based paint buffer subclasses (\ref QCPPaintBufferGlPbuffer, \ref QCPPaintBufferGlFbo) are used for subsequent replots. \see freeOpenGl */ bool QCustomPlot::setupOpenGl() { #ifdef QCP_OPENGL_FBO freeOpenGl(); QSurfaceFormat proposedSurfaceFormat; proposedSurfaceFormat.setSamples(mOpenGlMultisamples); #ifdef QCP_OPENGL_OFFSCREENSURFACE QOffscreenSurface *surface = new QOffscreenSurface; #else QWindow *surface = new QWindow; surface->setSurfaceType(QSurface::OpenGLSurface); #endif surface->setFormat(proposedSurfaceFormat); surface->create(); mGlSurface = QSharedPointer(surface); mGlContext = QSharedPointer(new QOpenGLContext); mGlContext->setFormat(mGlSurface->format()); if (!mGlContext->create()) { qDebug() << Q_FUNC_INFO << "Failed to create OpenGL context"; mGlContext.clear(); mGlSurface.clear(); return false; } if (!mGlContext->makeCurrent(mGlSurface.data())) // context needs to be current to create paint device { qDebug() << Q_FUNC_INFO << "Failed to make opengl context current"; mGlContext.clear(); mGlSurface.clear(); return false; } if (!QOpenGLFramebufferObject::hasOpenGLFramebufferObjects()) { qDebug() << Q_FUNC_INFO << "OpenGL of this system doesn't support frame buffer objects"; mGlContext.clear(); mGlSurface.clear(); return false; } mGlPaintDevice = QSharedPointer(new QOpenGLPaintDevice); return true; #elif defined(QCP_OPENGL_PBUFFER) return QGLFormat::hasOpenGL(); #else return false; #endif } /*! \internal When \ref setOpenGl is set to false, this method is used to deinitialize OpenGL (releases the context and frees resources). After OpenGL is disabled, all paint buffers should be deleted and then reallocated by calling \ref setupPaintBuffers, so the standard software rendering paint buffer subclass (\ref QCPPaintBufferPixmap) is used for subsequent replots. \see setupOpenGl */ void QCustomPlot::freeOpenGl() { #ifdef QCP_OPENGL_FBO mGlPaintDevice.clear(); mGlContext.clear(); mGlSurface.clear(); #endif } /*! \internal This method is used by \ref QCPAxisRect::removeAxis to report removed axes to the QCustomPlot so it may clear its QCustomPlot::xAxis, yAxis, xAxis2 and yAxis2 members accordingly. */ void QCustomPlot::axisRemoved(QCPAxis *axis) { if (xAxis == axis) xAxis = nullptr; if (xAxis2 == axis) xAxis2 = nullptr; if (yAxis == axis) yAxis = nullptr; if (yAxis2 == axis) yAxis2 = nullptr; // Note: No need to take care of range drag axes and range zoom axes, because they are stored in smart pointers } /*! \internal This method is used by the QCPLegend destructor to report legend removal to the QCustomPlot so it may clear its QCustomPlot::legend member accordingly. */ void QCustomPlot::legendRemoved(QCPLegend *legend) { if (this->legend == legend) this->legend = nullptr; } /*! \internal This slot is connected to the selection rect's \ref QCPSelectionRect::accepted signal when \ref setSelectionRectMode is set to \ref QCP::srmSelect. First, it determines which axis rect was the origin of the selection rect judging by the starting point of the selection. Then it goes through the plottables (\ref QCPAbstractPlottable1D to be precise) associated with that axis rect and finds the data points that are in \a rect. It does this by querying their \ref QCPAbstractPlottable1D::selectTestRect method. Then, the actual selection is done by calling the plottables' \ref QCPAbstractPlottable::selectEvent, placing the found selected data points in the \a details parameter as QVariant(\ref QCPDataSelection). All plottables that weren't touched by \a rect receive a \ref QCPAbstractPlottable::deselectEvent. \see processRectZoom */ void QCustomPlot::processRectSelection(QRect rect, QMouseEvent *event) { typedef QPair SelectionCandidate; typedef QMultiMap SelectionCandidates; // map key is number of selected data points, so we have selections sorted by size bool selectionStateChanged = false; if (mInteractions.testFlag(QCP::iSelectPlottables)) { SelectionCandidates potentialSelections; QRectF rectF(rect.normalized()); if (QCPAxisRect *affectedAxisRect = axisRectAt(rectF.topLeft())) { // determine plottables that were hit by the rect and thus are candidates for selection: foreach (QCPAbstractPlottable *plottable, affectedAxisRect->plottables()) { if (QCPPlottableInterface1D *plottableInterface = plottable->interface1D()) { QCPDataSelection dataSel = plottableInterface->selectTestRect(rectF, true); if (!dataSel.isEmpty()) potentialSelections.insert(dataSel.dataPointCount(), SelectionCandidate(plottable, dataSel)); } } if (!mInteractions.testFlag(QCP::iMultiSelect)) { // only leave plottable with most selected points in map, since we will only select a single plottable: if (!potentialSelections.isEmpty()) { SelectionCandidates::iterator it = potentialSelections.begin(); while (it != std::prev(potentialSelections.end())) // erase all except last element it = potentialSelections.erase(it); } } bool additive = event->modifiers().testFlag(mMultiSelectModifier); // deselect all other layerables if not additive selection: if (!additive) { // emit deselection except to those plottables who will be selected afterwards: foreach (QCPLayer *layer, mLayers) { foreach (QCPLayerable *layerable, layer->children()) { if ((potentialSelections.isEmpty() || potentialSelections.constBegin()->first != layerable) && mInteractions.testFlag(layerable->selectionCategory())) { bool selChanged = false; layerable->deselectEvent(&selChanged); selectionStateChanged |= selChanged; } } } } // go through selections in reverse (largest selection first) and emit select events: SelectionCandidates::const_iterator it = potentialSelections.constEnd(); while (it != potentialSelections.constBegin()) { --it; if (mInteractions.testFlag(it.value().first->selectionCategory())) { bool selChanged = false; it.value().first->selectEvent(event, additive, QVariant::fromValue(it.value().second), &selChanged); selectionStateChanged |= selChanged; } } } } if (selectionStateChanged) { emit selectionChangedByUser(); replot(rpQueuedReplot); } else if (mSelectionRect) mSelectionRect->layer()->replot(); } /*! \internal This slot is connected to the selection rect's \ref QCPSelectionRect::accepted signal when \ref setSelectionRectMode is set to \ref QCP::srmZoom. It determines which axis rect was the origin of the selection rect judging by the starting point of the selection, and then zooms the axes defined via \ref QCPAxisRect::setRangeZoomAxes to the provided \a rect (see \ref QCPAxisRect::zoom). \see processRectSelection */ void QCustomPlot::processRectZoom(QRect rect, QMouseEvent *event) { Q_UNUSED(event) if (QCPAxisRect *axisRect = axisRectAt(rect.topLeft())) { QList affectedAxes = QList() << axisRect->rangeZoomAxes(Qt::Horizontal) << axisRect->rangeZoomAxes(Qt::Vertical); affectedAxes.removeAll(static_cast(nullptr)); axisRect->zoom(QRectF(rect), affectedAxes); } replot(rpQueuedReplot); // always replot to make selection rect disappear } /*! \internal This method is called when a simple left mouse click was detected on the QCustomPlot surface. It first determines the layerable that was hit by the click, and then calls its \ref QCPLayerable::selectEvent. All other layerables receive a QCPLayerable::deselectEvent (unless the multi-select modifier was pressed, see \ref setMultiSelectModifier). In this method the hit layerable is determined a second time using \ref layerableAt (after the one in \ref mousePressEvent), because we want \a onlySelectable set to true this time. This implies that the mouse event grabber (mMouseEventLayerable) may be a different one from the clicked layerable determined here. For example, if a non-selectable layerable is in front of a selectable layerable at the click position, the front layerable will receive mouse events but the selectable one in the back will receive the \ref QCPLayerable::selectEvent. \see processRectSelection, QCPLayerable::selectTest */ void QCustomPlot::processPointSelection(QMouseEvent *event) { QVariant details; QCPLayerable *clickedLayerable = layerableAt(event->pos(), true, &details); bool selectionStateChanged = false; bool additive = mInteractions.testFlag(QCP::iMultiSelect) && event->modifiers().testFlag(mMultiSelectModifier); // deselect all other layerables if not additive selection: if (!additive) { foreach (QCPLayer *layer, mLayers) { foreach (QCPLayerable *layerable, layer->children()) { if (layerable != clickedLayerable && mInteractions.testFlag(layerable->selectionCategory())) { bool selChanged = false; layerable->deselectEvent(&selChanged); selectionStateChanged |= selChanged; } } } } if (clickedLayerable && mInteractions.testFlag(clickedLayerable->selectionCategory())) { // a layerable was actually clicked, call its selectEvent: bool selChanged = false; clickedLayerable->selectEvent(event, additive, details, &selChanged); selectionStateChanged |= selChanged; } if (selectionStateChanged) { emit selectionChangedByUser(); replot(rpQueuedReplot); } } /*! \internal Registers the specified plottable with this QCustomPlot and, if \ref setAutoAddPlottableToLegend is enabled, adds it to the legend (QCustomPlot::legend). QCustomPlot takes ownership of the plottable. Returns true on success, i.e. when \a plottable isn't already in this plot and the parent plot of \a plottable is this QCustomPlot. This method is called automatically in the QCPAbstractPlottable base class constructor. */ bool QCustomPlot::registerPlottable(QCPAbstractPlottable *plottable) { if (mPlottables.contains(plottable)) { qDebug() << Q_FUNC_INFO << "plottable already added to this QCustomPlot:" << reinterpret_cast(plottable); return false; } if (plottable->parentPlot() != this) { qDebug() << Q_FUNC_INFO << "plottable not created with this QCustomPlot as parent:" << reinterpret_cast(plottable); return false; } mPlottables.append(plottable); // possibly add plottable to legend: if (mAutoAddPlottableToLegend) plottable->addToLegend(); if (!plottable->layer()) // usually the layer is already set in the constructor of the plottable (via QCPLayerable constructor) plottable->setLayer(currentLayer()); return true; } /*! \internal In order to maintain the simplified graph interface of QCustomPlot, this method is called by the QCPGraph constructor to register itself with this QCustomPlot's internal graph list. Returns true on success, i.e. if \a graph is valid and wasn't already registered with this QCustomPlot. This graph specific registration happens in addition to the call to \ref registerPlottable by the QCPAbstractPlottable base class. */ bool QCustomPlot::registerGraph(QCPGraph *graph) { if (!graph) { qDebug() << Q_FUNC_INFO << "passed graph is zero"; return false; } if (mGraphs.contains(graph)) { qDebug() << Q_FUNC_INFO << "graph already registered with this QCustomPlot"; return false; } mGraphs.append(graph); return true; } /*! \internal Registers the specified item with this QCustomPlot. QCustomPlot takes ownership of the item. Returns true on success, i.e. when \a item wasn't already in the plot and the parent plot of \a item is this QCustomPlot. This method is called automatically in the QCPAbstractItem base class constructor. */ bool QCustomPlot::registerItem(QCPAbstractItem *item) { if (mItems.contains(item)) { qDebug() << Q_FUNC_INFO << "item already added to this QCustomPlot:" << reinterpret_cast(item); return false; } if (item->parentPlot() != this) { qDebug() << Q_FUNC_INFO << "item not created with this QCustomPlot as parent:" << reinterpret_cast(item); return false; } mItems.append(item); if (!item->layer()) // usually the layer is already set in the constructor of the item (via QCPLayerable constructor) item->setLayer(currentLayer()); return true; } /*! \internal Assigns all layers their index (QCPLayer::mIndex) in the mLayers list. This method is thus called after every operation that changes the layer indices, like layer removal, layer creation, layer moving. */ void QCustomPlot::updateLayerIndices() const { for (int i=0; imIndex = i; } /*! \internal Returns the top-most layerable at pixel position \a pos. If \a onlySelectable is set to true, only those layerables that are selectable will be considered. (Layerable subclasses communicate their selectability via the QCPLayerable::selectTest method, by returning -1.) \a selectionDetails is an output parameter that contains selection specifics of the affected layerable. This is useful if the respective layerable shall be given a subsequent QCPLayerable::selectEvent (like in \ref mouseReleaseEvent). \a selectionDetails usually contains information about which part of the layerable was hit, in multi-part layerables (e.g. QCPAxis::SelectablePart). If the layerable is a plottable, \a selectionDetails contains a \ref QCPDataSelection instance with the single data point which is closest to \a pos. \see layerableListAt, layoutElementAt, axisRectAt */ QCPLayerable *QCustomPlot::layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails) const { QList details; QList candidates = layerableListAt(pos, onlySelectable, selectionDetails ? &details : nullptr); if (selectionDetails && !details.isEmpty()) *selectionDetails = details.first(); if (!candidates.isEmpty()) return candidates.first(); else return nullptr; } /*! \internal Returns the layerables at pixel position \a pos. If \a onlySelectable is set to true, only those layerables that are selectable will be considered. (Layerable subclasses communicate their selectability via the QCPLayerable::selectTest method, by returning -1.) The returned list is sorted by the layerable/drawing order such that the layerable that appears on top in the plot is at index 0 of the returned list. If you only need to know the top layerable, rather use \ref layerableAt. \a selectionDetails is an output parameter that contains selection specifics of the affected layerable. This is useful if the respective layerable shall be given a subsequent QCPLayerable::selectEvent (like in \ref mouseReleaseEvent). \a selectionDetails usually contains information about which part of the layerable was hit, in multi-part layerables (e.g. QCPAxis::SelectablePart). If the layerable is a plottable, \a selectionDetails contains a \ref QCPDataSelection instance with the single data point which is closest to \a pos. \see layerableAt, layoutElementAt, axisRectAt */ QList QCustomPlot::layerableListAt(const QPointF &pos, bool onlySelectable, QList *selectionDetails) const { QList result; for (int layerIndex=mLayers.size()-1; layerIndex>=0; --layerIndex) { const QList layerables = mLayers.at(layerIndex)->children(); for (int i=layerables.size()-1; i>=0; --i) { if (!layerables.at(i)->realVisibility()) continue; QVariant details; double dist = layerables.at(i)->selectTest(pos, onlySelectable, selectionDetails ? &details : nullptr); if (dist >= 0 && dist < selectionTolerance()) { result.append(layerables.at(i)); if (selectionDetails) selectionDetails->append(details); } } } return result; } /*! Saves the plot to a rastered image file \a fileName in the image format \a format. The plot is sized to \a width and \a height in pixels and scaled with \a scale. (width 100 and scale 2.0 lead to a full resolution file with width 200.) If the \a format supports compression, \a quality may be between 0 and 100 to control it. Returns true on success. If this function fails, most likely the given \a format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats(). The \a resolution will be written to the image file header (if the file format supports this) and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected resolution unit internally. \see saveBmp, saveJpg, savePng, savePdf */ bool QCustomPlot::saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality, int resolution, QCP::ResolutionUnit resolutionUnit) { QImage buffer = toPixmap(width, height, scale).toImage(); int dotsPerMeter = 0; switch (resolutionUnit) { case QCP::ruDotsPerMeter: dotsPerMeter = resolution; break; case QCP::ruDotsPerCentimeter: dotsPerMeter = resolution*100; break; case QCP::ruDotsPerInch: dotsPerMeter = int(resolution/0.0254); break; } buffer.setDotsPerMeterX(dotsPerMeter); // this is saved together with some image formats, e.g. PNG, and is relevant when opening image in other tools buffer.setDotsPerMeterY(dotsPerMeter); // this is saved together with some image formats, e.g. PNG, and is relevant when opening image in other tools if (!buffer.isNull()) return buffer.save(fileName, format, quality); else return false; } /*! Renders the plot to a pixmap and returns it. The plot is sized to \a width and \a height in pixels and scaled with \a scale. (width 100 and scale 2.0 lead to a full resolution pixmap with width 200.) \see toPainter, saveRastered, saveBmp, savePng, saveJpg, savePdf */ QPixmap QCustomPlot::toPixmap(int width, int height, double scale) { // this method is somewhat similar to toPainter. Change something here, and a change in toPainter might be necessary, too. int newWidth, newHeight; if (width == 0 || height == 0) { newWidth = this->width(); newHeight = this->height(); } else { newWidth = width; newHeight = height; } int scaledWidth = qRound(scale*newWidth); int scaledHeight = qRound(scale*newHeight); QPixmap result(scaledWidth, scaledHeight); result.fill(mBackgroundBrush.style() == Qt::SolidPattern ? mBackgroundBrush.color() : Qt::transparent); // if using non-solid pattern, make transparent now and draw brush pattern later QCPPainter painter; painter.begin(&result); if (painter.isActive()) { QRect oldViewport = viewport(); setViewport(QRect(0, 0, newWidth, newHeight)); painter.setMode(QCPPainter::pmNoCaching); if (!qFuzzyCompare(scale, 1.0)) { if (scale > 1.0) // for scale < 1 we always want cosmetic pens where possible, because else lines might disappear for very small scales painter.setMode(QCPPainter::pmNonCosmetic); painter.scale(scale, scale); } if (mBackgroundBrush.style() != Qt::SolidPattern && mBackgroundBrush.style() != Qt::NoBrush) // solid fills were done a few lines above with QPixmap::fill painter.fillRect(mViewport, mBackgroundBrush); draw(&painter); setViewport(oldViewport); painter.end(); } else // might happen if pixmap has width or height zero { qDebug() << Q_FUNC_INFO << "Couldn't activate painter on pixmap"; return QPixmap(); } return result; } /*! Renders the plot using the passed \a painter. The plot is sized to \a width and \a height in pixels. If the \a painter's scale is not 1.0, the resulting plot will appear scaled accordingly. \note If you are restricted to using a QPainter (instead of QCPPainter), create a temporary QPicture and open a QCPPainter on it. Then call \ref toPainter with this QCPPainter. After ending the paint operation on the picture, draw it with the QPainter. This will reproduce the painter actions the QCPPainter took, with a QPainter. \see toPixmap */ void QCustomPlot::toPainter(QCPPainter *painter, int width, int height) { // this method is somewhat similar to toPixmap. Change something here, and a change in toPixmap might be necessary, too. int newWidth, newHeight; if (width == 0 || height == 0) { newWidth = this->width(); newHeight = this->height(); } else { newWidth = width; newHeight = height; } if (painter->isActive()) { QRect oldViewport = viewport(); setViewport(QRect(0, 0, newWidth, newHeight)); painter->setMode(QCPPainter::pmNoCaching); if (mBackgroundBrush.style() != Qt::NoBrush) // unlike in toPixmap, we can't do QPixmap::fill for Qt::SolidPattern brush style, so we also draw solid fills with fillRect here painter->fillRect(mViewport, mBackgroundBrush); draw(painter); setViewport(oldViewport); } else qDebug() << Q_FUNC_INFO << "Passed painter is not active"; } /* end of 'src/core.cpp' */ /* including file 'src/colorgradient.cpp' */ /* modified 2021-03-29T02:30:44, size 25278 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPColorGradient //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPColorGradient \brief Defines a color gradient for use with e.g. \ref QCPColorMap This class describes a color gradient which can be used to encode data with color. For example, QCPColorMap and QCPColorScale have \ref QCPColorMap::setGradient "setGradient" methods which take an instance of this class. Colors are set with \ref setColorStopAt(double position, const QColor &color) with a \a position from 0 to 1. In between these defined color positions, the color will be interpolated linearly either in RGB or HSV space, see \ref setColorInterpolation. Alternatively, load one of the preset color gradients shown in the image below, with \ref loadPreset, or by directly specifying the preset in the constructor. Apart from red, green and blue components, the gradient also interpolates the alpha values of the configured color stops. This allows to display some portions of the data range as transparent in the plot. How NaN values are interpreted can be configured with \ref setNanHandling. \image html QCPColorGradient.png The constructor \ref QCPColorGradient(GradientPreset preset) allows directly converting a \ref GradientPreset to a QCPColorGradient. This means that you can directly pass \ref GradientPreset to all the \a setGradient methods, e.g.: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorgradient-setgradient The total number of levels used in the gradient can be set with \ref setLevelCount. Whether the color gradient shall be applied periodically (wrapping around) to data values that lie outside the data range specified on the plottable instance can be controlled with \ref setPeriodic. */ /*! Constructs a new, empty QCPColorGradient with no predefined color stops. You can add own color stops with \ref setColorStopAt. The color level count is initialized to 350. */ QCPColorGradient::QCPColorGradient() : mLevelCount(350), mColorInterpolation(ciRGB), mNanHandling(nhNone), mNanColor(Qt::black), mPeriodic(false), mColorBufferInvalidated(true) { mColorBuffer.fill(qRgb(0, 0, 0), mLevelCount); } /*! Constructs a new QCPColorGradient initialized with the colors and color interpolation according to \a preset. The color level count is initialized to 350. */ QCPColorGradient::QCPColorGradient(GradientPreset preset) : mLevelCount(350), mColorInterpolation(ciRGB), mNanHandling(nhNone), mNanColor(Qt::black), mPeriodic(false), mColorBufferInvalidated(true) { mColorBuffer.fill(qRgb(0, 0, 0), mLevelCount); loadPreset(preset); } /* undocumented operator */ bool QCPColorGradient::operator==(const QCPColorGradient &other) const { return ((other.mLevelCount == this->mLevelCount) && (other.mColorInterpolation == this->mColorInterpolation) && (other.mNanHandling == this ->mNanHandling) && (other.mNanColor == this->mNanColor) && (other.mPeriodic == this->mPeriodic) && (other.mColorStops == this->mColorStops)); } /*! Sets the number of discretization levels of the color gradient to \a n. The default is 350 which is typically enough to create a smooth appearance. The minimum number of levels is 2. \image html QCPColorGradient-levelcount.png */ void QCPColorGradient::setLevelCount(int n) { if (n < 2) { qDebug() << Q_FUNC_INFO << "n must be greater or equal 2 but was" << n; n = 2; } if (n != mLevelCount) { mLevelCount = n; mColorBufferInvalidated = true; } } /*! Sets at which positions from 0 to 1 which color shall occur. The positions are the keys, the colors are the values of the passed QMap \a colorStops. In between these color stops, the color is interpolated according to \ref setColorInterpolation. A more convenient way to create a custom gradient may be to clear all color stops with \ref clearColorStops (or creating a new, empty QCPColorGradient) and then adding them one by one with \ref setColorStopAt. \see clearColorStops */ void QCPColorGradient::setColorStops(const QMap &colorStops) { mColorStops = colorStops; mColorBufferInvalidated = true; } /*! Sets the \a color the gradient will have at the specified \a position (from 0 to 1). In between these color stops, the color is interpolated according to \ref setColorInterpolation. \see setColorStops, clearColorStops */ void QCPColorGradient::setColorStopAt(double position, const QColor &color) { mColorStops.insert(position, color); mColorBufferInvalidated = true; } /*! Sets whether the colors in between the configured color stops (see \ref setColorStopAt) shall be interpolated linearly in RGB or in HSV color space. For example, a sweep in RGB space from red to green will have a muddy brown intermediate color, whereas in HSV space the intermediate color is yellow. */ void QCPColorGradient::setColorInterpolation(QCPColorGradient::ColorInterpolation interpolation) { if (interpolation != mColorInterpolation) { mColorInterpolation = interpolation; mColorBufferInvalidated = true; } } /*! Sets how NaNs in the data are displayed in the plot. \see setNanColor */ void QCPColorGradient::setNanHandling(QCPColorGradient::NanHandling handling) { mNanHandling = handling; } /*! Sets the color that NaN data is represented by, if \ref setNanHandling is set to ref nhNanColor. \see setNanHandling */ void QCPColorGradient::setNanColor(const QColor &color) { mNanColor = color; } /*! Sets whether data points that are outside the configured data range (e.g. \ref QCPColorMap::setDataRange) are colored by periodically repeating the color gradient or whether they all have the same color, corresponding to the respective gradient boundary color. \image html QCPColorGradient-periodic.png As shown in the image above, gradients that have the same start and end color are especially suitable for a periodic gradient mapping, since they produce smooth color transitions throughout the color map. A preset that has this property is \ref gpHues. In practice, using periodic color gradients makes sense when the data corresponds to a periodic dimension, such as an angle or a phase. If this is not the case, the color encoding might become ambiguous, because multiple different data values are shown as the same color. */ void QCPColorGradient::setPeriodic(bool enabled) { mPeriodic = enabled; } /*! \overload This method is used to quickly convert a \a data array to colors. The colors will be output in the array \a scanLine. Both \a data and \a scanLine must have the length \a n when passed to this function. The data range that shall be used for mapping the data value to the gradient is passed in \a range. \a logarithmic indicates whether the data values shall be mapped to colors logarithmically. if \a data actually contains 2D-data linearized via [row*columnCount + column], you can set \a dataIndexFactor to columnCount to convert a column instead of a row of the data array, in \a scanLine. \a scanLine will remain a regular (1D) array. This works because \a data is addressed data[i*dataIndexFactor]. Use the overloaded method to additionally provide alpha map data. The QRgb values that are placed in \a scanLine have their r, g, and b components premultiplied with alpha (see QImage::Format_ARGB32_Premultiplied). */ void QCPColorGradient::colorize(const double *data, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor, bool logarithmic) { // If you change something here, make sure to also adapt color() and the other colorize() overload if (!data) { qDebug() << Q_FUNC_INFO << "null pointer given as data"; return; } if (!scanLine) { qDebug() << Q_FUNC_INFO << "null pointer given as scanLine"; return; } if (mColorBufferInvalidated) updateColorBuffer(); const bool skipNanCheck = mNanHandling == nhNone; const double posToIndexFactor = !logarithmic ? (mLevelCount-1)/range.size() : (mLevelCount-1)/qLn(range.upper/range.lower); for (int i=0; i::const_iterator it=mColorStops.constBegin(); it!=mColorStops.constEnd(); ++it) result.setColorStopAt(1.0-it.key(), it.value()); return result; } /*! \internal Returns true if the color gradient uses transparency, i.e. if any of the configured color stops has an alpha value below 255. */ bool QCPColorGradient::stopsUseAlpha() const { for (QMap::const_iterator it=mColorStops.constBegin(); it!=mColorStops.constEnd(); ++it) { if (it.value().alpha() < 255) return true; } return false; } /*! \internal Updates the internal color buffer which will be used by \ref colorize and \ref color, to quickly convert positions to colors. This is where the interpolation between color stops is calculated. */ void QCPColorGradient::updateColorBuffer() { if (mColorBuffer.size() != mLevelCount) mColorBuffer.resize(mLevelCount); if (mColorStops.size() > 1) { double indexToPosFactor = 1.0/double(mLevelCount-1); const bool useAlpha = stopsUseAlpha(); for (int i=0; i::const_iterator it = mColorStops.lowerBound(position); if (it == mColorStops.constEnd()) // position is on or after last stop, use color of last stop { if (useAlpha) { const QColor col = std::prev(it).value(); const double alphaPremultiplier = col.alpha()/255.0; // since we use QImage::Format_ARGB32_Premultiplied mColorBuffer[i] = qRgba(int(col.red()*alphaPremultiplier), int(col.green()*alphaPremultiplier), int(col.blue()*alphaPremultiplier), col.alpha()); } else mColorBuffer[i] = std::prev(it).value().rgba(); } else if (it == mColorStops.constBegin()) // position is on or before first stop, use color of first stop { if (useAlpha) { const QColor &col = it.value(); const double alphaPremultiplier = col.alpha()/255.0; // since we use QImage::Format_ARGB32_Premultiplied mColorBuffer[i] = qRgba(int(col.red()*alphaPremultiplier), int(col.green()*alphaPremultiplier), int(col.blue()*alphaPremultiplier), col.alpha()); } else mColorBuffer[i] = it.value().rgba(); } else // position is in between stops (or on an intermediate stop), interpolate color { QMap::const_iterator high = it; QMap::const_iterator low = std::prev(it); double t = (position-low.key())/(high.key()-low.key()); // interpolation factor 0..1 switch (mColorInterpolation) { case ciRGB: { if (useAlpha) { const int alpha = int((1-t)*low.value().alpha() + t*high.value().alpha()); const double alphaPremultiplier = alpha/255.0; // since we use QImage::Format_ARGB32_Premultiplied mColorBuffer[i] = qRgba(int( ((1-t)*low.value().red() + t*high.value().red())*alphaPremultiplier ), int( ((1-t)*low.value().green() + t*high.value().green())*alphaPremultiplier ), int( ((1-t)*low.value().blue() + t*high.value().blue())*alphaPremultiplier ), alpha); } else { mColorBuffer[i] = qRgb(int( ((1-t)*low.value().red() + t*high.value().red()) ), int( ((1-t)*low.value().green() + t*high.value().green()) ), int( ((1-t)*low.value().blue() + t*high.value().blue())) ); } break; } case ciHSV: { QColor lowHsv = low.value().toHsv(); QColor highHsv = high.value().toHsv(); double hue = 0; double hueDiff = highHsv.hueF()-lowHsv.hueF(); if (hueDiff > 0.5) hue = lowHsv.hueF() - t*(1.0-hueDiff); else if (hueDiff < -0.5) hue = lowHsv.hueF() + t*(1.0+hueDiff); else hue = lowHsv.hueF() + t*hueDiff; if (hue < 0) hue += 1.0; else if (hue >= 1.0) hue -= 1.0; if (useAlpha) { const QRgb rgb = QColor::fromHsvF(hue, (1-t)*lowHsv.saturationF() + t*highHsv.saturationF(), (1-t)*lowHsv.valueF() + t*highHsv.valueF()).rgb(); const double alpha = (1-t)*lowHsv.alphaF() + t*highHsv.alphaF(); mColorBuffer[i] = qRgba(int(qRed(rgb)*alpha), int(qGreen(rgb)*alpha), int(qBlue(rgb)*alpha), int(255*alpha)); } else { mColorBuffer[i] = QColor::fromHsvF(hue, (1-t)*lowHsv.saturationF() + t*highHsv.saturationF(), (1-t)*lowHsv.valueF() + t*highHsv.valueF()).rgb(); } break; } } } } } else if (mColorStops.size() == 1) { const QRgb rgb = mColorStops.constBegin().value().rgb(); const double alpha = mColorStops.constBegin().value().alphaF(); mColorBuffer.fill(qRgba(int(qRed(rgb)*alpha), int(qGreen(rgb)*alpha), int(qBlue(rgb)*alpha), int(255*alpha))); } else // mColorStops is empty, fill color buffer with black { mColorBuffer.fill(qRgb(0, 0, 0)); } mColorBufferInvalidated = false; } /* end of 'src/colorgradient.cpp' */ /* including file 'src/selectiondecorator-bracket.cpp' */ /* modified 2021-03-29T02:30:44, size 12308 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPSelectionDecoratorBracket //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPSelectionDecoratorBracket \brief A selection decorator which draws brackets around each selected data segment Additionally to the regular highlighting of selected segments via color, fill and scatter style, this \ref QCPSelectionDecorator subclass draws markers at the begin and end of each selected data segment of the plottable. The shape of the markers can be controlled with \ref setBracketStyle, \ref setBracketWidth and \ref setBracketHeight. The color/fill can be controlled with \ref setBracketPen and \ref setBracketBrush. To introduce custom bracket styles, it is only necessary to sublcass \ref QCPSelectionDecoratorBracket and reimplement \ref drawBracket. The rest will be managed by the base class. */ /*! Creates a new QCPSelectionDecoratorBracket instance with default values. */ QCPSelectionDecoratorBracket::QCPSelectionDecoratorBracket() : mBracketPen(QPen(Qt::black)), mBracketBrush(Qt::NoBrush), mBracketWidth(5), mBracketHeight(50), mBracketStyle(bsSquareBracket), mTangentToData(false), mTangentAverage(2) { } QCPSelectionDecoratorBracket::~QCPSelectionDecoratorBracket() { } /*! Sets the pen that will be used to draw the brackets at the beginning and end of each selected data segment. */ void QCPSelectionDecoratorBracket::setBracketPen(const QPen &pen) { mBracketPen = pen; } /*! Sets the brush that will be used to draw the brackets at the beginning and end of each selected data segment. */ void QCPSelectionDecoratorBracket::setBracketBrush(const QBrush &brush) { mBracketBrush = brush; } /*! Sets the width of the drawn bracket. The width dimension is always parallel to the key axis of the data, or the tangent direction of the current data slope, if \ref setTangentToData is enabled. */ void QCPSelectionDecoratorBracket::setBracketWidth(int width) { mBracketWidth = width; } /*! Sets the height of the drawn bracket. The height dimension is always perpendicular to the key axis of the data, or the tangent direction of the current data slope, if \ref setTangentToData is enabled. */ void QCPSelectionDecoratorBracket::setBracketHeight(int height) { mBracketHeight = height; } /*! Sets the shape that the bracket/marker will have. \see setBracketWidth, setBracketHeight */ void QCPSelectionDecoratorBracket::setBracketStyle(QCPSelectionDecoratorBracket::BracketStyle style) { mBracketStyle = style; } /*! Sets whether the brackets will be rotated such that they align with the slope of the data at the position that they appear in. For noisy data, it might be more visually appealing to average the slope over multiple data points. This can be configured via \ref setTangentAverage. */ void QCPSelectionDecoratorBracket::setTangentToData(bool enabled) { mTangentToData = enabled; } /*! Controls over how many data points the slope shall be averaged, when brackets shall be aligned with the data (if \ref setTangentToData is true). From the position of the bracket, \a pointCount points towards the selected data range will be taken into account. The smallest value of \a pointCount is 1, which is effectively equivalent to disabling \ref setTangentToData. */ void QCPSelectionDecoratorBracket::setTangentAverage(int pointCount) { mTangentAverage = pointCount; if (mTangentAverage < 1) mTangentAverage = 1; } /*! Draws the bracket shape with \a painter. The parameter \a direction is either -1 or 1 and indicates whether the bracket shall point to the left or the right (i.e. is a closing or opening bracket, respectively). The passed \a painter already contains all transformations that are necessary to position and rotate the bracket appropriately. Painting operations can be performed as if drawing upright brackets on flat data with horizontal key axis, with (0, 0) being the center of the bracket. If you wish to sublcass \ref QCPSelectionDecoratorBracket in order to provide custom bracket shapes (see \ref QCPSelectionDecoratorBracket::bsUserStyle), this is the method you should reimplement. */ void QCPSelectionDecoratorBracket::drawBracket(QCPPainter *painter, int direction) const { switch (mBracketStyle) { case bsSquareBracket: { painter->drawLine(QLineF(mBracketWidth*direction, -mBracketHeight*0.5, 0, -mBracketHeight*0.5)); painter->drawLine(QLineF(mBracketWidth*direction, mBracketHeight*0.5, 0, mBracketHeight*0.5)); painter->drawLine(QLineF(0, -mBracketHeight*0.5, 0, mBracketHeight*0.5)); break; } case bsHalfEllipse: { painter->drawArc(QRectF(-mBracketWidth*0.5, -mBracketHeight*0.5, mBracketWidth, mBracketHeight), -90*16, -180*16*direction); break; } case bsEllipse: { painter->drawEllipse(QRectF(-mBracketWidth*0.5, -mBracketHeight*0.5, mBracketWidth, mBracketHeight)); break; } case bsPlus: { painter->drawLine(QLineF(0, -mBracketHeight*0.5, 0, mBracketHeight*0.5)); painter->drawLine(QLineF(-mBracketWidth*0.5, 0, mBracketWidth*0.5, 0)); break; } default: { qDebug() << Q_FUNC_INFO << "unknown/custom bracket style can't be handeld by default implementation:" << static_cast(mBracketStyle); break; } } } /*! Draws the bracket decoration on the data points at the begin and end of each selected data segment given in \a seletion. It uses the method \ref drawBracket to actually draw the shapes. \seebaseclassmethod */ void QCPSelectionDecoratorBracket::drawDecoration(QCPPainter *painter, QCPDataSelection selection) { if (!mPlottable || selection.isEmpty()) return; if (QCPPlottableInterface1D *interface1d = mPlottable->interface1D()) { foreach (const QCPDataRange &dataRange, selection.dataRanges()) { // determine position and (if tangent mode is enabled) angle of brackets: int openBracketDir = (mPlottable->keyAxis() && !mPlottable->keyAxis()->rangeReversed()) ? 1 : -1; int closeBracketDir = -openBracketDir; QPointF openBracketPos = getPixelCoordinates(interface1d, dataRange.begin()); QPointF closeBracketPos = getPixelCoordinates(interface1d, dataRange.end()-1); double openBracketAngle = 0; double closeBracketAngle = 0; if (mTangentToData) { openBracketAngle = getTangentAngle(interface1d, dataRange.begin(), openBracketDir); closeBracketAngle = getTangentAngle(interface1d, dataRange.end()-1, closeBracketDir); } // draw opening bracket: QTransform oldTransform = painter->transform(); painter->setPen(mBracketPen); painter->setBrush(mBracketBrush); painter->translate(openBracketPos); painter->rotate(openBracketAngle/M_PI*180.0); drawBracket(painter, openBracketDir); painter->setTransform(oldTransform); // draw closing bracket: painter->setPen(mBracketPen); painter->setBrush(mBracketBrush); painter->translate(closeBracketPos); painter->rotate(closeBracketAngle/M_PI*180.0); drawBracket(painter, closeBracketDir); painter->setTransform(oldTransform); } } } /*! \internal If \ref setTangentToData is enabled, brackets need to be rotated according to the data slope. This method returns the angle in radians by which a bracket at the given \a dataIndex must be rotated. The parameter \a direction must be set to either -1 or 1, representing whether it is an opening or closing bracket. Since for slope calculation multiple data points are required, this defines the direction in which the algorithm walks, starting at \a dataIndex, to average those data points. (see \ref setTangentToData and \ref setTangentAverage) \a interface1d is the interface to the plottable's data which is used to query data coordinates. */ double QCPSelectionDecoratorBracket::getTangentAngle(const QCPPlottableInterface1D *interface1d, int dataIndex, int direction) const { if (!interface1d || dataIndex < 0 || dataIndex >= interface1d->dataCount()) return 0; direction = direction < 0 ? -1 : 1; // enforce direction is either -1 or 1 // how many steps we can actually go from index in the given direction without exceeding data bounds: int averageCount; if (direction < 0) averageCount = qMin(mTangentAverage, dataIndex); else averageCount = qMin(mTangentAverage, interface1d->dataCount()-1-dataIndex); qDebug() << averageCount; // calculate point average of averageCount points: QVector points(averageCount); QPointF pointsAverage; int currentIndex = dataIndex; for (int i=0; ikeyAxis(); QCPAxis *valueAxis = mPlottable->valueAxis(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return {0, 0}; } if (keyAxis->orientation() == Qt::Horizontal) return {keyAxis->coordToPixel(interface1d->dataMainKey(dataIndex)), valueAxis->coordToPixel(interface1d->dataMainValue(dataIndex))}; else return {valueAxis->coordToPixel(interface1d->dataMainValue(dataIndex)), keyAxis->coordToPixel(interface1d->dataMainKey(dataIndex))}; } /* end of 'src/selectiondecorator-bracket.cpp' */ /* including file 'src/layoutelements/layoutelement-axisrect.cpp' */ /* modified 2021-03-29T02:30:44, size 47193 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAxisRect //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAxisRect \brief Holds multiple axes and arranges them in a rectangular shape. This class represents an axis rect, a rectangular area that is bounded on all sides with an arbitrary number of axes. Initially QCustomPlot has one axis rect, accessible via QCustomPlot::axisRect(). However, the layout system allows to have multiple axis rects, e.g. arranged in a grid layout (QCustomPlot::plotLayout). By default, QCPAxisRect comes with four axes, at bottom, top, left and right. They can be accessed via \ref axis by providing the respective axis type (\ref QCPAxis::AxisType) and index. If you need all axes in the axis rect, use \ref axes. The top and right axes are set to be invisible initially (QCPAxis::setVisible). To add more axes to a side, use \ref addAxis or \ref addAxes. To remove an axis, use \ref removeAxis. The axis rect layerable itself only draws a background pixmap or color, if specified (\ref setBackground). It is placed on the "background" layer initially (see \ref QCPLayer for an explanation of the QCustomPlot layer system). The axes that are held by the axis rect can be placed on other layers, independently of the axis rect. Every axis rect has a child layout of type \ref QCPLayoutInset. It is accessible via \ref insetLayout and can be used to have other layout elements (or even other layouts with multiple elements) hovering inside the axis rect. If an axis rect is clicked and dragged, it processes this by moving certain axis ranges. The behaviour can be controlled with \ref setRangeDrag and \ref setRangeDragAxes. If the mouse wheel is scrolled while the cursor is on the axis rect, certain axes are scaled. This is controllable via \ref setRangeZoom, \ref setRangeZoomAxes and \ref setRangeZoomFactor. These interactions are only enabled if \ref QCustomPlot::setInteractions contains \ref QCP::iRangeDrag and \ref QCP::iRangeZoom. \image html AxisRectSpacingOverview.png
Overview of the spacings and paddings that define the geometry of an axis. The dashed line on the far left indicates the viewport/widget border.
*/ /* start documentation of inline functions */ /*! \fn QCPLayoutInset *QCPAxisRect::insetLayout() const Returns the inset layout of this axis rect. It can be used to place other layout elements (or even layouts with multiple other elements) inside/on top of an axis rect. \see QCPLayoutInset */ /*! \fn int QCPAxisRect::left() const Returns the pixel position of the left border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPAxisRect::right() const Returns the pixel position of the right border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPAxisRect::top() const Returns the pixel position of the top border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPAxisRect::bottom() const Returns the pixel position of the bottom border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPAxisRect::width() const Returns the pixel width of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPAxisRect::height() const Returns the pixel height of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QSize QCPAxisRect::size() const Returns the pixel size of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPAxisRect::topLeft() const Returns the top left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPAxisRect::topRight() const Returns the top right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPAxisRect::bottomLeft() const Returns the bottom left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPAxisRect::bottomRight() const Returns the bottom right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPAxisRect::center() const Returns the center of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /* end documentation of inline functions */ /*! Creates a QCPAxisRect instance and sets default values. An axis is added for each of the four sides, the top and right axes are set invisible initially. */ QCPAxisRect::QCPAxisRect(QCustomPlot *parentPlot, bool setupDefaultAxes) : QCPLayoutElement(parentPlot), mBackgroundBrush(Qt::NoBrush), mBackgroundScaled(true), mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), mInsetLayout(new QCPLayoutInset), mRangeDrag(Qt::Horizontal|Qt::Vertical), mRangeZoom(Qt::Horizontal|Qt::Vertical), mRangeZoomFactorHorz(0.85), mRangeZoomFactorVert(0.85), mDragging(false) { mInsetLayout->initializeParentPlot(mParentPlot); mInsetLayout->setParentLayerable(this); mInsetLayout->setParent(this); setMinimumSize(50, 50); setMinimumMargins(QMargins(15, 15, 15, 15)); mAxes.insert(QCPAxis::atLeft, QList()); mAxes.insert(QCPAxis::atRight, QList()); mAxes.insert(QCPAxis::atTop, QList()); mAxes.insert(QCPAxis::atBottom, QList()); if (setupDefaultAxes) { QCPAxis *xAxis = addAxis(QCPAxis::atBottom); QCPAxis *yAxis = addAxis(QCPAxis::atLeft); QCPAxis *xAxis2 = addAxis(QCPAxis::atTop); QCPAxis *yAxis2 = addAxis(QCPAxis::atRight); setRangeDragAxes(xAxis, yAxis); setRangeZoomAxes(xAxis, yAxis); xAxis2->setVisible(false); yAxis2->setVisible(false); xAxis->grid()->setVisible(true); yAxis->grid()->setVisible(true); xAxis2->grid()->setVisible(false); yAxis2->grid()->setVisible(false); xAxis2->grid()->setZeroLinePen(Qt::NoPen); yAxis2->grid()->setZeroLinePen(Qt::NoPen); xAxis2->grid()->setVisible(false); yAxis2->grid()->setVisible(false); } } QCPAxisRect::~QCPAxisRect() { delete mInsetLayout; mInsetLayout = nullptr; foreach (QCPAxis *axis, axes()) removeAxis(axis); } /*! Returns the number of axes on the axis rect side specified with \a type. \see axis */ int QCPAxisRect::axisCount(QCPAxis::AxisType type) const { return mAxes.value(type).size(); } /*! Returns the axis with the given \a index on the axis rect side specified with \a type. \see axisCount, axes */ QCPAxis *QCPAxisRect::axis(QCPAxis::AxisType type, int index) const { QList ax(mAxes.value(type)); if (index >= 0 && index < ax.size()) { return ax.at(index); } else { qDebug() << Q_FUNC_INFO << "Axis index out of bounds:" << index; return nullptr; } } /*! Returns all axes on the axis rect sides specified with \a types. \a types may be a single \ref QCPAxis::AxisType or an or-combination, to get the axes of multiple sides. \see axis */ QList QCPAxisRect::axes(QCPAxis::AxisTypes types) const { QList result; if (types.testFlag(QCPAxis::atLeft)) result << mAxes.value(QCPAxis::atLeft); if (types.testFlag(QCPAxis::atRight)) result << mAxes.value(QCPAxis::atRight); if (types.testFlag(QCPAxis::atTop)) result << mAxes.value(QCPAxis::atTop); if (types.testFlag(QCPAxis::atBottom)) result << mAxes.value(QCPAxis::atBottom); return result; } /*! \overload Returns all axes of this axis rect. */ QList QCPAxisRect::axes() const { QList result; QHashIterator > it(mAxes); while (it.hasNext()) { it.next(); result << it.value(); } return result; } /*! Adds a new axis to the axis rect side specified with \a type, and returns it. If \a axis is 0, a new QCPAxis instance is created internally. QCustomPlot owns the returned axis, so if you want to remove an axis, use \ref removeAxis instead of deleting it manually. You may inject QCPAxis instances (or subclasses of QCPAxis) by setting \a axis to an axis that was previously created outside QCustomPlot. It is important to note that QCustomPlot takes ownership of the axis, so you may not delete it afterwards. Further, the \a axis must have been created with this axis rect as parent and with the same axis type as specified in \a type. If this is not the case, a debug output is generated, the axis is not added, and the method returns \c nullptr. This method can not be used to move \a axis between axis rects. The same \a axis instance must not be added multiple times to the same or different axis rects. If an axis rect side already contains one or more axes, the lower and upper endings of the new axis (\ref QCPAxis::setLowerEnding, \ref QCPAxis::setUpperEnding) are set to \ref QCPLineEnding::esHalfBar. \see addAxes, setupFullAxesBox */ QCPAxis *QCPAxisRect::addAxis(QCPAxis::AxisType type, QCPAxis *axis) { QCPAxis *newAxis = axis; if (!newAxis) { newAxis = new QCPAxis(this, type); } else // user provided existing axis instance, do some sanity checks { if (newAxis->axisType() != type) { qDebug() << Q_FUNC_INFO << "passed axis has different axis type than specified in type parameter"; return nullptr; } if (newAxis->axisRect() != this) { qDebug() << Q_FUNC_INFO << "passed axis doesn't have this axis rect as parent axis rect"; return nullptr; } if (axes().contains(newAxis)) { qDebug() << Q_FUNC_INFO << "passed axis is already owned by this axis rect"; return nullptr; } } if (!mAxes[type].isEmpty()) // multiple axes on one side, add half-bar axis ending to additional axes with offset { bool invert = (type == QCPAxis::atRight) || (type == QCPAxis::atBottom); newAxis->setLowerEnding(QCPLineEnding(QCPLineEnding::esHalfBar, 6, 10, !invert)); newAxis->setUpperEnding(QCPLineEnding(QCPLineEnding::esHalfBar, 6, 10, invert)); } mAxes[type].append(newAxis); // reset convenience axis pointers on parent QCustomPlot if they are unset: if (mParentPlot && mParentPlot->axisRectCount() > 0 && mParentPlot->axisRect(0) == this) { switch (type) { case QCPAxis::atBottom: { if (!mParentPlot->xAxis) mParentPlot->xAxis = newAxis; break; } case QCPAxis::atLeft: { if (!mParentPlot->yAxis) mParentPlot->yAxis = newAxis; break; } case QCPAxis::atTop: { if (!mParentPlot->xAxis2) mParentPlot->xAxis2 = newAxis; break; } case QCPAxis::atRight: { if (!mParentPlot->yAxis2) mParentPlot->yAxis2 = newAxis; break; } } } return newAxis; } /*! Adds a new axis with \ref addAxis to each axis rect side specified in \a types. This may be an or-combination of QCPAxis::AxisType, so axes can be added to multiple sides at once. Returns a list of the added axes. \see addAxis, setupFullAxesBox */ QList QCPAxisRect::addAxes(QCPAxis::AxisTypes types) { QList result; if (types.testFlag(QCPAxis::atLeft)) result << addAxis(QCPAxis::atLeft); if (types.testFlag(QCPAxis::atRight)) result << addAxis(QCPAxis::atRight); if (types.testFlag(QCPAxis::atTop)) result << addAxis(QCPAxis::atTop); if (types.testFlag(QCPAxis::atBottom)) result << addAxis(QCPAxis::atBottom); return result; } /*! Removes the specified \a axis from the axis rect and deletes it. Returns true on success, i.e. if \a axis was a valid axis in this axis rect. \see addAxis */ bool QCPAxisRect::removeAxis(QCPAxis *axis) { // don't access axis->axisType() to provide safety when axis is an invalid pointer, rather go through all axis containers: QHashIterator > it(mAxes); while (it.hasNext()) { it.next(); if (it.value().contains(axis)) { if (it.value().first() == axis && it.value().size() > 1) // if removing first axis, transfer axis offset to the new first axis (which at this point is the second axis, if it exists) it.value()[1]->setOffset(axis->offset()); mAxes[it.key()].removeOne(axis); if (qobject_cast(parentPlot())) // make sure this isn't called from QObject dtor when QCustomPlot is already destructed (happens when the axis rect is not in any layout and thus QObject-child of QCustomPlot) parentPlot()->axisRemoved(axis); delete axis; return true; } } qDebug() << Q_FUNC_INFO << "Axis isn't in axis rect:" << reinterpret_cast(axis); return false; } /*! Zooms in (or out) to the passed rectangular region \a pixelRect, given in pixel coordinates. All axes of this axis rect will have their range zoomed accordingly. If you only wish to zoom specific axes, use the overloaded version of this method. \see QCustomPlot::setSelectionRectMode */ void QCPAxisRect::zoom(const QRectF &pixelRect) { zoom(pixelRect, axes()); } /*! \overload Zooms in (or out) to the passed rectangular region \a pixelRect, given in pixel coordinates. Only the axes passed in \a affectedAxes will have their ranges zoomed accordingly. \see QCustomPlot::setSelectionRectMode */ void QCPAxisRect::zoom(const QRectF &pixelRect, const QList &affectedAxes) { foreach (QCPAxis *axis, affectedAxes) { if (!axis) { qDebug() << Q_FUNC_INFO << "a passed axis was zero"; continue; } QCPRange pixelRange; if (axis->orientation() == Qt::Horizontal) pixelRange = QCPRange(pixelRect.left(), pixelRect.right()); else pixelRange = QCPRange(pixelRect.top(), pixelRect.bottom()); axis->setRange(axis->pixelToCoord(pixelRange.lower), axis->pixelToCoord(pixelRange.upper)); } } /*! Convenience function to create an axis on each side that doesn't have any axes yet and set their visibility to true. Further, the top/right axes are assigned the following properties of the bottom/left axes: \li range (\ref QCPAxis::setRange) \li range reversed (\ref QCPAxis::setRangeReversed) \li scale type (\ref QCPAxis::setScaleType) \li tick visibility (\ref QCPAxis::setTicks) \li number format (\ref QCPAxis::setNumberFormat) \li number precision (\ref QCPAxis::setNumberPrecision) \li tick count of ticker (\ref QCPAxisTicker::setTickCount) \li tick origin of ticker (\ref QCPAxisTicker::setTickOrigin) Tick label visibility (\ref QCPAxis::setTickLabels) of the right and top axes are set to false. If \a connectRanges is true, the \ref QCPAxis::rangeChanged "rangeChanged" signals of the bottom and left axes are connected to the \ref QCPAxis::setRange slots of the top and right axes. */ void QCPAxisRect::setupFullAxesBox(bool connectRanges) { QCPAxis *xAxis, *yAxis, *xAxis2, *yAxis2; if (axisCount(QCPAxis::atBottom) == 0) xAxis = addAxis(QCPAxis::atBottom); else xAxis = axis(QCPAxis::atBottom); if (axisCount(QCPAxis::atLeft) == 0) yAxis = addAxis(QCPAxis::atLeft); else yAxis = axis(QCPAxis::atLeft); if (axisCount(QCPAxis::atTop) == 0) xAxis2 = addAxis(QCPAxis::atTop); else xAxis2 = axis(QCPAxis::atTop); if (axisCount(QCPAxis::atRight) == 0) yAxis2 = addAxis(QCPAxis::atRight); else yAxis2 = axis(QCPAxis::atRight); xAxis->setVisible(true); yAxis->setVisible(true); xAxis2->setVisible(true); yAxis2->setVisible(true); xAxis2->setTickLabels(false); yAxis2->setTickLabels(false); xAxis2->setRange(xAxis->range()); xAxis2->setRangeReversed(xAxis->rangeReversed()); xAxis2->setScaleType(xAxis->scaleType()); xAxis2->setTicks(xAxis->ticks()); xAxis2->setNumberFormat(xAxis->numberFormat()); xAxis2->setNumberPrecision(xAxis->numberPrecision()); xAxis2->ticker()->setTickCount(xAxis->ticker()->tickCount()); xAxis2->ticker()->setTickOrigin(xAxis->ticker()->tickOrigin()); yAxis2->setRange(yAxis->range()); yAxis2->setRangeReversed(yAxis->rangeReversed()); yAxis2->setScaleType(yAxis->scaleType()); yAxis2->setTicks(yAxis->ticks()); yAxis2->setNumberFormat(yAxis->numberFormat()); yAxis2->setNumberPrecision(yAxis->numberPrecision()); yAxis2->ticker()->setTickCount(yAxis->ticker()->tickCount()); yAxis2->ticker()->setTickOrigin(yAxis->ticker()->tickOrigin()); if (connectRanges) { connect(xAxis, SIGNAL(rangeChanged(QCPRange)), xAxis2, SLOT(setRange(QCPRange))); connect(yAxis, SIGNAL(rangeChanged(QCPRange)), yAxis2, SLOT(setRange(QCPRange))); } } /*! Returns a list of all the plottables that are associated with this axis rect. A plottable is considered associated with an axis rect if its key or value axis (or both) is in this axis rect. \see graphs, items */ QList QCPAxisRect::plottables() const { // Note: don't append all QCPAxis::plottables() into a list, because we might get duplicate entries QList result; foreach (QCPAbstractPlottable *plottable, mParentPlot->mPlottables) { if (plottable->keyAxis()->axisRect() == this || plottable->valueAxis()->axisRect() == this) result.append(plottable); } return result; } /*! Returns a list of all the graphs that are associated with this axis rect. A graph is considered associated with an axis rect if its key or value axis (or both) is in this axis rect. \see plottables, items */ QList QCPAxisRect::graphs() const { // Note: don't append all QCPAxis::graphs() into a list, because we might get duplicate entries QList result; foreach (QCPGraph *graph, mParentPlot->mGraphs) { if (graph->keyAxis()->axisRect() == this || graph->valueAxis()->axisRect() == this) result.append(graph); } return result; } /*! Returns a list of all the items that are associated with this axis rect. An item is considered associated with an axis rect if any of its positions has key or value axis set to an axis that is in this axis rect, or if any of its positions has \ref QCPItemPosition::setAxisRect set to the axis rect, or if the clip axis rect (\ref QCPAbstractItem::setClipAxisRect) is set to this axis rect. \see plottables, graphs */ QList QCPAxisRect::items() const { // Note: don't just append all QCPAxis::items() into a list, because we might get duplicate entries // and miss those items that have this axis rect as clipAxisRect. QList result; foreach (QCPAbstractItem *item, mParentPlot->mItems) { if (item->clipAxisRect() == this) { result.append(item); continue; } foreach (QCPItemPosition *position, item->positions()) { if (position->axisRect() == this || position->keyAxis()->axisRect() == this || position->valueAxis()->axisRect() == this) { result.append(item); break; } } } return result; } /*! This method is called automatically upon replot and doesn't need to be called by users of QCPAxisRect. Calls the base class implementation to update the margins (see \ref QCPLayoutElement::update), and finally passes the \ref rect to the inset layout (\ref insetLayout) and calls its QCPInsetLayout::update function. \seebaseclassmethod */ void QCPAxisRect::update(UpdatePhase phase) { QCPLayoutElement::update(phase); switch (phase) { case upPreparation: { foreach (QCPAxis *axis, axes()) axis->setupTickVectors(); break; } case upLayout: { mInsetLayout->setOuterRect(rect()); break; } default: break; } // pass update call on to inset layout (doesn't happen automatically, because QCPAxisRect doesn't derive from QCPLayout): mInsetLayout->update(phase); } /* inherits documentation from base class */ QList QCPAxisRect::elements(bool recursive) const { QList result; if (mInsetLayout) { result << mInsetLayout; if (recursive) result << mInsetLayout->elements(recursive); } return result; } /* inherits documentation from base class */ void QCPAxisRect::applyDefaultAntialiasingHint(QCPPainter *painter) const { painter->setAntialiasing(false); } /* inherits documentation from base class */ void QCPAxisRect::draw(QCPPainter *painter) { drawBackground(painter); } /*! Sets \a pm as the axis background pixmap. The axis background pixmap will be drawn inside the axis rect. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else. For cases where the provided pixmap doesn't have the same size as the axis rect, scaling can be enabled with \ref setBackgroundScaled and the scaling mode (i.e. whether and how the aspect ratio is preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, consider using the overloaded version of this function. Below the pixmap, the axis rect may be optionally filled with a brush, if specified with \ref setBackground(const QBrush &brush). \see setBackgroundScaled, setBackgroundScaledMode, setBackground(const QBrush &brush) */ void QCPAxisRect::setBackground(const QPixmap &pm) { mBackgroundPixmap = pm; mScaledBackgroundPixmap = QPixmap(); } /*! \overload Sets \a brush as the background brush. The axis rect background will be filled with this brush. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else. The brush will be drawn before (under) any background pixmap, which may be specified with \ref setBackground(const QPixmap &pm). To disable drawing of a background brush, set \a brush to Qt::NoBrush. \see setBackground(const QPixmap &pm) */ void QCPAxisRect::setBackground(const QBrush &brush) { mBackgroundBrush = brush; } /*! \overload Allows setting the background pixmap of the axis rect, whether it shall be scaled and how it shall be scaled in one call. \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode */ void QCPAxisRect::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) { mBackgroundPixmap = pm; mScaledBackgroundPixmap = QPixmap(); mBackgroundScaled = scaled; mBackgroundScaledMode = mode; } /*! Sets whether the axis background pixmap shall be scaled to fit the axis rect or not. If \a scaled is set to true, you may control whether and how the aspect ratio of the original pixmap is preserved with \ref setBackgroundScaledMode. Note that the scaled version of the original pixmap is buffered, so there is no performance penalty on replots. (Except when the axis rect dimensions are changed continuously.) \see setBackground, setBackgroundScaledMode */ void QCPAxisRect::setBackgroundScaled(bool scaled) { mBackgroundScaled = scaled; } /*! If scaling of the axis background pixmap is enabled (\ref setBackgroundScaled), use this function to define whether and how the aspect ratio of the original pixmap passed to \ref setBackground is preserved. \see setBackground, setBackgroundScaled */ void QCPAxisRect::setBackgroundScaledMode(Qt::AspectRatioMode mode) { mBackgroundScaledMode = mode; } /*! Returns the range drag axis of the \a orientation provided. If multiple axes were set, returns the first one (use \ref rangeDragAxes to retrieve a list with all set axes). \see setRangeDragAxes */ QCPAxis *QCPAxisRect::rangeDragAxis(Qt::Orientation orientation) { if (orientation == Qt::Horizontal) return mRangeDragHorzAxis.isEmpty() ? nullptr : mRangeDragHorzAxis.first().data(); else return mRangeDragVertAxis.isEmpty() ? nullptr : mRangeDragVertAxis.first().data(); } /*! Returns the range zoom axis of the \a orientation provided. If multiple axes were set, returns the first one (use \ref rangeZoomAxes to retrieve a list with all set axes). \see setRangeZoomAxes */ QCPAxis *QCPAxisRect::rangeZoomAxis(Qt::Orientation orientation) { if (orientation == Qt::Horizontal) return mRangeZoomHorzAxis.isEmpty() ? nullptr : mRangeZoomHorzAxis.first().data(); else return mRangeZoomVertAxis.isEmpty() ? nullptr : mRangeZoomVertAxis.first().data(); } /*! Returns all range drag axes of the \a orientation provided. \see rangeZoomAxis, setRangeZoomAxes */ QList QCPAxisRect::rangeDragAxes(Qt::Orientation orientation) { QList result; if (orientation == Qt::Horizontal) { foreach (QPointer axis, mRangeDragHorzAxis) { if (!axis.isNull()) result.append(axis.data()); } } else { foreach (QPointer axis, mRangeDragVertAxis) { if (!axis.isNull()) result.append(axis.data()); } } return result; } /*! Returns all range zoom axes of the \a orientation provided. \see rangeDragAxis, setRangeDragAxes */ QList QCPAxisRect::rangeZoomAxes(Qt::Orientation orientation) { QList result; if (orientation == Qt::Horizontal) { foreach (QPointer axis, mRangeZoomHorzAxis) { if (!axis.isNull()) result.append(axis.data()); } } else { foreach (QPointer axis, mRangeZoomVertAxis) { if (!axis.isNull()) result.append(axis.data()); } } return result; } /*! Returns the range zoom factor of the \a orientation provided. \see setRangeZoomFactor */ double QCPAxisRect::rangeZoomFactor(Qt::Orientation orientation) { return (orientation == Qt::Horizontal ? mRangeZoomFactorHorz : mRangeZoomFactorVert); } /*! Sets which axis orientation may be range dragged by the user with mouse interaction. What orientation corresponds to which specific axis can be set with \ref setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical). By default, the horizontal axis is the bottom axis (xAxis) and the vertical axis is the left axis (yAxis). To disable range dragging entirely, pass \c nullptr as \a orientations or remove \ref QCP::iRangeDrag from \ref QCustomPlot::setInteractions. To enable range dragging for both directions, pass Qt::Horizontal | Qt::Vertical as \a orientations. In addition to setting \a orientations to a non-zero value, make sure \ref QCustomPlot::setInteractions contains \ref QCP::iRangeDrag to enable the range dragging interaction. \see setRangeZoom, setRangeDragAxes, QCustomPlot::setNoAntialiasingOnDrag */ void QCPAxisRect::setRangeDrag(Qt::Orientations orientations) { mRangeDrag = orientations; } /*! Sets which axis orientation may be zoomed by the user with the mouse wheel. What orientation corresponds to which specific axis can be set with \ref setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical). By default, the horizontal axis is the bottom axis (xAxis) and the vertical axis is the left axis (yAxis). To disable range zooming entirely, pass \c nullptr as \a orientations or remove \ref QCP::iRangeZoom from \ref QCustomPlot::setInteractions. To enable range zooming for both directions, pass Qt::Horizontal | Qt::Vertical as \a orientations. In addition to setting \a orientations to a non-zero value, make sure \ref QCustomPlot::setInteractions contains \ref QCP::iRangeZoom to enable the range zooming interaction. \see setRangeZoomFactor, setRangeZoomAxes, setRangeDrag */ void QCPAxisRect::setRangeZoom(Qt::Orientations orientations) { mRangeZoom = orientations; } /*! \overload Sets the axes whose range will be dragged when \ref setRangeDrag enables mouse range dragging on the QCustomPlot widget. Pass \c nullptr if no axis shall be dragged in the respective orientation. Use the overload taking a list of axes, if multiple axes (more than one per orientation) shall react to dragging interactions. \see setRangeZoomAxes */ void QCPAxisRect::setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical) { QList horz, vert; if (horizontal) horz.append(horizontal); if (vertical) vert.append(vertical); setRangeDragAxes(horz, vert); } /*! \overload This method allows to set up multiple axes to react to horizontal and vertical dragging. The drag orientation that the respective axis will react to is deduced from its orientation (\ref QCPAxis::orientation). In the unusual case that you wish to e.g. drag a vertically oriented axis with a horizontal drag motion, use the overload taking two separate lists for horizontal and vertical dragging. */ void QCPAxisRect::setRangeDragAxes(QList axes) { QList horz, vert; foreach (QCPAxis *ax, axes) { if (ax->orientation() == Qt::Horizontal) horz.append(ax); else vert.append(ax); } setRangeDragAxes(horz, vert); } /*! \overload This method allows to set multiple axes up to react to horizontal and vertical dragging, and define specifically which axis reacts to which drag orientation (irrespective of the axis orientation). */ void QCPAxisRect::setRangeDragAxes(QList horizontal, QList vertical) { mRangeDragHorzAxis.clear(); foreach (QCPAxis *ax, horizontal) { QPointer axPointer(ax); if (!axPointer.isNull()) mRangeDragHorzAxis.append(axPointer); else qDebug() << Q_FUNC_INFO << "invalid axis passed in horizontal list:" << reinterpret_cast(ax); } mRangeDragVertAxis.clear(); foreach (QCPAxis *ax, vertical) { QPointer axPointer(ax); if (!axPointer.isNull()) mRangeDragVertAxis.append(axPointer); else qDebug() << Q_FUNC_INFO << "invalid axis passed in vertical list:" << reinterpret_cast(ax); } } /*! Sets the axes whose range will be zoomed when \ref setRangeZoom enables mouse wheel zooming on the QCustomPlot widget. Pass \c nullptr if no axis shall be zoomed in the respective orientation. The two axes can be zoomed with different strengths, when different factors are passed to \ref setRangeZoomFactor(double horizontalFactor, double verticalFactor). Use the overload taking a list of axes, if multiple axes (more than one per orientation) shall react to zooming interactions. \see setRangeDragAxes */ void QCPAxisRect::setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical) { QList horz, vert; if (horizontal) horz.append(horizontal); if (vertical) vert.append(vertical); setRangeZoomAxes(horz, vert); } /*! \overload This method allows to set up multiple axes to react to horizontal and vertical range zooming. The zoom orientation that the respective axis will react to is deduced from its orientation (\ref QCPAxis::orientation). In the unusual case that you wish to e.g. zoom a vertically oriented axis with a horizontal zoom interaction, use the overload taking two separate lists for horizontal and vertical zooming. */ void QCPAxisRect::setRangeZoomAxes(QList axes) { QList horz, vert; foreach (QCPAxis *ax, axes) { if (ax->orientation() == Qt::Horizontal) horz.append(ax); else vert.append(ax); } setRangeZoomAxes(horz, vert); } /*! \overload This method allows to set multiple axes up to react to horizontal and vertical zooming, and define specifically which axis reacts to which zoom orientation (irrespective of the axis orientation). */ void QCPAxisRect::setRangeZoomAxes(QList horizontal, QList vertical) { mRangeZoomHorzAxis.clear(); foreach (QCPAxis *ax, horizontal) { QPointer axPointer(ax); if (!axPointer.isNull()) mRangeZoomHorzAxis.append(axPointer); else qDebug() << Q_FUNC_INFO << "invalid axis passed in horizontal list:" << reinterpret_cast(ax); } mRangeZoomVertAxis.clear(); foreach (QCPAxis *ax, vertical) { QPointer axPointer(ax); if (!axPointer.isNull()) mRangeZoomVertAxis.append(axPointer); else qDebug() << Q_FUNC_INFO << "invalid axis passed in vertical list:" << reinterpret_cast(ax); } } /*! Sets how strong one rotation step of the mouse wheel zooms, when range zoom was activated with \ref setRangeZoom. The two parameters \a horizontalFactor and \a verticalFactor provide a way to let the horizontal axis zoom at different rates than the vertical axis. Which axis is horizontal and which is vertical, can be set with \ref setRangeZoomAxes. When the zoom factor is greater than one, scrolling the mouse wheel backwards (towards the user) will zoom in (make the currently visible range smaller). For zoom factors smaller than one, the same scrolling direction will zoom out. */ void QCPAxisRect::setRangeZoomFactor(double horizontalFactor, double verticalFactor) { mRangeZoomFactorHorz = horizontalFactor; mRangeZoomFactorVert = verticalFactor; } /*! \overload Sets both the horizontal and vertical zoom \a factor. */ void QCPAxisRect::setRangeZoomFactor(double factor) { mRangeZoomFactorHorz = factor; mRangeZoomFactorVert = factor; } /*! \internal Draws the background of this axis rect. It may consist of a background fill (a QBrush) and a pixmap. If a brush was given via \ref setBackground(const QBrush &brush), this function first draws an according filling inside the axis rect with the provided \a painter. Then, if a pixmap was provided via \ref setBackground, this function buffers the scaled version depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside the axis rect with the provided \a painter. The scaled version is buffered in mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when the axis rect has changed in a way that requires a rescale of the background pixmap (this is dependent on the \ref setBackgroundScaledMode), or when a differend axis background pixmap was set. \see setBackground, setBackgroundScaled, setBackgroundScaledMode */ void QCPAxisRect::drawBackground(QCPPainter *painter) { // draw background fill: if (mBackgroundBrush != Qt::NoBrush) painter->fillRect(mRect, mBackgroundBrush); // draw background pixmap (on top of fill, if brush specified): if (!mBackgroundPixmap.isNull()) { if (mBackgroundScaled) { // check whether mScaledBackground needs to be updated: QSize scaledSize(mBackgroundPixmap.size()); scaledSize.scale(mRect.size(), mBackgroundScaledMode); if (mScaledBackgroundPixmap.size() != scaledSize) mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mRect.size(), mBackgroundScaledMode, Qt::SmoothTransformation); painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mScaledBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height()) & mScaledBackgroundPixmap.rect()); } else { painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height())); } } } /*! \internal This function makes sure multiple axes on the side specified with \a type don't collide, but are distributed according to their respective space requirement (QCPAxis::calculateMargin). It does this by setting an appropriate offset (\ref QCPAxis::setOffset) on all axes except the one with index zero. This function is called by \ref calculateAutoMargin. */ void QCPAxisRect::updateAxesOffset(QCPAxis::AxisType type) { const QList axesList = mAxes.value(type); if (axesList.isEmpty()) return; bool isFirstVisible = !axesList.first()->visible(); // if the first axis is visible, the second axis (which is where the loop starts) isn't the first visible axis, so initialize with false for (int i=1; ioffset() + axesList.at(i-1)->calculateMargin(); if (axesList.at(i)->visible()) // only add inner tick length to offset if this axis is visible and it's not the first visible one (might happen if true first axis is invisible) { if (!isFirstVisible) offset += axesList.at(i)->tickLengthIn(); isFirstVisible = false; } axesList.at(i)->setOffset(offset); } } /* inherits documentation from base class */ int QCPAxisRect::calculateAutoMargin(QCP::MarginSide side) { if (!mAutoMargins.testFlag(side)) qDebug() << Q_FUNC_INFO << "Called with side that isn't specified as auto margin"; updateAxesOffset(QCPAxis::marginSideToAxisType(side)); // note: only need to look at the last (outer most) axis to determine the total margin, due to updateAxisOffset call const QList axesList = mAxes.value(QCPAxis::marginSideToAxisType(side)); if (!axesList.isEmpty()) return axesList.last()->offset() + axesList.last()->calculateMargin(); else return 0; } /*! \internal Reacts to a change in layout to potentially set the convenience axis pointers \ref QCustomPlot::xAxis, \ref QCustomPlot::yAxis, etc. of the parent QCustomPlot to the respective axes of this axis rect. This is only done if the respective convenience pointer is currently zero and if there is no QCPAxisRect at position (0, 0) of the plot layout. This automation makes it simpler to replace the main axis rect with a newly created one, without the need to manually reset the convenience pointers. */ void QCPAxisRect::layoutChanged() { if (mParentPlot && mParentPlot->axisRectCount() > 0 && mParentPlot->axisRect(0) == this) { if (axisCount(QCPAxis::atBottom) > 0 && !mParentPlot->xAxis) mParentPlot->xAxis = axis(QCPAxis::atBottom); if (axisCount(QCPAxis::atLeft) > 0 && !mParentPlot->yAxis) mParentPlot->yAxis = axis(QCPAxis::atLeft); if (axisCount(QCPAxis::atTop) > 0 && !mParentPlot->xAxis2) mParentPlot->xAxis2 = axis(QCPAxis::atTop); if (axisCount(QCPAxis::atRight) > 0 && !mParentPlot->yAxis2) mParentPlot->yAxis2 = axis(QCPAxis::atRight); } } /*! \internal Event handler for when a mouse button is pressed on the axis rect. If the left mouse button is pressed, the range dragging interaction is initialized (the actual range manipulation happens in the \ref mouseMoveEvent). The mDragging flag is set to true and some anchor points are set that are needed to determine the distance the mouse was dragged in the mouse move/release events later. \see mouseMoveEvent, mouseReleaseEvent */ void QCPAxisRect::mousePressEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) if (event->buttons() & Qt::LeftButton) { mDragging = true; // initialize antialiasing backup in case we start dragging: if (mParentPlot->noAntialiasingOnDrag()) { mAADragBackup = mParentPlot->antialiasedElements(); mNotAADragBackup = mParentPlot->notAntialiasedElements(); } // Mouse range dragging interaction: if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) { mDragStartHorzRange.clear(); foreach (QPointer axis, mRangeDragHorzAxis) mDragStartHorzRange.append(axis.isNull() ? QCPRange() : axis->range()); mDragStartVertRange.clear(); foreach (QPointer axis, mRangeDragVertAxis) mDragStartVertRange.append(axis.isNull() ? QCPRange() : axis->range()); } } } /*! \internal Event handler for when the mouse is moved on the axis rect. If range dragging was activated in a preceding \ref mousePressEvent, the range is moved accordingly. \see mousePressEvent, mouseReleaseEvent */ void QCPAxisRect::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(startPos) // Mouse range dragging interaction: if (mDragging && mParentPlot->interactions().testFlag(QCP::iRangeDrag)) { if (mRangeDrag.testFlag(Qt::Horizontal)) { for (int i=0; i= mDragStartHorzRange.size()) break; if (ax->mScaleType == QCPAxis::stLinear) { double diff = ax->pixelToCoord(startPos.x()) - ax->pixelToCoord(event->pos().x()); ax->setRange(mDragStartHorzRange.at(i).lower+diff, mDragStartHorzRange.at(i).upper+diff); } else if (ax->mScaleType == QCPAxis::stLogarithmic) { double diff = ax->pixelToCoord(startPos.x()) / ax->pixelToCoord(event->pos().x()); ax->setRange(mDragStartHorzRange.at(i).lower*diff, mDragStartHorzRange.at(i).upper*diff); } } } if (mRangeDrag.testFlag(Qt::Vertical)) { for (int i=0; i= mDragStartVertRange.size()) break; if (ax->mScaleType == QCPAxis::stLinear) { double diff = ax->pixelToCoord(startPos.y()) - ax->pixelToCoord(event->pos().y()); ax->setRange(mDragStartVertRange.at(i).lower+diff, mDragStartVertRange.at(i).upper+diff); } else if (ax->mScaleType == QCPAxis::stLogarithmic) { double diff = ax->pixelToCoord(startPos.y()) / ax->pixelToCoord(event->pos().y()); ax->setRange(mDragStartVertRange.at(i).lower*diff, mDragStartVertRange.at(i).upper*diff); } } } if (mRangeDrag != 0) // if either vertical or horizontal drag was enabled, do a replot { if (mParentPlot->noAntialiasingOnDrag()) mParentPlot->setNotAntialiasedElements(QCP::aeAll); mParentPlot->replot(QCustomPlot::rpQueuedReplot); } } } /* inherits documentation from base class */ void QCPAxisRect::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(event) Q_UNUSED(startPos) mDragging = false; if (mParentPlot->noAntialiasingOnDrag()) { mParentPlot->setAntialiasedElements(mAADragBackup); mParentPlot->setNotAntialiasedElements(mNotAADragBackup); } } /*! \internal Event handler for mouse wheel events. If rangeZoom is Qt::Horizontal, Qt::Vertical or both, the ranges of the axes defined as rangeZoomHorzAxis and rangeZoomVertAxis are scaled. The center of the scaling operation is the current cursor position inside the axis rect. The scaling factor is dependent on the mouse wheel delta (which direction the wheel was rotated) to provide a natural zooming feel. The Strength of the zoom can be controlled via \ref setRangeZoomFactor. Note, that event->angleDelta() is usually +/-120 for single rotation steps. However, if the mouse wheel is turned rapidly, many steps may bunch up to one event, so the delta may then be multiples of 120. This is taken into account here, by calculating \a wheelSteps and using it as exponent of the range zoom factor. This takes care of the wheel direction automatically, by inverting the factor, when the wheel step is negative (f^-1 = 1/f). */ void QCPAxisRect::wheelEvent(QWheelEvent *event) { #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) const double delta = event->delta(); #else const double delta = event->angleDelta().y(); #endif #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0) const QPointF pos = event->pos(); #else const QPointF pos = event->position(); #endif // Mouse range zooming interaction: if (mParentPlot->interactions().testFlag(QCP::iRangeZoom)) { if (mRangeZoom != 0) { double factor; double wheelSteps = delta/120.0; // a single step delta is +/-120 usually if (mRangeZoom.testFlag(Qt::Horizontal)) { factor = qPow(mRangeZoomFactorHorz, wheelSteps); foreach (QPointer axis, mRangeZoomHorzAxis) { if (!axis.isNull()) axis->scaleRange(factor, axis->pixelToCoord(pos.x())); } } if (mRangeZoom.testFlag(Qt::Vertical)) { factor = qPow(mRangeZoomFactorVert, wheelSteps); foreach (QPointer axis, mRangeZoomVertAxis) { if (!axis.isNull()) axis->scaleRange(factor, axis->pixelToCoord(pos.y())); } } mParentPlot->replot(); } } } /* end of 'src/layoutelements/layoutelement-axisrect.cpp' */ /* including file 'src/layoutelements/layoutelement-legend.cpp' */ /* modified 2021-03-29T02:30:44, size 31762 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAbstractLegendItem //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAbstractLegendItem \brief The abstract base class for all entries in a QCPLegend. It defines a very basic interface for entries in a QCPLegend. For representing plottables in the legend, the subclass \ref QCPPlottableLegendItem is more suitable. Only derive directly from this class when you need absolute freedom (e.g. a custom legend entry that's not even associated with a plottable). You must implement the following pure virtual functions: \li \ref draw (from QCPLayerable) You inherit the following members you may use:
QCPLegend *\b mParentLegend A pointer to the parent QCPLegend.
QFont \b mFont The generic font of the item. You should use this font for all or at least the most prominent text of the item.
*/ /* start of documentation of signals */ /*! \fn void QCPAbstractLegendItem::selectionChanged(bool selected) This signal is emitted when the selection state of this legend item has changed, either by user interaction or by a direct call to \ref setSelected. */ /* end of documentation of signals */ /*! Constructs a QCPAbstractLegendItem and associates it with the QCPLegend \a parent. This does not cause the item to be added to \a parent, so \ref QCPLegend::addItem must be called separately. */ QCPAbstractLegendItem::QCPAbstractLegendItem(QCPLegend *parent) : QCPLayoutElement(parent->parentPlot()), mParentLegend(parent), mFont(parent->font()), mTextColor(parent->textColor()), mSelectedFont(parent->selectedFont()), mSelectedTextColor(parent->selectedTextColor()), mSelectable(true), mSelected(false) { setLayer(QLatin1String("legend")); setMargins(QMargins(0, 0, 0, 0)); } /*! Sets the default font of this specific legend item to \a font. \see setTextColor, QCPLegend::setFont */ void QCPAbstractLegendItem::setFont(const QFont &font) { mFont = font; } /*! Sets the default text color of this specific legend item to \a color. \see setFont, QCPLegend::setTextColor */ void QCPAbstractLegendItem::setTextColor(const QColor &color) { mTextColor = color; } /*! When this legend item is selected, \a font is used to draw generic text, instead of the normal font set with \ref setFont. \see setFont, QCPLegend::setSelectedFont */ void QCPAbstractLegendItem::setSelectedFont(const QFont &font) { mSelectedFont = font; } /*! When this legend item is selected, \a color is used to draw generic text, instead of the normal color set with \ref setTextColor. \see setTextColor, QCPLegend::setSelectedTextColor */ void QCPAbstractLegendItem::setSelectedTextColor(const QColor &color) { mSelectedTextColor = color; } /*! Sets whether this specific legend item is selectable. \see setSelectedParts, QCustomPlot::setInteractions */ void QCPAbstractLegendItem::setSelectable(bool selectable) { if (mSelectable != selectable) { mSelectable = selectable; emit selectableChanged(mSelectable); } } /*! Sets whether this specific legend item is selected. It is possible to set the selection state of this item by calling this function directly, even if setSelectable is set to false. \see setSelectableParts, QCustomPlot::setInteractions */ void QCPAbstractLegendItem::setSelected(bool selected) { if (mSelected != selected) { mSelected = selected; emit selectionChanged(mSelected); } } /* inherits documentation from base class */ double QCPAbstractLegendItem::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (!mParentPlot) return -1; if (onlySelectable && (!mSelectable || !mParentLegend->selectableParts().testFlag(QCPLegend::spItems))) return -1; if (mRect.contains(pos.toPoint())) return mParentPlot->selectionTolerance()*0.99; else return -1; } /* inherits documentation from base class */ void QCPAbstractLegendItem::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeLegendItems); } /* inherits documentation from base class */ QRect QCPAbstractLegendItem::clipRect() const { return mOuterRect; } /* inherits documentation from base class */ void QCPAbstractLegendItem::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) Q_UNUSED(details) if (mSelectable && mParentLegend->selectableParts().testFlag(QCPLegend::spItems)) { bool selBefore = mSelected; setSelected(additive ? !mSelected : true); if (selectionStateChanged) *selectionStateChanged = mSelected != selBefore; } } /* inherits documentation from base class */ void QCPAbstractLegendItem::deselectEvent(bool *selectionStateChanged) { if (mSelectable && mParentLegend->selectableParts().testFlag(QCPLegend::spItems)) { bool selBefore = mSelected; setSelected(false); if (selectionStateChanged) *selectionStateChanged = mSelected != selBefore; } } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPlottableLegendItem //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPlottableLegendItem \brief A legend item representing a plottable with an icon and the plottable name. This is the standard legend item for plottables. It displays an icon of the plottable next to the plottable name. The icon is drawn by the respective plottable itself (\ref QCPAbstractPlottable::drawLegendIcon), and tries to give an intuitive symbol for the plottable. For example, the QCPGraph draws a centered horizontal line and/or a single scatter point in the middle. Legend items of this type are always associated with one plottable (retrievable via the plottable() function and settable with the constructor). You may change the font of the plottable name with \ref setFont. Icon padding and border pen is taken from the parent QCPLegend, see \ref QCPLegend::setIconBorderPen and \ref QCPLegend::setIconTextPadding. The function \ref QCPAbstractPlottable::addToLegend/\ref QCPAbstractPlottable::removeFromLegend creates/removes legend items of this type. Since QCPLegend is based on QCPLayoutGrid, a legend item itself is just a subclass of QCPLayoutElement. While it could be added to a legend (or any other layout) via the normal layout interface, QCPLegend has specialized functions for handling legend items conveniently, see the documentation of \ref QCPLegend. */ /*! Creates a new legend item associated with \a plottable. Once it's created, it can be added to the legend via \ref QCPLegend::addItem. A more convenient way of adding/removing a plottable to/from the legend is via the functions \ref QCPAbstractPlottable::addToLegend and \ref QCPAbstractPlottable::removeFromLegend. */ QCPPlottableLegendItem::QCPPlottableLegendItem(QCPLegend *parent, QCPAbstractPlottable *plottable) : QCPAbstractLegendItem(parent), mPlottable(plottable) { setAntialiased(false); } /*! \internal Returns the pen that shall be used to draw the icon border, taking into account the selection state of this item. */ QPen QCPPlottableLegendItem::getIconBorderPen() const { return mSelected ? mParentLegend->selectedIconBorderPen() : mParentLegend->iconBorderPen(); } /*! \internal Returns the text color that shall be used to draw text, taking into account the selection state of this item. */ QColor QCPPlottableLegendItem::getTextColor() const { return mSelected ? mSelectedTextColor : mTextColor; } /*! \internal Returns the font that shall be used to draw text, taking into account the selection state of this item. */ QFont QCPPlottableLegendItem::getFont() const { return mSelected ? mSelectedFont : mFont; } /*! \internal Draws the item with \a painter. The size and position of the drawn legend item is defined by the parent layout (typically a \ref QCPLegend) and the \ref minimumOuterSizeHint and \ref maximumOuterSizeHint of this legend item. */ void QCPPlottableLegendItem::draw(QCPPainter *painter) { if (!mPlottable) return; painter->setFont(getFont()); painter->setPen(QPen(getTextColor())); QSize iconSize = mParentLegend->iconSize(); QRect textRect = painter->fontMetrics().boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPlottable->name()); QRect iconRect(mRect.topLeft(), iconSize); int textHeight = qMax(textRect.height(), iconSize.height()); // if text has smaller height than icon, center text vertically in icon height, else align tops painter->drawText(mRect.x()+iconSize.width()+mParentLegend->iconTextPadding(), mRect.y(), textRect.width(), textHeight, Qt::TextDontClip, mPlottable->name()); // draw icon: painter->save(); painter->setClipRect(iconRect, Qt::IntersectClip); mPlottable->drawLegendIcon(painter, iconRect); painter->restore(); // draw icon border: if (getIconBorderPen().style() != Qt::NoPen) { painter->setPen(getIconBorderPen()); painter->setBrush(Qt::NoBrush); int halfPen = qCeil(painter->pen().widthF()*0.5)+1; painter->setClipRect(mOuterRect.adjusted(-halfPen, -halfPen, halfPen, halfPen)); // extend default clip rect so thicker pens (especially during selection) are not clipped painter->drawRect(iconRect); } } /*! \internal Calculates and returns the size of this item. This includes the icon, the text and the padding in between. \seebaseclassmethod */ QSize QCPPlottableLegendItem::minimumOuterSizeHint() const { if (!mPlottable) return {}; QSize result(0, 0); QRect textRect; QFontMetrics fontMetrics(getFont()); QSize iconSize = mParentLegend->iconSize(); textRect = fontMetrics.boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPlottable->name()); result.setWidth(iconSize.width() + mParentLegend->iconTextPadding() + textRect.width()); result.setHeight(qMax(textRect.height(), iconSize.height())); result.rwidth() += mMargins.left()+mMargins.right(); result.rheight() += mMargins.top()+mMargins.bottom(); return result; } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPLegend //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPLegend \brief Manages a legend inside a QCustomPlot. A legend is a small box somewhere in the plot which lists plottables with their name and icon. A legend is populated with legend items by calling \ref QCPAbstractPlottable::addToLegend on the plottable, for which a legend item shall be created. In the case of the main legend (\ref QCustomPlot::legend), simply adding plottables to the plot while \ref QCustomPlot::setAutoAddPlottableToLegend is set to true (the default) creates corresponding legend items. The legend item associated with a certain plottable can be removed with \ref QCPAbstractPlottable::removeFromLegend. However, QCPLegend also offers an interface to add and manipulate legend items directly: \ref item, \ref itemWithPlottable, \ref itemCount, \ref addItem, \ref removeItem, etc. Since \ref QCPLegend derives from \ref QCPLayoutGrid, it can be placed in any position a \ref QCPLayoutElement may be positioned. The legend items are themselves \ref QCPLayoutElement "QCPLayoutElements" which are placed in the grid layout of the legend. \ref QCPLegend only adds an interface specialized for handling child elements of type \ref QCPAbstractLegendItem, as mentioned above. In principle, any other layout elements may also be added to a legend via the normal \ref QCPLayoutGrid interface. See the special page about \link thelayoutsystem The Layout System\endlink for examples on how to add other elements to the legend and move it outside the axis rect. Use the methods \ref setFillOrder and \ref setWrap inherited from \ref QCPLayoutGrid to control in which order (column first or row first) the legend is filled up when calling \ref addItem, and at which column or row wrapping occurs. The default fill order for legends is \ref foRowsFirst. By default, every QCustomPlot has one legend (\ref QCustomPlot::legend) which is placed in the inset layout of the main axis rect (\ref QCPAxisRect::insetLayout). To move the legend to another position inside the axis rect, use the methods of the \ref QCPLayoutInset. To move the legend outside of the axis rect, place it anywhere else with the \ref QCPLayout/\ref QCPLayoutElement interface. */ /* start of documentation of signals */ /*! \fn void QCPLegend::selectionChanged(QCPLegend::SelectableParts selection); This signal is emitted when the selection state of this legend has changed. \see setSelectedParts, setSelectableParts */ /* end of documentation of signals */ /*! Constructs a new QCPLegend instance with default values. Note that by default, QCustomPlot already contains a legend ready to be used as \ref QCustomPlot::legend */ QCPLegend::QCPLegend() : mIconTextPadding{} { setFillOrder(QCPLayoutGrid::foRowsFirst); setWrap(0); setRowSpacing(3); setColumnSpacing(8); setMargins(QMargins(7, 5, 7, 4)); setAntialiased(false); setIconSize(32, 18); setIconTextPadding(7); setSelectableParts(spLegendBox | spItems); setSelectedParts(spNone); setBorderPen(QPen(Qt::black, 0)); setSelectedBorderPen(QPen(Qt::blue, 2)); setIconBorderPen(Qt::NoPen); setSelectedIconBorderPen(QPen(Qt::blue, 2)); setBrush(Qt::white); setSelectedBrush(Qt::white); setTextColor(Qt::black); setSelectedTextColor(Qt::blue); } QCPLegend::~QCPLegend() { clearItems(); if (qobject_cast(mParentPlot)) // make sure this isn't called from QObject dtor when QCustomPlot is already destructed (happens when the legend is not in any layout and thus QObject-child of QCustomPlot) mParentPlot->legendRemoved(this); } /* no doc for getter, see setSelectedParts */ QCPLegend::SelectableParts QCPLegend::selectedParts() const { // check whether any legend elements selected, if yes, add spItems to return value bool hasSelectedItems = false; for (int i=0; iselected()) { hasSelectedItems = true; break; } } if (hasSelectedItems) return mSelectedParts | spItems; else return mSelectedParts & ~spItems; } /*! Sets the pen, the border of the entire legend is drawn with. */ void QCPLegend::setBorderPen(const QPen &pen) { mBorderPen = pen; } /*! Sets the brush of the legend background. */ void QCPLegend::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the default font of legend text. Legend items that draw text (e.g. the name of a graph) will use this font by default. However, a different font can be specified on a per-item-basis by accessing the specific legend item. This function will also set \a font on all already existing legend items. \see QCPAbstractLegendItem::setFont */ void QCPLegend::setFont(const QFont &font) { mFont = font; for (int i=0; isetFont(mFont); } } /*! Sets the default color of legend text. Legend items that draw text (e.g. the name of a graph) will use this color by default. However, a different colors can be specified on a per-item-basis by accessing the specific legend item. This function will also set \a color on all already existing legend items. \see QCPAbstractLegendItem::setTextColor */ void QCPLegend::setTextColor(const QColor &color) { mTextColor = color; for (int i=0; isetTextColor(color); } } /*! Sets the size of legend icons. Legend items that draw an icon (e.g. a visual representation of the graph) will use this size by default. */ void QCPLegend::setIconSize(const QSize &size) { mIconSize = size; } /*! \overload */ void QCPLegend::setIconSize(int width, int height) { mIconSize.setWidth(width); mIconSize.setHeight(height); } /*! Sets the horizontal space in pixels between the legend icon and the text next to it. Legend items that draw an icon (e.g. a visual representation of the graph) and text (e.g. the name of the graph) will use this space by default. */ void QCPLegend::setIconTextPadding(int padding) { mIconTextPadding = padding; } /*! Sets the pen used to draw a border around each legend icon. Legend items that draw an icon (e.g. a visual representation of the graph) will use this pen by default. If no border is wanted, set this to \a Qt::NoPen. */ void QCPLegend::setIconBorderPen(const QPen &pen) { mIconBorderPen = pen; } /*! Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. (When \ref QCustomPlot::setInteractions contains \ref QCP::iSelectLegend.) However, even when \a selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling \ref setSelectedParts directly. \see SelectablePart, setSelectedParts */ void QCPLegend::setSelectableParts(const SelectableParts &selectable) { if (mSelectableParts != selectable) { mSelectableParts = selectable; emit selectableChanged(mSelectableParts); } } /*! Sets the selected state of the respective legend parts described by \ref SelectablePart. When a part is selected, it uses a different pen/font and brush. If some legend items are selected and \a selected doesn't contain \ref spItems, those items become deselected. The entire selection mechanism is handled automatically when \ref QCustomPlot::setInteractions contains iSelectLegend. You only need to call this function when you wish to change the selection state manually. This function can change the selection state of a part even when \ref setSelectableParts was set to a value that actually excludes the part. emits the \ref selectionChanged signal when \a selected is different from the previous selection state. Note that it doesn't make sense to set the selected state \ref spItems here when it wasn't set before, because there's no way to specify which exact items to newly select. Do this by calling \ref QCPAbstractLegendItem::setSelected directly on the legend item you wish to select. \see SelectablePart, setSelectableParts, selectTest, setSelectedBorderPen, setSelectedIconBorderPen, setSelectedBrush, setSelectedFont */ void QCPLegend::setSelectedParts(const SelectableParts &selected) { SelectableParts newSelected = selected; mSelectedParts = this->selectedParts(); // update mSelectedParts in case item selection changed if (mSelectedParts != newSelected) { if (!mSelectedParts.testFlag(spItems) && newSelected.testFlag(spItems)) // attempt to set spItems flag (can't do that) { qDebug() << Q_FUNC_INFO << "spItems flag can not be set, it can only be unset with this function"; newSelected &= ~spItems; } if (mSelectedParts.testFlag(spItems) && !newSelected.testFlag(spItems)) // spItems flag was unset, so clear item selection { for (int i=0; isetSelected(false); } } mSelectedParts = newSelected; emit selectionChanged(mSelectedParts); } } /*! When the legend box is selected, this pen is used to draw the border instead of the normal pen set via \ref setBorderPen. \see setSelectedParts, setSelectableParts, setSelectedBrush */ void QCPLegend::setSelectedBorderPen(const QPen &pen) { mSelectedBorderPen = pen; } /*! Sets the pen legend items will use to draw their icon borders, when they are selected. \see setSelectedParts, setSelectableParts, setSelectedFont */ void QCPLegend::setSelectedIconBorderPen(const QPen &pen) { mSelectedIconBorderPen = pen; } /*! When the legend box is selected, this brush is used to draw the legend background instead of the normal brush set via \ref setBrush. \see setSelectedParts, setSelectableParts, setSelectedBorderPen */ void QCPLegend::setSelectedBrush(const QBrush &brush) { mSelectedBrush = brush; } /*! Sets the default font that is used by legend items when they are selected. This function will also set \a font on all already existing legend items. \see setFont, QCPAbstractLegendItem::setSelectedFont */ void QCPLegend::setSelectedFont(const QFont &font) { mSelectedFont = font; for (int i=0; isetSelectedFont(font); } } /*! Sets the default text color that is used by legend items when they are selected. This function will also set \a color on all already existing legend items. \see setTextColor, QCPAbstractLegendItem::setSelectedTextColor */ void QCPLegend::setSelectedTextColor(const QColor &color) { mSelectedTextColor = color; for (int i=0; isetSelectedTextColor(color); } } /*! Returns the item with index \a i. If non-legend items were added to the legend, and the element at the specified cell index is not a QCPAbstractLegendItem, returns \c nullptr. Note that the linear index depends on the current fill order (\ref setFillOrder). \see itemCount, addItem, itemWithPlottable */ QCPAbstractLegendItem *QCPLegend::item(int index) const { return qobject_cast(elementAt(index)); } /*! Returns the QCPPlottableLegendItem which is associated with \a plottable (e.g. a \ref QCPGraph*). If such an item isn't in the legend, returns \c nullptr. \see hasItemWithPlottable */ QCPPlottableLegendItem *QCPLegend::itemWithPlottable(const QCPAbstractPlottable *plottable) const { for (int i=0; i(item(i))) { if (pli->plottable() == plottable) return pli; } } return nullptr; } /*! Returns the number of items currently in the legend. It is identical to the base class QCPLayoutGrid::elementCount(), and unlike the other "item" interface methods of QCPLegend, doesn't only address elements which can be cast to QCPAbstractLegendItem. Note that if empty cells are in the legend (e.g. by calling methods of the \ref QCPLayoutGrid base class which allows creating empty cells), they are included in the returned count. \see item */ int QCPLegend::itemCount() const { return elementCount(); } /*! Returns whether the legend contains \a item. \see hasItemWithPlottable */ bool QCPLegend::hasItem(QCPAbstractLegendItem *item) const { for (int i=0; iitem(i)) return true; } return false; } /*! Returns whether the legend contains a QCPPlottableLegendItem which is associated with \a plottable (e.g. a \ref QCPGraph*). If such an item isn't in the legend, returns false. \see itemWithPlottable */ bool QCPLegend::hasItemWithPlottable(const QCPAbstractPlottable *plottable) const { return itemWithPlottable(plottable); } /*! Adds \a item to the legend, if it's not present already. The element is arranged according to the current fill order (\ref setFillOrder) and wrapping (\ref setWrap). Returns true on sucess, i.e. if the item wasn't in the list already and has been successfuly added. The legend takes ownership of the item. \see removeItem, item, hasItem */ bool QCPLegend::addItem(QCPAbstractLegendItem *item) { return addElement(item); } /*! \overload Removes the item with the specified \a index from the legend and deletes it. After successful removal, the legend is reordered according to the current fill order (\ref setFillOrder) and wrapping (\ref setWrap), so no empty cell remains where the removed \a item was. If you don't want this, rather use the raw element interface of \ref QCPLayoutGrid. Returns true, if successful. Unlike \ref QCPLayoutGrid::removeAt, this method only removes elements derived from \ref QCPAbstractLegendItem. \see itemCount, clearItems */ bool QCPLegend::removeItem(int index) { if (QCPAbstractLegendItem *ali = item(index)) { bool success = remove(ali); if (success) setFillOrder(fillOrder(), true); // gets rid of empty cell by reordering return success; } else return false; } /*! \overload Removes \a item from the legend and deletes it. After successful removal, the legend is reordered according to the current fill order (\ref setFillOrder) and wrapping (\ref setWrap), so no empty cell remains where the removed \a item was. If you don't want this, rather use the raw element interface of \ref QCPLayoutGrid. Returns true, if successful. \see clearItems */ bool QCPLegend::removeItem(QCPAbstractLegendItem *item) { bool success = remove(item); if (success) setFillOrder(fillOrder(), true); // gets rid of empty cell by reordering return success; } /*! Removes all items from the legend. */ void QCPLegend::clearItems() { for (int i=elementCount()-1; i>=0; --i) { if (item(i)) removeAt(i); // don't use removeItem() because it would unnecessarily reorder the whole legend for each item } setFillOrder(fillOrder(), true); // get rid of empty cells by reordering once after all items are removed } /*! Returns the legend items that are currently selected. If no items are selected, the list is empty. \see QCPAbstractLegendItem::setSelected, setSelectable */ QList QCPLegend::selectedItems() const { QList result; for (int i=0; iselected()) result.append(ali); } } return result; } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing main legend elements. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \seebaseclassmethod \see setAntialiased */ void QCPLegend::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeLegend); } /*! \internal Returns the pen used to paint the border of the legend, taking into account the selection state of the legend box. */ QPen QCPLegend::getBorderPen() const { return mSelectedParts.testFlag(spLegendBox) ? mSelectedBorderPen : mBorderPen; } /*! \internal Returns the brush used to paint the background of the legend, taking into account the selection state of the legend box. */ QBrush QCPLegend::getBrush() const { return mSelectedParts.testFlag(spLegendBox) ? mSelectedBrush : mBrush; } /*! \internal Draws the legend box with the provided \a painter. The individual legend items are layerables themselves, thus are drawn independently. */ void QCPLegend::draw(QCPPainter *painter) { // draw background rect: painter->setBrush(getBrush()); painter->setPen(getBorderPen()); painter->drawRect(mOuterRect); } /* inherits documentation from base class */ double QCPLegend::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if (!mParentPlot) return -1; if (onlySelectable && !mSelectableParts.testFlag(spLegendBox)) return -1; if (mOuterRect.contains(pos.toPoint())) { if (details) details->setValue(spLegendBox); return mParentPlot->selectionTolerance()*0.99; } return -1; } /* inherits documentation from base class */ void QCPLegend::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) mSelectedParts = selectedParts(); // in case item selection has changed if (details.value() == spLegendBox && mSelectableParts.testFlag(spLegendBox)) { SelectableParts selBefore = mSelectedParts; setSelectedParts(additive ? mSelectedParts^spLegendBox : mSelectedParts|spLegendBox); // no need to unset spItems in !additive case, because they will be deselected by QCustomPlot (they're normal QCPLayerables with own deselectEvent) if (selectionStateChanged) *selectionStateChanged = mSelectedParts != selBefore; } } /* inherits documentation from base class */ void QCPLegend::deselectEvent(bool *selectionStateChanged) { mSelectedParts = selectedParts(); // in case item selection has changed if (mSelectableParts.testFlag(spLegendBox)) { SelectableParts selBefore = mSelectedParts; setSelectedParts(selectedParts() & ~spLegendBox); if (selectionStateChanged) *selectionStateChanged = mSelectedParts != selBefore; } } /* inherits documentation from base class */ QCP::Interaction QCPLegend::selectionCategory() const { return QCP::iSelectLegend; } /* inherits documentation from base class */ QCP::Interaction QCPAbstractLegendItem::selectionCategory() const { return QCP::iSelectLegend; } /* inherits documentation from base class */ void QCPLegend::parentPlotInitialized(QCustomPlot *parentPlot) { if (parentPlot && !parentPlot->legend) parentPlot->legend = this; } /* end of 'src/layoutelements/layoutelement-legend.cpp' */ /* including file 'src/layoutelements/layoutelement-textelement.cpp' */ /* modified 2021-03-29T02:30:44, size 12925 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPTextElement //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPTextElement \brief A layout element displaying a text The text may be specified with \ref setText, the formatting can be controlled with \ref setFont, \ref setTextColor, and \ref setTextFlags. A text element can be added as follows: \snippet documentation/doc-code-snippets/mainwindow.cpp qcptextelement-creation */ /* start documentation of signals */ /*! \fn void QCPTextElement::selectionChanged(bool selected) This signal is emitted when the selection state has changed to \a selected, either by user interaction or by a direct call to \ref setSelected. \see setSelected, setSelectable */ /*! \fn void QCPTextElement::clicked(QMouseEvent *event) This signal is emitted when the text element is clicked. \see doubleClicked, selectTest */ /*! \fn void QCPTextElement::doubleClicked(QMouseEvent *event) This signal is emitted when the text element is double clicked. \see clicked, selectTest */ /* end documentation of signals */ /*! \overload Creates a new QCPTextElement instance and sets default values. The initial text is empty (\ref setText). */ QCPTextElement::QCPTextElement(QCustomPlot *parentPlot) : QCPLayoutElement(parentPlot), mText(), mTextFlags(Qt::AlignCenter), mFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below mTextColor(Qt::black), mSelectedFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below mSelectedTextColor(Qt::blue), mSelectable(false), mSelected(false) { if (parentPlot) { mFont = parentPlot->font(); mSelectedFont = parentPlot->font(); } setMargins(QMargins(2, 2, 2, 2)); } /*! \overload Creates a new QCPTextElement instance and sets default values. The initial text is set to \a text. */ QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text) : QCPLayoutElement(parentPlot), mText(text), mTextFlags(Qt::AlignCenter), mFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below mTextColor(Qt::black), mSelectedFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below mSelectedTextColor(Qt::blue), mSelectable(false), mSelected(false) { if (parentPlot) { mFont = parentPlot->font(); mSelectedFont = parentPlot->font(); } setMargins(QMargins(2, 2, 2, 2)); } /*! \overload Creates a new QCPTextElement instance and sets default values. The initial text is set to \a text with \a pointSize. */ QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text, double pointSize) : QCPLayoutElement(parentPlot), mText(text), mTextFlags(Qt::AlignCenter), mFont(QFont(QLatin1String("sans serif"), int(pointSize))), // will be taken from parentPlot if available, see below mTextColor(Qt::black), mSelectedFont(QFont(QLatin1String("sans serif"), int(pointSize))), // will be taken from parentPlot if available, see below mSelectedTextColor(Qt::blue), mSelectable(false), mSelected(false) { mFont.setPointSizeF(pointSize); // set here again as floating point, because constructor above only takes integer if (parentPlot) { mFont = parentPlot->font(); mFont.setPointSizeF(pointSize); mSelectedFont = parentPlot->font(); mSelectedFont.setPointSizeF(pointSize); } setMargins(QMargins(2, 2, 2, 2)); } /*! \overload Creates a new QCPTextElement instance and sets default values. The initial text is set to \a text with \a pointSize and the specified \a fontFamily. */ QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QString &fontFamily, double pointSize) : QCPLayoutElement(parentPlot), mText(text), mTextFlags(Qt::AlignCenter), mFont(QFont(fontFamily, int(pointSize))), mTextColor(Qt::black), mSelectedFont(QFont(fontFamily, int(pointSize))), mSelectedTextColor(Qt::blue), mSelectable(false), mSelected(false) { mFont.setPointSizeF(pointSize); // set here again as floating point, because constructor above only takes integer setMargins(QMargins(2, 2, 2, 2)); } /*! \overload Creates a new QCPTextElement instance and sets default values. The initial text is set to \a text with the specified \a font. */ QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QFont &font) : QCPLayoutElement(parentPlot), mText(text), mTextFlags(Qt::AlignCenter), mFont(font), mTextColor(Qt::black), mSelectedFont(font), mSelectedTextColor(Qt::blue), mSelectable(false), mSelected(false) { setMargins(QMargins(2, 2, 2, 2)); } /*! Sets the text that will be displayed to \a text. Multiple lines can be created by insertion of "\n". \see setFont, setTextColor, setTextFlags */ void QCPTextElement::setText(const QString &text) { mText = text; } /*! Sets options for text alignment and wrapping behaviour. \a flags is a bitwise OR-combination of \c Qt::AlignmentFlag and \c Qt::TextFlag enums. Possible enums are: - Qt::AlignLeft - Qt::AlignRight - Qt::AlignHCenter - Qt::AlignJustify - Qt::AlignTop - Qt::AlignBottom - Qt::AlignVCenter - Qt::AlignCenter - Qt::TextDontClip - Qt::TextSingleLine - Qt::TextExpandTabs - Qt::TextShowMnemonic - Qt::TextWordWrap - Qt::TextIncludeTrailingSpaces */ void QCPTextElement::setTextFlags(int flags) { mTextFlags = flags; } /*! Sets the \a font of the text. \see setTextColor, setSelectedFont */ void QCPTextElement::setFont(const QFont &font) { mFont = font; } /*! Sets the \a color of the text. \see setFont, setSelectedTextColor */ void QCPTextElement::setTextColor(const QColor &color) { mTextColor = color; } /*! Sets the \a font of the text that will be used if the text element is selected (\ref setSelected). \see setFont */ void QCPTextElement::setSelectedFont(const QFont &font) { mSelectedFont = font; } /*! Sets the \a color of the text that will be used if the text element is selected (\ref setSelected). \see setTextColor */ void QCPTextElement::setSelectedTextColor(const QColor &color) { mSelectedTextColor = color; } /*! Sets whether the user may select this text element. Note that even when \a selectable is set to false, the selection state may be changed programmatically via \ref setSelected. */ void QCPTextElement::setSelectable(bool selectable) { if (mSelectable != selectable) { mSelectable = selectable; emit selectableChanged(mSelectable); } } /*! Sets the selection state of this text element to \a selected. If the selection has changed, \ref selectionChanged is emitted. Note that this function can change the selection state independently of the current \ref setSelectable state. */ void QCPTextElement::setSelected(bool selected) { if (mSelected != selected) { mSelected = selected; emit selectionChanged(mSelected); } } /* inherits documentation from base class */ void QCPTextElement::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeOther); } /* inherits documentation from base class */ void QCPTextElement::draw(QCPPainter *painter) { painter->setFont(mainFont()); painter->setPen(QPen(mainTextColor())); painter->drawText(mRect, mTextFlags, mText, &mTextBoundingRect); } /* inherits documentation from base class */ QSize QCPTextElement::minimumOuterSizeHint() const { QFontMetrics metrics(mFont); QSize result(metrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip, mText).size()); result.rwidth() += mMargins.left()+mMargins.right(); result.rheight() += mMargins.top()+mMargins.bottom(); return result; } /* inherits documentation from base class */ QSize QCPTextElement::maximumOuterSizeHint() const { QFontMetrics metrics(mFont); QSize result(metrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip, mText).size()); result.setWidth(QWIDGETSIZE_MAX); result.rheight() += mMargins.top()+mMargins.bottom(); return result; } /* inherits documentation from base class */ void QCPTextElement::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) Q_UNUSED(details) if (mSelectable) { bool selBefore = mSelected; setSelected(additive ? !mSelected : true); if (selectionStateChanged) *selectionStateChanged = mSelected != selBefore; } } /* inherits documentation from base class */ void QCPTextElement::deselectEvent(bool *selectionStateChanged) { if (mSelectable) { bool selBefore = mSelected; setSelected(false); if (selectionStateChanged) *selectionStateChanged = mSelected != selBefore; } } /*! Returns 0.99*selectionTolerance (see \ref QCustomPlot::setSelectionTolerance) when \a pos is within the bounding box of the text element's text. Note that this bounding box is updated in the draw call. If \a pos is outside the text's bounding box or if \a onlySelectable is true and this text element is not selectable (\ref setSelectable), returns -1. \seebaseclassmethod */ double QCPTextElement::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; if (mTextBoundingRect.contains(pos.toPoint())) return mParentPlot->selectionTolerance()*0.99; else return -1; } /*! Accepts the mouse event in order to emit the according click signal in the \ref mouseReleaseEvent. \seebaseclassmethod */ void QCPTextElement::mousePressEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) event->accept(); } /*! Emits the \ref clicked signal if the cursor hasn't moved by more than a few pixels since the \ref mousePressEvent. \seebaseclassmethod */ void QCPTextElement::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { if ((QPointF(event->pos())-startPos).manhattanLength() <= 3) emit clicked(event); } /*! Emits the \ref doubleClicked signal. \seebaseclassmethod */ void QCPTextElement::mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) emit doubleClicked(event); } /*! \internal Returns the main font to be used. This is mSelectedFont if \ref setSelected is set to true, else mFont is returned. */ QFont QCPTextElement::mainFont() const { return mSelected ? mSelectedFont : mFont; } /*! \internal Returns the main color to be used. This is mSelectedTextColor if \ref setSelected is set to true, else mTextColor is returned. */ QColor QCPTextElement::mainTextColor() const { return mSelected ? mSelectedTextColor : mTextColor; } /* end of 'src/layoutelements/layoutelement-textelement.cpp' */ /* including file 'src/layoutelements/layoutelement-colorscale.cpp' */ /* modified 2021-03-29T02:30:44, size 26531 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPColorScale //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPColorScale \brief A color scale for use with color coding data such as QCPColorMap This layout element can be placed on the plot to correlate a color gradient with data values. It is usually used in combination with one or multiple \ref QCPColorMap "QCPColorMaps". \image html QCPColorScale.png The color scale can be either horizontal or vertical, as shown in the image above. The orientation and the side where the numbers appear is controlled with \ref setType. Use \ref QCPColorMap::setColorScale to connect a color map with a color scale. Once they are connected, they share their gradient, data range and data scale type (\ref setGradient, \ref setDataRange, \ref setDataScaleType). Multiple color maps may be associated with a single color scale, to make them all synchronize these properties. To have finer control over the number display and axis behaviour, you can directly access the \ref axis. See the documentation of QCPAxis for details about configuring axes. For example, if you want to change the number of automatically generated ticks, call \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-tickcount Placing a color scale next to the main axis rect works like with any other layout element: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-creation In this case we have placed it to the right of the default axis rect, so it wasn't necessary to call \ref setType, since \ref QCPAxis::atRight is already the default. The text next to the color scale can be set with \ref setLabel. For optimum appearance (like in the image above), it may be desirable to line up the axis rect and the borders of the color scale. Use a \ref QCPMarginGroup to achieve this: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-margingroup Color scales are initialized with a non-zero minimum top and bottom margin (\ref setMinimumMargins), because vertical color scales are most common and the minimum top/bottom margin makes sure it keeps some distance to the top/bottom widget border. So if you change to a horizontal color scale by setting \ref setType to \ref QCPAxis::atBottom or \ref QCPAxis::atTop, you might want to also change the minimum margins accordingly, e.g. setMinimumMargins(QMargins(6, 0, 6, 0)). */ /* start documentation of inline functions */ /*! \fn QCPAxis *QCPColorScale::axis() const Returns the internal \ref QCPAxis instance of this color scale. You can access it to alter the appearance and behaviour of the axis. \ref QCPColorScale duplicates some properties in its interface for convenience. Those are \ref setDataRange (\ref QCPAxis::setRange), \ref setDataScaleType (\ref QCPAxis::setScaleType), and the method \ref setLabel (\ref QCPAxis::setLabel). As they each are connected, it does not matter whether you use the method on the QCPColorScale or on its QCPAxis. If the type of the color scale is changed with \ref setType, the axis returned by this method will change, too, to either the left, right, bottom or top axis, depending on which type was set. */ /* end documentation of signals */ /* start documentation of signals */ /*! \fn void QCPColorScale::dataRangeChanged(const QCPRange &newRange); This signal is emitted when the data range changes. \see setDataRange */ /*! \fn void QCPColorScale::dataScaleTypeChanged(QCPAxis::ScaleType scaleType); This signal is emitted when the data scale type changes. \see setDataScaleType */ /*! \fn void QCPColorScale::gradientChanged(const QCPColorGradient &newGradient); This signal is emitted when the gradient changes. \see setGradient */ /* end documentation of signals */ /*! Constructs a new QCPColorScale. */ QCPColorScale::QCPColorScale(QCustomPlot *parentPlot) : QCPLayoutElement(parentPlot), mType(QCPAxis::atTop), // set to atTop such that setType(QCPAxis::atRight) below doesn't skip work because it thinks it's already atRight mDataScaleType(QCPAxis::stLinear), mGradient(QCPColorGradient::gpCold), mBarWidth(20), mAxisRect(new QCPColorScaleAxisRectPrivate(this)) { setMinimumMargins(QMargins(0, 6, 0, 6)); // for default right color scale types, keep some room at bottom and top (important if no margin group is used) setType(QCPAxis::atRight); setDataRange(QCPRange(0, 6)); } QCPColorScale::~QCPColorScale() { delete mAxisRect; } /* undocumented getter */ QString QCPColorScale::label() const { if (!mColorAxis) { qDebug() << Q_FUNC_INFO << "internal color axis undefined"; return QString(); } return mColorAxis.data()->label(); } /* undocumented getter */ bool QCPColorScale::rangeDrag() const { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return false; } return mAxisRect.data()->rangeDrag().testFlag(QCPAxis::orientation(mType)) && mAxisRect.data()->rangeDragAxis(QCPAxis::orientation(mType)) && mAxisRect.data()->rangeDragAxis(QCPAxis::orientation(mType))->orientation() == QCPAxis::orientation(mType); } /* undocumented getter */ bool QCPColorScale::rangeZoom() const { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return false; } return mAxisRect.data()->rangeZoom().testFlag(QCPAxis::orientation(mType)) && mAxisRect.data()->rangeZoomAxis(QCPAxis::orientation(mType)) && mAxisRect.data()->rangeZoomAxis(QCPAxis::orientation(mType))->orientation() == QCPAxis::orientation(mType); } /*! Sets at which side of the color scale the axis is placed, and thus also its orientation. Note that after setting \a type to a different value, the axis returned by \ref axis() will be a different one. The new axis will adopt the following properties from the previous axis: The range, scale type, label and ticker (the latter will be shared and not copied). */ void QCPColorScale::setType(QCPAxis::AxisType type) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } if (mType != type) { mType = type; QCPRange rangeTransfer(0, 6); QString labelTransfer; QSharedPointer tickerTransfer; // transfer/revert some settings on old axis if it exists: bool doTransfer = !mColorAxis.isNull(); if (doTransfer) { rangeTransfer = mColorAxis.data()->range(); labelTransfer = mColorAxis.data()->label(); tickerTransfer = mColorAxis.data()->ticker(); mColorAxis.data()->setLabel(QString()); disconnect(mColorAxis.data(), SIGNAL(rangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); disconnect(mColorAxis.data(), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); } const QList allAxisTypes = QList() << QCPAxis::atLeft << QCPAxis::atRight << QCPAxis::atBottom << QCPAxis::atTop; foreach (QCPAxis::AxisType atype, allAxisTypes) { mAxisRect.data()->axis(atype)->setTicks(atype == mType); mAxisRect.data()->axis(atype)->setTickLabels(atype== mType); } // set new mColorAxis pointer: mColorAxis = mAxisRect.data()->axis(mType); // transfer settings to new axis: if (doTransfer) { mColorAxis.data()->setRange(rangeTransfer); // range transfer necessary if axis changes from vertical to horizontal or vice versa (axes with same orientation are synchronized via signals) mColorAxis.data()->setLabel(labelTransfer); mColorAxis.data()->setTicker(tickerTransfer); } connect(mColorAxis.data(), SIGNAL(rangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); connect(mColorAxis.data(), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); mAxisRect.data()->setRangeDragAxes(QList() << mColorAxis.data()); } } /*! Sets the range spanned by the color gradient and that is shown by the axis in the color scale. It is equivalent to calling QCPColorMap::setDataRange on any of the connected color maps. It is also equivalent to directly accessing the \ref axis and setting its range with \ref QCPAxis::setRange. \see setDataScaleType, setGradient, rescaleDataRange */ void QCPColorScale::setDataRange(const QCPRange &dataRange) { if (mDataRange.lower != dataRange.lower || mDataRange.upper != dataRange.upper) { mDataRange = dataRange; if (mColorAxis) mColorAxis.data()->setRange(mDataRange); emit dataRangeChanged(mDataRange); } } /*! Sets the scale type of the color scale, i.e. whether values are associated with colors linearly or logarithmically. It is equivalent to calling QCPColorMap::setDataScaleType on any of the connected color maps. It is also equivalent to directly accessing the \ref axis and setting its scale type with \ref QCPAxis::setScaleType. Note that this method controls the coordinate transformation. For logarithmic scales, you will likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting the color scale's \ref axis ticker to an instance of \ref QCPAxisTickerLog : \snippet documentation/doc-code-snippets/mainwindow.cpp qcpaxisticker-log-colorscale See the documentation of \ref QCPAxisTickerLog about the details of logarithmic axis tick creation. \see setDataRange, setGradient */ void QCPColorScale::setDataScaleType(QCPAxis::ScaleType scaleType) { if (mDataScaleType != scaleType) { mDataScaleType = scaleType; if (mColorAxis) mColorAxis.data()->setScaleType(mDataScaleType); if (mDataScaleType == QCPAxis::stLogarithmic) setDataRange(mDataRange.sanitizedForLogScale()); emit dataScaleTypeChanged(mDataScaleType); } } /*! Sets the color gradient that will be used to represent data values. It is equivalent to calling QCPColorMap::setGradient on any of the connected color maps. \see setDataRange, setDataScaleType */ void QCPColorScale::setGradient(const QCPColorGradient &gradient) { if (mGradient != gradient) { mGradient = gradient; if (mAxisRect) mAxisRect.data()->mGradientImageInvalidated = true; emit gradientChanged(mGradient); } } /*! Sets the axis label of the color scale. This is equivalent to calling \ref QCPAxis::setLabel on the internal \ref axis. */ void QCPColorScale::setLabel(const QString &str) { if (!mColorAxis) { qDebug() << Q_FUNC_INFO << "internal color axis undefined"; return; } mColorAxis.data()->setLabel(str); } /*! Sets the width (or height, for horizontal color scales) the bar where the gradient is displayed will have. */ void QCPColorScale::setBarWidth(int width) { mBarWidth = width; } /*! Sets whether the user can drag the data range (\ref setDataRange). Note that \ref QCP::iRangeDrag must be in the QCustomPlot's interactions (\ref QCustomPlot::setInteractions) to allow range dragging. */ void QCPColorScale::setRangeDrag(bool enabled) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } if (enabled) { mAxisRect.data()->setRangeDrag(QCPAxis::orientation(mType)); } else { #if QT_VERSION < QT_VERSION_CHECK(5, 2, 0) mAxisRect.data()->setRangeDrag(nullptr); #else mAxisRect.data()->setRangeDrag({}); #endif } } /*! Sets whether the user can zoom the data range (\ref setDataRange) by scrolling the mouse wheel. Note that \ref QCP::iRangeZoom must be in the QCustomPlot's interactions (\ref QCustomPlot::setInteractions) to allow range dragging. */ void QCPColorScale::setRangeZoom(bool enabled) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } if (enabled) { mAxisRect.data()->setRangeZoom(QCPAxis::orientation(mType)); } else { #if QT_VERSION < QT_VERSION_CHECK(5, 2, 0) mAxisRect.data()->setRangeDrag(nullptr); #else mAxisRect.data()->setRangeZoom({}); #endif } } /*! Returns a list of all the color maps associated with this color scale. */ QList QCPColorScale::colorMaps() const { QList result; for (int i=0; iplottableCount(); ++i) { if (QCPColorMap *cm = qobject_cast(mParentPlot->plottable(i))) if (cm->colorScale() == this) result.append(cm); } return result; } /*! Changes the data range such that all color maps associated with this color scale are fully mapped to the gradient in the data dimension. \see setDataRange */ void QCPColorScale::rescaleDataRange(bool onlyVisibleMaps) { QList maps = colorMaps(); QCPRange newRange; bool haveRange = false; QCP::SignDomain sign = QCP::sdBoth; if (mDataScaleType == QCPAxis::stLogarithmic) sign = (mDataRange.upper < 0 ? QCP::sdNegative : QCP::sdPositive); foreach (QCPColorMap *map, maps) { if (!map->realVisibility() && onlyVisibleMaps) continue; QCPRange mapRange; if (map->colorScale() == this) { bool currentFoundRange = true; mapRange = map->data()->dataBounds(); if (sign == QCP::sdPositive) { if (mapRange.lower <= 0 && mapRange.upper > 0) mapRange.lower = mapRange.upper*1e-3; else if (mapRange.lower <= 0 && mapRange.upper <= 0) currentFoundRange = false; } else if (sign == QCP::sdNegative) { if (mapRange.upper >= 0 && mapRange.lower < 0) mapRange.upper = mapRange.lower*1e-3; else if (mapRange.upper >= 0 && mapRange.lower >= 0) currentFoundRange = false; } if (currentFoundRange) { if (!haveRange) newRange = mapRange; else newRange.expand(mapRange); haveRange = true; } } } if (haveRange) { if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this dimension), shift current range to at least center the data { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason if (mDataScaleType == QCPAxis::stLinear) { newRange.lower = center-mDataRange.size()/2.0; newRange.upper = center+mDataRange.size()/2.0; } else // mScaleType == stLogarithmic { newRange.lower = center/qSqrt(mDataRange.upper/mDataRange.lower); newRange.upper = center*qSqrt(mDataRange.upper/mDataRange.lower); } } setDataRange(newRange); } } /* inherits documentation from base class */ void QCPColorScale::update(UpdatePhase phase) { QCPLayoutElement::update(phase); if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } mAxisRect.data()->update(phase); switch (phase) { case upMargins: { if (mType == QCPAxis::atBottom || mType == QCPAxis::atTop) { setMaximumSize(QWIDGETSIZE_MAX, mBarWidth+mAxisRect.data()->margins().top()+mAxisRect.data()->margins().bottom()); setMinimumSize(0, mBarWidth+mAxisRect.data()->margins().top()+mAxisRect.data()->margins().bottom()); } else { setMaximumSize(mBarWidth+mAxisRect.data()->margins().left()+mAxisRect.data()->margins().right(), QWIDGETSIZE_MAX); setMinimumSize(mBarWidth+mAxisRect.data()->margins().left()+mAxisRect.data()->margins().right(), 0); } break; } case upLayout: { mAxisRect.data()->setOuterRect(rect()); break; } default: break; } } /* inherits documentation from base class */ void QCPColorScale::applyDefaultAntialiasingHint(QCPPainter *painter) const { painter->setAntialiasing(false); } /* inherits documentation from base class */ void QCPColorScale::mousePressEvent(QMouseEvent *event, const QVariant &details) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } mAxisRect.data()->mousePressEvent(event, details); } /* inherits documentation from base class */ void QCPColorScale::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } mAxisRect.data()->mouseMoveEvent(event, startPos); } /* inherits documentation from base class */ void QCPColorScale::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } mAxisRect.data()->mouseReleaseEvent(event, startPos); } /* inherits documentation from base class */ void QCPColorScale::wheelEvent(QWheelEvent *event) { if (!mAxisRect) { qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; return; } mAxisRect.data()->wheelEvent(event); } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPColorScaleAxisRectPrivate //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPColorScaleAxisRectPrivate \internal \brief An axis rect subclass for use in a QCPColorScale This is a private class and not part of the public QCustomPlot interface. It provides the axis rect functionality for the QCPColorScale class. */ /*! Creates a new instance, as a child of \a parentColorScale. */ QCPColorScaleAxisRectPrivate::QCPColorScaleAxisRectPrivate(QCPColorScale *parentColorScale) : QCPAxisRect(parentColorScale->parentPlot(), true), mParentColorScale(parentColorScale), mGradientImageInvalidated(true) { setParentLayerable(parentColorScale); setMinimumMargins(QMargins(0, 0, 0, 0)); const QList allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; foreach (QCPAxis::AxisType type, allAxisTypes) { axis(type)->setVisible(true); axis(type)->grid()->setVisible(false); axis(type)->setPadding(0); connect(axis(type), SIGNAL(selectionChanged(QCPAxis::SelectableParts)), this, SLOT(axisSelectionChanged(QCPAxis::SelectableParts))); connect(axis(type), SIGNAL(selectableChanged(QCPAxis::SelectableParts)), this, SLOT(axisSelectableChanged(QCPAxis::SelectableParts))); } connect(axis(QCPAxis::atLeft), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atRight), SLOT(setRange(QCPRange))); connect(axis(QCPAxis::atRight), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atLeft), SLOT(setRange(QCPRange))); connect(axis(QCPAxis::atBottom), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atTop), SLOT(setRange(QCPRange))); connect(axis(QCPAxis::atTop), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atBottom), SLOT(setRange(QCPRange))); connect(axis(QCPAxis::atLeft), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atRight), SLOT(setScaleType(QCPAxis::ScaleType))); connect(axis(QCPAxis::atRight), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atLeft), SLOT(setScaleType(QCPAxis::ScaleType))); connect(axis(QCPAxis::atBottom), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atTop), SLOT(setScaleType(QCPAxis::ScaleType))); connect(axis(QCPAxis::atTop), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atBottom), SLOT(setScaleType(QCPAxis::ScaleType))); // make layer transfers of color scale transfer to axis rect and axes // the axes must be set after axis rect, such that they appear above color gradient drawn by axis rect: connect(parentColorScale, SIGNAL(layerChanged(QCPLayer*)), this, SLOT(setLayer(QCPLayer*))); foreach (QCPAxis::AxisType type, allAxisTypes) connect(parentColorScale, SIGNAL(layerChanged(QCPLayer*)), axis(type), SLOT(setLayer(QCPLayer*))); } /*! \internal Updates the color gradient image if necessary, by calling \ref updateGradientImage, then draws it. Then the axes are drawn by calling the \ref QCPAxisRect::draw base class implementation. \seebaseclassmethod */ void QCPColorScaleAxisRectPrivate::draw(QCPPainter *painter) { if (mGradientImageInvalidated) updateGradientImage(); bool mirrorHorz = false; bool mirrorVert = false; if (mParentColorScale->mColorAxis) { mirrorHorz = mParentColorScale->mColorAxis.data()->rangeReversed() && (mParentColorScale->type() == QCPAxis::atBottom || mParentColorScale->type() == QCPAxis::atTop); mirrorVert = mParentColorScale->mColorAxis.data()->rangeReversed() && (mParentColorScale->type() == QCPAxis::atLeft || mParentColorScale->type() == QCPAxis::atRight); } painter->drawImage(rect().adjusted(0, -1, 0, -1), mGradientImage.mirrored(mirrorHorz, mirrorVert)); QCPAxisRect::draw(painter); } /*! \internal Uses the current gradient of the parent \ref QCPColorScale (specified in the constructor) to generate a gradient image. This gradient image will be used in the \ref draw method. */ void QCPColorScaleAxisRectPrivate::updateGradientImage() { if (rect().isEmpty()) return; const QImage::Format format = QImage::Format_ARGB32_Premultiplied; int n = mParentColorScale->mGradient.levelCount(); int w, h; QVector data(n); for (int i=0; imType == QCPAxis::atBottom || mParentColorScale->mType == QCPAxis::atTop) { w = n; h = rect().height(); mGradientImage = QImage(w, h, format); QVector pixels; for (int y=0; y(mGradientImage.scanLine(y))); mParentColorScale->mGradient.colorize(data.constData(), QCPRange(0, n-1), pixels.first(), n); for (int y=1; y(mGradientImage.scanLine(y)); const QRgb lineColor = mParentColorScale->mGradient.color(data[h-1-y], QCPRange(0, n-1)); for (int x=0; x allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; foreach (QCPAxis::AxisType type, allAxisTypes) { if (QCPAxis *senderAxis = qobject_cast(sender())) if (senderAxis->axisType() == type) continue; if (axis(type)->selectableParts().testFlag(QCPAxis::spAxis)) { if (selectedParts.testFlag(QCPAxis::spAxis)) axis(type)->setSelectedParts(axis(type)->selectedParts() | QCPAxis::spAxis); else axis(type)->setSelectedParts(axis(type)->selectedParts() & ~QCPAxis::spAxis); } } } /*! \internal This slot is connected to the selectableChanged signals of the four axes in the constructor. It synchronizes the selectability of the axes. */ void QCPColorScaleAxisRectPrivate::axisSelectableChanged(QCPAxis::SelectableParts selectableParts) { // synchronize axis base selectability: const QList allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; foreach (QCPAxis::AxisType type, allAxisTypes) { if (QCPAxis *senderAxis = qobject_cast(sender())) if (senderAxis->axisType() == type) continue; if (axis(type)->selectableParts().testFlag(QCPAxis::spAxis)) { if (selectableParts.testFlag(QCPAxis::spAxis)) axis(type)->setSelectableParts(axis(type)->selectableParts() | QCPAxis::spAxis); else axis(type)->setSelectableParts(axis(type)->selectableParts() & ~QCPAxis::spAxis); } } } /* end of 'src/layoutelements/layoutelement-colorscale.cpp' */ /* including file 'src/plottables/plottable-graph.cpp' */ /* modified 2021-03-29T02:30:44, size 74518 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPGraphData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPGraphData \brief Holds the data of one single data point for QCPGraph. The stored data is: \li \a key: coordinate on the key axis of this data point (this is the \a mainKey and the \a sortKey) \li \a value: coordinate on the value axis of this data point (this is the \a mainValue) The container for storing multiple data points is \ref QCPGraphDataContainer. It is a typedef for \ref QCPDataContainer with \ref QCPGraphData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods. \see QCPGraphDataContainer */ /* start documentation of inline functions */ /*! \fn double QCPGraphData::sortKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static QCPGraphData QCPGraphData::fromSortKey(double sortKey) Returns a data point with the specified \a sortKey. All other members are set to zero. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static static bool QCPGraphData::sortKeyIsMainKey() Since the member \a key is both the data point key coordinate and the data ordering parameter, this method returns true. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPGraphData::mainKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPGraphData::mainValue() const Returns the \a value member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn QCPRange QCPGraphData::valueRange() const Returns a QCPRange with both lower and upper boundary set to \a value of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /* end documentation of inline functions */ /*! Constructs a data point with key and value set to zero. */ QCPGraphData::QCPGraphData() : key(0), value(0) { } /*! Constructs a data point with the specified \a key and \a value. */ QCPGraphData::QCPGraphData(double key, double value) : key(key), value(value) { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPGraph //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPGraph \brief A plottable representing a graph in a plot. \image html QCPGraph.png Usually you create new graphs by calling QCustomPlot::addGraph. The resulting instance can be accessed via QCustomPlot::graph. To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can also access and modify the data via the \ref data method, which returns a pointer to the internal \ref QCPGraphDataContainer. Graphs are used to display single-valued data. Single-valued means that there should only be one data point per unique key coordinate. In other words, the graph can't have \a loops. If you do want to plot non-single-valued curves, rather use the QCPCurve plottable. Gaps in the graph line can be created by adding data points with NaN as value (qQNaN() or std::numeric_limits::quiet_NaN()) in between the two data points that shall be separated. \section qcpgraph-appearance Changing the appearance The appearance of the graph is mainly determined by the line style, scatter style, brush and pen of the graph (\ref setLineStyle, \ref setScatterStyle, \ref setBrush, \ref setPen). \subsection filling Filling under or between graphs QCPGraph knows two types of fills: Normal graph fills towards the zero-value-line parallel to the key axis of the graph, and fills between two graphs, called channel fills. To enable a fill, just set a brush with \ref setBrush which is neither Qt::NoBrush nor fully transparent. By default, a normal fill towards the zero-value-line will be drawn. To set up a channel fill between this graph and another one, call \ref setChannelFillGraph with the other graph as parameter. \see QCustomPlot::addGraph, QCustomPlot::graph */ /* start of documentation of inline functions */ /*! \fn QSharedPointer QCPGraph::data() const Returns a shared pointer to the internal data storage of type \ref QCPGraphDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular \ref setData or \ref addData methods. */ /* end of documentation of inline functions */ /*! Constructs a graph which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. The created QCPGraph is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the QCPGraph, so do not delete it manually but use QCustomPlot::removePlottable() instead. To directly create a graph inside a plot, you can also use the simpler QCustomPlot::addGraph function. */ QCPGraph::QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable1D(keyAxis, valueAxis), mLineStyle{}, mScatterSkip{}, mAdaptiveSampling{} { // special handling for QCPGraphs to maintain the simple graph interface: mParentPlot->registerGraph(this); setPen(QPen(Qt::blue, 0)); setBrush(Qt::NoBrush); setLineStyle(lsLine); setScatterSkip(0); setChannelFillGraph(nullptr); setAdaptiveSampling(true); } QCPGraph::~QCPGraph() { } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple QCPGraphs may share the same data container safely. Modifying the data in the container will then affect all graphs that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpgraph-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, rather use the \ref QCPDataContainer::set method on the graph's data container directly: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpgraph-datasharing-2 \see addData */ void QCPGraph::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Replaces the current data with the provided points in \a keys and \a values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. \see addData */ void QCPGraph::setData(const QVector &keys, const QVector &values, bool alreadySorted) { mDataContainer->clear(); addData(keys, values, alreadySorted); } /*! Sets how the single data points are connected in the plot. For scatter-only plots, set \a ls to \ref lsNone and \ref setScatterStyle to the desired scatter style. \see setScatterStyle */ void QCPGraph::setLineStyle(LineStyle ls) { mLineStyle = ls; } /*! Sets the visual appearance of single data points in the plot. If set to \ref QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only-plots with appropriate line style). \see QCPScatterStyle, setLineStyle */ void QCPGraph::setScatterStyle(const QCPScatterStyle &style) { mScatterStyle = style; } /*! If scatters are displayed (scatter style not \ref QCPScatterStyle::ssNone), \a skip number of scatter points are skipped/not drawn after every drawn scatter point. This can be used to make the data appear sparser while for example still having a smooth line, and to improve performance for very high density plots. If \a skip is set to 0 (default), all scatter points are drawn. \see setScatterStyle */ void QCPGraph::setScatterSkip(int skip) { mScatterSkip = qMax(0, skip); } /*! Sets the target graph for filling the area between this graph and \a targetGraph with the current brush (\ref setBrush). When \a targetGraph is set to 0, a normal graph fill to the zero-value-line will be shown. To disable any filling, set the brush to Qt::NoBrush. \see setBrush */ void QCPGraph::setChannelFillGraph(QCPGraph *targetGraph) { // prevent setting channel target to this graph itself: if (targetGraph == this) { qDebug() << Q_FUNC_INFO << "targetGraph is this graph itself"; mChannelFillGraph = nullptr; return; } // prevent setting channel target to a graph not in the plot: if (targetGraph && targetGraph->mParentPlot != mParentPlot) { qDebug() << Q_FUNC_INFO << "targetGraph not in same plot"; mChannelFillGraph = nullptr; return; } mChannelFillGraph = targetGraph; } /*! Sets whether adaptive sampling shall be used when plotting this graph. QCustomPlot's adaptive sampling technique can drastically improve the replot performance for graphs with a larger number of points (e.g. above 10,000), without notably changing the appearance of the graph. By default, adaptive sampling is enabled. Even if enabled, QCustomPlot decides whether adaptive sampling shall actually be used on a per-graph basis. So leaving adaptive sampling enabled has no disadvantage in almost all cases. \image html adaptive-sampling-line.png "A line plot of 500,000 points without and with adaptive sampling" As can be seen, line plots experience no visual degradation from adaptive sampling. Outliers are reproduced reliably, as well as the overall shape of the data set. The replot time reduces dramatically though. This allows QCustomPlot to display large amounts of data in realtime. \image html adaptive-sampling-scatter.png "A scatter plot of 100,000 points without and with adaptive sampling" Care must be taken when using high-density scatter plots in combination with adaptive sampling. The adaptive sampling algorithm treats scatter plots more carefully than line plots which still gives a significant reduction of replot times, but not quite as much as for line plots. This is because scatter plots inherently need more data points to be preserved in order to still resemble the original, non-adaptive-sampling plot. As shown above, the results still aren't quite identical, as banding occurs for the outer data points. This is in fact intentional, such that the boundaries of the data cloud stay visible to the viewer. How strong the banding appears, depends on the point density, i.e. the number of points in the plot. For some situations with scatter plots it might thus be desirable to manually turn adaptive sampling off. For example, when saving the plot to disk. This can be achieved by setting \a enabled to false before issuing a command like \ref QCustomPlot::savePng, and setting \a enabled back to true afterwards. */ void QCPGraph::setAdaptiveSampling(bool enabled) { mAdaptiveSampling = enabled; } /*! \overload Adds the provided points in \a keys and \a values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPGraph::addData(const QVector &keys, const QVector &values, bool alreadySorted) { if (keys.size() != values.size()) qDebug() << Q_FUNC_INFO << "keys and values have different sizes:" << keys.size() << values.size(); const int n = qMin(keys.size(), values.size()); QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->key = keys[i]; it->value = values[i]; ++it; ++i; } mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write } /*! \overload Adds the provided data point as \a key and \a value to the current data. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPGraph::addData(double key, double value) { mDataContainer->add(QCPGraphData(key, value)); } /*! Implements a selectTest specific to this plottable's point geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod \ref QCPAbstractPlottable::selectTest */ double QCPGraph::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { QCPGraphDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); double result = pointDistance(pos, closestDataPoint); if (details) { int pointIndex = int(closestDataPoint-mDataContainer->constBegin()); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return result; } else return -1; } /* inherits documentation from base class */ QCPRange QCPGraph::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { return mDataContainer->keyRange(foundRange, inSignDomain); } /* inherits documentation from base class */ QCPRange QCPGraph::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); } /* inherits documentation from base class */ void QCPGraph::draw(QCPPainter *painter) { if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (mKeyAxis.data()->range().size() <= 0 || mDataContainer->isEmpty()) return; if (mLineStyle == lsNone && mScatterStyle.isNone()) return; QVector lines, scatters; // line and (if necessary) scatter pixel coordinates will be stored here while iterating over segments // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; for (int i=0; i= unselectedSegments.size(); // get line pixel points appropriate to line style: QCPDataRange lineDataRange = isSelectedSegment ? allSegments.at(i) : allSegments.at(i).adjusted(-1, 1); // unselected segments extend lines to bordering selected data point (safe to exceed total data bounds in first/last segment, getLines takes care) getLines(&lines, lineDataRange); // check data validity if flag set: #ifdef QCUSTOMPLOT_CHECK_DATA QCPGraphDataContainer::const_iterator it; for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) { if (QCP::isInvalidData(it->key, it->value)) qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "invalid." << "Plottable name:" << name(); } #endif // draw fill of graph: if (isSelectedSegment && mSelectionDecorator) mSelectionDecorator->applyBrush(painter); else painter->setBrush(mBrush); painter->setPen(Qt::NoPen); drawFill(painter, &lines); // draw line: if (mLineStyle != lsNone) { if (isSelectedSegment && mSelectionDecorator) mSelectionDecorator->applyPen(painter); else painter->setPen(mPen); painter->setBrush(Qt::NoBrush); if (mLineStyle == lsImpulse) drawImpulsePlot(painter, lines); else drawLinePlot(painter, lines); // also step plots can be drawn as a line plot } // draw scatters: QCPScatterStyle finalScatterStyle = mScatterStyle; if (isSelectedSegment && mSelectionDecorator) finalScatterStyle = mSelectionDecorator->getFinalScatterStyle(mScatterStyle); if (!finalScatterStyle.isNone()) { getScatters(&scatters, allSegments.at(i)); drawScatterPlot(painter, scatters, finalScatterStyle); } } // draw other selection decoration that isn't just line/scatter pens and brushes: if (mSelectionDecorator) mSelectionDecorator->drawDecoration(painter, selection()); } /* inherits documentation from base class */ void QCPGraph::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { // draw fill: if (mBrush.style() != Qt::NoBrush) { applyFillAntialiasingHint(painter); painter->fillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); } // draw line vertically centered: if (mLineStyle != lsNone) { applyDefaultAntialiasingHint(painter); painter->setPen(mPen); painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens } // draw scatter symbol: if (!mScatterStyle.isNone()) { applyScattersAntialiasingHint(painter); // scale scatter pixmap if it's too large to fit in legend icon rect: if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) { QCPScatterStyle scaledStyle(mScatterStyle); scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); scaledStyle.applyTo(painter, mPen); scaledStyle.drawShape(painter, QRectF(rect).center()); } else { mScatterStyle.applyTo(painter, mPen); mScatterStyle.drawShape(painter, QRectF(rect).center()); } } } /*! \internal This method retrieves an optimized set of data points via \ref getOptimizedLineData, and branches out to the line style specific functions such as \ref dataToLines, \ref dataToStepLeftLines, etc. according to the line style of the graph. \a lines will be filled with points in pixel coordinates, that can be drawn with the according draw functions like \ref drawLinePlot and \ref drawImpulsePlot. The points returned in \a lines aren't necessarily the original data points. For example, step line styles require additional points to form the steps when drawn. If the line style of the graph is \ref lsNone, the \a lines vector will be empty. \a dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in \a dataRange, e.g. when extending ranges coming from \ref getDataSegments. \see getScatters */ void QCPGraph::getLines(QVector *lines, const QCPDataRange &dataRange) const { if (!lines) return; QCPGraphDataContainer::const_iterator begin, end; getVisibleDataBounds(begin, end, dataRange); if (begin == end) { lines->clear(); return; } QVector lineData; if (mLineStyle != lsNone) getOptimizedLineData(&lineData, begin, end); if (mKeyAxis->rangeReversed() != (mKeyAxis->orientation() == Qt::Vertical)) // make sure key pixels are sorted ascending in lineData (significantly simplifies following processing) std::reverse(lineData.begin(), lineData.end()); switch (mLineStyle) { case lsNone: lines->clear(); break; case lsLine: *lines = dataToLines(lineData); break; case lsStepLeft: *lines = dataToStepLeftLines(lineData); break; case lsStepRight: *lines = dataToStepRightLines(lineData); break; case lsStepCenter: *lines = dataToStepCenterLines(lineData); break; case lsImpulse: *lines = dataToImpulseLines(lineData); break; } } /*! \internal This method retrieves an optimized set of data points via \ref getOptimizedScatterData and then converts them to pixel coordinates. The resulting points are returned in \a scatters, and can be passed to \ref drawScatterPlot. \a dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in \a dataRange, e.g. when extending ranges coming from \ref getDataSegments. */ void QCPGraph::getScatters(QVector *scatters, const QCPDataRange &dataRange) const { if (!scatters) return; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; scatters->clear(); return; } QCPGraphDataContainer::const_iterator begin, end; getVisibleDataBounds(begin, end, dataRange); if (begin == end) { scatters->clear(); return; } QVector data; getOptimizedScatterData(&data, begin, end); if (mKeyAxis->rangeReversed() != (mKeyAxis->orientation() == Qt::Vertical)) // make sure key pixels are sorted ascending in data (significantly simplifies following processing) std::reverse(data.begin(), data.end()); scatters->resize(data.size()); if (keyAxis->orientation() == Qt::Vertical) { for (int i=0; icoordToPixel(data.at(i).value)); (*scatters)[i].setY(keyAxis->coordToPixel(data.at(i).key)); } } } else { for (int i=0; icoordToPixel(data.at(i).key)); (*scatters)[i].setY(valueAxis->coordToPixel(data.at(i).value)); } } } } /*! \internal Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style \ref lsLine. The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a getLines if the line style is set accordingly. \see dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot */ QVector QCPGraph::dataToLines(const QVector &data) const { QVector result; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } result.resize(data.size()); // transform data points to pixels: if (keyAxis->orientation() == Qt::Vertical) { for (int i=0; icoordToPixel(data.at(i).value)); result[i].setY(keyAxis->coordToPixel(data.at(i).key)); } } else // key axis is horizontal { for (int i=0; icoordToPixel(data.at(i).key)); result[i].setY(valueAxis->coordToPixel(data.at(i).value)); } } return result; } /*! \internal Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style \ref lsStepLeft. The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a getLines if the line style is set accordingly. \see dataToLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot */ QVector QCPGraph::dataToStepLeftLines(const QVector &data) const { QVector result; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } result.resize(data.size()*2); // calculate steps from data and transform to pixel coordinates: if (keyAxis->orientation() == Qt::Vertical) { double lastValue = valueAxis->coordToPixel(data.first().value); for (int i=0; icoordToPixel(data.at(i).key); result[i*2+0].setX(lastValue); result[i*2+0].setY(key); lastValue = valueAxis->coordToPixel(data.at(i).value); result[i*2+1].setX(lastValue); result[i*2+1].setY(key); } } else // key axis is horizontal { double lastValue = valueAxis->coordToPixel(data.first().value); for (int i=0; icoordToPixel(data.at(i).key); result[i*2+0].setX(key); result[i*2+0].setY(lastValue); lastValue = valueAxis->coordToPixel(data.at(i).value); result[i*2+1].setX(key); result[i*2+1].setY(lastValue); } } return result; } /*! \internal Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style \ref lsStepRight. The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a getLines if the line style is set accordingly. \see dataToLines, dataToStepLeftLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot */ QVector QCPGraph::dataToStepRightLines(const QVector &data) const { QVector result; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } result.resize(data.size()*2); // calculate steps from data and transform to pixel coordinates: if (keyAxis->orientation() == Qt::Vertical) { double lastKey = keyAxis->coordToPixel(data.first().key); for (int i=0; icoordToPixel(data.at(i).value); result[i*2+0].setX(value); result[i*2+0].setY(lastKey); lastKey = keyAxis->coordToPixel(data.at(i).key); result[i*2+1].setX(value); result[i*2+1].setY(lastKey); } } else // key axis is horizontal { double lastKey = keyAxis->coordToPixel(data.first().key); for (int i=0; icoordToPixel(data.at(i).value); result[i*2+0].setX(lastKey); result[i*2+0].setY(value); lastKey = keyAxis->coordToPixel(data.at(i).key); result[i*2+1].setX(lastKey); result[i*2+1].setY(value); } } return result; } /*! \internal Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style \ref lsStepCenter. The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a getLines if the line style is set accordingly. \see dataToLines, dataToStepLeftLines, dataToStepRightLines, dataToImpulseLines, getLines, drawLinePlot */ QVector QCPGraph::dataToStepCenterLines(const QVector &data) const { QVector result; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } result.resize(data.size()*2); // calculate steps from data and transform to pixel coordinates: if (keyAxis->orientation() == Qt::Vertical) { double lastKey = keyAxis->coordToPixel(data.first().key); double lastValue = valueAxis->coordToPixel(data.first().value); result[0].setX(lastValue); result[0].setY(lastKey); for (int i=1; icoordToPixel(data.at(i).key)+lastKey)*0.5; result[i*2-1].setX(lastValue); result[i*2-1].setY(key); lastValue = valueAxis->coordToPixel(data.at(i).value); lastKey = keyAxis->coordToPixel(data.at(i).key); result[i*2+0].setX(lastValue); result[i*2+0].setY(key); } result[data.size()*2-1].setX(lastValue); result[data.size()*2-1].setY(lastKey); } else // key axis is horizontal { double lastKey = keyAxis->coordToPixel(data.first().key); double lastValue = valueAxis->coordToPixel(data.first().value); result[0].setX(lastKey); result[0].setY(lastValue); for (int i=1; icoordToPixel(data.at(i).key)+lastKey)*0.5; result[i*2-1].setX(key); result[i*2-1].setY(lastValue); lastValue = valueAxis->coordToPixel(data.at(i).value); lastKey = keyAxis->coordToPixel(data.at(i).key); result[i*2+0].setX(key); result[i*2+0].setY(lastValue); } result[data.size()*2-1].setX(lastKey); result[data.size()*2-1].setY(lastValue); } return result; } /*! \internal Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style \ref lsImpulse. The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a getLines if the line style is set accordingly. \see dataToLines, dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, getLines, drawImpulsePlot */ QVector QCPGraph::dataToImpulseLines(const QVector &data) const { QVector result; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } result.resize(data.size()*2); // transform data points to pixels: if (keyAxis->orientation() == Qt::Vertical) { for (int i=0; icoordToPixel(data.at(i).key); result[i*2+0].setX(valueAxis->coordToPixel(0)); result[i*2+0].setY(key); result[i*2+1].setX(valueAxis->coordToPixel(data.at(i).value)); result[i*2+1].setY(key); } } else // key axis is horizontal { for (int i=0; icoordToPixel(data.at(i).key); result[i*2+0].setX(key); result[i*2+0].setY(valueAxis->coordToPixel(0)); result[i*2+1].setX(key); result[i*2+1].setY(valueAxis->coordToPixel(data.at(i).value)); } } return result; } /*! \internal Draws the fill of the graph using the specified \a painter, with the currently set brush. Depending on whether a normal fill or a channel fill (\ref setChannelFillGraph) is needed, \ref getFillPolygon or \ref getChannelFillPolygon are used to find the according fill polygons. In order to handle NaN Data points correctly (the fill needs to be split into disjoint areas), this method first determines a list of non-NaN segments with \ref getNonNanSegments, on which to operate. In the channel fill case, \ref getOverlappingSegments is used to consolidate the non-NaN segments of the two involved graphs, before passing the overlapping pairs to \ref getChannelFillPolygon. Pass the points of this graph's line as \a lines, in pixel coordinates. \see drawLinePlot, drawImpulsePlot, drawScatterPlot */ void QCPGraph::drawFill(QCPPainter *painter, QVector *lines) const { if (mLineStyle == lsImpulse) return; // fill doesn't make sense for impulse plot if (painter->brush().style() == Qt::NoBrush || painter->brush().color().alpha() == 0) return; applyFillAntialiasingHint(painter); const QVector segments = getNonNanSegments(lines, keyAxis()->orientation()); if (!mChannelFillGraph) { // draw base fill under graph, fill goes all the way to the zero-value-line: foreach (QCPDataRange segment, segments) painter->drawPolygon(getFillPolygon(lines, segment)); } else { // draw fill between this graph and mChannelFillGraph: QVector otherLines; mChannelFillGraph->getLines(&otherLines, QCPDataRange(0, mChannelFillGraph->dataCount())); if (!otherLines.isEmpty()) { QVector otherSegments = getNonNanSegments(&otherLines, mChannelFillGraph->keyAxis()->orientation()); QVector > segmentPairs = getOverlappingSegments(segments, lines, otherSegments, &otherLines); for (int i=0; idrawPolygon(getChannelFillPolygon(lines, segmentPairs.at(i).first, &otherLines, segmentPairs.at(i).second)); } } } /*! \internal Draws scatter symbols at every point passed in \a scatters, given in pixel coordinates. The scatters will be drawn with \a painter and have the appearance as specified in \a style. \see drawLinePlot, drawImpulsePlot */ void QCPGraph::drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const { applyScattersAntialiasingHint(painter); style.applyTo(painter, mPen); foreach (const QPointF &scatter, scatters) style.drawShape(painter, scatter.x(), scatter.y()); } /*! \internal Draws lines between the points in \a lines, given in pixel coordinates. \see drawScatterPlot, drawImpulsePlot, QCPAbstractPlottable1D::drawPolyline */ void QCPGraph::drawLinePlot(QCPPainter *painter, const QVector &lines) const { if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) { applyDefaultAntialiasingHint(painter); drawPolyline(painter, lines); } } /*! \internal Draws impulses from the provided data, i.e. it connects all line pairs in \a lines, given in pixel coordinates. The \a lines necessary for impulses are generated by \ref dataToImpulseLines from the regular graph data points. \see drawLinePlot, drawScatterPlot */ void QCPGraph::drawImpulsePlot(QCPPainter *painter, const QVector &lines) const { if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) { applyDefaultAntialiasingHint(painter); QPen oldPen = painter->pen(); QPen newPen = painter->pen(); newPen.setCapStyle(Qt::FlatCap); // so impulse line doesn't reach beyond zero-line painter->setPen(newPen); painter->drawLines(lines); painter->setPen(oldPen); } } /*! \internal Returns via \a lineData the data points that need to be visualized for this graph when plotting graph lines, taking into consideration the currently visible axis ranges and, if \ref setAdaptiveSampling is enabled, local point densities. The considered data can be restricted further by \a begin and \a end, e.g. to only plot a certain segment of the data (see \ref getDataSegments). This method is used by \ref getLines to retrieve the basic working set of data. \see getOptimizedScatterData */ void QCPGraph::getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const { if (!lineData) return; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (begin == end) return; int dataCount = int(end-begin); int maxCount = (std::numeric_limits::max)(); if (mAdaptiveSampling) { double keyPixelSpan = qAbs(keyAxis->coordToPixel(begin->key)-keyAxis->coordToPixel((end-1)->key)); if (2*keyPixelSpan+2 < static_cast((std::numeric_limits::max)())) maxCount = int(2*keyPixelSpan+2); } if (mAdaptiveSampling && dataCount >= maxCount) // use adaptive sampling only if there are at least two points per pixel on average { QCPGraphDataContainer::const_iterator it = begin; double minValue = it->value; double maxValue = it->value; QCPGraphDataContainer::const_iterator currentIntervalFirstPoint = it; int reversedFactor = keyAxis->pixelOrientation(); // is used to calculate keyEpsilon pixel into the correct direction int reversedRound = reversedFactor==-1 ? 1 : 0; // is used to switch between floor (normal) and ceil (reversed) rounding of currentIntervalStartKey double currentIntervalStartKey = keyAxis->pixelToCoord(int(keyAxis->coordToPixel(begin->key)+reversedRound)); double lastIntervalEndKey = currentIntervalStartKey; double keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); // interval of one pixel on screen when mapped to plot key coordinates bool keyEpsilonVariable = keyAxis->scaleType() == QCPAxis::stLogarithmic; // indicates whether keyEpsilon needs to be updated after every interval (for log axes) int intervalDataCount = 1; ++it; // advance iterator to second data point because adaptive sampling works in 1 point retrospect while (it != end) { if (it->key < currentIntervalStartKey+keyEpsilon) // data point is still within same pixel, so skip it and expand value span of this cluster if necessary { if (it->value < minValue) minValue = it->value; else if (it->value > maxValue) maxValue = it->value; ++intervalDataCount; } else // new pixel interval started { if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them to a cluster { if (lastIntervalEndKey < currentIntervalStartKey-keyEpsilon) // last point is further away, so first point of this cluster must be at a real data point lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.2, currentIntervalFirstPoint->value)); lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.25, minValue)); lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.75, maxValue)); if (it->key > currentIntervalStartKey+keyEpsilon*2) // new pixel started further away from previous cluster, so make sure the last point of the cluster is at a real data point lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.8, (it-1)->value)); } else lineData->append(QCPGraphData(currentIntervalFirstPoint->key, currentIntervalFirstPoint->value)); lastIntervalEndKey = (it-1)->key; minValue = it->value; maxValue = it->value; currentIntervalFirstPoint = it; currentIntervalStartKey = keyAxis->pixelToCoord(int(keyAxis->coordToPixel(it->key)+reversedRound)); if (keyEpsilonVariable) keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); intervalDataCount = 1; } ++it; } // handle last interval: if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them to a cluster { if (lastIntervalEndKey < currentIntervalStartKey-keyEpsilon) // last point wasn't a cluster, so first point of this cluster must be at a real data point lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.2, currentIntervalFirstPoint->value)); lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.25, minValue)); lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.75, maxValue)); } else lineData->append(QCPGraphData(currentIntervalFirstPoint->key, currentIntervalFirstPoint->value)); } else // don't use adaptive sampling algorithm, transfer points one-to-one from the data container into the output { lineData->resize(dataCount); std::copy(begin, end, lineData->begin()); } } /*! \internal Returns via \a scatterData the data points that need to be visualized for this graph when plotting scatter points, taking into consideration the currently visible axis ranges and, if \ref setAdaptiveSampling is enabled, local point densities. The considered data can be restricted further by \a begin and \a end, e.g. to only plot a certain segment of the data (see \ref getDataSegments). This method is used by \ref getScatters to retrieve the basic working set of data. \see getOptimizedLineData */ void QCPGraph::getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const { if (!scatterData) return; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } const int scatterModulo = mScatterSkip+1; const bool doScatterSkip = mScatterSkip > 0; int beginIndex = int(begin-mDataContainer->constBegin()); int endIndex = int(end-mDataContainer->constBegin()); while (doScatterSkip && begin != end && beginIndex % scatterModulo != 0) // advance begin iterator to first non-skipped scatter { ++beginIndex; ++begin; } if (begin == end) return; int dataCount = int(end-begin); int maxCount = (std::numeric_limits::max)(); if (mAdaptiveSampling) { int keyPixelSpan = int(qAbs(keyAxis->coordToPixel(begin->key)-keyAxis->coordToPixel((end-1)->key))); maxCount = 2*keyPixelSpan+2; } if (mAdaptiveSampling && dataCount >= maxCount) // use adaptive sampling only if there are at least two points per pixel on average { double valueMaxRange = valueAxis->range().upper; double valueMinRange = valueAxis->range().lower; QCPGraphDataContainer::const_iterator it = begin; int itIndex = int(beginIndex); double minValue = it->value; double maxValue = it->value; QCPGraphDataContainer::const_iterator minValueIt = it; QCPGraphDataContainer::const_iterator maxValueIt = it; QCPGraphDataContainer::const_iterator currentIntervalStart = it; int reversedFactor = keyAxis->pixelOrientation(); // is used to calculate keyEpsilon pixel into the correct direction int reversedRound = reversedFactor==-1 ? 1 : 0; // is used to switch between floor (normal) and ceil (reversed) rounding of currentIntervalStartKey double currentIntervalStartKey = keyAxis->pixelToCoord(int(keyAxis->coordToPixel(begin->key)+reversedRound)); double keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); // interval of one pixel on screen when mapped to plot key coordinates bool keyEpsilonVariable = keyAxis->scaleType() == QCPAxis::stLogarithmic; // indicates whether keyEpsilon needs to be updated after every interval (for log axes) int intervalDataCount = 1; // advance iterator to second (non-skipped) data point because adaptive sampling works in 1 point retrospect: if (!doScatterSkip) ++it; else { itIndex += scatterModulo; if (itIndex < endIndex) // make sure we didn't jump over end it += scatterModulo; else { it = end; itIndex = endIndex; } } // main loop over data points: while (it != end) { if (it->key < currentIntervalStartKey+keyEpsilon) // data point is still within same pixel, so skip it and expand value span of this pixel if necessary { if (it->value < minValue && it->value > valueMinRange && it->value < valueMaxRange) { minValue = it->value; minValueIt = it; } else if (it->value > maxValue && it->value > valueMinRange && it->value < valueMaxRange) { maxValue = it->value; maxValueIt = it; } ++intervalDataCount; } else // new pixel started { if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them { // determine value pixel span and add as many points in interval to maintain certain vertical data density (this is specific to scatter plot): double valuePixelSpan = qAbs(valueAxis->coordToPixel(minValue)-valueAxis->coordToPixel(maxValue)); int dataModulo = qMax(1, qRound(intervalDataCount/(valuePixelSpan/4.0))); // approximately every 4 value pixels one data point on average QCPGraphDataContainer::const_iterator intervalIt = currentIntervalStart; int c = 0; while (intervalIt != it) { if ((c % dataModulo == 0 || intervalIt == minValueIt || intervalIt == maxValueIt) && intervalIt->value > valueMinRange && intervalIt->value < valueMaxRange) scatterData->append(*intervalIt); ++c; if (!doScatterSkip) ++intervalIt; else intervalIt += scatterModulo; // since we know indices of "currentIntervalStart", "intervalIt" and "it" are multiples of scatterModulo, we can't accidentally jump over "it" here } } else if (currentIntervalStart->value > valueMinRange && currentIntervalStart->value < valueMaxRange) scatterData->append(*currentIntervalStart); minValue = it->value; maxValue = it->value; currentIntervalStart = it; currentIntervalStartKey = keyAxis->pixelToCoord(int(keyAxis->coordToPixel(it->key)+reversedRound)); if (keyEpsilonVariable) keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); intervalDataCount = 1; } // advance to next data point: if (!doScatterSkip) ++it; else { itIndex += scatterModulo; if (itIndex < endIndex) // make sure we didn't jump over end it += scatterModulo; else { it = end; itIndex = endIndex; } } } // handle last interval: if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them { // determine value pixel span and add as many points in interval to maintain certain vertical data density (this is specific to scatter plot): double valuePixelSpan = qAbs(valueAxis->coordToPixel(minValue)-valueAxis->coordToPixel(maxValue)); int dataModulo = qMax(1, qRound(intervalDataCount/(valuePixelSpan/4.0))); // approximately every 4 value pixels one data point on average QCPGraphDataContainer::const_iterator intervalIt = currentIntervalStart; int intervalItIndex = int(intervalIt-mDataContainer->constBegin()); int c = 0; while (intervalIt != it) { if ((c % dataModulo == 0 || intervalIt == minValueIt || intervalIt == maxValueIt) && intervalIt->value > valueMinRange && intervalIt->value < valueMaxRange) scatterData->append(*intervalIt); ++c; if (!doScatterSkip) ++intervalIt; else // here we can't guarantee that adding scatterModulo doesn't exceed "it" (because "it" is equal to "end" here, and "end" isn't scatterModulo-aligned), so check via index comparison: { intervalItIndex += scatterModulo; if (intervalItIndex < itIndex) intervalIt += scatterModulo; else { intervalIt = it; intervalItIndex = itIndex; } } } } else if (currentIntervalStart->value > valueMinRange && currentIntervalStart->value < valueMaxRange) scatterData->append(*currentIntervalStart); } else // don't use adaptive sampling algorithm, transfer points one-to-one from the data container into the output { QCPGraphDataContainer::const_iterator it = begin; int itIndex = beginIndex; scatterData->reserve(dataCount); while (it != end) { scatterData->append(*it); // advance to next data point: if (!doScatterSkip) ++it; else { itIndex += scatterModulo; if (itIndex < endIndex) it += scatterModulo; else { it = end; itIndex = endIndex; } } } } } /*! This method outputs the currently visible data range via \a begin and \a end. The returned range will also never exceed \a rangeRestriction. This method takes into account that the drawing of data lines at the axis rect border always requires the points just outside the visible axis range. So \a begin and \a end may actually indicate a range that contains one additional data point to the left and right of the visible axis range. */ void QCPGraph::getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const { if (rangeRestriction.isEmpty()) { end = mDataContainer->constEnd(); begin = end; } else { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } // get visible data range: begin = mDataContainer->findBegin(keyAxis->range().lower); end = mDataContainer->findEnd(keyAxis->range().upper); // limit lower/upperEnd to rangeRestriction: mDataContainer->limitIteratorsToDataRange(begin, end, rangeRestriction); // this also ensures rangeRestriction outside data bounds doesn't break anything } } /*! \internal This method goes through the passed points in \a lineData and returns a list of the segments which don't contain NaN data points. \a keyOrientation defines whether the \a x or \a y member of the passed QPointF is used to check for NaN. If \a keyOrientation is \c Qt::Horizontal, the \a y member is checked, if it is \c Qt::Vertical, the \a x member is checked. \see getOverlappingSegments, drawFill */ QVector QCPGraph::getNonNanSegments(const QVector *lineData, Qt::Orientation keyOrientation) const { QVector result; const int n = lineData->size(); QCPDataRange currentSegment(-1, -1); int i = 0; if (keyOrientation == Qt::Horizontal) { while (i < n) { while (i < n && qIsNaN(lineData->at(i).y())) // seek next non-NaN data point ++i; if (i == n) break; currentSegment.setBegin(i++); while (i < n && !qIsNaN(lineData->at(i).y())) // seek next NaN data point or end of data ++i; currentSegment.setEnd(i++); result.append(currentSegment); } } else // keyOrientation == Qt::Vertical { while (i < n) { while (i < n && qIsNaN(lineData->at(i).x())) // seek next non-NaN data point ++i; if (i == n) break; currentSegment.setBegin(i++); while (i < n && !qIsNaN(lineData->at(i).x())) // seek next NaN data point or end of data ++i; currentSegment.setEnd(i++); result.append(currentSegment); } } return result; } /*! \internal This method takes two segment lists (e.g. created by \ref getNonNanSegments) \a thisSegments and \a otherSegments, and their associated point data \a thisData and \a otherData. It returns all pairs of segments (the first from \a thisSegments, the second from \a otherSegments), which overlap in plot coordinates. This method is useful in the case of a channel fill between two graphs, when only those non-NaN segments which actually overlap in their key coordinate shall be considered for drawing a channel fill polygon. It is assumed that the passed segments in \a thisSegments are ordered ascending by index, and that the segments don't overlap themselves. The same is assumed for the segments in \a otherSegments. This is fulfilled when the segments are obtained via \ref getNonNanSegments. \see getNonNanSegments, segmentsIntersect, drawFill, getChannelFillPolygon */ QVector > QCPGraph::getOverlappingSegments(QVector thisSegments, const QVector *thisData, QVector otherSegments, const QVector *otherData) const { QVector > result; if (thisData->isEmpty() || otherData->isEmpty() || thisSegments.isEmpty() || otherSegments.isEmpty()) return result; int thisIndex = 0; int otherIndex = 0; const bool verticalKey = mKeyAxis->orientation() == Qt::Vertical; while (thisIndex < thisSegments.size() && otherIndex < otherSegments.size()) { if (thisSegments.at(thisIndex).size() < 2) // segments with fewer than two points won't have a fill anyhow { ++thisIndex; continue; } if (otherSegments.at(otherIndex).size() < 2) // segments with fewer than two points won't have a fill anyhow { ++otherIndex; continue; } double thisLower, thisUpper, otherLower, otherUpper; if (!verticalKey) { thisLower = thisData->at(thisSegments.at(thisIndex).begin()).x(); thisUpper = thisData->at(thisSegments.at(thisIndex).end()-1).x(); otherLower = otherData->at(otherSegments.at(otherIndex).begin()).x(); otherUpper = otherData->at(otherSegments.at(otherIndex).end()-1).x(); } else { thisLower = thisData->at(thisSegments.at(thisIndex).begin()).y(); thisUpper = thisData->at(thisSegments.at(thisIndex).end()-1).y(); otherLower = otherData->at(otherSegments.at(otherIndex).begin()).y(); otherUpper = otherData->at(otherSegments.at(otherIndex).end()-1).y(); } int bPrecedence; if (segmentsIntersect(thisLower, thisUpper, otherLower, otherUpper, bPrecedence)) result.append(QPair(thisSegments.at(thisIndex), otherSegments.at(otherIndex))); if (bPrecedence <= 0) // otherSegment doesn't reach as far as thisSegment, so continue with next otherSegment, keeping current thisSegment ++otherIndex; else // otherSegment reaches further than thisSegment, so continue with next thisSegment, keeping current otherSegment ++thisIndex; } return result; } /*! \internal Returns whether the segments defined by the coordinates (aLower, aUpper) and (bLower, bUpper) have overlap. The output parameter \a bPrecedence indicates whether the \a b segment reaches farther than the \a a segment or not. If \a bPrecedence returns 1, segment \a b reaches the farthest to higher coordinates (i.e. bUpper > aUpper). If it returns -1, segment \a a reaches the farthest. Only if both segment's upper bounds are identical, 0 is returned as \a bPrecedence. It is assumed that the lower bounds always have smaller or equal values than the upper bounds. \see getOverlappingSegments */ bool QCPGraph::segmentsIntersect(double aLower, double aUpper, double bLower, double bUpper, int &bPrecedence) const { bPrecedence = 0; if (aLower > bUpper) { bPrecedence = -1; return false; } else if (bLower > aUpper) { bPrecedence = 1; return false; } else { if (aUpper > bUpper) bPrecedence = -1; else if (aUpper < bUpper) bPrecedence = 1; return true; } } /*! \internal Returns the point which closes the fill polygon on the zero-value-line parallel to the key axis. The logarithmic axis scale case is a bit special, since the zero-value-line in pixel coordinates is in positive or negative infinity. So this case is handled separately by just closing the fill polygon on the axis which lies in the direction towards the zero value. \a matchingDataPoint will provide the key (in pixels) of the returned point. Depending on whether the key axis of this graph is horizontal or vertical, \a matchingDataPoint will provide the x or y value of the returned point, respectively. */ QPointF QCPGraph::getFillBasePoint(QPointF matchingDataPoint) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return {}; } QPointF result; if (valueAxis->scaleType() == QCPAxis::stLinear) { if (keyAxis->orientation() == Qt::Horizontal) { result.setX(matchingDataPoint.x()); result.setY(valueAxis->coordToPixel(0)); } else // keyAxis->orientation() == Qt::Vertical { result.setX(valueAxis->coordToPixel(0)); result.setY(matchingDataPoint.y()); } } else // valueAxis->mScaleType == QCPAxis::stLogarithmic { // In logarithmic scaling we can't just draw to value 0 so we just fill all the way // to the axis which is in the direction towards 0 if (keyAxis->orientation() == Qt::Vertical) { if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis result.setX(keyAxis->axisRect()->right()); else result.setX(keyAxis->axisRect()->left()); result.setY(matchingDataPoint.y()); } else if (keyAxis->axisType() == QCPAxis::atTop || keyAxis->axisType() == QCPAxis::atBottom) { result.setX(matchingDataPoint.x()); if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis result.setY(keyAxis->axisRect()->top()); else result.setY(keyAxis->axisRect()->bottom()); } } return result; } /*! \internal Returns the polygon needed for drawing normal fills between this graph and the key axis. Pass the graph's data points (in pixel coordinates) as \a lineData, and specify the \a segment which shall be used for the fill. The collection of \a lineData points described by \a segment must not contain NaN data points (see \ref getNonNanSegments). The returned fill polygon will be closed at the key axis (the zero-value line) for linear value axes. For logarithmic value axes the polygon will reach just beyond the corresponding axis rect side (see \ref getFillBasePoint). For increased performance (due to implicit sharing), keep the returned QPolygonF const. \see drawFill, getNonNanSegments */ const QPolygonF QCPGraph::getFillPolygon(const QVector *lineData, QCPDataRange segment) const { if (segment.size() < 2) return QPolygonF(); QPolygonF result(segment.size()+2); result[0] = getFillBasePoint(lineData->at(segment.begin())); std::copy(lineData->constBegin()+segment.begin(), lineData->constBegin()+segment.end(), result.begin()+1); result[result.size()-1] = getFillBasePoint(lineData->at(segment.end()-1)); return result; } /*! \internal Returns the polygon needed for drawing (partial) channel fills between this graph and the graph specified by \ref setChannelFillGraph. The data points of this graph are passed as pixel coordinates via \a thisData, the data of the other graph as \a otherData. The returned polygon will be calculated for the specified data segments \a thisSegment and \a otherSegment, pertaining to the respective \a thisData and \a otherData, respectively. The passed \a thisSegment and \a otherSegment should correspond to the segment pairs returned by \ref getOverlappingSegments, to make sure only segments that actually have key coordinate overlap need to be processed here. For increased performance due to implicit sharing, keep the returned QPolygonF const. \see drawFill, getOverlappingSegments, getNonNanSegments */ const QPolygonF QCPGraph::getChannelFillPolygon(const QVector *thisData, QCPDataRange thisSegment, const QVector *otherData, QCPDataRange otherSegment) const { if (!mChannelFillGraph) return QPolygonF(); QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPolygonF(); } if (!mChannelFillGraph.data()->mKeyAxis) { qDebug() << Q_FUNC_INFO << "channel fill target key axis invalid"; return QPolygonF(); } if (mChannelFillGraph.data()->mKeyAxis.data()->orientation() != keyAxis->orientation()) return QPolygonF(); // don't have same axis orientation, can't fill that (Note: if keyAxis fits, valueAxis will fit too, because it's always orthogonal to keyAxis) if (thisData->isEmpty()) return QPolygonF(); QVector thisSegmentData(thisSegment.size()); QVector otherSegmentData(otherSegment.size()); std::copy(thisData->constBegin()+thisSegment.begin(), thisData->constBegin()+thisSegment.end(), thisSegmentData.begin()); std::copy(otherData->constBegin()+otherSegment.begin(), otherData->constBegin()+otherSegment.end(), otherSegmentData.begin()); // pointers to be able to swap them, depending which data range needs cropping: QVector *staticData = &thisSegmentData; QVector *croppedData = &otherSegmentData; // crop both vectors to ranges in which the keys overlap (which coord is key, depends on axisType): if (keyAxis->orientation() == Qt::Horizontal) { // x is key // crop lower bound: if (staticData->first().x() < croppedData->first().x()) // other one must be cropped qSwap(staticData, croppedData); const int lowBound = findIndexBelowX(croppedData, staticData->first().x()); if (lowBound == -1) return QPolygonF(); // key ranges have no overlap croppedData->remove(0, lowBound); // set lowest point of cropped data to fit exactly key position of first static data point via linear interpolation: if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation double slope; if (!qFuzzyCompare(croppedData->at(1).x(), croppedData->at(0).x())) slope = (croppedData->at(1).y()-croppedData->at(0).y())/(croppedData->at(1).x()-croppedData->at(0).x()); else slope = 0; (*croppedData)[0].setY(croppedData->at(0).y()+slope*(staticData->first().x()-croppedData->at(0).x())); (*croppedData)[0].setX(staticData->first().x()); // crop upper bound: if (staticData->last().x() > croppedData->last().x()) // other one must be cropped qSwap(staticData, croppedData); int highBound = findIndexAboveX(croppedData, staticData->last().x()); if (highBound == -1) return QPolygonF(); // key ranges have no overlap croppedData->remove(highBound+1, croppedData->size()-(highBound+1)); // set highest point of cropped data to fit exactly key position of last static data point via linear interpolation: if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation const int li = croppedData->size()-1; // last index if (!qFuzzyCompare(croppedData->at(li).x(), croppedData->at(li-1).x())) slope = (croppedData->at(li).y()-croppedData->at(li-1).y())/(croppedData->at(li).x()-croppedData->at(li-1).x()); else slope = 0; (*croppedData)[li].setY(croppedData->at(li-1).y()+slope*(staticData->last().x()-croppedData->at(li-1).x())); (*croppedData)[li].setX(staticData->last().x()); } else // mKeyAxis->orientation() == Qt::Vertical { // y is key // crop lower bound: if (staticData->first().y() < croppedData->first().y()) // other one must be cropped qSwap(staticData, croppedData); int lowBound = findIndexBelowY(croppedData, staticData->first().y()); if (lowBound == -1) return QPolygonF(); // key ranges have no overlap croppedData->remove(0, lowBound); // set lowest point of cropped data to fit exactly key position of first static data point via linear interpolation: if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation double slope; if (!qFuzzyCompare(croppedData->at(1).y(), croppedData->at(0).y())) // avoid division by zero in step plots slope = (croppedData->at(1).x()-croppedData->at(0).x())/(croppedData->at(1).y()-croppedData->at(0).y()); else slope = 0; (*croppedData)[0].setX(croppedData->at(0).x()+slope*(staticData->first().y()-croppedData->at(0).y())); (*croppedData)[0].setY(staticData->first().y()); // crop upper bound: if (staticData->last().y() > croppedData->last().y()) // other one must be cropped qSwap(staticData, croppedData); int highBound = findIndexAboveY(croppedData, staticData->last().y()); if (highBound == -1) return QPolygonF(); // key ranges have no overlap croppedData->remove(highBound+1, croppedData->size()-(highBound+1)); // set highest point of cropped data to fit exactly key position of last static data point via linear interpolation: if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation int li = croppedData->size()-1; // last index if (!qFuzzyCompare(croppedData->at(li).y(), croppedData->at(li-1).y())) // avoid division by zero in step plots slope = (croppedData->at(li).x()-croppedData->at(li-1).x())/(croppedData->at(li).y()-croppedData->at(li-1).y()); else slope = 0; (*croppedData)[li].setX(croppedData->at(li-1).x()+slope*(staticData->last().y()-croppedData->at(li-1).y())); (*croppedData)[li].setY(staticData->last().y()); } // return joined: for (int i=otherSegmentData.size()-1; i>=0; --i) // insert reversed, otherwise the polygon will be twisted thisSegmentData << otherSegmentData.at(i); return QPolygonF(thisSegmentData); } /*! \internal Finds the smallest index of \a data, whose points x value is just above \a x. Assumes x values in \a data points are ordered ascending, as is ensured by \ref getLines/\ref getScatters if the key axis is horizontal. Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. */ int QCPGraph::findIndexAboveX(const QVector *data, double x) const { for (int i=data->size()-1; i>=0; --i) { if (data->at(i).x() < x) { if (isize()-1) return i+1; else return data->size()-1; } } return -1; } /*! \internal Finds the highest index of \a data, whose points x value is just below \a x. Assumes x values in \a data points are ordered ascending, as is ensured by \ref getLines/\ref getScatters if the key axis is horizontal. Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. */ int QCPGraph::findIndexBelowX(const QVector *data, double x) const { for (int i=0; isize(); ++i) { if (data->at(i).x() > x) { if (i>0) return i-1; else return 0; } } return -1; } /*! \internal Finds the smallest index of \a data, whose points y value is just above \a y. Assumes y values in \a data points are ordered ascending, as is ensured by \ref getLines/\ref getScatters if the key axis is vertical. Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. */ int QCPGraph::findIndexAboveY(const QVector *data, double y) const { for (int i=data->size()-1; i>=0; --i) { if (data->at(i).y() < y) { if (isize()-1) return i+1; else return data->size()-1; } } return -1; } /*! \internal Calculates the minimum distance in pixels the graph's representation has from the given \a pixelPoint. This is used to determine whether the graph was clicked or not, e.g. in \ref selectTest. The closest data point to \a pixelPoint is returned in \a closestData. Note that if the graph has a line representation, the returned distance may be smaller than the distance to the \a closestData point, since the distance to the graph line is also taken into account. If either the graph has no data or if the line style is \ref lsNone and the scatter style's shape is \ref QCPScatterStyle::ssNone (i.e. there is no visual representation of the graph), returns -1.0. */ double QCPGraph::pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const { closestData = mDataContainer->constEnd(); if (mDataContainer->isEmpty()) return -1.0; if (mLineStyle == lsNone && mScatterStyle.isNone()) return -1.0; // calculate minimum distances to graph data points and find closestData iterator: double minDistSqr = (std::numeric_limits::max)(); // determine which key range comes into question, taking selection tolerance around pos into account: double posKeyMin, posKeyMax, dummy; pixelsToCoords(pixelPoint-QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMin, dummy); pixelsToCoords(pixelPoint+QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMax, dummy); if (posKeyMin > posKeyMax) qSwap(posKeyMin, posKeyMax); // iterate over found data points and then choose the one with the shortest distance to pos: QCPGraphDataContainer::const_iterator begin = mDataContainer->findBegin(posKeyMin, true); QCPGraphDataContainer::const_iterator end = mDataContainer->findEnd(posKeyMax, true); for (QCPGraphDataContainer::const_iterator it=begin; it!=end; ++it) { const double currentDistSqr = QCPVector2D(coordsToPixels(it->key, it->value)-pixelPoint).lengthSquared(); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestData = it; } } // calculate distance to graph line if there is one (if so, will probably be smaller than distance to closest data point): if (mLineStyle != lsNone) { // line displayed, calculate distance to line segments: QVector lineData; getLines(&lineData, QCPDataRange(0, dataCount())); // don't limit data range further since with sharp data spikes, line segments may be closer to test point than segments with closer key coordinate QCPVector2D p(pixelPoint); const int step = mLineStyle==lsImpulse ? 2 : 1; // impulse plot differs from other line styles in that the lineData points are only pairwise connected for (int i=0; i *data, double y) const { for (int i=0; isize(); ++i) { if (data->at(i).y() > y) { if (i>0) return i-1; else return 0; } } return -1; } /* end of 'src/plottables/plottable-graph.cpp' */ /* including file 'src/plottables/plottable-curve.cpp' */ /* modified 2021-03-29T02:30:44, size 63851 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPCurveData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPCurveData \brief Holds the data of one single data point for QCPCurve. The stored data is: \li \a t: the free ordering parameter of this curve point, like in the mathematical vector (x(t), y(t)). (This is the \a sortKey) \li \a key: coordinate on the key axis of this curve point (this is the \a mainKey) \li \a value: coordinate on the value axis of this curve point (this is the \a mainValue) The container for storing multiple data points is \ref QCPCurveDataContainer. It is a typedef for \ref QCPDataContainer with \ref QCPCurveData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods. \see QCPCurveDataContainer */ /* start documentation of inline functions */ /*! \fn double QCPCurveData::sortKey() const Returns the \a t member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static QCPCurveData QCPCurveData::fromSortKey(double sortKey) Returns a data point with the specified \a sortKey (assigned to the data point's \a t member). All other members are set to zero. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static static bool QCPCurveData::sortKeyIsMainKey() Since the member \a key is the data point key coordinate and the member \a t is the data ordering parameter, this method returns false. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPCurveData::mainKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPCurveData::mainValue() const Returns the \a value member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn QCPRange QCPCurveData::valueRange() const Returns a QCPRange with both lower and upper boundary set to \a value of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /* end documentation of inline functions */ /*! Constructs a curve data point with t, key and value set to zero. */ QCPCurveData::QCPCurveData() : t(0), key(0), value(0) { } /*! Constructs a curve data point with the specified \a t, \a key and \a value. */ QCPCurveData::QCPCurveData(double t, double key, double value) : t(t), key(key), value(value) { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPCurve //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPCurve \brief A plottable representing a parametric curve in a plot. \image html QCPCurve.png Unlike QCPGraph, plottables of this type may have multiple points with the same key coordinate, so their visual representation can have \a loops. This is realized by introducing a third coordinate \a t, which defines the order of the points described by the other two coordinates \a x and \a y. To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can also access and modify the curve's data via the \ref data method, which returns a pointer to the internal \ref QCPCurveDataContainer. Gaps in the curve can be created by adding data points with NaN as key and value (qQNaN() or std::numeric_limits::quiet_NaN()) in between the two data points that shall be separated. \section qcpcurve-appearance Changing the appearance The appearance of the curve is determined by the pen and the brush (\ref setPen, \ref setBrush). \section qcpcurve-usage Usage Like all data representing objects in QCustomPlot, the QCPCurve is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) Usually, you first create an instance: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-creation-1 which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-creation-2 */ /* start of documentation of inline functions */ /*! \fn QSharedPointer QCPCurve::data() const Returns a shared pointer to the internal data storage of type \ref QCPCurveDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular \ref setData or \ref addData methods. */ /* end of documentation of inline functions */ /*! Constructs a curve which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. The created QCPCurve is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the QCPCurve, so do not delete it manually but use QCustomPlot::removePlottable() instead. */ QCPCurve::QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable1D(keyAxis, valueAxis), mScatterSkip{}, mLineStyle{} { // modify inherited properties from abstract plottable: setPen(QPen(Qt::blue, 0)); setBrush(Qt::NoBrush); setScatterStyle(QCPScatterStyle()); setLineStyle(lsLine); setScatterSkip(0); } QCPCurve::~QCPCurve() { } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple QCPCurves may share the same data container safely. Modifying the data in the container will then affect all curves that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, rather use the \ref QCPDataContainer::set method on the curve's data container directly: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-datasharing-2 \see addData */ void QCPCurve::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Replaces the current data with the provided points in \a t, \a keys and \a values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a t in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. \see addData */ void QCPCurve::setData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted) { mDataContainer->clear(); addData(t, keys, values, alreadySorted); } /*! \overload Replaces the current data with the provided points in \a keys and \a values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. The t parameter of each data point will be set to the integer index of the respective key/value pair. \see addData */ void QCPCurve::setData(const QVector &keys, const QVector &values) { mDataContainer->clear(); addData(keys, values); } /*! Sets the visual appearance of single data points in the plot. If set to \ref QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only plots with appropriate line style). \see QCPScatterStyle, setLineStyle */ void QCPCurve::setScatterStyle(const QCPScatterStyle &style) { mScatterStyle = style; } /*! If scatters are displayed (scatter style not \ref QCPScatterStyle::ssNone), \a skip number of scatter points are skipped/not drawn after every drawn scatter point. This can be used to make the data appear sparser while for example still having a smooth line, and to improve performance for very high density plots. If \a skip is set to 0 (default), all scatter points are drawn. \see setScatterStyle */ void QCPCurve::setScatterSkip(int skip) { mScatterSkip = qMax(0, skip); } /*! Sets how the single data points are connected in the plot or how they are represented visually apart from the scatter symbol. For scatter-only plots, set \a style to \ref lsNone and \ref setScatterStyle to the desired scatter style. \see setScatterStyle */ void QCPCurve::setLineStyle(QCPCurve::LineStyle style) { mLineStyle = style; } /*! \overload Adds the provided points in \a t, \a keys and \a values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPCurve::addData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted) { if (t.size() != keys.size() || t.size() != values.size()) qDebug() << Q_FUNC_INFO << "ts, keys and values have different sizes:" << t.size() << keys.size() << values.size(); const int n = qMin(qMin(t.size(), keys.size()), values.size()); QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->t = t[i]; it->key = keys[i]; it->value = values[i]; ++it; ++i; } mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write } /*! \overload Adds the provided points in \a keys and \a values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. The t parameter of each data point will be set to the integer index of the respective key/value pair. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPCurve::addData(const QVector &keys, const QVector &values) { if (keys.size() != values.size()) qDebug() << Q_FUNC_INFO << "keys and values have different sizes:" << keys.size() << values.size(); const int n = qMin(keys.size(), values.size()); double tStart; if (!mDataContainer->isEmpty()) tStart = (mDataContainer->constEnd()-1)->t + 1.0; else tStart = 0; QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->t = tStart + i; it->key = keys[i]; it->value = values[i]; ++it; ++i; } mDataContainer->add(tempData, true); // don't modify tempData beyond this to prevent copy on write } /*! \overload Adds the provided data point as \a t, \a key and \a value to the current data. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPCurve::addData(double t, double key, double value) { mDataContainer->add(QCPCurveData(t, key, value)); } /*! \overload Adds the provided data point as \a key and \a value to the current data. The t parameter is generated automatically by increments of 1 for each point, starting at the highest t of previously existing data or 0, if the curve data is empty. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPCurve::addData(double key, double value) { if (!mDataContainer->isEmpty()) mDataContainer->add(QCPCurveData((mDataContainer->constEnd()-1)->t + 1.0, key, value)); else mDataContainer->add(QCPCurveData(0.0, key, value)); } /*! Implements a selectTest specific to this plottable's point geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod \ref QCPAbstractPlottable::selectTest */ double QCPCurve::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { QCPCurveDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); double result = pointDistance(pos, closestDataPoint); if (details) { int pointIndex = int( closestDataPoint-mDataContainer->constBegin() ); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return result; } else return -1; } /* inherits documentation from base class */ QCPRange QCPCurve::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { return mDataContainer->keyRange(foundRange, inSignDomain); } /* inherits documentation from base class */ QCPRange QCPCurve::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); } /* inherits documentation from base class */ void QCPCurve::draw(QCPPainter *painter) { if (mDataContainer->isEmpty()) return; // allocate line vector: QVector lines, scatters; // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; for (int i=0; i= unselectedSegments.size(); // fill with curve data: QPen finalCurvePen = mPen; // determine the final pen already here, because the line optimization depends on its stroke width if (isSelectedSegment && mSelectionDecorator) finalCurvePen = mSelectionDecorator->pen(); QCPDataRange lineDataRange = isSelectedSegment ? allSegments.at(i) : allSegments.at(i).adjusted(-1, 1); // unselected segments extend lines to bordering selected data point (safe to exceed total data bounds in first/last segment, getCurveLines takes care) getCurveLines(&lines, lineDataRange, finalCurvePen.widthF()); // check data validity if flag set: #ifdef QCUSTOMPLOT_CHECK_DATA for (QCPCurveDataContainer::const_iterator it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) { if (QCP::isInvalidData(it->t) || QCP::isInvalidData(it->key, it->value)) qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "invalid." << "Plottable name:" << name(); } #endif // draw curve fill: applyFillAntialiasingHint(painter); if (isSelectedSegment && mSelectionDecorator) mSelectionDecorator->applyBrush(painter); else painter->setBrush(mBrush); painter->setPen(Qt::NoPen); if (painter->brush().style() != Qt::NoBrush && painter->brush().color().alpha() != 0) painter->drawPolygon(QPolygonF(lines)); // draw curve line: if (mLineStyle != lsNone) { painter->setPen(finalCurvePen); painter->setBrush(Qt::NoBrush); drawCurveLine(painter, lines); } // draw scatters: QCPScatterStyle finalScatterStyle = mScatterStyle; if (isSelectedSegment && mSelectionDecorator) finalScatterStyle = mSelectionDecorator->getFinalScatterStyle(mScatterStyle); if (!finalScatterStyle.isNone()) { getScatters(&scatters, allSegments.at(i), finalScatterStyle.size()); drawScatterPlot(painter, scatters, finalScatterStyle); } } // draw other selection decoration that isn't just line/scatter pens and brushes: if (mSelectionDecorator) mSelectionDecorator->drawDecoration(painter, selection()); } /* inherits documentation from base class */ void QCPCurve::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { // draw fill: if (mBrush.style() != Qt::NoBrush) { applyFillAntialiasingHint(painter); painter->fillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); } // draw line vertically centered: if (mLineStyle != lsNone) { applyDefaultAntialiasingHint(painter); painter->setPen(mPen); painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens } // draw scatter symbol: if (!mScatterStyle.isNone()) { applyScattersAntialiasingHint(painter); // scale scatter pixmap if it's too large to fit in legend icon rect: if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) { QCPScatterStyle scaledStyle(mScatterStyle); scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); scaledStyle.applyTo(painter, mPen); scaledStyle.drawShape(painter, QRectF(rect).center()); } else { mScatterStyle.applyTo(painter, mPen); mScatterStyle.drawShape(painter, QRectF(rect).center()); } } } /*! \internal Draws lines between the points in \a lines, given in pixel coordinates. \see drawScatterPlot, getCurveLines */ void QCPCurve::drawCurveLine(QCPPainter *painter, const QVector &lines) const { if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) { applyDefaultAntialiasingHint(painter); drawPolyline(painter, lines); } } /*! \internal Draws scatter symbols at every point passed in \a points, given in pixel coordinates. The scatters will be drawn with \a painter and have the appearance as specified in \a style. \see drawCurveLine, getCurveLines */ void QCPCurve::drawScatterPlot(QCPPainter *painter, const QVector &points, const QCPScatterStyle &style) const { // draw scatter point symbols: applyScattersAntialiasingHint(painter); style.applyTo(painter, mPen); foreach (const QPointF &point, points) if (!qIsNaN(point.x()) && !qIsNaN(point.y())) style.drawShape(painter, point); } /*! \internal Called by \ref draw to generate points in pixel coordinates which represent the line of the curve. Line segments that aren't visible in the current axis rect are handled in an optimized way. They are projected onto a rectangle slightly larger than the visible axis rect and simplified regarding point count. The algorithm makes sure to preserve appearance of lines and fills inside the visible axis rect by generating new temporary points on the outer rect if necessary. \a lines will be filled with points in pixel coordinates, that can be drawn with \ref drawCurveLine. \a dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in \a dataRange, e.g. when extending ranges coming from \ref getDataSegments. \a penWidth specifies the pen width that will be used to later draw the lines generated by this function. This is needed here to calculate an accordingly wider margin around the axis rect when performing the line optimization. Methods that are also involved in the algorithm are: \ref getRegion, \ref getOptimizedPoint, \ref getOptimizedCornerPoints \ref mayTraverse, \ref getTraverse, \ref getTraverseCornerPoints. \see drawCurveLine, drawScatterPlot */ void QCPCurve::getCurveLines(QVector *lines, const QCPDataRange &dataRange, double penWidth) const { if (!lines) return; lines->clear(); QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } // add margins to rect to compensate for stroke width const double strokeMargin = qMax(qreal(1.0), qreal(penWidth*0.75)); // stroke radius + 50% safety const double keyMin = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyAxis->range().lower)-strokeMargin*keyAxis->pixelOrientation()); const double keyMax = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyAxis->range().upper)+strokeMargin*keyAxis->pixelOrientation()); const double valueMin = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueAxis->range().lower)-strokeMargin*valueAxis->pixelOrientation()); const double valueMax = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueAxis->range().upper)+strokeMargin*valueAxis->pixelOrientation()); QCPCurveDataContainer::const_iterator itBegin = mDataContainer->constBegin(); QCPCurveDataContainer::const_iterator itEnd = mDataContainer->constEnd(); mDataContainer->limitIteratorsToDataRange(itBegin, itEnd, dataRange); if (itBegin == itEnd) return; QCPCurveDataContainer::const_iterator it = itBegin; QCPCurveDataContainer::const_iterator prevIt = itEnd-1; int prevRegion = getRegion(prevIt->key, prevIt->value, keyMin, valueMax, keyMax, valueMin); QVector trailingPoints; // points that must be applied after all other points (are generated only when handling first point to get virtual segment between last and first point right) while (it != itEnd) { const int currentRegion = getRegion(it->key, it->value, keyMin, valueMax, keyMax, valueMin); if (currentRegion != prevRegion) // changed region, possibly need to add some optimized edge points or original points if entering R { if (currentRegion != 5) // segment doesn't end in R, so it's a candidate for removal { QPointF crossA, crossB; if (prevRegion == 5) // we're coming from R, so add this point optimized { lines->append(getOptimizedPoint(currentRegion, it->key, it->value, prevIt->key, prevIt->value, keyMin, valueMax, keyMax, valueMin)); // in the situations 5->1/7/9/3 the segment may leave R and directly cross through two outer regions. In these cases we need to add an additional corner point *lines << getOptimizedCornerPoints(prevRegion, currentRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin); } else if (mayTraverse(prevRegion, currentRegion) && getTraverse(prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin, crossA, crossB)) { // add the two cross points optimized if segment crosses R and if segment isn't virtual zeroth segment between last and first curve point: QVector beforeTraverseCornerPoints, afterTraverseCornerPoints; getTraverseCornerPoints(prevRegion, currentRegion, keyMin, valueMax, keyMax, valueMin, beforeTraverseCornerPoints, afterTraverseCornerPoints); if (it != itBegin) { *lines << beforeTraverseCornerPoints; lines->append(crossA); lines->append(crossB); *lines << afterTraverseCornerPoints; } else { lines->append(crossB); *lines << afterTraverseCornerPoints; trailingPoints << beforeTraverseCornerPoints << crossA ; } } else // doesn't cross R, line is just moving around in outside regions, so only need to add optimized point(s) at the boundary corner(s) { *lines << getOptimizedCornerPoints(prevRegion, currentRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin); } } else // segment does end in R, so we add previous point optimized and this point at original position { if (it == itBegin) // it is first point in curve and prevIt is last one. So save optimized point for adding it to the lineData in the end trailingPoints << getOptimizedPoint(prevRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin); else lines->append(getOptimizedPoint(prevRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin)); lines->append(coordsToPixels(it->key, it->value)); } } else // region didn't change { if (currentRegion == 5) // still in R, keep adding original points { lines->append(coordsToPixels(it->key, it->value)); } else // still outside R, no need to add anything { // see how this is not doing anything? That's the main optimization... } } prevIt = it; prevRegion = currentRegion; ++it; } *lines << trailingPoints; } /*! \internal Called by \ref draw to generate points in pixel coordinates which represent the scatters of the curve. If a scatter skip is configured (\ref setScatterSkip), the returned points are accordingly sparser. Scatters that aren't visible in the current axis rect are optimized away. \a scatters will be filled with points in pixel coordinates, that can be drawn with \ref drawScatterPlot. \a dataRange specifies the beginning and ending data indices that will be taken into account for conversion. \a scatterWidth specifies the scatter width that will be used to later draw the scatters at pixel coordinates generated by this function. This is needed here to calculate an accordingly wider margin around the axis rect when performing the data point reduction. \see draw, drawScatterPlot */ void QCPCurve::getScatters(QVector *scatters, const QCPDataRange &dataRange, double scatterWidth) const { if (!scatters) return; scatters->clear(); QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } QCPCurveDataContainer::const_iterator begin = mDataContainer->constBegin(); QCPCurveDataContainer::const_iterator end = mDataContainer->constEnd(); mDataContainer->limitIteratorsToDataRange(begin, end, dataRange); if (begin == end) return; const int scatterModulo = mScatterSkip+1; const bool doScatterSkip = mScatterSkip > 0; int endIndex = int( end-mDataContainer->constBegin() ); QCPRange keyRange = keyAxis->range(); QCPRange valueRange = valueAxis->range(); // extend range to include width of scatter symbols: keyRange.lower = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyRange.lower)-scatterWidth*keyAxis->pixelOrientation()); keyRange.upper = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyRange.upper)+scatterWidth*keyAxis->pixelOrientation()); valueRange.lower = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueRange.lower)-scatterWidth*valueAxis->pixelOrientation()); valueRange.upper = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueRange.upper)+scatterWidth*valueAxis->pixelOrientation()); QCPCurveDataContainer::const_iterator it = begin; int itIndex = int( begin-mDataContainer->constBegin() ); while (doScatterSkip && it != end && itIndex % scatterModulo != 0) // advance begin iterator to first non-skipped scatter { ++itIndex; ++it; } if (keyAxis->orientation() == Qt::Vertical) { while (it != end) { if (!qIsNaN(it->value) && keyRange.contains(it->key) && valueRange.contains(it->value)) scatters->append(QPointF(valueAxis->coordToPixel(it->value), keyAxis->coordToPixel(it->key))); // advance iterator to next (non-skipped) data point: if (!doScatterSkip) ++it; else { itIndex += scatterModulo; if (itIndex < endIndex) // make sure we didn't jump over end it += scatterModulo; else { it = end; itIndex = endIndex; } } } } else { while (it != end) { if (!qIsNaN(it->value) && keyRange.contains(it->key) && valueRange.contains(it->value)) scatters->append(QPointF(keyAxis->coordToPixel(it->key), valueAxis->coordToPixel(it->value))); // advance iterator to next (non-skipped) data point: if (!doScatterSkip) ++it; else { itIndex += scatterModulo; if (itIndex < endIndex) // make sure we didn't jump over end it += scatterModulo; else { it = end; itIndex = endIndex; } } } } } /*! \internal This function is part of the curve optimization algorithm of \ref getCurveLines. It returns the region of the given point (\a key, \a value) with respect to a rectangle defined by \a keyMin, \a keyMax, \a valueMin, and \a valueMax. The regions are enumerated from top to bottom (\a valueMin to \a valueMax) and left to right (\a keyMin to \a keyMax):
147
258
369
With the rectangle being region 5, and the outer regions extending infinitely outwards. In the curve optimization algorithm, region 5 is considered to be the visible portion of the plot. */ int QCPCurve::getRegion(double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const { if (key < keyMin) // region 123 { if (value > valueMax) return 1; else if (value < valueMin) return 3; else return 2; } else if (key > keyMax) // region 789 { if (value > valueMax) return 7; else if (value < valueMin) return 9; else return 8; } else // region 456 { if (value > valueMax) return 4; else if (value < valueMin) return 6; else return 5; } } /*! \internal This function is part of the curve optimization algorithm of \ref getCurveLines. This method is used in case the current segment passes from inside the visible rect (region 5, see \ref getRegion) to any of the outer regions (\a otherRegion). The current segment is given by the line connecting (\a key, \a value) with (\a otherKey, \a otherValue). It returns the intersection point of the segment with the border of region 5. For this function it doesn't matter whether (\a key, \a value) is the point inside region 5 or whether it's (\a otherKey, \a otherValue), i.e. whether the segment is coming from region 5 or leaving it. It is important though that \a otherRegion correctly identifies the other region not equal to 5. */ QPointF QCPCurve::getOptimizedPoint(int otherRegion, double otherKey, double otherValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const { // The intersection point interpolation here is done in pixel coordinates, so we don't need to // differentiate between different axis scale types. Note that the nomenclature // top/left/bottom/right/min/max is with respect to the rect in plot coordinates, wich may be // different in pixel coordinates (horz/vert key axes, reversed ranges) const double keyMinPx = mKeyAxis->coordToPixel(keyMin); const double keyMaxPx = mKeyAxis->coordToPixel(keyMax); const double valueMinPx = mValueAxis->coordToPixel(valueMin); const double valueMaxPx = mValueAxis->coordToPixel(valueMax); const double otherValuePx = mValueAxis->coordToPixel(otherValue); const double valuePx = mValueAxis->coordToPixel(value); const double otherKeyPx = mKeyAxis->coordToPixel(otherKey); const double keyPx = mKeyAxis->coordToPixel(key); double intersectKeyPx = keyMinPx; // initial key just a fail-safe double intersectValuePx = valueMinPx; // initial value just a fail-safe switch (otherRegion) { case 1: // top and left edge { intersectValuePx = valueMaxPx; intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether top edge is not intersected, then it must be left edge (qMin/qMax necessary since axes may be reversed) { intersectKeyPx = keyMinPx; intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); } break; } case 2: // left edge { intersectKeyPx = keyMinPx; intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); break; } case 3: // bottom and left edge { intersectValuePx = valueMinPx; intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether bottom edge is not intersected, then it must be left edge (qMin/qMax necessary since axes may be reversed) { intersectKeyPx = keyMinPx; intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); } break; } case 4: // top edge { intersectValuePx = valueMaxPx; intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); break; } case 5: { break; // case 5 shouldn't happen for this function but we add it anyway to prevent potential discontinuity in branch table } case 6: // bottom edge { intersectValuePx = valueMinPx; intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); break; } case 7: // top and right edge { intersectValuePx = valueMaxPx; intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether top edge is not intersected, then it must be right edge (qMin/qMax necessary since axes may be reversed) { intersectKeyPx = keyMaxPx; intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); } break; } case 8: // right edge { intersectKeyPx = keyMaxPx; intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); break; } case 9: // bottom and right edge { intersectValuePx = valueMinPx; intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether bottom edge is not intersected, then it must be right edge (qMin/qMax necessary since axes may be reversed) { intersectKeyPx = keyMaxPx; intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); } break; } } if (mKeyAxis->orientation() == Qt::Horizontal) return {intersectKeyPx, intersectValuePx}; else return {intersectValuePx, intersectKeyPx}; } /*! \internal This function is part of the curve optimization algorithm of \ref getCurveLines. In situations where a single segment skips over multiple regions it might become necessary to add extra points at the corners of region 5 (see \ref getRegion) such that the optimized segment doesn't unintentionally cut through the visible area of the axis rect and create plot artifacts. This method provides these points that must be added, assuming the original segment doesn't start, end, or traverse region 5. (Corner points where region 5 is traversed are calculated by \ref getTraverseCornerPoints.) For example, consider a segment which directly goes from region 4 to 2 but originally is far out to the top left such that it doesn't cross region 5. Naively optimizing these points by projecting them on the top and left borders of region 5 will create a segment that surely crosses 5, creating a visual artifact in the plot. This method prevents this by providing extra points at the top left corner, making the optimized curve correctly pass from region 4 to 1 to 2 without traversing 5. */ QVector QCPCurve::getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const { QVector result; switch (prevRegion) { case 1: { switch (currentRegion) { case 2: { result << coordsToPixels(keyMin, valueMax); break; } case 4: { result << coordsToPixels(keyMin, valueMax); break; } case 3: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMin, valueMin); break; } case 7: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMax, valueMax); break; } case 6: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } case 8: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } case 9: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points if ((value-prevValue)/(key-prevKey)*(keyMin-key)+value < valueMin) // segment passes below R { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); } else { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); } break; } } break; } case 2: { switch (currentRegion) { case 1: { result << coordsToPixels(keyMin, valueMax); break; } case 3: { result << coordsToPixels(keyMin, valueMin); break; } case 4: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } case 6: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } case 7: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); break; } case 9: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); break; } } break; } case 3: { switch (currentRegion) { case 2: { result << coordsToPixels(keyMin, valueMin); break; } case 6: { result << coordsToPixels(keyMin, valueMin); break; } case 1: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMin, valueMax); break; } case 9: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMax, valueMin); break; } case 4: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } case 8: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } case 7: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points if ((value-prevValue)/(key-prevKey)*(keyMax-key)+value < valueMin) // segment passes below R { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); } else { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); } break; } } break; } case 4: { switch (currentRegion) { case 1: { result << coordsToPixels(keyMin, valueMax); break; } case 7: { result << coordsToPixels(keyMax, valueMax); break; } case 2: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } case 8: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } case 3: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); break; } case 9: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); break; } } break; } case 5: { switch (currentRegion) { case 1: { result << coordsToPixels(keyMin, valueMax); break; } case 7: { result << coordsToPixels(keyMax, valueMax); break; } case 9: { result << coordsToPixels(keyMax, valueMin); break; } case 3: { result << coordsToPixels(keyMin, valueMin); break; } } break; } case 6: { switch (currentRegion) { case 3: { result << coordsToPixels(keyMin, valueMin); break; } case 9: { result << coordsToPixels(keyMax, valueMin); break; } case 2: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } case 8: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } case 1: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); break; } case 7: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); break; } } break; } case 7: { switch (currentRegion) { case 4: { result << coordsToPixels(keyMax, valueMax); break; } case 8: { result << coordsToPixels(keyMax, valueMax); break; } case 1: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMin, valueMax); break; } case 9: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMax, valueMin); break; } case 2: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } case 6: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } case 3: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points if ((value-prevValue)/(key-prevKey)*(keyMax-key)+value < valueMin) // segment passes below R { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); } else { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); } break; } } break; } case 8: { switch (currentRegion) { case 7: { result << coordsToPixels(keyMax, valueMax); break; } case 9: { result << coordsToPixels(keyMax, valueMin); break; } case 4: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } case 6: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } case 1: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); break; } case 3: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); break; } } break; } case 9: { switch (currentRegion) { case 6: { result << coordsToPixels(keyMax, valueMin); break; } case 8: { result << coordsToPixels(keyMax, valueMin); break; } case 3: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMin, valueMin); break; } case 7: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMax, valueMax); break; } case 2: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } case 4: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } case 1: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points if ((value-prevValue)/(key-prevKey)*(keyMin-key)+value < valueMin) // segment passes below R { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); } else { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); } break; } } break; } } return result; } /*! \internal This function is part of the curve optimization algorithm of \ref getCurveLines. This method returns whether a segment going from \a prevRegion to \a currentRegion (see \ref getRegion) may traverse the visible region 5. This function assumes that neither \a prevRegion nor \a currentRegion is 5 itself. If this method returns false, the segment for sure doesn't pass region 5. If it returns true, the segment may or may not pass region 5 and a more fine-grained calculation must be used (\ref getTraverse). */ bool QCPCurve::mayTraverse(int prevRegion, int currentRegion) const { switch (prevRegion) { case 1: { switch (currentRegion) { case 4: case 7: case 2: case 3: return false; default: return true; } } case 2: { switch (currentRegion) { case 1: case 3: return false; default: return true; } } case 3: { switch (currentRegion) { case 1: case 2: case 6: case 9: return false; default: return true; } } case 4: { switch (currentRegion) { case 1: case 7: return false; default: return true; } } case 5: return false; // should never occur case 6: { switch (currentRegion) { case 3: case 9: return false; default: return true; } } case 7: { switch (currentRegion) { case 1: case 4: case 8: case 9: return false; default: return true; } } case 8: { switch (currentRegion) { case 7: case 9: return false; default: return true; } } case 9: { switch (currentRegion) { case 3: case 6: case 8: case 7: return false; default: return true; } } default: return true; } } /*! \internal This function is part of the curve optimization algorithm of \ref getCurveLines. This method assumes that the \ref mayTraverse test has returned true, so there is a chance the segment defined by (\a prevKey, \a prevValue) and (\a key, \a value) goes through the visible region 5. The return value of this method indicates whether the segment actually traverses region 5 or not. If the segment traverses 5, the output parameters \a crossA and \a crossB indicate the entry and exit points of region 5. They will become the optimized points for that segment. */ bool QCPCurve::getTraverse(double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const { // The intersection point interpolation here is done in pixel coordinates, so we don't need to // differentiate between different axis scale types. Note that the nomenclature // top/left/bottom/right/min/max is with respect to the rect in plot coordinates, wich may be // different in pixel coordinates (horz/vert key axes, reversed ranges) QList intersections; const double valueMinPx = mValueAxis->coordToPixel(valueMin); const double valueMaxPx = mValueAxis->coordToPixel(valueMax); const double keyMinPx = mKeyAxis->coordToPixel(keyMin); const double keyMaxPx = mKeyAxis->coordToPixel(keyMax); const double keyPx = mKeyAxis->coordToPixel(key); const double valuePx = mValueAxis->coordToPixel(value); const double prevKeyPx = mKeyAxis->coordToPixel(prevKey); const double prevValuePx = mValueAxis->coordToPixel(prevValue); if (qFuzzyIsNull(keyPx-prevKeyPx)) // line is parallel to value axis { // due to region filter in mayTraverse(), if line is parallel to value or key axis, region 5 is traversed here intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyPx, valueMinPx) : QPointF(valueMinPx, keyPx)); // direction will be taken care of at end of method intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyPx, valueMaxPx) : QPointF(valueMaxPx, keyPx)); } else if (qFuzzyIsNull(valuePx-prevValuePx)) // line is parallel to key axis { // due to region filter in mayTraverse(), if line is parallel to value or key axis, region 5 is traversed here intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMinPx, valuePx) : QPointF(valuePx, keyMinPx)); // direction will be taken care of at end of method intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMaxPx, valuePx) : QPointF(valuePx, keyMaxPx)); } else // line is skewed { double gamma; double keyPerValuePx = (keyPx-prevKeyPx)/(valuePx-prevValuePx); // check top of rect: gamma = prevKeyPx + (valueMaxPx-prevValuePx)*keyPerValuePx; if (gamma >= qMin(keyMinPx, keyMaxPx) && gamma <= qMax(keyMinPx, keyMaxPx)) // qMin/qMax necessary since axes may be reversed intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(gamma, valueMaxPx) : QPointF(valueMaxPx, gamma)); // check bottom of rect: gamma = prevKeyPx + (valueMinPx-prevValuePx)*keyPerValuePx; if (gamma >= qMin(keyMinPx, keyMaxPx) && gamma <= qMax(keyMinPx, keyMaxPx)) // qMin/qMax necessary since axes may be reversed intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(gamma, valueMinPx) : QPointF(valueMinPx, gamma)); const double valuePerKeyPx = 1.0/keyPerValuePx; // check left of rect: gamma = prevValuePx + (keyMinPx-prevKeyPx)*valuePerKeyPx; if (gamma >= qMin(valueMinPx, valueMaxPx) && gamma <= qMax(valueMinPx, valueMaxPx)) // qMin/qMax necessary since axes may be reversed intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMinPx, gamma) : QPointF(gamma, keyMinPx)); // check right of rect: gamma = prevValuePx + (keyMaxPx-prevKeyPx)*valuePerKeyPx; if (gamma >= qMin(valueMinPx, valueMaxPx) && gamma <= qMax(valueMinPx, valueMaxPx)) // qMin/qMax necessary since axes may be reversed intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMaxPx, gamma) : QPointF(gamma, keyMaxPx)); } // handle cases where found points isn't exactly 2: if (intersections.size() > 2) { // line probably goes through corner of rect, and we got duplicate points there. single out the point pair with greatest distance in between: double distSqrMax = 0; QPointF pv1, pv2; for (int i=0; i distSqrMax) { pv1 = intersections.at(i); pv2 = intersections.at(k); distSqrMax = distSqr; } } } intersections = QList() << pv1 << pv2; } else if (intersections.size() != 2) { // one or even zero points found (shouldn't happen unless line perfectly tangent to corner), no need to draw segment return false; } // possibly re-sort points so optimized point segment has same direction as original segment: double xDelta = keyPx-prevKeyPx; double yDelta = valuePx-prevValuePx; if (mKeyAxis->orientation() != Qt::Horizontal) qSwap(xDelta, yDelta); if (xDelta*(intersections.at(1).x()-intersections.at(0).x()) + yDelta*(intersections.at(1).y()-intersections.at(0).y()) < 0) // scalar product of both segments < 0 -> opposite direction intersections.move(0, 1); crossA = intersections.at(0); crossB = intersections.at(1); return true; } /*! \internal This function is part of the curve optimization algorithm of \ref getCurveLines. This method assumes that the \ref getTraverse test has returned true, so the segment definitely traverses the visible region 5 when going from \a prevRegion to \a currentRegion. In certain situations it is not sufficient to merely generate the entry and exit points of the segment into/out of region 5, as \ref getTraverse provides. It may happen that a single segment, in addition to traversing region 5, skips another region outside of region 5, which makes it necessary to add an optimized corner point there (very similar to the job \ref getOptimizedCornerPoints does for segments that are completely in outside regions and don't traverse 5). As an example, consider a segment going from region 1 to region 6, traversing the lower left corner of region 5. In this configuration, the segment additionally crosses the border between region 1 and 2 before entering region 5. This makes it necessary to add an additional point in the top left corner, before adding the optimized traverse points. So in this case, the output parameter \a beforeTraverse will contain the top left corner point, and \a afterTraverse will be empty. In some cases, such as when going from region 1 to 9, it may even be necessary to add additional corner points before and after the traverse. Then both \a beforeTraverse and \a afterTraverse return the respective corner points. */ void QCPCurve::getTraverseCornerPoints(int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector &beforeTraverse, QVector &afterTraverse) const { switch (prevRegion) { case 1: { switch (currentRegion) { case 6: { beforeTraverse << coordsToPixels(keyMin, valueMax); break; } case 9: { beforeTraverse << coordsToPixels(keyMin, valueMax); afterTraverse << coordsToPixels(keyMax, valueMin); break; } case 8: { beforeTraverse << coordsToPixels(keyMin, valueMax); break; } } break; } case 2: { switch (currentRegion) { case 7: { afterTraverse << coordsToPixels(keyMax, valueMax); break; } case 9: { afterTraverse << coordsToPixels(keyMax, valueMin); break; } } break; } case 3: { switch (currentRegion) { case 4: { beforeTraverse << coordsToPixels(keyMin, valueMin); break; } case 7: { beforeTraverse << coordsToPixels(keyMin, valueMin); afterTraverse << coordsToPixels(keyMax, valueMax); break; } case 8: { beforeTraverse << coordsToPixels(keyMin, valueMin); break; } } break; } case 4: { switch (currentRegion) { case 3: { afterTraverse << coordsToPixels(keyMin, valueMin); break; } case 9: { afterTraverse << coordsToPixels(keyMax, valueMin); break; } } break; } case 5: { break; } // shouldn't happen because this method only handles full traverses case 6: { switch (currentRegion) { case 1: { afterTraverse << coordsToPixels(keyMin, valueMax); break; } case 7: { afterTraverse << coordsToPixels(keyMax, valueMax); break; } } break; } case 7: { switch (currentRegion) { case 2: { beforeTraverse << coordsToPixels(keyMax, valueMax); break; } case 3: { beforeTraverse << coordsToPixels(keyMax, valueMax); afterTraverse << coordsToPixels(keyMin, valueMin); break; } case 6: { beforeTraverse << coordsToPixels(keyMax, valueMax); break; } } break; } case 8: { switch (currentRegion) { case 1: { afterTraverse << coordsToPixels(keyMin, valueMax); break; } case 3: { afterTraverse << coordsToPixels(keyMin, valueMin); break; } } break; } case 9: { switch (currentRegion) { case 2: { beforeTraverse << coordsToPixels(keyMax, valueMin); break; } case 1: { beforeTraverse << coordsToPixels(keyMax, valueMin); afterTraverse << coordsToPixels(keyMin, valueMax); break; } case 4: { beforeTraverse << coordsToPixels(keyMax, valueMin); break; } } break; } } } /*! \internal Calculates the (minimum) distance (in pixels) the curve's representation has from the given \a pixelPoint in pixels. This is used to determine whether the curve was clicked or not, e.g. in \ref selectTest. The closest data point to \a pixelPoint is returned in \a closestData. Note that if the curve has a line representation, the returned distance may be smaller than the distance to the \a closestData point, since the distance to the curve line is also taken into account. If either the curve has no data or if the line style is \ref lsNone and the scatter style's shape is \ref QCPScatterStyle::ssNone (i.e. there is no visual representation of the curve), returns -1.0. */ double QCPCurve::pointDistance(const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const { closestData = mDataContainer->constEnd(); if (mDataContainer->isEmpty()) return -1.0; if (mLineStyle == lsNone && mScatterStyle.isNone()) return -1.0; if (mDataContainer->size() == 1) { QPointF dataPoint = coordsToPixels(mDataContainer->constBegin()->key, mDataContainer->constBegin()->value); closestData = mDataContainer->constBegin(); return QCPVector2D(dataPoint-pixelPoint).length(); } // calculate minimum distances to curve data points and find closestData iterator: double minDistSqr = (std::numeric_limits::max)(); // iterate over found data points and then choose the one with the shortest distance to pos: QCPCurveDataContainer::const_iterator begin = mDataContainer->constBegin(); QCPCurveDataContainer::const_iterator end = mDataContainer->constEnd(); for (QCPCurveDataContainer::const_iterator it=begin; it!=end; ++it) { const double currentDistSqr = QCPVector2D(coordsToPixels(it->key, it->value)-pixelPoint).lengthSquared(); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestData = it; } } // calculate distance to line if there is one (if so, will probably be smaller than distance to closest data point): if (mLineStyle != lsNone) { QVector lines; getCurveLines(&lines, QCPDataRange(0, dataCount()), mParentPlot->selectionTolerance()*1.2); // optimized lines outside axis rect shouldn't respond to clicks at the edge, so use 1.2*tolerance as pen width for (int i=0; i QCPBarsGroup::bars() const Returns all bars currently in this group. \see bars(int index) */ /*! \fn int QCPBarsGroup::size() const Returns the number of QCPBars plottables that are part of this group. */ /*! \fn bool QCPBarsGroup::isEmpty() const Returns whether this bars group is empty. \see size */ /*! \fn bool QCPBarsGroup::contains(QCPBars *bars) Returns whether the specified \a bars plottable is part of this group. */ /* end of documentation of inline functions */ /*! Constructs a new bars group for the specified QCustomPlot instance. */ QCPBarsGroup::QCPBarsGroup(QCustomPlot *parentPlot) : QObject(parentPlot), mParentPlot(parentPlot), mSpacingType(stAbsolute), mSpacing(4) { } QCPBarsGroup::~QCPBarsGroup() { clear(); } /*! Sets how the spacing between adjacent bars is interpreted. See \ref SpacingType. The actual spacing can then be specified with \ref setSpacing. \see setSpacing */ void QCPBarsGroup::setSpacingType(SpacingType spacingType) { mSpacingType = spacingType; } /*! Sets the spacing between adjacent bars. What the number passed as \a spacing actually means, is defined by the current \ref SpacingType, which can be set with \ref setSpacingType. \see setSpacingType */ void QCPBarsGroup::setSpacing(double spacing) { mSpacing = spacing; } /*! Returns the QCPBars instance with the specified \a index in this group. If no such QCPBars exists, returns \c nullptr. \see bars(), size */ QCPBars *QCPBarsGroup::bars(int index) const { if (index >= 0 && index < mBars.size()) { return mBars.at(index); } else { qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; return nullptr; } } /*! Removes all QCPBars plottables from this group. \see isEmpty */ void QCPBarsGroup::clear() { const QList oldBars = mBars; foreach (QCPBars *bars, oldBars) bars->setBarsGroup(nullptr); // removes itself from mBars via removeBars } /*! Adds the specified \a bars plottable to this group. Alternatively, you can also use \ref QCPBars::setBarsGroup on the \a bars instance. \see insert, remove */ void QCPBarsGroup::append(QCPBars *bars) { if (!bars) { qDebug() << Q_FUNC_INFO << "bars is 0"; return; } if (!mBars.contains(bars)) bars->setBarsGroup(this); else qDebug() << Q_FUNC_INFO << "bars plottable is already in this bars group:" << reinterpret_cast(bars); } /*! Inserts the specified \a bars plottable into this group at the specified index position \a i. This gives you full control over the ordering of the bars. \a bars may already be part of this group. In that case, \a bars is just moved to the new index position. \see append, remove */ void QCPBarsGroup::insert(int i, QCPBars *bars) { if (!bars) { qDebug() << Q_FUNC_INFO << "bars is 0"; return; } // first append to bars list normally: if (!mBars.contains(bars)) bars->setBarsGroup(this); // then move to according position: mBars.move(mBars.indexOf(bars), qBound(0, i, mBars.size()-1)); } /*! Removes the specified \a bars plottable from this group. \see contains, clear */ void QCPBarsGroup::remove(QCPBars *bars) { if (!bars) { qDebug() << Q_FUNC_INFO << "bars is 0"; return; } if (mBars.contains(bars)) bars->setBarsGroup(nullptr); else qDebug() << Q_FUNC_INFO << "bars plottable is not in this bars group:" << reinterpret_cast(bars); } /*! \internal Adds the specified \a bars to the internal mBars list of bars. This method does not change the barsGroup property on \a bars. \see unregisterBars */ void QCPBarsGroup::registerBars(QCPBars *bars) { if (!mBars.contains(bars)) mBars.append(bars); } /*! \internal Removes the specified \a bars from the internal mBars list of bars. This method does not change the barsGroup property on \a bars. \see registerBars */ void QCPBarsGroup::unregisterBars(QCPBars *bars) { mBars.removeOne(bars); } /*! \internal Returns the pixel offset in the key dimension the specified \a bars plottable should have at the given key coordinate \a keyCoord. The offset is relative to the pixel position of the key coordinate \a keyCoord. */ double QCPBarsGroup::keyPixelOffset(const QCPBars *bars, double keyCoord) { // find list of all base bars in case some mBars are stacked: QList baseBars; foreach (const QCPBars *b, mBars) { while (b->barBelow()) b = b->barBelow(); if (!baseBars.contains(b)) baseBars.append(b); } // find base bar this "bars" is stacked on: const QCPBars *thisBase = bars; while (thisBase->barBelow()) thisBase = thisBase->barBelow(); // determine key pixel offset of this base bars considering all other base bars in this barsgroup: double result = 0; int index = baseBars.indexOf(thisBase); if (index >= 0) { if (baseBars.size() % 2 == 1 && index == (baseBars.size()-1)/2) // is center bar (int division on purpose) { return result; } else { double lowerPixelWidth, upperPixelWidth; int startIndex; int dir = (index <= (baseBars.size()-1)/2) ? -1 : 1; // if bar is to lower keys of center, dir is negative if (baseBars.size() % 2 == 0) // even number of bars { startIndex = baseBars.size()/2 + (dir < 0 ? -1 : 0); result += getPixelSpacing(baseBars.at(startIndex), keyCoord)*0.5; // half of middle spacing } else // uneven number of bars { startIndex = (baseBars.size()-1)/2+dir; baseBars.at((baseBars.size()-1)/2)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); result += qAbs(upperPixelWidth-lowerPixelWidth)*0.5; // half of center bar result += getPixelSpacing(baseBars.at((baseBars.size()-1)/2), keyCoord); // center bar spacing } for (int i = startIndex; i != index; i += dir) // add widths and spacings of bars in between center and our bars { baseBars.at(i)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); result += qAbs(upperPixelWidth-lowerPixelWidth); result += getPixelSpacing(baseBars.at(i), keyCoord); } // finally half of our bars width: baseBars.at(index)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); result += qAbs(upperPixelWidth-lowerPixelWidth)*0.5; // correct sign of result depending on orientation and direction of key axis: result *= dir*thisBase->keyAxis()->pixelOrientation(); } } return result; } /*! \internal Returns the spacing in pixels which is between this \a bars and the following one, both at the key coordinate \a keyCoord. \note Typically the returned value doesn't depend on \a bars or \a keyCoord. \a bars is only needed to get access to the key axis transformation and axis rect for the modes \ref stAxisRectRatio and \ref stPlotCoords. The \a keyCoord is only relevant for spacings given in \ref stPlotCoords on a logarithmic axis. */ double QCPBarsGroup::getPixelSpacing(const QCPBars *bars, double keyCoord) { switch (mSpacingType) { case stAbsolute: { return mSpacing; } case stAxisRectRatio: { if (bars->keyAxis()->orientation() == Qt::Horizontal) return bars->keyAxis()->axisRect()->width()*mSpacing; else return bars->keyAxis()->axisRect()->height()*mSpacing; } case stPlotCoords: { double keyPixel = bars->keyAxis()->coordToPixel(keyCoord); return qAbs(bars->keyAxis()->coordToPixel(keyCoord+mSpacing)-keyPixel); } } return 0; } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPBarsData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPBarsData \brief Holds the data of one single data point (one bar) for QCPBars. The stored data is: \li \a key: coordinate on the key axis of this bar (this is the \a mainKey and the \a sortKey) \li \a value: height coordinate on the value axis of this bar (this is the \a mainValue) The container for storing multiple data points is \ref QCPBarsDataContainer. It is a typedef for \ref QCPDataContainer with \ref QCPBarsData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods. \see QCPBarsDataContainer */ /* start documentation of inline functions */ /*! \fn double QCPBarsData::sortKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static QCPBarsData QCPBarsData::fromSortKey(double sortKey) Returns a data point with the specified \a sortKey. All other members are set to zero. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static static bool QCPBarsData::sortKeyIsMainKey() Since the member \a key is both the data point key coordinate and the data ordering parameter, this method returns true. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPBarsData::mainKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPBarsData::mainValue() const Returns the \a value member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn QCPRange QCPBarsData::valueRange() const Returns a QCPRange with both lower and upper boundary set to \a value of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /* end documentation of inline functions */ /*! Constructs a bar data point with key and value set to zero. */ QCPBarsData::QCPBarsData() : key(0), value(0) { } /*! Constructs a bar data point with the specified \a key and \a value. */ QCPBarsData::QCPBarsData(double key, double value) : key(key), value(value) { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPBars //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPBars \brief A plottable representing a bar chart in a plot. \image html QCPBars.png To plot data, assign it with the \ref setData or \ref addData functions. \section qcpbars-appearance Changing the appearance The appearance of the bars is determined by the pen and the brush (\ref setPen, \ref setBrush). The width of the individual bars can be controlled with \ref setWidthType and \ref setWidth. Bar charts are stackable. This means, two QCPBars plottables can be placed on top of each other (see \ref QCPBars::moveAbove). So when two bars are at the same key position, they will appear stacked. If you would like to group multiple QCPBars plottables together so they appear side by side as shown below, use QCPBarsGroup. \image html QCPBarsGroup.png \section qcpbars-usage Usage Like all data representing objects in QCustomPlot, the QCPBars is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) Usually, you first create an instance: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-1 which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-2 */ /* start of documentation of inline functions */ /*! \fn QSharedPointer QCPBars::data() const Returns a shared pointer to the internal data storage of type \ref QCPBarsDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular \ref setData or \ref addData methods. */ /*! \fn QCPBars *QCPBars::barBelow() const Returns the bars plottable that is directly below this bars plottable. If there is no such plottable, returns \c nullptr. \see barAbove, moveBelow, moveAbove */ /*! \fn QCPBars *QCPBars::barAbove() const Returns the bars plottable that is directly above this bars plottable. If there is no such plottable, returns \c nullptr. \see barBelow, moveBelow, moveAbove */ /* end of documentation of inline functions */ /*! Constructs a bar chart which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. The created QCPBars is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the QCPBars, so do not delete it manually but use QCustomPlot::removePlottable() instead. */ QCPBars::QCPBars(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable1D(keyAxis, valueAxis), mWidth(0.75), mWidthType(wtPlotCoords), mBarsGroup(nullptr), mBaseValue(0), mStackingGap(1) { // modify inherited properties from abstract plottable: mPen.setColor(Qt::blue); mPen.setStyle(Qt::SolidLine); mBrush.setColor(QColor(40, 50, 255, 30)); mBrush.setStyle(Qt::SolidPattern); mSelectionDecorator->setBrush(QBrush(QColor(160, 160, 255))); } QCPBars::~QCPBars() { setBarsGroup(nullptr); if (mBarBelow || mBarAbove) connectBars(mBarBelow.data(), mBarAbove.data()); // take this bar out of any stacking } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple QCPBars may share the same data container safely. Modifying the data in the container will then affect all bars that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, rather use the \ref QCPDataContainer::set method on the bar's data container directly: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-datasharing-2 \see addData */ void QCPBars::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Replaces the current data with the provided points in \a keys and \a values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. \see addData */ void QCPBars::setData(const QVector &keys, const QVector &values, bool alreadySorted) { mDataContainer->clear(); addData(keys, values, alreadySorted); } /*! Sets the width of the bars. How the number passed as \a width is interpreted (e.g. screen pixels, plot coordinates,...), depends on the currently set width type, see \ref setWidthType and \ref WidthType. */ void QCPBars::setWidth(double width) { mWidth = width; } /*! Sets how the width of the bars is defined. See the documentation of \ref WidthType for an explanation of the possible values for \a widthType. The default value is \ref wtPlotCoords. \see setWidth */ void QCPBars::setWidthType(QCPBars::WidthType widthType) { mWidthType = widthType; } /*! Sets to which QCPBarsGroup this QCPBars instance belongs to. Alternatively, you can also use \ref QCPBarsGroup::append. To remove this QCPBars from any group, set \a barsGroup to \c nullptr. */ void QCPBars::setBarsGroup(QCPBarsGroup *barsGroup) { // deregister at old group: if (mBarsGroup) mBarsGroup->unregisterBars(this); mBarsGroup = barsGroup; // register at new group: if (mBarsGroup) mBarsGroup->registerBars(this); } /*! Sets the base value of this bars plottable. The base value defines where on the value coordinate the bars start. How far the bars extend from the base value is given by their individual value data. For example, if the base value is set to 1, a bar with data value 2 will have its lowest point at value coordinate 1 and highest point at 3. For stacked bars, only the base value of the bottom-most QCPBars has meaning. The default base value is 0. */ void QCPBars::setBaseValue(double baseValue) { mBaseValue = baseValue; } /*! If this bars plottable is stacked on top of another bars plottable (\ref moveAbove), this method allows specifying a distance in \a pixels, by which the drawn bar rectangles will be separated by the bars below it. */ void QCPBars::setStackingGap(double pixels) { mStackingGap = pixels; } /*! \overload Adds the provided points in \a keys and \a values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPBars::addData(const QVector &keys, const QVector &values, bool alreadySorted) { if (keys.size() != values.size()) qDebug() << Q_FUNC_INFO << "keys and values have different sizes:" << keys.size() << values.size(); const int n = qMin(keys.size(), values.size()); QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->key = keys[i]; it->value = values[i]; ++it; ++i; } mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write } /*! \overload Adds the provided data point as \a key and \a value to the current data. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPBars::addData(double key, double value) { mDataContainer->add(QCPBarsData(key, value)); } /*! Moves this bars plottable below \a bars. In other words, the bars of this plottable will appear below the bars of \a bars. The move target \a bars must use the same key and value axis as this plottable. Inserting into and removing from existing bar stacking is handled gracefully. If \a bars already has a bars object below itself, this bars object is inserted between the two. If this bars object is already between two other bars, the two other bars will be stacked on top of each other after the operation. To remove this bars plottable from any stacking, set \a bars to \c nullptr. \see moveBelow, barAbove, barBelow */ void QCPBars::moveBelow(QCPBars *bars) { if (bars == this) return; if (bars && (bars->keyAxis() != mKeyAxis.data() || bars->valueAxis() != mValueAxis.data())) { qDebug() << Q_FUNC_INFO << "passed QCPBars* doesn't have same key and value axis as this QCPBars"; return; } // remove from stacking: connectBars(mBarBelow.data(), mBarAbove.data()); // Note: also works if one (or both) of them is 0 // if new bar given, insert this bar below it: if (bars) { if (bars->mBarBelow) connectBars(bars->mBarBelow.data(), this); connectBars(this, bars); } } /*! Moves this bars plottable above \a bars. In other words, the bars of this plottable will appear above the bars of \a bars. The move target \a bars must use the same key and value axis as this plottable. Inserting into and removing from existing bar stacking is handled gracefully. If \a bars already has a bars object above itself, this bars object is inserted between the two. If this bars object is already between two other bars, the two other bars will be stacked on top of each other after the operation. To remove this bars plottable from any stacking, set \a bars to \c nullptr. \see moveBelow, barBelow, barAbove */ void QCPBars::moveAbove(QCPBars *bars) { if (bars == this) return; if (bars && (bars->keyAxis() != mKeyAxis.data() || bars->valueAxis() != mValueAxis.data())) { qDebug() << Q_FUNC_INFO << "passed QCPBars* doesn't have same key and value axis as this QCPBars"; return; } // remove from stacking: connectBars(mBarBelow.data(), mBarAbove.data()); // Note: also works if one (or both) of them is 0 // if new bar given, insert this bar above it: if (bars) { if (bars->mBarAbove) connectBars(this, bars->mBarAbove.data()); connectBars(bars, this); } } /*! \copydoc QCPPlottableInterface1D::selectTestRect */ QCPDataSelection QCPBars::selectTestRect(const QRectF &rect, bool onlySelectable) const { QCPDataSelection result; if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return result; if (!mKeyAxis || !mValueAxis) return result; QCPBarsDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); for (QCPBarsDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) { if (rect.intersects(getBarRect(it->key, it->value))) result.addDataRange(QCPDataRange(int(it-mDataContainer->constBegin()), int(it-mDataContainer->constBegin()+1)), false); } result.simplify(); return result; } /*! Implements a selectTest specific to this plottable's point geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod \ref QCPAbstractPlottable::selectTest */ double QCPBars::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { // get visible data range: QCPBarsDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); for (QCPBarsDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) { if (getBarRect(it->key, it->value).contains(pos)) { if (details) { int pointIndex = int(it-mDataContainer->constBegin()); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return mParentPlot->selectionTolerance()*0.99; } } } return -1; } /* inherits documentation from base class */ QCPRange QCPBars::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { /* Note: If this QCPBars uses absolute pixels as width (or is in a QCPBarsGroup with spacing in absolute pixels), using this method to adapt the key axis range to fit the bars into the currently visible axis range will not work perfectly. Because in the moment the axis range is changed to the new range, the fixed pixel widths/spacings will represent different coordinate spans than before, which in turn would require a different key range to perfectly fit, and so on. The only solution would be to iteratively approach the perfect fitting axis range, but the mismatch isn't large enough in most applications, to warrant this here. If a user does need a better fit, he should call the corresponding axis rescale multiple times in a row. */ QCPRange range; range = mDataContainer->keyRange(foundRange, inSignDomain); // determine exact range of bars by including bar width and barsgroup offset: if (foundRange && mKeyAxis) { double lowerPixelWidth, upperPixelWidth, keyPixel; // lower range bound: getPixelWidth(range.lower, lowerPixelWidth, upperPixelWidth); keyPixel = mKeyAxis.data()->coordToPixel(range.lower) + lowerPixelWidth; if (mBarsGroup) keyPixel += mBarsGroup->keyPixelOffset(this, range.lower); const double lowerCorrected = mKeyAxis.data()->pixelToCoord(keyPixel); if (!qIsNaN(lowerCorrected) && qIsFinite(lowerCorrected) && range.lower > lowerCorrected) range.lower = lowerCorrected; // upper range bound: getPixelWidth(range.upper, lowerPixelWidth, upperPixelWidth); keyPixel = mKeyAxis.data()->coordToPixel(range.upper) + upperPixelWidth; if (mBarsGroup) keyPixel += mBarsGroup->keyPixelOffset(this, range.upper); const double upperCorrected = mKeyAxis.data()->pixelToCoord(keyPixel); if (!qIsNaN(upperCorrected) && qIsFinite(upperCorrected) && range.upper < upperCorrected) range.upper = upperCorrected; } return range; } /* inherits documentation from base class */ QCPRange QCPBars::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { // Note: can't simply use mDataContainer->valueRange here because we need to // take into account bar base value and possible stacking of multiple bars QCPRange range; range.lower = mBaseValue; range.upper = mBaseValue; bool haveLower = true; // set to true, because baseValue should always be visible in bar charts bool haveUpper = true; // set to true, because baseValue should always be visible in bar charts QCPBarsDataContainer::const_iterator itBegin = mDataContainer->constBegin(); QCPBarsDataContainer::const_iterator itEnd = mDataContainer->constEnd(); if (inKeyRange != QCPRange()) { itBegin = mDataContainer->findBegin(inKeyRange.lower, false); itEnd = mDataContainer->findEnd(inKeyRange.upper, false); } for (QCPBarsDataContainer::const_iterator it = itBegin; it != itEnd; ++it) { const double current = it->value + getStackedBaseValue(it->key, it->value >= 0); if (qIsNaN(current)) continue; if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current < range.lower || !haveLower) { range.lower = current; haveLower = true; } if (current > range.upper || !haveUpper) { range.upper = current; haveUpper = true; } } } foundRange = true; // return true because bar charts always have the 0-line visible return range; } /* inherits documentation from base class */ QPointF QCPBars::dataPixelPosition(int index) const { if (index >= 0 && index < mDataContainer->size()) { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return {}; } const QCPDataContainer::const_iterator it = mDataContainer->constBegin()+index; const double valuePixel = valueAxis->coordToPixel(getStackedBaseValue(it->key, it->value >= 0) + it->value); const double keyPixel = keyAxis->coordToPixel(it->key) + (mBarsGroup ? mBarsGroup->keyPixelOffset(this, it->key) : 0); if (keyAxis->orientation() == Qt::Horizontal) return {keyPixel, valuePixel}; else return {valuePixel, keyPixel}; } else { qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; return {}; } } /* inherits documentation from base class */ void QCPBars::draw(QCPPainter *painter) { if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (mDataContainer->isEmpty()) return; QCPBarsDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; for (int i=0; i= unselectedSegments.size(); QCPBarsDataContainer::const_iterator begin = visibleBegin; QCPBarsDataContainer::const_iterator end = visibleEnd; mDataContainer->limitIteratorsToDataRange(begin, end, allSegments.at(i)); if (begin == end) continue; for (QCPBarsDataContainer::const_iterator it=begin; it!=end; ++it) { // check data validity if flag set: #ifdef QCUSTOMPLOT_CHECK_DATA if (QCP::isInvalidData(it->key, it->value)) qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "of drawn range invalid." << "Plottable name:" << name(); #endif // draw bar: if (isSelectedSegment && mSelectionDecorator) { mSelectionDecorator->applyBrush(painter); mSelectionDecorator->applyPen(painter); } else { painter->setBrush(mBrush); painter->setPen(mPen); } applyDefaultAntialiasingHint(painter); painter->drawPolygon(getBarRect(it->key, it->value)); } } // draw other selection decoration that isn't just line/scatter pens and brushes: if (mSelectionDecorator) mSelectionDecorator->drawDecoration(painter, selection()); } /* inherits documentation from base class */ void QCPBars::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { // draw filled rect: applyDefaultAntialiasingHint(painter); painter->setBrush(mBrush); painter->setPen(mPen); QRectF r = QRectF(0, 0, rect.width()*0.67, rect.height()*0.67); r.moveCenter(rect.center()); painter->drawRect(r); } /*! \internal called by \ref draw to determine which data (key) range is visible at the current key axis range setting, so only that needs to be processed. It also takes into account the bar width. \a begin returns an iterator to the lowest data point that needs to be taken into account when plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a lower may still be just outside the visible range. \a end returns an iterator one higher than the highest visible data point. Same as before, \a end may also lie just outside of the visible range. if the plottable contains no data, both \a begin and \a end point to constEnd. */ void QCPBars::getVisibleDataBounds(QCPBarsDataContainer::const_iterator &begin, QCPBarsDataContainer::const_iterator &end) const { if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; begin = mDataContainer->constEnd(); end = mDataContainer->constEnd(); return; } if (mDataContainer->isEmpty()) { begin = mDataContainer->constEnd(); end = mDataContainer->constEnd(); return; } // get visible data range as QMap iterators begin = mDataContainer->findBegin(mKeyAxis.data()->range().lower); end = mDataContainer->findEnd(mKeyAxis.data()->range().upper); double lowerPixelBound = mKeyAxis.data()->coordToPixel(mKeyAxis.data()->range().lower); double upperPixelBound = mKeyAxis.data()->coordToPixel(mKeyAxis.data()->range().upper); bool isVisible = false; // walk left from begin to find lower bar that actually is completely outside visible pixel range: QCPBarsDataContainer::const_iterator it = begin; while (it != mDataContainer->constBegin()) { --it; const QRectF barRect = getBarRect(it->key, it->value); if (mKeyAxis.data()->orientation() == Qt::Horizontal) isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.right() >= lowerPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.left() <= lowerPixelBound)); else // keyaxis is vertical isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.top() <= lowerPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.bottom() >= lowerPixelBound)); if (isVisible) begin = it; else break; } // walk right from ubound to find upper bar that actually is completely outside visible pixel range: it = end; while (it != mDataContainer->constEnd()) { const QRectF barRect = getBarRect(it->key, it->value); if (mKeyAxis.data()->orientation() == Qt::Horizontal) isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.left() <= upperPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.right() >= upperPixelBound)); else // keyaxis is vertical isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.bottom() >= upperPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.top() <= upperPixelBound)); if (isVisible) end = it+1; else break; ++it; } } /*! \internal Returns the rect in pixel coordinates of a single bar with the specified \a key and \a value. The rect is shifted according to the bar stacking (see \ref moveAbove) and base value (see \ref setBaseValue), and to have non-overlapping border lines with the bars stacked below. */ QRectF QCPBars::getBarRect(double key, double value) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return {}; } double lowerPixelWidth, upperPixelWidth; getPixelWidth(key, lowerPixelWidth, upperPixelWidth); double base = getStackedBaseValue(key, value >= 0); double basePixel = valueAxis->coordToPixel(base); double valuePixel = valueAxis->coordToPixel(base+value); double keyPixel = keyAxis->coordToPixel(key); if (mBarsGroup) keyPixel += mBarsGroup->keyPixelOffset(this, key); double bottomOffset = (mBarBelow && mPen != Qt::NoPen ? 1 : 0)*(mPen.isCosmetic() ? 1 : mPen.widthF()); bottomOffset += mBarBelow ? mStackingGap : 0; bottomOffset *= (value<0 ? -1 : 1)*valueAxis->pixelOrientation(); if (qAbs(valuePixel-basePixel) <= qAbs(bottomOffset)) bottomOffset = valuePixel-basePixel; if (keyAxis->orientation() == Qt::Horizontal) { return QRectF(QPointF(keyPixel+lowerPixelWidth, valuePixel), QPointF(keyPixel+upperPixelWidth, basePixel+bottomOffset)).normalized(); } else { return QRectF(QPointF(basePixel+bottomOffset, keyPixel+lowerPixelWidth), QPointF(valuePixel, keyPixel+upperPixelWidth)).normalized(); } } /*! \internal This function is used to determine the width of the bar at coordinate \a key, according to the specified width (\ref setWidth) and width type (\ref setWidthType). The output parameters \a lower and \a upper return the number of pixels the bar extends to lower and higher keys, relative to the \a key coordinate (so with a non-reversed horizontal axis, \a lower is negative and \a upper positive). */ void QCPBars::getPixelWidth(double key, double &lower, double &upper) const { lower = 0; upper = 0; switch (mWidthType) { case wtAbsolute: { upper = mWidth*0.5*mKeyAxis.data()->pixelOrientation(); lower = -upper; break; } case wtAxisRectRatio: { if (mKeyAxis && mKeyAxis.data()->axisRect()) { if (mKeyAxis.data()->orientation() == Qt::Horizontal) upper = mKeyAxis.data()->axisRect()->width()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); else upper = mKeyAxis.data()->axisRect()->height()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); lower = -upper; } else qDebug() << Q_FUNC_INFO << "No key axis or axis rect defined"; break; } case wtPlotCoords: { if (mKeyAxis) { double keyPixel = mKeyAxis.data()->coordToPixel(key); upper = mKeyAxis.data()->coordToPixel(key+mWidth*0.5)-keyPixel; lower = mKeyAxis.data()->coordToPixel(key-mWidth*0.5)-keyPixel; // no need to qSwap(lower, higher) when range reversed, because higher/lower are gained by // coordinate transform which includes range direction } else qDebug() << Q_FUNC_INFO << "No key axis defined"; break; } } } /*! \internal This function is called to find at which value to start drawing the base of a bar at \a key, when it is stacked on top of another QCPBars (e.g. with \ref moveAbove). positive and negative bars are separated per stack (positive are stacked above baseValue upwards, negative are stacked below baseValue downwards). This can be indicated with \a positive. So if the bar for which we need the base value is negative, set \a positive to false. */ double QCPBars::getStackedBaseValue(double key, bool positive) const { if (mBarBelow) { double max = 0; // don't initialize with mBaseValue here because only base value of bottom-most bar has meaning in a bar stack // find bars of mBarBelow that are approximately at key and find largest one: double epsilon = qAbs(key)*(sizeof(key)==4 ? 1e-6 : 1e-14); // should be safe even when changed to use float at some point if (key == 0) epsilon = (sizeof(key)==4 ? 1e-6 : 1e-14); QCPBarsDataContainer::const_iterator it = mBarBelow.data()->mDataContainer->findBegin(key-epsilon); QCPBarsDataContainer::const_iterator itEnd = mBarBelow.data()->mDataContainer->findEnd(key+epsilon); while (it != itEnd) { if (it->key > key-epsilon && it->key < key+epsilon) { if ((positive && it->value > max) || (!positive && it->value < max)) max = it->value; } ++it; } // recurse down the bar-stack to find the total height: return max + mBarBelow.data()->getStackedBaseValue(key, positive); } else return mBaseValue; } /*! \internal Connects \a below and \a above to each other via their mBarAbove/mBarBelow properties. The bar(s) currently above lower and below upper will become disconnected to lower/upper. If lower is zero, upper will be disconnected at the bottom. If upper is zero, lower will be disconnected at the top. */ void QCPBars::connectBars(QCPBars *lower, QCPBars *upper) { if (!lower && !upper) return; if (!lower) // disconnect upper at bottom { // disconnect old bar below upper: if (upper->mBarBelow && upper->mBarBelow.data()->mBarAbove.data() == upper) upper->mBarBelow.data()->mBarAbove = nullptr; upper->mBarBelow = nullptr; } else if (!upper) // disconnect lower at top { // disconnect old bar above lower: if (lower->mBarAbove && lower->mBarAbove.data()->mBarBelow.data() == lower) lower->mBarAbove.data()->mBarBelow = nullptr; lower->mBarAbove = nullptr; } else // connect lower and upper { // disconnect old bar above lower: if (lower->mBarAbove && lower->mBarAbove.data()->mBarBelow.data() == lower) lower->mBarAbove.data()->mBarBelow = nullptr; // disconnect old bar below upper: if (upper->mBarBelow && upper->mBarBelow.data()->mBarAbove.data() == upper) upper->mBarBelow.data()->mBarAbove = nullptr; lower->mBarAbove = upper; upper->mBarBelow = lower; } } /* end of 'src/plottables/plottable-bars.cpp' */ /* including file 'src/plottables/plottable-statisticalbox.cpp' */ /* modified 2021-03-29T02:30:44, size 28951 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPStatisticalBoxData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPStatisticalBoxData \brief Holds the data of one single data point for QCPStatisticalBox. The stored data is: \li \a key: coordinate on the key axis of this data point (this is the \a mainKey and the \a sortKey) \li \a minimum: the position of the lower whisker, typically the minimum measurement of the sample that's not considered an outlier. \li \a lowerQuartile: the lower end of the box. The lower and the upper quartiles are the two statistical quartiles around the median of the sample, they should contain 50% of the sample data. \li \a median: the value of the median mark inside the quartile box. The median separates the sample data in half (50% of the sample data is below/above the median). (This is the \a mainValue) \li \a upperQuartile: the upper end of the box. The lower and the upper quartiles are the two statistical quartiles around the median of the sample, they should contain 50% of the sample data. \li \a maximum: the position of the upper whisker, typically the maximum measurement of the sample that's not considered an outlier. \li \a outliers: a QVector of outlier values that will be drawn as scatter points at the \a key coordinate of this data point (see \ref QCPStatisticalBox::setOutlierStyle) The container for storing multiple data points is \ref QCPStatisticalBoxDataContainer. It is a typedef for \ref QCPDataContainer with \ref QCPStatisticalBoxData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods. \see QCPStatisticalBoxDataContainer */ /* start documentation of inline functions */ /*! \fn double QCPStatisticalBoxData::sortKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static QCPStatisticalBoxData QCPStatisticalBoxData::fromSortKey(double sortKey) Returns a data point with the specified \a sortKey. All other members are set to zero. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static static bool QCPStatisticalBoxData::sortKeyIsMainKey() Since the member \a key is both the data point key coordinate and the data ordering parameter, this method returns true. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPStatisticalBoxData::mainKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPStatisticalBoxData::mainValue() const Returns the \a median member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn QCPRange QCPStatisticalBoxData::valueRange() const Returns a QCPRange spanning from the \a minimum to the \a maximum member of this statistical box data point, possibly further expanded by outliers. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /* end documentation of inline functions */ /*! Constructs a data point with key and all values set to zero. */ QCPStatisticalBoxData::QCPStatisticalBoxData() : key(0), minimum(0), lowerQuartile(0), median(0), upperQuartile(0), maximum(0) { } /*! Constructs a data point with the specified \a key, \a minimum, \a lowerQuartile, \a median, \a upperQuartile, \a maximum and optionally a number of \a outliers. */ QCPStatisticalBoxData::QCPStatisticalBoxData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers) : key(key), minimum(minimum), lowerQuartile(lowerQuartile), median(median), upperQuartile(upperQuartile), maximum(maximum), outliers(outliers) { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPStatisticalBox //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPStatisticalBox \brief A plottable representing a single statistical box in a plot. \image html QCPStatisticalBox.png To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can also access and modify the data via the \ref data method, which returns a pointer to the internal \ref QCPStatisticalBoxDataContainer. Additionally each data point can itself have a list of outliers, drawn as scatter points at the key coordinate of the respective statistical box data point. They can either be set by using the respective \ref addData(double,double,double,double,double,double,const QVector&) "addData" method or accessing the individual data points through \ref data, and setting the QVector outliers of the data points directly. \section qcpstatisticalbox-appearance Changing the appearance The appearance of each data point box, ranging from the lower to the upper quartile, is controlled via \ref setPen and \ref setBrush. You may change the width of the boxes with \ref setWidth in plot coordinates. Each data point's visual representation also consists of two whiskers. Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum. The appearance of the whiskers can be modified with: \ref setWhiskerPen, \ref setWhiskerBarPen, \ref setWhiskerWidth. The whisker width is the width of the bar perpendicular to the whisker at the top (for maximum) and bottom (for minimum). If the whisker pen is changed, make sure to set the \c capStyle to \c Qt::FlatCap. Otherwise the backbone line might exceed the whisker bars by a few pixels due to the pen cap being not perfectly flat. The median indicator line inside the box has its own pen, \ref setMedianPen. The outlier data points are drawn as normal scatter points. Their look can be controlled with \ref setOutlierStyle \section qcpstatisticalbox-usage Usage Like all data representing objects in QCustomPlot, the QCPStatisticalBox is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) Usually, you first create an instance: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-creation-1 which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-creation-2 */ /* start documentation of inline functions */ /*! \fn QSharedPointer QCPStatisticalBox::data() const Returns a shared pointer to the internal data storage of type \ref QCPStatisticalBoxDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular \ref setData or \ref addData methods. */ /* end documentation of inline functions */ /*! Constructs a statistical box which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. The created QCPStatisticalBox is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the QCPStatisticalBox, so do not delete it manually but use QCustomPlot::removePlottable() instead. */ QCPStatisticalBox::QCPStatisticalBox(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable1D(keyAxis, valueAxis), mWidth(0.5), mWhiskerWidth(0.2), mWhiskerPen(Qt::black, 0, Qt::DashLine, Qt::FlatCap), mWhiskerBarPen(Qt::black), mWhiskerAntialiased(false), mMedianPen(Qt::black, 3, Qt::SolidLine, Qt::FlatCap), mOutlierStyle(QCPScatterStyle::ssCircle, Qt::blue, 6) { setPen(QPen(Qt::black)); setBrush(Qt::NoBrush); } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple QCPStatisticalBoxes may share the same data container safely. Modifying the data in the container will then affect all statistical boxes that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, rather use the \ref QCPDataContainer::set method on the statistical box data container directly: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-datasharing-2 \see addData */ void QCPStatisticalBox::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Replaces the current data with the provided points in \a keys, \a minimum, \a lowerQuartile, \a median, \a upperQuartile and \a maximum. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. \see addData */ void QCPStatisticalBox::setData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted) { mDataContainer->clear(); addData(keys, minimum, lowerQuartile, median, upperQuartile, maximum, alreadySorted); } /*! Sets the width of the boxes in key coordinates. \see setWhiskerWidth */ void QCPStatisticalBox::setWidth(double width) { mWidth = width; } /*! Sets the width of the whiskers in key coordinates. Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum. \see setWidth */ void QCPStatisticalBox::setWhiskerWidth(double width) { mWhiskerWidth = width; } /*! Sets the pen used for drawing the whisker backbone. Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum. Make sure to set the \c capStyle of the passed \a pen to \c Qt::FlatCap. Otherwise the backbone line might exceed the whisker bars by a few pixels due to the pen cap being not perfectly flat. \see setWhiskerBarPen */ void QCPStatisticalBox::setWhiskerPen(const QPen &pen) { mWhiskerPen = pen; } /*! Sets the pen used for drawing the whisker bars. Those are the lines parallel to the key axis at each end of the whisker backbone. Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum. \see setWhiskerPen */ void QCPStatisticalBox::setWhiskerBarPen(const QPen &pen) { mWhiskerBarPen = pen; } /*! Sets whether the statistical boxes whiskers are drawn with antialiasing or not. Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements. */ void QCPStatisticalBox::setWhiskerAntialiased(bool enabled) { mWhiskerAntialiased = enabled; } /*! Sets the pen used for drawing the median indicator line inside the statistical boxes. */ void QCPStatisticalBox::setMedianPen(const QPen &pen) { mMedianPen = pen; } /*! Sets the appearance of the outlier data points. Outliers can be specified with the method \ref addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers) */ void QCPStatisticalBox::setOutlierStyle(const QCPScatterStyle &style) { mOutlierStyle = style; } /*! \overload Adds the provided points in \a keys, \a minimum, \a lowerQuartile, \a median, \a upperQuartile and \a maximum to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPStatisticalBox::addData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted) { if (keys.size() != minimum.size() || minimum.size() != lowerQuartile.size() || lowerQuartile.size() != median.size() || median.size() != upperQuartile.size() || upperQuartile.size() != maximum.size() || maximum.size() != keys.size()) qDebug() << Q_FUNC_INFO << "keys, minimum, lowerQuartile, median, upperQuartile, maximum have different sizes:" << keys.size() << minimum.size() << lowerQuartile.size() << median.size() << upperQuartile.size() << maximum.size(); const int n = qMin(keys.size(), qMin(minimum.size(), qMin(lowerQuartile.size(), qMin(median.size(), qMin(upperQuartile.size(), maximum.size()))))); QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->key = keys[i]; it->minimum = minimum[i]; it->lowerQuartile = lowerQuartile[i]; it->median = median[i]; it->upperQuartile = upperQuartile[i]; it->maximum = maximum[i]; ++it; ++i; } mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write } /*! \overload Adds the provided data point as \a key, \a minimum, \a lowerQuartile, \a median, \a upperQuartile and \a maximum to the current data. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. */ void QCPStatisticalBox::addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers) { mDataContainer->add(QCPStatisticalBoxData(key, minimum, lowerQuartile, median, upperQuartile, maximum, outliers)); } /*! \copydoc QCPPlottableInterface1D::selectTestRect */ QCPDataSelection QCPStatisticalBox::selectTestRect(const QRectF &rect, bool onlySelectable) const { QCPDataSelection result; if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return result; if (!mKeyAxis || !mValueAxis) return result; QCPStatisticalBoxDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); for (QCPStatisticalBoxDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) { if (rect.intersects(getQuartileBox(it))) result.addDataRange(QCPDataRange(int(it-mDataContainer->constBegin()), int(it-mDataContainer->constBegin()+1)), false); } result.simplify(); return result; } /*! Implements a selectTest specific to this plottable's point geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod \ref QCPAbstractPlottable::selectTest */ double QCPStatisticalBox::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { // get visible data range: QCPStatisticalBoxDataContainer::const_iterator visibleBegin, visibleEnd; QCPStatisticalBoxDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); getVisibleDataBounds(visibleBegin, visibleEnd); double minDistSqr = (std::numeric_limits::max)(); for (QCPStatisticalBoxDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) { if (getQuartileBox(it).contains(pos)) // quartile box { double currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestDataPoint = it; } } else // whiskers { const QVector whiskerBackbones = getWhiskerBackboneLines(it); const QCPVector2D posVec(pos); foreach (const QLineF &backbone, whiskerBackbones) { double currentDistSqr = posVec.distanceSquaredToLine(backbone); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestDataPoint = it; } } } } if (details) { int pointIndex = int(closestDataPoint-mDataContainer->constBegin()); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return qSqrt(minDistSqr); } return -1; } /* inherits documentation from base class */ QCPRange QCPStatisticalBox::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { QCPRange range = mDataContainer->keyRange(foundRange, inSignDomain); // determine exact range by including width of bars/flags: if (foundRange) { if (inSignDomain != QCP::sdPositive || range.lower-mWidth*0.5 > 0) range.lower -= mWidth*0.5; if (inSignDomain != QCP::sdNegative || range.upper+mWidth*0.5 < 0) range.upper += mWidth*0.5; } return range; } /* inherits documentation from base class */ QCPRange QCPStatisticalBox::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); } /* inherits documentation from base class */ void QCPStatisticalBox::draw(QCPPainter *painter) { if (mDataContainer->isEmpty()) return; QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } QCPStatisticalBoxDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; for (int i=0; i= unselectedSegments.size(); QCPStatisticalBoxDataContainer::const_iterator begin = visibleBegin; QCPStatisticalBoxDataContainer::const_iterator end = visibleEnd; mDataContainer->limitIteratorsToDataRange(begin, end, allSegments.at(i)); if (begin == end) continue; for (QCPStatisticalBoxDataContainer::const_iterator it=begin; it!=end; ++it) { // check data validity if flag set: # ifdef QCUSTOMPLOT_CHECK_DATA if (QCP::isInvalidData(it->key, it->minimum) || QCP::isInvalidData(it->lowerQuartile, it->median) || QCP::isInvalidData(it->upperQuartile, it->maximum)) qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "of drawn range has invalid data." << "Plottable name:" << name(); for (int i=0; ioutliers.size(); ++i) if (QCP::isInvalidData(it->outliers.at(i))) qDebug() << Q_FUNC_INFO << "Data point outlier at" << it->key << "of drawn range invalid." << "Plottable name:" << name(); # endif if (isSelectedSegment && mSelectionDecorator) { mSelectionDecorator->applyPen(painter); mSelectionDecorator->applyBrush(painter); } else { painter->setPen(mPen); painter->setBrush(mBrush); } QCPScatterStyle finalOutlierStyle = mOutlierStyle; if (isSelectedSegment && mSelectionDecorator) finalOutlierStyle = mSelectionDecorator->getFinalScatterStyle(mOutlierStyle); drawStatisticalBox(painter, it, finalOutlierStyle); } } // draw other selection decoration that isn't just line/scatter pens and brushes: if (mSelectionDecorator) mSelectionDecorator->drawDecoration(painter, selection()); } /* inherits documentation from base class */ void QCPStatisticalBox::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { // draw filled rect: applyDefaultAntialiasingHint(painter); painter->setPen(mPen); painter->setBrush(mBrush); QRectF r = QRectF(0, 0, rect.width()*0.67, rect.height()*0.67); r.moveCenter(rect.center()); painter->drawRect(r); } /*! Draws the graphical representation of a single statistical box with the data given by the iterator \a it with the provided \a painter. If the statistical box has a set of outlier data points, they are drawn with \a outlierStyle. \see getQuartileBox, getWhiskerBackboneLines, getWhiskerBarLines */ void QCPStatisticalBox::drawStatisticalBox(QCPPainter *painter, QCPStatisticalBoxDataContainer::const_iterator it, const QCPScatterStyle &outlierStyle) const { // draw quartile box: applyDefaultAntialiasingHint(painter); const QRectF quartileBox = getQuartileBox(it); painter->drawRect(quartileBox); // draw median line with cliprect set to quartile box: painter->save(); painter->setClipRect(quartileBox, Qt::IntersectClip); painter->setPen(mMedianPen); painter->drawLine(QLineF(coordsToPixels(it->key-mWidth*0.5, it->median), coordsToPixels(it->key+mWidth*0.5, it->median))); painter->restore(); // draw whisker lines: applyAntialiasingHint(painter, mWhiskerAntialiased, QCP::aePlottables); painter->setPen(mWhiskerPen); painter->drawLines(getWhiskerBackboneLines(it)); painter->setPen(mWhiskerBarPen); painter->drawLines(getWhiskerBarLines(it)); // draw outliers: applyScattersAntialiasingHint(painter); outlierStyle.applyTo(painter, mPen); for (int i=0; ioutliers.size(); ++i) outlierStyle.drawShape(painter, coordsToPixels(it->key, it->outliers.at(i))); } /*! \internal called by \ref draw to determine which data (key) range is visible at the current key axis range setting, so only that needs to be processed. It also takes into account the bar width. \a begin returns an iterator to the lowest data point that needs to be taken into account when plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a lower may still be just outside the visible range. \a end returns an iterator one higher than the highest visible data point. Same as before, \a end may also lie just outside of the visible range. if the plottable contains no data, both \a begin and \a end point to constEnd. */ void QCPStatisticalBox::getVisibleDataBounds(QCPStatisticalBoxDataContainer::const_iterator &begin, QCPStatisticalBoxDataContainer::const_iterator &end) const { if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; begin = mDataContainer->constEnd(); end = mDataContainer->constEnd(); return; } begin = mDataContainer->findBegin(mKeyAxis.data()->range().lower-mWidth*0.5); // subtract half width of box to include partially visible data points end = mDataContainer->findEnd(mKeyAxis.data()->range().upper+mWidth*0.5); // add half width of box to include partially visible data points } /*! \internal Returns the box in plot coordinates (keys in x, values in y of the returned rect) that covers the value range from the lower to the upper quartile, of the data given by \a it. \see drawStatisticalBox, getWhiskerBackboneLines, getWhiskerBarLines */ QRectF QCPStatisticalBox::getQuartileBox(QCPStatisticalBoxDataContainer::const_iterator it) const { QRectF result; result.setTopLeft(coordsToPixels(it->key-mWidth*0.5, it->upperQuartile)); result.setBottomRight(coordsToPixels(it->key+mWidth*0.5, it->lowerQuartile)); return result; } /*! \internal Returns the whisker backbones (keys in x, values in y of the returned lines) that cover the value range from the minimum to the lower quartile, and from the upper quartile to the maximum of the data given by \a it. \see drawStatisticalBox, getQuartileBox, getWhiskerBarLines */ QVector QCPStatisticalBox::getWhiskerBackboneLines(QCPStatisticalBoxDataContainer::const_iterator it) const { QVector result(2); result[0].setPoints(coordsToPixels(it->key, it->lowerQuartile), coordsToPixels(it->key, it->minimum)); // min backbone result[1].setPoints(coordsToPixels(it->key, it->upperQuartile), coordsToPixels(it->key, it->maximum)); // max backbone return result; } /*! \internal Returns the whisker bars (keys in x, values in y of the returned lines) that are placed at the end of the whisker backbones, at the minimum and maximum of the data given by \a it. \see drawStatisticalBox, getQuartileBox, getWhiskerBackboneLines */ QVector QCPStatisticalBox::getWhiskerBarLines(QCPStatisticalBoxDataContainer::const_iterator it) const { QVector result(2); result[0].setPoints(coordsToPixels(it->key-mWhiskerWidth*0.5, it->minimum), coordsToPixels(it->key+mWhiskerWidth*0.5, it->minimum)); // min bar result[1].setPoints(coordsToPixels(it->key-mWhiskerWidth*0.5, it->maximum), coordsToPixels(it->key+mWhiskerWidth*0.5, it->maximum)); // max bar return result; } /* end of 'src/plottables/plottable-statisticalbox.cpp' */ /* including file 'src/plottables/plottable-colormap.cpp' */ /* modified 2021-03-29T02:30:44, size 48149 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPColorMapData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPColorMapData \brief Holds the two-dimensional data of a QCPColorMap plottable. This class is a data storage for \ref QCPColorMap. It holds a two-dimensional array, which \ref QCPColorMap then displays as a 2D image in the plot, where the array values are represented by a color, depending on the value. The size of the array can be controlled via \ref setSize (or \ref setKeySize, \ref setValueSize). Which plot coordinates these cells correspond to can be configured with \ref setRange (or \ref setKeyRange, \ref setValueRange). The data cells can be accessed in two ways: They can be directly addressed by an integer index with \ref setCell. This is the fastest method. Alternatively, they can be addressed by their plot coordinate with \ref setData. plot coordinate to cell index transformations and vice versa are provided by the functions \ref coordToCell and \ref cellToCoord. A \ref QCPColorMapData also holds an on-demand two-dimensional array of alpha values which (if allocated) has the same size as the data map. It can be accessed via \ref setAlpha, \ref fillAlpha and \ref clearAlpha. The memory for the alpha map is only allocated if needed, i.e. on the first call of \ref setAlpha. \ref clearAlpha restores full opacity and frees the alpha map. This class also buffers the minimum and maximum values that are in the data set, to provide QCPColorMap::rescaleDataRange with the necessary information quickly. Setting a cell to a value that is greater than the current maximum increases this maximum to the new value. However, setting the cell that currently holds the maximum value to a smaller value doesn't decrease the maximum again, because finding the true new maximum would require going through the entire data array, which might be time consuming. The same holds for the data minimum. This functionality is given by \ref recalculateDataBounds, such that you can decide when it is sensible to find the true current minimum and maximum. The method QCPColorMap::rescaleDataRange offers a convenience parameter \a recalculateDataBounds which may be set to true to automatically call \ref recalculateDataBounds internally. */ /* start of documentation of inline functions */ /*! \fn bool QCPColorMapData::isEmpty() const Returns whether this instance carries no data. This is equivalent to having a size where at least one of the dimensions is 0 (see \ref setSize). */ /* end of documentation of inline functions */ /*! Constructs a new QCPColorMapData instance. The instance has \a keySize cells in the key direction and \a valueSize cells in the value direction. These cells will be displayed by the \ref QCPColorMap at the coordinates \a keyRange and \a valueRange. \see setSize, setKeySize, setValueSize, setRange, setKeyRange, setValueRange */ QCPColorMapData::QCPColorMapData(int keySize, int valueSize, const QCPRange &keyRange, const QCPRange &valueRange) : mKeySize(0), mValueSize(0), mKeyRange(keyRange), mValueRange(valueRange), mIsEmpty(true), mData(nullptr), mAlpha(nullptr), mDataModified(true) { setSize(keySize, valueSize); fill(0); } QCPColorMapData::~QCPColorMapData() { delete[] mData; delete[] mAlpha; } /*! Constructs a new QCPColorMapData instance copying the data and range of \a other. */ QCPColorMapData::QCPColorMapData(const QCPColorMapData &other) : mKeySize(0), mValueSize(0), mIsEmpty(true), mData(nullptr), mAlpha(nullptr), mDataModified(true) { *this = other; } /*! Overwrites this color map data instance with the data stored in \a other. The alpha map state is transferred, too. */ QCPColorMapData &QCPColorMapData::operator=(const QCPColorMapData &other) { if (&other != this) { const int keySize = other.keySize(); const int valueSize = other.valueSize(); if (!other.mAlpha && mAlpha) clearAlpha(); setSize(keySize, valueSize); if (other.mAlpha && !mAlpha) createAlpha(false); setRange(other.keyRange(), other.valueRange()); if (!isEmpty()) { memcpy(mData, other.mData, sizeof(mData[0])*size_t(keySize*valueSize)); if (mAlpha) memcpy(mAlpha, other.mAlpha, sizeof(mAlpha[0])*size_t(keySize*valueSize)); } mDataBounds = other.mDataBounds; mDataModified = true; } return *this; } /* undocumented getter */ double QCPColorMapData::data(double key, double value) { int keyCell = int( (key-mKeyRange.lower)/(mKeyRange.upper-mKeyRange.lower)*(mKeySize-1)+0.5 ); int valueCell = int( (value-mValueRange.lower)/(mValueRange.upper-mValueRange.lower)*(mValueSize-1)+0.5 ); if (keyCell >= 0 && keyCell < mKeySize && valueCell >= 0 && valueCell < mValueSize) return mData[valueCell*mKeySize + keyCell]; else return 0; } /* undocumented getter */ double QCPColorMapData::cell(int keyIndex, int valueIndex) { if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) return mData[valueIndex*mKeySize + keyIndex]; else return 0; } /*! Returns the alpha map value of the cell with the indices \a keyIndex and \a valueIndex. If this color map data doesn't have an alpha map (because \ref setAlpha was never called after creation or after a call to \ref clearAlpha), returns 255, which corresponds to full opacity. \see setAlpha */ unsigned char QCPColorMapData::alpha(int keyIndex, int valueIndex) { if (mAlpha && keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) return mAlpha[valueIndex*mKeySize + keyIndex]; else return 255; } /*! Resizes the data array to have \a keySize cells in the key dimension and \a valueSize cells in the value dimension. The current data is discarded and the map cells are set to 0, unless the map had already the requested size. Setting at least one of \a keySize or \a valueSize to zero frees the internal data array and \ref isEmpty returns true. \see setRange, setKeySize, setValueSize */ void QCPColorMapData::setSize(int keySize, int valueSize) { if (keySize != mKeySize || valueSize != mValueSize) { mKeySize = keySize; mValueSize = valueSize; delete[] mData; mIsEmpty = mKeySize == 0 || mValueSize == 0; if (!mIsEmpty) { #ifdef __EXCEPTIONS try { // 2D arrays get memory intensive fast. So if the allocation fails, at least output debug message #endif mData = new double[size_t(mKeySize*mValueSize)]; #ifdef __EXCEPTIONS } catch (...) { mData = nullptr; } #endif if (mData) fill(0); else qDebug() << Q_FUNC_INFO << "out of memory for data dimensions "<< mKeySize << "*" << mValueSize; } else mData = nullptr; if (mAlpha) // if we had an alpha map, recreate it with new size createAlpha(); mDataModified = true; } } /*! Resizes the data array to have \a keySize cells in the key dimension. The current data is discarded and the map cells are set to 0, unless the map had already the requested size. Setting \a keySize to zero frees the internal data array and \ref isEmpty returns true. \see setKeyRange, setSize, setValueSize */ void QCPColorMapData::setKeySize(int keySize) { setSize(keySize, mValueSize); } /*! Resizes the data array to have \a valueSize cells in the value dimension. The current data is discarded and the map cells are set to 0, unless the map had already the requested size. Setting \a valueSize to zero frees the internal data array and \ref isEmpty returns true. \see setValueRange, setSize, setKeySize */ void QCPColorMapData::setValueSize(int valueSize) { setSize(mKeySize, valueSize); } /*! Sets the coordinate ranges the data shall be distributed over. This defines the rectangular area covered by the color map in plot coordinates. The outer cells will be centered on the range boundaries given to this function. For example, if the key size (\ref setKeySize) is 3 and \a keyRange is set to QCPRange(2, 3) there will be cells centered on the key coordinates 2, 2.5 and 3. \see setSize */ void QCPColorMapData::setRange(const QCPRange &keyRange, const QCPRange &valueRange) { setKeyRange(keyRange); setValueRange(valueRange); } /*! Sets the coordinate range the data shall be distributed over in the key dimension. Together with the value range, This defines the rectangular area covered by the color map in plot coordinates. The outer cells will be centered on the range boundaries given to this function. For example, if the key size (\ref setKeySize) is 3 and \a keyRange is set to QCPRange(2, 3) there will be cells centered on the key coordinates 2, 2.5 and 3. \see setRange, setValueRange, setSize */ void QCPColorMapData::setKeyRange(const QCPRange &keyRange) { mKeyRange = keyRange; } /*! Sets the coordinate range the data shall be distributed over in the value dimension. Together with the key range, This defines the rectangular area covered by the color map in plot coordinates. The outer cells will be centered on the range boundaries given to this function. For example, if the value size (\ref setValueSize) is 3 and \a valueRange is set to QCPRange(2, 3) there will be cells centered on the value coordinates 2, 2.5 and 3. \see setRange, setKeyRange, setSize */ void QCPColorMapData::setValueRange(const QCPRange &valueRange) { mValueRange = valueRange; } /*! Sets the data of the cell, which lies at the plot coordinates given by \a key and \a value, to \a z. \note The QCPColorMap always displays the data at equal key/value intervals, even if the key or value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, you shouldn't use the \ref QCPColorMapData::setData method as it uses a linear transformation to determine the cell index. Rather directly access the cell index with \ref QCPColorMapData::setCell. \see setCell, setRange */ void QCPColorMapData::setData(double key, double value, double z) { int keyCell = int( (key-mKeyRange.lower)/(mKeyRange.upper-mKeyRange.lower)*(mKeySize-1)+0.5 ); int valueCell = int( (value-mValueRange.lower)/(mValueRange.upper-mValueRange.lower)*(mValueSize-1)+0.5 ); if (keyCell >= 0 && keyCell < mKeySize && valueCell >= 0 && valueCell < mValueSize) { mData[valueCell*mKeySize + keyCell] = z; if (z < mDataBounds.lower) mDataBounds.lower = z; if (z > mDataBounds.upper) mDataBounds.upper = z; mDataModified = true; } } /*! Sets the data of the cell with indices \a keyIndex and \a valueIndex to \a z. The indices enumerate the cells starting from zero, up to the map's size-1 in the respective dimension (see \ref setSize). In the standard plot configuration (horizontal key axis and vertical value axis, both not range-reversed), the cell with indices (0, 0) is in the bottom left corner and the cell with indices (keySize-1, valueSize-1) is in the top right corner of the color map. \see setData, setSize */ void QCPColorMapData::setCell(int keyIndex, int valueIndex, double z) { if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) { mData[valueIndex*mKeySize + keyIndex] = z; if (z < mDataBounds.lower) mDataBounds.lower = z; if (z > mDataBounds.upper) mDataBounds.upper = z; mDataModified = true; } else qDebug() << Q_FUNC_INFO << "index out of bounds:" << keyIndex << valueIndex; } /*! Sets the alpha of the color map cell given by \a keyIndex and \a valueIndex to \a alpha. A value of 0 for \a alpha results in a fully transparent cell, and a value of 255 results in a fully opaque cell. If an alpha map doesn't exist yet for this color map data, it will be created here. If you wish to restore full opacity and free any allocated memory of the alpha map, call \ref clearAlpha. Note that the cell-wise alpha which can be configured here is independent of any alpha configured in the color map's gradient (\ref QCPColorGradient). If a cell is affected both by the cell-wise and gradient alpha, the alpha values will be blended accordingly during rendering of the color map. \see fillAlpha, clearAlpha */ void QCPColorMapData::setAlpha(int keyIndex, int valueIndex, unsigned char alpha) { if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) { if (mAlpha || createAlpha()) { mAlpha[valueIndex*mKeySize + keyIndex] = alpha; mDataModified = true; } } else qDebug() << Q_FUNC_INFO << "index out of bounds:" << keyIndex << valueIndex; } /*! Goes through the data and updates the buffered minimum and maximum data values. Calling this method is only advised if you are about to call \ref QCPColorMap::rescaleDataRange and can not guarantee that the cells holding the maximum or minimum data haven't been overwritten with a smaller or larger value respectively, since the buffered maximum/minimum values have been updated the last time. Why this is the case is explained in the class description (\ref QCPColorMapData). Note that the method \ref QCPColorMap::rescaleDataRange provides a parameter \a recalculateDataBounds for convenience. Setting this to true will call this method for you, before doing the rescale. */ void QCPColorMapData::recalculateDataBounds() { if (mKeySize > 0 && mValueSize > 0) { double minHeight = mData[0]; double maxHeight = mData[0]; const int dataCount = mValueSize*mKeySize; for (int i=0; i maxHeight) maxHeight = mData[i]; if (mData[i] < minHeight) minHeight = mData[i]; } mDataBounds.lower = minHeight; mDataBounds.upper = maxHeight; } } /*! Frees the internal data memory. This is equivalent to calling \ref setSize "setSize(0, 0)". */ void QCPColorMapData::clear() { setSize(0, 0); } /*! Frees the internal alpha map. The color map will have full opacity again. */ void QCPColorMapData::clearAlpha() { if (mAlpha) { delete[] mAlpha; mAlpha = nullptr; mDataModified = true; } } /*! Sets all cells to the value \a z. */ void QCPColorMapData::fill(double z) { const int dataCount = mValueSize*mKeySize; for (int i=0; i(data); return; } if (copy) { *mMapData = *data; } else { delete mMapData; mMapData = data; } mMapImageInvalidated = true; } /*! Sets the data range of this color map to \a dataRange. The data range defines which data values are mapped to the color gradient. To make the data range span the full range of the data set, use \ref rescaleDataRange. \see QCPColorScale::setDataRange */ void QCPColorMap::setDataRange(const QCPRange &dataRange) { if (!QCPRange::validRange(dataRange)) return; if (mDataRange.lower != dataRange.lower || mDataRange.upper != dataRange.upper) { if (mDataScaleType == QCPAxis::stLogarithmic) mDataRange = dataRange.sanitizedForLogScale(); else mDataRange = dataRange.sanitizedForLinScale(); mMapImageInvalidated = true; emit dataRangeChanged(mDataRange); } } /*! Sets whether the data is correlated with the color gradient linearly or logarithmically. \see QCPColorScale::setDataScaleType */ void QCPColorMap::setDataScaleType(QCPAxis::ScaleType scaleType) { if (mDataScaleType != scaleType) { mDataScaleType = scaleType; mMapImageInvalidated = true; emit dataScaleTypeChanged(mDataScaleType); if (mDataScaleType == QCPAxis::stLogarithmic) setDataRange(mDataRange.sanitizedForLogScale()); } } /*! Sets the color gradient that is used to represent the data. For more details on how to create an own gradient or use one of the preset gradients, see \ref QCPColorGradient. The colors defined by the gradient will be used to represent data values in the currently set data range, see \ref setDataRange. Data points that are outside this data range will either be colored uniformly with the respective gradient boundary color, or the gradient will repeat, depending on \ref QCPColorGradient::setPeriodic. \see QCPColorScale::setGradient */ void QCPColorMap::setGradient(const QCPColorGradient &gradient) { if (mGradient != gradient) { mGradient = gradient; mMapImageInvalidated = true; emit gradientChanged(mGradient); } } /*! Sets whether the color map image shall use bicubic interpolation when displaying the color map shrinked or expanded, and not at a 1:1 pixel-to-data scale. \image html QCPColorMap-interpolate.png "A 10*10 color map, with interpolation and without interpolation enabled" */ void QCPColorMap::setInterpolate(bool enabled) { mInterpolate = enabled; mMapImageInvalidated = true; // because oversampling factors might need to change } /*! Sets whether the outer most data rows and columns are clipped to the specified key and value range (see \ref QCPColorMapData::setKeyRange, \ref QCPColorMapData::setValueRange). if \a enabled is set to false, the data points at the border of the color map are drawn with the same width and height as all other data points. Since the data points are represented by rectangles of one color centered on the data coordinate, this means that the shown color map extends by half a data point over the specified key/value range in each direction. \image html QCPColorMap-tightboundary.png "A color map, with tight boundary enabled and disabled" */ void QCPColorMap::setTightBoundary(bool enabled) { mTightBoundary = enabled; } /*! Associates the color scale \a colorScale with this color map. This means that both the color scale and the color map synchronize their gradient, data range and data scale type (\ref setGradient, \ref setDataRange, \ref setDataScaleType). Multiple color maps can be associated with one single color scale. This causes the color maps to also synchronize those properties, via the mutual color scale. This function causes the color map to adopt the current color gradient, data range and data scale type of \a colorScale. After this call, you may change these properties at either the color map or the color scale, and the setting will be applied to both. Pass \c nullptr as \a colorScale to disconnect the color scale from this color map again. */ void QCPColorMap::setColorScale(QCPColorScale *colorScale) { if (mColorScale) // unconnect signals from old color scale { disconnect(this, SIGNAL(dataRangeChanged(QCPRange)), mColorScale.data(), SLOT(setDataRange(QCPRange))); disconnect(this, SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), mColorScale.data(), SLOT(setDataScaleType(QCPAxis::ScaleType))); disconnect(this, SIGNAL(gradientChanged(QCPColorGradient)), mColorScale.data(), SLOT(setGradient(QCPColorGradient))); disconnect(mColorScale.data(), SIGNAL(dataRangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); disconnect(mColorScale.data(), SIGNAL(gradientChanged(QCPColorGradient)), this, SLOT(setGradient(QCPColorGradient))); disconnect(mColorScale.data(), SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); } mColorScale = colorScale; if (mColorScale) // connect signals to new color scale { setGradient(mColorScale.data()->gradient()); setDataRange(mColorScale.data()->dataRange()); setDataScaleType(mColorScale.data()->dataScaleType()); connect(this, SIGNAL(dataRangeChanged(QCPRange)), mColorScale.data(), SLOT(setDataRange(QCPRange))); connect(this, SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), mColorScale.data(), SLOT(setDataScaleType(QCPAxis::ScaleType))); connect(this, SIGNAL(gradientChanged(QCPColorGradient)), mColorScale.data(), SLOT(setGradient(QCPColorGradient))); connect(mColorScale.data(), SIGNAL(dataRangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); connect(mColorScale.data(), SIGNAL(gradientChanged(QCPColorGradient)), this, SLOT(setGradient(QCPColorGradient))); connect(mColorScale.data(), SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); } } /*! Sets the data range (\ref setDataRange) to span the minimum and maximum values that occur in the current data set. This corresponds to the \ref rescaleKeyAxis or \ref rescaleValueAxis methods, only for the third data dimension of the color map. The minimum and maximum values of the data set are buffered in the internal QCPColorMapData instance (\ref data). As data is updated via its \ref QCPColorMapData::setCell or \ref QCPColorMapData::setData, the buffered minimum and maximum values are updated, too. For performance reasons, however, they are only updated in an expanding fashion. So the buffered maximum can only increase and the buffered minimum can only decrease. In consequence, changes to the data that actually lower the maximum of the data set (by overwriting the cell holding the current maximum with a smaller value), aren't recognized and the buffered maximum overestimates the true maximum of the data set. The same happens for the buffered minimum. To recalculate the true minimum and maximum by explicitly looking at each cell, the method QCPColorMapData::recalculateDataBounds can be used. For convenience, setting the parameter \a recalculateDataBounds calls this method before setting the data range to the buffered minimum and maximum. \see setDataRange */ void QCPColorMap::rescaleDataRange(bool recalculateDataBounds) { if (recalculateDataBounds) mMapData->recalculateDataBounds(); setDataRange(mMapData->dataBounds()); } /*! Takes the current appearance of the color map and updates the legend icon, which is used to represent this color map in the legend (see \ref QCPLegend). The \a transformMode specifies whether the rescaling is done by a faster, low quality image scaling algorithm (Qt::FastTransformation) or by a slower, higher quality algorithm (Qt::SmoothTransformation). The current color map appearance is scaled down to \a thumbSize. Ideally, this should be equal to the size of the legend icon (see \ref QCPLegend::setIconSize). If it isn't exactly the configured legend icon size, the thumb will be rescaled during drawing of the legend item. \see setDataRange */ void QCPColorMap::updateLegendIcon(Qt::TransformationMode transformMode, const QSize &thumbSize) { if (mMapImage.isNull() && !data()->isEmpty()) updateMapImage(); // try to update map image if it's null (happens if no draw has happened yet) if (!mMapImage.isNull()) // might still be null, e.g. if data is empty, so check here again { bool mirrorX = (keyAxis()->orientation() == Qt::Horizontal ? keyAxis() : valueAxis())->rangeReversed(); bool mirrorY = (valueAxis()->orientation() == Qt::Vertical ? valueAxis() : keyAxis())->rangeReversed(); mLegendIcon = QPixmap::fromImage(mMapImage.mirrored(mirrorX, mirrorY)).scaled(thumbSize, Qt::KeepAspectRatio, transformMode); } } /* inherits documentation from base class */ double QCPColorMap::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if ((onlySelectable && mSelectable == QCP::stNone) || mMapData->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { double posKey, posValue; pixelsToCoords(pos, posKey, posValue); if (mMapData->keyRange().contains(posKey) && mMapData->valueRange().contains(posValue)) { if (details) details->setValue(QCPDataSelection(QCPDataRange(0, 1))); // temporary solution, to facilitate whole-plottable selection. Replace in future version with segmented 2D selection. return mParentPlot->selectionTolerance()*0.99; } } return -1; } /* inherits documentation from base class */ QCPRange QCPColorMap::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { foundRange = true; QCPRange result = mMapData->keyRange(); result.normalize(); if (inSignDomain == QCP::sdPositive) { if (result.lower <= 0 && result.upper > 0) result.lower = result.upper*1e-3; else if (result.lower <= 0 && result.upper <= 0) foundRange = false; } else if (inSignDomain == QCP::sdNegative) { if (result.upper >= 0 && result.lower < 0) result.upper = result.lower*1e-3; else if (result.upper >= 0 && result.lower >= 0) foundRange = false; } return result; } /* inherits documentation from base class */ QCPRange QCPColorMap::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { if (inKeyRange != QCPRange()) { if (mMapData->keyRange().upper < inKeyRange.lower || mMapData->keyRange().lower > inKeyRange.upper) { foundRange = false; return {}; } } foundRange = true; QCPRange result = mMapData->valueRange(); result.normalize(); if (inSignDomain == QCP::sdPositive) { if (result.lower <= 0 && result.upper > 0) result.lower = result.upper*1e-3; else if (result.lower <= 0 && result.upper <= 0) foundRange = false; } else if (inSignDomain == QCP::sdNegative) { if (result.upper >= 0 && result.lower < 0) result.upper = result.lower*1e-3; else if (result.upper >= 0 && result.lower >= 0) foundRange = false; } return result; } /*! \internal Updates the internal map image buffer by going through the internal \ref QCPColorMapData and turning the data values into color pixels with \ref QCPColorGradient::colorize. This method is called by \ref QCPColorMap::draw if either the data has been modified or the map image has been invalidated for a different reason (e.g. a change of the data range with \ref setDataRange). If the map cell count is low, the image created will be oversampled in order to avoid a QPainter::drawImage bug which makes inner pixel boundaries jitter when stretch-drawing images without smooth transform enabled. Accordingly, oversampling isn't performed if \ref setInterpolate is true. */ void QCPColorMap::updateMapImage() { QCPAxis *keyAxis = mKeyAxis.data(); if (!keyAxis) return; if (mMapData->isEmpty()) return; const QImage::Format format = QImage::Format_ARGB32_Premultiplied; const int keySize = mMapData->keySize(); const int valueSize = mMapData->valueSize(); int keyOversamplingFactor = mInterpolate ? 1 : int(1.0+100.0/double(keySize)); // make mMapImage have at least size 100, factor becomes 1 if size > 200 or interpolation is on int valueOversamplingFactor = mInterpolate ? 1 : int(1.0+100.0/double(valueSize)); // make mMapImage have at least size 100, factor becomes 1 if size > 200 or interpolation is on // resize mMapImage to correct dimensions including possible oversampling factors, according to key/value axes orientation: if (keyAxis->orientation() == Qt::Horizontal && (mMapImage.width() != keySize*keyOversamplingFactor || mMapImage.height() != valueSize*valueOversamplingFactor)) mMapImage = QImage(QSize(keySize*keyOversamplingFactor, valueSize*valueOversamplingFactor), format); else if (keyAxis->orientation() == Qt::Vertical && (mMapImage.width() != valueSize*valueOversamplingFactor || mMapImage.height() != keySize*keyOversamplingFactor)) mMapImage = QImage(QSize(valueSize*valueOversamplingFactor, keySize*keyOversamplingFactor), format); if (mMapImage.isNull()) { qDebug() << Q_FUNC_INFO << "Couldn't create map image (possibly too large for memory)"; mMapImage = QImage(QSize(10, 10), format); mMapImage.fill(Qt::black); } else { QImage *localMapImage = &mMapImage; // this is the image on which the colorization operates. Either the final mMapImage, or if we need oversampling, mUndersampledMapImage if (keyOversamplingFactor > 1 || valueOversamplingFactor > 1) { // resize undersampled map image to actual key/value cell sizes: if (keyAxis->orientation() == Qt::Horizontal && (mUndersampledMapImage.width() != keySize || mUndersampledMapImage.height() != valueSize)) mUndersampledMapImage = QImage(QSize(keySize, valueSize), format); else if (keyAxis->orientation() == Qt::Vertical && (mUndersampledMapImage.width() != valueSize || mUndersampledMapImage.height() != keySize)) mUndersampledMapImage = QImage(QSize(valueSize, keySize), format); localMapImage = &mUndersampledMapImage; // make the colorization run on the undersampled image } else if (!mUndersampledMapImage.isNull()) mUndersampledMapImage = QImage(); // don't need oversampling mechanism anymore (map size has changed) but mUndersampledMapImage still has nonzero size, free it const double *rawData = mMapData->mData; const unsigned char *rawAlpha = mMapData->mAlpha; if (keyAxis->orientation() == Qt::Horizontal) { const int lineCount = valueSize; const int rowCount = keySize; for (int line=0; line(localMapImage->scanLine(lineCount-1-line)); // invert scanline index because QImage counts scanlines from top, but our vertical index counts from bottom (mathematical coordinate system) if (rawAlpha) mGradient.colorize(rawData+line*rowCount, rawAlpha+line*rowCount, mDataRange, pixels, rowCount, 1, mDataScaleType==QCPAxis::stLogarithmic); else mGradient.colorize(rawData+line*rowCount, mDataRange, pixels, rowCount, 1, mDataScaleType==QCPAxis::stLogarithmic); } } else // keyAxis->orientation() == Qt::Vertical { const int lineCount = keySize; const int rowCount = valueSize; for (int line=0; line(localMapImage->scanLine(lineCount-1-line)); // invert scanline index because QImage counts scanlines from top, but our vertical index counts from bottom (mathematical coordinate system) if (rawAlpha) mGradient.colorize(rawData+line, rawAlpha+line, mDataRange, pixels, rowCount, lineCount, mDataScaleType==QCPAxis::stLogarithmic); else mGradient.colorize(rawData+line, mDataRange, pixels, rowCount, lineCount, mDataScaleType==QCPAxis::stLogarithmic); } } if (keyOversamplingFactor > 1 || valueOversamplingFactor > 1) { if (keyAxis->orientation() == Qt::Horizontal) mMapImage = mUndersampledMapImage.scaled(keySize*keyOversamplingFactor, valueSize*valueOversamplingFactor, Qt::IgnoreAspectRatio, Qt::FastTransformation); else mMapImage = mUndersampledMapImage.scaled(valueSize*valueOversamplingFactor, keySize*keyOversamplingFactor, Qt::IgnoreAspectRatio, Qt::FastTransformation); } } mMapData->mDataModified = false; mMapImageInvalidated = false; } /* inherits documentation from base class */ void QCPColorMap::draw(QCPPainter *painter) { if (mMapData->isEmpty()) return; if (!mKeyAxis || !mValueAxis) return; applyDefaultAntialiasingHint(painter); if (mMapData->mDataModified || mMapImageInvalidated) updateMapImage(); // use buffer if painting vectorized (PDF): const bool useBuffer = painter->modes().testFlag(QCPPainter::pmVectorized); QCPPainter *localPainter = painter; // will be redirected to paint on mapBuffer if painting vectorized QRectF mapBufferTarget; // the rect in absolute widget coordinates where the visible map portion/buffer will end up in QPixmap mapBuffer; if (useBuffer) { const double mapBufferPixelRatio = 3; // factor by which DPI is increased in embedded bitmaps mapBufferTarget = painter->clipRegion().boundingRect(); mapBuffer = QPixmap((mapBufferTarget.size()*mapBufferPixelRatio).toSize()); mapBuffer.fill(Qt::transparent); localPainter = new QCPPainter(&mapBuffer); localPainter->scale(mapBufferPixelRatio, mapBufferPixelRatio); localPainter->translate(-mapBufferTarget.topLeft()); } QRectF imageRect = QRectF(coordsToPixels(mMapData->keyRange().lower, mMapData->valueRange().lower), coordsToPixels(mMapData->keyRange().upper, mMapData->valueRange().upper)).normalized(); // extend imageRect to contain outer halves/quarters of bordering/cornering pixels (cells are centered on map range boundary): double halfCellWidth = 0; // in pixels double halfCellHeight = 0; // in pixels if (keyAxis()->orientation() == Qt::Horizontal) { if (mMapData->keySize() > 1) halfCellWidth = 0.5*imageRect.width()/double(mMapData->keySize()-1); if (mMapData->valueSize() > 1) halfCellHeight = 0.5*imageRect.height()/double(mMapData->valueSize()-1); } else // keyAxis orientation is Qt::Vertical { if (mMapData->keySize() > 1) halfCellHeight = 0.5*imageRect.height()/double(mMapData->keySize()-1); if (mMapData->valueSize() > 1) halfCellWidth = 0.5*imageRect.width()/double(mMapData->valueSize()-1); } imageRect.adjust(-halfCellWidth, -halfCellHeight, halfCellWidth, halfCellHeight); const bool mirrorX = (keyAxis()->orientation() == Qt::Horizontal ? keyAxis() : valueAxis())->rangeReversed(); const bool mirrorY = (valueAxis()->orientation() == Qt::Vertical ? valueAxis() : keyAxis())->rangeReversed(); const bool smoothBackup = localPainter->renderHints().testFlag(QPainter::SmoothPixmapTransform); localPainter->setRenderHint(QPainter::SmoothPixmapTransform, mInterpolate); QRegion clipBackup; if (mTightBoundary) { clipBackup = localPainter->clipRegion(); QRectF tightClipRect = QRectF(coordsToPixels(mMapData->keyRange().lower, mMapData->valueRange().lower), coordsToPixels(mMapData->keyRange().upper, mMapData->valueRange().upper)).normalized(); localPainter->setClipRect(tightClipRect, Qt::IntersectClip); } localPainter->drawImage(imageRect, mMapImage.mirrored(mirrorX, mirrorY)); if (mTightBoundary) localPainter->setClipRegion(clipBackup); localPainter->setRenderHint(QPainter::SmoothPixmapTransform, smoothBackup); if (useBuffer) // localPainter painted to mapBuffer, so now draw buffer with original painter { delete localPainter; painter->drawPixmap(mapBufferTarget.toRect(), mapBuffer); } } /* inherits documentation from base class */ void QCPColorMap::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { applyDefaultAntialiasingHint(painter); // draw map thumbnail: if (!mLegendIcon.isNull()) { QPixmap scaledIcon = mLegendIcon.scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::FastTransformation); QRectF iconRect = QRectF(0, 0, scaledIcon.width(), scaledIcon.height()); iconRect.moveCenter(rect.center()); painter->drawPixmap(iconRect.topLeft(), scaledIcon); } /* // draw frame: painter->setBrush(Qt::NoBrush); painter->setPen(Qt::black); painter->drawRect(rect.adjusted(1, 1, 0, 0)); */ } /* end of 'src/plottables/plottable-colormap.cpp' */ /* including file 'src/plottables/plottable-financial.cpp' */ /* modified 2021-03-29T02:30:44, size 42914 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPFinancialData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPFinancialData \brief Holds the data of one single data point for QCPFinancial. The stored data is: \li \a key: coordinate on the key axis of this data point (this is the \a mainKey and the \a sortKey) \li \a open: The opening value at the data point (this is the \a mainValue) \li \a high: The high/maximum value at the data point \li \a low: The low/minimum value at the data point \li \a close: The closing value at the data point The container for storing multiple data points is \ref QCPFinancialDataContainer. It is a typedef for \ref QCPDataContainer with \ref QCPFinancialData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods. \see QCPFinancialDataContainer */ /* start documentation of inline functions */ /*! \fn double QCPFinancialData::sortKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static QCPFinancialData QCPFinancialData::fromSortKey(double sortKey) Returns a data point with the specified \a sortKey. All other members are set to zero. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn static static bool QCPFinancialData::sortKeyIsMainKey() Since the member \a key is both the data point key coordinate and the data ordering parameter, this method returns true. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPFinancialData::mainKey() const Returns the \a key member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn double QCPFinancialData::mainValue() const Returns the \a open member of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /*! \fn QCPRange QCPFinancialData::valueRange() const Returns a QCPRange spanning from the \a low to the \a high value of this data point. For a general explanation of what this method is good for in the context of the data container, see the documentation of \ref QCPDataContainer. */ /* end documentation of inline functions */ /*! Constructs a data point with key and all values set to zero. */ QCPFinancialData::QCPFinancialData() : key(0), open(0), high(0), low(0), close(0) { } /*! Constructs a data point with the specified \a key and OHLC values. */ QCPFinancialData::QCPFinancialData(double key, double open, double high, double low, double close) : key(key), open(open), high(high), low(low), close(close) { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPFinancial //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPFinancial \brief A plottable representing a financial stock chart \image html QCPFinancial.png This plottable represents time series data binned to certain intervals, mainly used for stock charts. The two common representations OHLC (Open-High-Low-Close) bars and Candlesticks can be set via \ref setChartStyle. The data is passed via \ref setData as a set of open/high/low/close values at certain keys (typically times). This means the data must be already binned appropriately. If data is only available as a series of values (e.g. \a price against \a time), you can use the static convenience function \ref timeSeriesToOhlc to generate binned OHLC-data which can then be passed to \ref setData. The width of the OHLC bars/candlesticks can be controlled with \ref setWidth and \ref setWidthType. A typical choice is to set the width type to \ref wtPlotCoords (the default) and the width to (or slightly less than) one time bin interval width. \section qcpfinancial-appearance Changing the appearance Charts can be either single- or two-colored (\ref setTwoColored). If set to be single-colored, lines are drawn with the plottable's pen (\ref setPen) and fills with the brush (\ref setBrush). If set to two-colored, positive changes of the value during an interval (\a close >= \a open) are represented with a different pen and brush than negative changes (\a close < \a open). These can be configured with \ref setPenPositive, \ref setPenNegative, \ref setBrushPositive, and \ref setBrushNegative. In two-colored mode, the normal plottable pen/brush is ignored. Upon selection however, the normal selected pen/brush (provided by the \ref selectionDecorator) is used, irrespective of whether the chart is single- or two-colored. \section qcpfinancial-usage Usage Like all data representing objects in QCustomPlot, the QCPFinancial is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) Usually, you first create an instance: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-creation-1 which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-creation-2 Here we have used the static helper method \ref timeSeriesToOhlc, to turn a time-price data series into a 24-hour binned open-high-low-close data series as QCPFinancial uses. */ /* start of documentation of inline functions */ /*! \fn QCPFinancialDataContainer *QCPFinancial::data() const Returns a pointer to the internal data storage of type \ref QCPFinancialDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular \ref setData or \ref addData methods, in certain situations. */ /* end of documentation of inline functions */ /*! Constructs a financial chart which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. The created QCPFinancial is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the QCPFinancial, so do not delete it manually but use QCustomPlot::removePlottable() instead. */ QCPFinancial::QCPFinancial(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable1D(keyAxis, valueAxis), mChartStyle(csCandlestick), mWidth(0.5), mWidthType(wtPlotCoords), mTwoColored(true), mBrushPositive(QBrush(QColor(50, 160, 0))), mBrushNegative(QBrush(QColor(180, 0, 15))), mPenPositive(QPen(QColor(40, 150, 0))), mPenNegative(QPen(QColor(170, 5, 5))) { mSelectionDecorator->setBrush(QBrush(QColor(160, 160, 255))); } QCPFinancial::~QCPFinancial() { } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple QCPFinancials may share the same data container safely. Modifying the data in the container will then affect all financials that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, rather use the \ref QCPDataContainer::set method on the financial's data container directly: \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-datasharing-2 \see addData, timeSeriesToOhlc */ void QCPFinancial::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Replaces the current data with the provided points in \a keys, \a open, \a high, \a low and \a close. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. \see addData, timeSeriesToOhlc */ void QCPFinancial::setData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted) { mDataContainer->clear(); addData(keys, open, high, low, close, alreadySorted); } /*! Sets which representation style shall be used to display the OHLC data. */ void QCPFinancial::setChartStyle(QCPFinancial::ChartStyle style) { mChartStyle = style; } /*! Sets the width of the individual bars/candlesticks to \a width in plot key coordinates. A typical choice is to set it to (or slightly less than) one bin interval width. */ void QCPFinancial::setWidth(double width) { mWidth = width; } /*! Sets how the width of the financial bars is defined. See the documentation of \ref WidthType for an explanation of the possible values for \a widthType. The default value is \ref wtPlotCoords. \see setWidth */ void QCPFinancial::setWidthType(QCPFinancial::WidthType widthType) { mWidthType = widthType; } /*! Sets whether this chart shall contrast positive from negative trends per data point by using two separate colors to draw the respective bars/candlesticks. If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref setBrush). \see setPenPositive, setPenNegative, setBrushPositive, setBrushNegative */ void QCPFinancial::setTwoColored(bool twoColored) { mTwoColored = twoColored; } /*! If \ref setTwoColored is set to true, this function controls the brush that is used to draw fills of data points with a positive trend (i.e. bars/candlesticks with close >= open). If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref setBrush). \see setBrushNegative, setPenPositive, setPenNegative */ void QCPFinancial::setBrushPositive(const QBrush &brush) { mBrushPositive = brush; } /*! If \ref setTwoColored is set to true, this function controls the brush that is used to draw fills of data points with a negative trend (i.e. bars/candlesticks with close < open). If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref setBrush). \see setBrushPositive, setPenNegative, setPenPositive */ void QCPFinancial::setBrushNegative(const QBrush &brush) { mBrushNegative = brush; } /*! If \ref setTwoColored is set to true, this function controls the pen that is used to draw outlines of data points with a positive trend (i.e. bars/candlesticks with close >= open). If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref setBrush). \see setPenNegative, setBrushPositive, setBrushNegative */ void QCPFinancial::setPenPositive(const QPen &pen) { mPenPositive = pen; } /*! If \ref setTwoColored is set to true, this function controls the pen that is used to draw outlines of data points with a negative trend (i.e. bars/candlesticks with close < open). If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref setBrush). \see setPenPositive, setBrushNegative, setBrushPositive */ void QCPFinancial::setPenNegative(const QPen &pen) { mPenNegative = pen; } /*! \overload Adds the provided points in \a keys, \a open, \a high, \a low and \a close to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. \see timeSeriesToOhlc */ void QCPFinancial::addData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted) { if (keys.size() != open.size() || open.size() != high.size() || high.size() != low.size() || low.size() != close.size() || close.size() != keys.size()) qDebug() << Q_FUNC_INFO << "keys, open, high, low, close have different sizes:" << keys.size() << open.size() << high.size() << low.size() << close.size(); const int n = qMin(keys.size(), qMin(open.size(), qMin(high.size(), qMin(low.size(), close.size())))); QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->key = keys[i]; it->open = open[i]; it->high = high[i]; it->low = low[i]; it->close = close[i]; ++it; ++i; } mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write } /*! \overload Adds the provided data point as \a key, \a open, \a high, \a low and \a close to the current data. Alternatively, you can also access and modify the data directly via the \ref data method, which returns a pointer to the internal data container. \see timeSeriesToOhlc */ void QCPFinancial::addData(double key, double open, double high, double low, double close) { mDataContainer->add(QCPFinancialData(key, open, high, low, close)); } /*! \copydoc QCPPlottableInterface1D::selectTestRect */ QCPDataSelection QCPFinancial::selectTestRect(const QRectF &rect, bool onlySelectable) const { QCPDataSelection result; if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return result; if (!mKeyAxis || !mValueAxis) return result; QCPFinancialDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); for (QCPFinancialDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) { if (rect.intersects(selectionHitBox(it))) result.addDataRange(QCPDataRange(int(it-mDataContainer->constBegin()), int(it-mDataContainer->constBegin()+1)), false); } result.simplify(); return result; } /*! Implements a selectTest specific to this plottable's point geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod \ref QCPAbstractPlottable::selectTest */ double QCPFinancial::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { // get visible data range: QCPFinancialDataContainer::const_iterator visibleBegin, visibleEnd; QCPFinancialDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); getVisibleDataBounds(visibleBegin, visibleEnd); // perform select test according to configured style: double result = -1; switch (mChartStyle) { case QCPFinancial::csOhlc: result = ohlcSelectTest(pos, visibleBegin, visibleEnd, closestDataPoint); break; case QCPFinancial::csCandlestick: result = candlestickSelectTest(pos, visibleBegin, visibleEnd, closestDataPoint); break; } if (details) { int pointIndex = int(closestDataPoint-mDataContainer->constBegin()); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return result; } return -1; } /* inherits documentation from base class */ QCPRange QCPFinancial::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { QCPRange range = mDataContainer->keyRange(foundRange, inSignDomain); // determine exact range by including width of bars/flags: if (foundRange) { if (inSignDomain != QCP::sdPositive || range.lower-mWidth*0.5 > 0) range.lower -= mWidth*0.5; if (inSignDomain != QCP::sdNegative || range.upper+mWidth*0.5 < 0) range.upper += mWidth*0.5; } return range; } /* inherits documentation from base class */ QCPRange QCPFinancial::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); } /*! A convenience function that converts time series data (\a value against \a time) to OHLC binned data points. The return value can then be passed on to \ref QCPFinancialDataContainer::set(const QCPFinancialDataContainer&). The size of the bins can be controlled with \a timeBinSize in the same units as \a time is given. For example, if the unit of \a time is seconds and single OHLC/Candlesticks should span an hour each, set \a timeBinSize to 3600. \a timeBinOffset allows to control precisely at what \a time coordinate a bin should start. The value passed as \a timeBinOffset doesn't need to be in the range encompassed by the \a time keys. It merely defines the mathematical offset/phase of the bins that will be used to process the data. */ QCPFinancialDataContainer QCPFinancial::timeSeriesToOhlc(const QVector &time, const QVector &value, double timeBinSize, double timeBinOffset) { QCPFinancialDataContainer data; int count = qMin(time.size(), value.size()); if (count == 0) return QCPFinancialDataContainer(); QCPFinancialData currentBinData(0, value.first(), value.first(), value.first(), value.first()); int currentBinIndex = qFloor((time.first()-timeBinOffset)/timeBinSize+0.5); for (int i=0; i currentBinData.high) currentBinData.high = value.at(i); if (i == count-1) // last data point is in current bin, finalize bin: { currentBinData.close = value.at(i); currentBinData.key = timeBinOffset+(index)*timeBinSize; data.add(currentBinData); } } else // data point not anymore in current bin, set close of old and open of new bin, and add old to map: { // finalize current bin: currentBinData.close = value.at(i-1); currentBinData.key = timeBinOffset+(index-1)*timeBinSize; data.add(currentBinData); // start next bin: currentBinIndex = index; currentBinData.open = value.at(i); currentBinData.high = value.at(i); currentBinData.low = value.at(i); } } return data; } /* inherits documentation from base class */ void QCPFinancial::draw(QCPPainter *painter) { // get visible data range: QCPFinancialDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd); // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; for (int i=0; i= unselectedSegments.size(); QCPFinancialDataContainer::const_iterator begin = visibleBegin; QCPFinancialDataContainer::const_iterator end = visibleEnd; mDataContainer->limitIteratorsToDataRange(begin, end, allSegments.at(i)); if (begin == end) continue; // draw data segment according to configured style: switch (mChartStyle) { case QCPFinancial::csOhlc: drawOhlcPlot(painter, begin, end, isSelectedSegment); break; case QCPFinancial::csCandlestick: drawCandlestickPlot(painter, begin, end, isSelectedSegment); break; } } // draw other selection decoration that isn't just line/scatter pens and brushes: if (mSelectionDecorator) mSelectionDecorator->drawDecoration(painter, selection()); } /* inherits documentation from base class */ void QCPFinancial::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { painter->setAntialiasing(false); // legend icon especially of csCandlestick looks better without antialiasing if (mChartStyle == csOhlc) { if (mTwoColored) { // draw upper left half icon with positive color: painter->setBrush(mBrushPositive); painter->setPen(mPenPositive); painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.topLeft().toPoint())); painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); // draw bottom right half icon with negative color: painter->setBrush(mBrushNegative); painter->setPen(mPenNegative); painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.bottomRight().toPoint())); painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); } else { painter->setBrush(mBrush); painter->setPen(mPen); painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); } } else if (mChartStyle == csCandlestick) { if (mTwoColored) { // draw upper left half icon with positive color: painter->setBrush(mBrushPositive); painter->setPen(mPenPositive); painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.topLeft().toPoint())); painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); // draw bottom right half icon with negative color: painter->setBrush(mBrushNegative); painter->setPen(mPenNegative); painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.bottomRight().toPoint())); painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); } else { painter->setBrush(mBrush); painter->setPen(mPen); painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); } } } /*! \internal Draws the data from \a begin to \a end-1 as OHLC bars with the provided \a painter. This method is a helper function for \ref draw. It is used when the chart style is \ref csOhlc. */ void QCPFinancial::drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected) { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (keyAxis->orientation() == Qt::Horizontal) { for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) { if (isSelected && mSelectionDecorator) mSelectionDecorator->applyPen(painter); else if (mTwoColored) painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); else painter->setPen(mPen); double keyPixel = keyAxis->coordToPixel(it->key); double openPixel = valueAxis->coordToPixel(it->open); double closePixel = valueAxis->coordToPixel(it->close); // draw backbone: painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it->high)), QPointF(keyPixel, valueAxis->coordToPixel(it->low))); // draw open: double pixelWidth = getPixelWidth(it->key, keyPixel); // sign of this makes sure open/close are on correct sides painter->drawLine(QPointF(keyPixel-pixelWidth, openPixel), QPointF(keyPixel, openPixel)); // draw close: painter->drawLine(QPointF(keyPixel, closePixel), QPointF(keyPixel+pixelWidth, closePixel)); } } else { for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) { if (isSelected && mSelectionDecorator) mSelectionDecorator->applyPen(painter); else if (mTwoColored) painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); else painter->setPen(mPen); double keyPixel = keyAxis->coordToPixel(it->key); double openPixel = valueAxis->coordToPixel(it->open); double closePixel = valueAxis->coordToPixel(it->close); // draw backbone: painter->drawLine(QPointF(valueAxis->coordToPixel(it->high), keyPixel), QPointF(valueAxis->coordToPixel(it->low), keyPixel)); // draw open: double pixelWidth = getPixelWidth(it->key, keyPixel); // sign of this makes sure open/close are on correct sides painter->drawLine(QPointF(openPixel, keyPixel-pixelWidth), QPointF(openPixel, keyPixel)); // draw close: painter->drawLine(QPointF(closePixel, keyPixel), QPointF(closePixel, keyPixel+pixelWidth)); } } } /*! \internal Draws the data from \a begin to \a end-1 as Candlesticks with the provided \a painter. This method is a helper function for \ref draw. It is used when the chart style is \ref csCandlestick. */ void QCPFinancial::drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected) { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (keyAxis->orientation() == Qt::Horizontal) { for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) { if (isSelected && mSelectionDecorator) { mSelectionDecorator->applyPen(painter); mSelectionDecorator->applyBrush(painter); } else if (mTwoColored) { painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); painter->setBrush(it->close >= it->open ? mBrushPositive : mBrushNegative); } else { painter->setPen(mPen); painter->setBrush(mBrush); } double keyPixel = keyAxis->coordToPixel(it->key); double openPixel = valueAxis->coordToPixel(it->open); double closePixel = valueAxis->coordToPixel(it->close); // draw high: painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it->high)), QPointF(keyPixel, valueAxis->coordToPixel(qMax(it->open, it->close)))); // draw low: painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it->low)), QPointF(keyPixel, valueAxis->coordToPixel(qMin(it->open, it->close)))); // draw open-close box: double pixelWidth = getPixelWidth(it->key, keyPixel); painter->drawRect(QRectF(QPointF(keyPixel-pixelWidth, closePixel), QPointF(keyPixel+pixelWidth, openPixel))); } } else // keyAxis->orientation() == Qt::Vertical { for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) { if (isSelected && mSelectionDecorator) { mSelectionDecorator->applyPen(painter); mSelectionDecorator->applyBrush(painter); } else if (mTwoColored) { painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); painter->setBrush(it->close >= it->open ? mBrushPositive : mBrushNegative); } else { painter->setPen(mPen); painter->setBrush(mBrush); } double keyPixel = keyAxis->coordToPixel(it->key); double openPixel = valueAxis->coordToPixel(it->open); double closePixel = valueAxis->coordToPixel(it->close); // draw high: painter->drawLine(QPointF(valueAxis->coordToPixel(it->high), keyPixel), QPointF(valueAxis->coordToPixel(qMax(it->open, it->close)), keyPixel)); // draw low: painter->drawLine(QPointF(valueAxis->coordToPixel(it->low), keyPixel), QPointF(valueAxis->coordToPixel(qMin(it->open, it->close)), keyPixel)); // draw open-close box: double pixelWidth = getPixelWidth(it->key, keyPixel); painter->drawRect(QRectF(QPointF(closePixel, keyPixel-pixelWidth), QPointF(openPixel, keyPixel+pixelWidth))); } } } /*! \internal This function is used to determine the width of the bar at coordinate \a key, according to the specified width (\ref setWidth) and width type (\ref setWidthType). Provide the pixel position of \a key in \a keyPixel (because usually this was already calculated via \ref QCPAxis::coordToPixel when this function is called). It returns the number of pixels the bar extends to higher keys, relative to the \a key coordinate. So with a non-reversed horizontal axis, the return value is positive. With a reversed horizontal axis, the return value is negative. This is important so the open/close flags on the \ref csOhlc bar are drawn to the correct side. */ double QCPFinancial::getPixelWidth(double key, double keyPixel) const { double result = 0; switch (mWidthType) { case wtAbsolute: { if (mKeyAxis) result = mWidth*0.5*mKeyAxis.data()->pixelOrientation(); break; } case wtAxisRectRatio: { if (mKeyAxis && mKeyAxis.data()->axisRect()) { if (mKeyAxis.data()->orientation() == Qt::Horizontal) result = mKeyAxis.data()->axisRect()->width()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); else result = mKeyAxis.data()->axisRect()->height()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); } else qDebug() << Q_FUNC_INFO << "No key axis or axis rect defined"; break; } case wtPlotCoords: { if (mKeyAxis) result = mKeyAxis.data()->coordToPixel(key+mWidth*0.5)-keyPixel; else qDebug() << Q_FUNC_INFO << "No key axis defined"; break; } } return result; } /*! \internal This method is a helper function for \ref selectTest. It is used to test for selection when the chart style is \ref csOhlc. It only tests against the data points between \a begin and \a end. Like \ref selectTest, this method returns the shortest distance of \a pos to the graphical representation of the plottable, and \a closestDataPoint will point to the respective data point. */ double QCPFinancial::ohlcSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const { closestDataPoint = mDataContainer->constEnd(); QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } double minDistSqr = (std::numeric_limits::max)(); if (keyAxis->orientation() == Qt::Horizontal) { for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) { double keyPixel = keyAxis->coordToPixel(it->key); // calculate distance to backbone: double currentDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(keyPixel, valueAxis->coordToPixel(it->high)), QCPVector2D(keyPixel, valueAxis->coordToPixel(it->low))); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestDataPoint = it; } } } else // keyAxis->orientation() == Qt::Vertical { for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) { double keyPixel = keyAxis->coordToPixel(it->key); // calculate distance to backbone: double currentDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(valueAxis->coordToPixel(it->high), keyPixel), QCPVector2D(valueAxis->coordToPixel(it->low), keyPixel)); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestDataPoint = it; } } } return qSqrt(minDistSqr); } /*! \internal This method is a helper function for \ref selectTest. It is used to test for selection when the chart style is \ref csCandlestick. It only tests against the data points between \a begin and \a end. Like \ref selectTest, this method returns the shortest distance of \a pos to the graphical representation of the plottable, and \a closestDataPoint will point to the respective data point. */ double QCPFinancial::candlestickSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const { closestDataPoint = mDataContainer->constEnd(); QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } double minDistSqr = (std::numeric_limits::max)(); if (keyAxis->orientation() == Qt::Horizontal) { for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) { double currentDistSqr; // determine whether pos is in open-close-box: QCPRange boxKeyRange(it->key-mWidth*0.5, it->key+mWidth*0.5); QCPRange boxValueRange(it->close, it->open); double posKey, posValue; pixelsToCoords(pos, posKey, posValue); if (boxKeyRange.contains(posKey) && boxValueRange.contains(posValue)) // is in open-close-box { currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; } else { // calculate distance to high/low lines: double keyPixel = keyAxis->coordToPixel(it->key); double highLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(keyPixel, valueAxis->coordToPixel(it->high)), QCPVector2D(keyPixel, valueAxis->coordToPixel(qMax(it->open, it->close)))); double lowLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(keyPixel, valueAxis->coordToPixel(it->low)), QCPVector2D(keyPixel, valueAxis->coordToPixel(qMin(it->open, it->close)))); currentDistSqr = qMin(highLineDistSqr, lowLineDistSqr); } if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestDataPoint = it; } } } else // keyAxis->orientation() == Qt::Vertical { for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) { double currentDistSqr; // determine whether pos is in open-close-box: QCPRange boxKeyRange(it->key-mWidth*0.5, it->key+mWidth*0.5); QCPRange boxValueRange(it->close, it->open); double posKey, posValue; pixelsToCoords(pos, posKey, posValue); if (boxKeyRange.contains(posKey) && boxValueRange.contains(posValue)) // is in open-close-box { currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; } else { // calculate distance to high/low lines: double keyPixel = keyAxis->coordToPixel(it->key); double highLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(valueAxis->coordToPixel(it->high), keyPixel), QCPVector2D(valueAxis->coordToPixel(qMax(it->open, it->close)), keyPixel)); double lowLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(valueAxis->coordToPixel(it->low), keyPixel), QCPVector2D(valueAxis->coordToPixel(qMin(it->open, it->close)), keyPixel)); currentDistSqr = qMin(highLineDistSqr, lowLineDistSqr); } if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestDataPoint = it; } } } return qSqrt(minDistSqr); } /*! \internal called by the drawing methods to determine which data (key) range is visible at the current key axis range setting, so only that needs to be processed. \a begin returns an iterator to the lowest data point that needs to be taken into account when plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a begin may still be just outside the visible range. \a end returns the iterator just above the highest data point that needs to be taken into account. Same as before, \a end may also lie just outside of the visible range if the plottable contains no data, both \a begin and \a end point to \c constEnd. */ void QCPFinancial::getVisibleDataBounds(QCPFinancialDataContainer::const_iterator &begin, QCPFinancialDataContainer::const_iterator &end) const { if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; begin = mDataContainer->constEnd(); end = mDataContainer->constEnd(); return; } begin = mDataContainer->findBegin(mKeyAxis.data()->range().lower-mWidth*0.5); // subtract half width of ohlc/candlestick to include partially visible data points end = mDataContainer->findEnd(mKeyAxis.data()->range().upper+mWidth*0.5); // add half width of ohlc/candlestick to include partially visible data points } /*! \internal Returns the hit box in pixel coordinates that will be used for data selection with the selection rect (\ref selectTestRect), of the data point given by \a it. */ QRectF QCPFinancial::selectionHitBox(QCPFinancialDataContainer::const_iterator it) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return {}; } double keyPixel = keyAxis->coordToPixel(it->key); double highPixel = valueAxis->coordToPixel(it->high); double lowPixel = valueAxis->coordToPixel(it->low); double keyWidthPixels = keyPixel-keyAxis->coordToPixel(it->key-mWidth*0.5); if (keyAxis->orientation() == Qt::Horizontal) return QRectF(keyPixel-keyWidthPixels, highPixel, keyWidthPixels*2, lowPixel-highPixel).normalized(); else return QRectF(highPixel, keyPixel-keyWidthPixels, lowPixel-highPixel, keyWidthPixels*2).normalized(); } /* end of 'src/plottables/plottable-financial.cpp' */ /* including file 'src/plottables/plottable-errorbar.cpp' */ /* modified 2021-03-29T02:30:44, size 37679 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPErrorBarsData //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPErrorBarsData \brief Holds the data of one single error bar for QCPErrorBars. The stored data is: \li \a errorMinus: how much the error bar extends towards negative coordinates from the data point position \li \a errorPlus: how much the error bar extends towards positive coordinates from the data point position The container for storing the error bar information is \ref QCPErrorBarsDataContainer. It is a typedef for QVector<\ref QCPErrorBarsData>. \see QCPErrorBarsDataContainer */ /*! Constructs an error bar with errors set to zero. */ QCPErrorBarsData::QCPErrorBarsData() : errorMinus(0), errorPlus(0) { } /*! Constructs an error bar with equal \a error in both negative and positive direction. */ QCPErrorBarsData::QCPErrorBarsData(double error) : errorMinus(error), errorPlus(error) { } /*! Constructs an error bar with negative and positive errors set to \a errorMinus and \a errorPlus, respectively. */ QCPErrorBarsData::QCPErrorBarsData(double errorMinus, double errorPlus) : errorMinus(errorMinus), errorPlus(errorPlus) { } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPErrorBars //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPErrorBars \brief A plottable that adds a set of error bars to other plottables. \image html QCPErrorBars.png The \ref QCPErrorBars plottable can be attached to other one-dimensional plottables (e.g. \ref QCPGraph, \ref QCPCurve, \ref QCPBars, etc.) and equips them with error bars. Use \ref setDataPlottable to define for which plottable the \ref QCPErrorBars shall display the error bars. The orientation of the error bars can be controlled with \ref setErrorType. By using \ref setData, you can supply the actual error data, either as symmetric error or plus/minus asymmetric errors. \ref QCPErrorBars only stores the error data. The absolute key/value position of each error bar will be adopted from the configured data plottable. The error data of the \ref QCPErrorBars are associated one-to-one via their index to the data points of the data plottable. You can directly access and manipulate the error bar data via \ref data. Set either of the plus/minus errors to NaN (qQNaN() or std::numeric_limits::quiet_NaN()) to not show the respective error bar on the data point at that index. \section qcperrorbars-appearance Changing the appearance The appearance of the error bars is defined by the pen (\ref setPen), and the width of the whiskers (\ref setWhiskerWidth). Further, the error bar backbones may leave a gap around the data point center to prevent that error bars are drawn too close to or even through scatter points. This gap size can be controlled via \ref setSymbolGap. */ /* start of documentation of inline functions */ /*! \fn QSharedPointer QCPErrorBars::data() const Returns a shared pointer to the internal data storage of type \ref QCPErrorBarsDataContainer. You may use it to directly manipulate the error values, which may be more convenient and faster than using the regular \ref setData methods. */ /* end of documentation of inline functions */ /*! Constructs an error bars plottable which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. It is also important that the \a keyAxis and \a valueAxis are the same for the error bars plottable and the data plottable that the error bars shall be drawn on (\ref setDataPlottable). The created \ref QCPErrorBars is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the \ref QCPErrorBars, so do not delete it manually but use \ref QCustomPlot::removePlottable() instead. */ QCPErrorBars::QCPErrorBars(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable(keyAxis, valueAxis), mDataContainer(new QVector), mErrorType(etValueError), mWhiskerWidth(9), mSymbolGap(10) { setPen(QPen(Qt::black, 0)); setBrush(Qt::NoBrush); } QCPErrorBars::~QCPErrorBars() { } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple \ref QCPErrorBars instances may share the same data container safely. Modifying the data in the container will then affect all \ref QCPErrorBars instances that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp qcperrorbars-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, assign the data containers directly: \snippet documentation/doc-code-snippets/mainwindow.cpp qcperrorbars-datasharing-2 (This uses different notation compared with other plottables, because the \ref QCPErrorBars uses a \c QVector as its data container, instead of a \ref QCPDataContainer.) \see addData */ void QCPErrorBars::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Sets symmetrical error values as specified in \a error. The errors will be associated one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). You can directly access and manipulate the error bar data via \ref data. \see addData */ void QCPErrorBars::setData(const QVector &error) { mDataContainer->clear(); addData(error); } /*! \overload Sets asymmetrical errors as specified in \a errorMinus and \a errorPlus. The errors will be associated one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). You can directly access and manipulate the error bar data via \ref data. \see addData */ void QCPErrorBars::setData(const QVector &errorMinus, const QVector &errorPlus) { mDataContainer->clear(); addData(errorMinus, errorPlus); } /*! Sets the data plottable to which the error bars will be applied. The error values specified e.g. via \ref setData will be associated one-to-one by the data point index to the data points of \a plottable. This means that the error bars will adopt the key/value coordinates of the data point with the same index. The passed \a plottable must be a one-dimensional plottable, i.e. it must implement the \ref QCPPlottableInterface1D. Further, it must not be a \ref QCPErrorBars instance itself. If either of these restrictions is violated, a corresponding qDebug output is generated, and the data plottable of this \ref QCPErrorBars instance is set to zero. For proper display, care must also be taken that the key and value axes of the \a plottable match those configured for this \ref QCPErrorBars instance. */ void QCPErrorBars::setDataPlottable(QCPAbstractPlottable *plottable) { if (plottable && qobject_cast(plottable)) { mDataPlottable = nullptr; qDebug() << Q_FUNC_INFO << "can't set another QCPErrorBars instance as data plottable"; return; } if (plottable && !plottable->interface1D()) { mDataPlottable = nullptr; qDebug() << Q_FUNC_INFO << "passed plottable doesn't implement 1d interface, can't associate with QCPErrorBars"; return; } mDataPlottable = plottable; } /*! Sets in which orientation the error bars shall appear on the data points. If your data needs both error dimensions, create two \ref QCPErrorBars with different \a type. */ void QCPErrorBars::setErrorType(ErrorType type) { mErrorType = type; } /*! Sets the width of the whiskers (the short bars at the end of the actual error bar backbones) to \a pixels. */ void QCPErrorBars::setWhiskerWidth(double pixels) { mWhiskerWidth = pixels; } /*! Sets the gap diameter around the data points that will be left out when drawing the error bar backbones. This gap prevents that error bars are drawn too close to or even through scatter points. */ void QCPErrorBars::setSymbolGap(double pixels) { mSymbolGap = pixels; } /*! \overload Adds symmetrical error values as specified in \a error. The errors will be associated one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). You can directly access and manipulate the error bar data via \ref data. \see setData */ void QCPErrorBars::addData(const QVector &error) { addData(error, error); } /*! \overload Adds asymmetrical errors as specified in \a errorMinus and \a errorPlus. The errors will be associated one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). You can directly access and manipulate the error bar data via \ref data. \see setData */ void QCPErrorBars::addData(const QVector &errorMinus, const QVector &errorPlus) { if (errorMinus.size() != errorPlus.size()) qDebug() << Q_FUNC_INFO << "minus and plus error vectors have different sizes:" << errorMinus.size() << errorPlus.size(); const int n = qMin(errorMinus.size(), errorPlus.size()); mDataContainer->reserve(n); for (int i=0; iappend(QCPErrorBarsData(errorMinus.at(i), errorPlus.at(i))); } /*! \overload Adds a single symmetrical error bar as specified in \a error. The errors will be associated one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). You can directly access and manipulate the error bar data via \ref data. \see setData */ void QCPErrorBars::addData(double error) { mDataContainer->append(QCPErrorBarsData(error)); } /*! \overload Adds a single asymmetrical error bar as specified in \a errorMinus and \a errorPlus. The errors will be associated one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). You can directly access and manipulate the error bar data via \ref data. \see setData */ void QCPErrorBars::addData(double errorMinus, double errorPlus) { mDataContainer->append(QCPErrorBarsData(errorMinus, errorPlus)); } /* inherits documentation from base class */ int QCPErrorBars::dataCount() const { return mDataContainer->size(); } /* inherits documentation from base class */ double QCPErrorBars::dataMainKey(int index) const { if (mDataPlottable) return mDataPlottable->interface1D()->dataMainKey(index); else qDebug() << Q_FUNC_INFO << "no data plottable set"; return 0; } /* inherits documentation from base class */ double QCPErrorBars::dataSortKey(int index) const { if (mDataPlottable) return mDataPlottable->interface1D()->dataSortKey(index); else qDebug() << Q_FUNC_INFO << "no data plottable set"; return 0; } /* inherits documentation from base class */ double QCPErrorBars::dataMainValue(int index) const { if (mDataPlottable) return mDataPlottable->interface1D()->dataMainValue(index); else qDebug() << Q_FUNC_INFO << "no data plottable set"; return 0; } /* inherits documentation from base class */ QCPRange QCPErrorBars::dataValueRange(int index) const { if (mDataPlottable) { const double value = mDataPlottable->interface1D()->dataMainValue(index); if (index >= 0 && index < mDataContainer->size() && mErrorType == etValueError) return {value-mDataContainer->at(index).errorMinus, value+mDataContainer->at(index).errorPlus}; else return {value, value}; } else { qDebug() << Q_FUNC_INFO << "no data plottable set"; return {}; } } /* inherits documentation from base class */ QPointF QCPErrorBars::dataPixelPosition(int index) const { if (mDataPlottable) return mDataPlottable->interface1D()->dataPixelPosition(index); else qDebug() << Q_FUNC_INFO << "no data plottable set"; return {}; } /* inherits documentation from base class */ bool QCPErrorBars::sortKeyIsMainKey() const { if (mDataPlottable) { return mDataPlottable->interface1D()->sortKeyIsMainKey(); } else { qDebug() << Q_FUNC_INFO << "no data plottable set"; return true; } } /*! \copydoc QCPPlottableInterface1D::selectTestRect */ QCPDataSelection QCPErrorBars::selectTestRect(const QRectF &rect, bool onlySelectable) const { QCPDataSelection result; if (!mDataPlottable) return result; if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return result; if (!mKeyAxis || !mValueAxis) return result; QCPErrorBarsDataContainer::const_iterator visibleBegin, visibleEnd; getVisibleDataBounds(visibleBegin, visibleEnd, QCPDataRange(0, dataCount())); QVector backbones, whiskers; for (QCPErrorBarsDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) { backbones.clear(); whiskers.clear(); getErrorBarLines(it, backbones, whiskers); foreach (const QLineF &backbone, backbones) { if (rectIntersectsLine(rect, backbone)) { result.addDataRange(QCPDataRange(int(it-mDataContainer->constBegin()), int(it-mDataContainer->constBegin()+1)), false); break; } } } result.simplify(); return result; } /* inherits documentation from base class */ int QCPErrorBars::findBegin(double sortKey, bool expandedRange) const { if (mDataPlottable) { if (mDataContainer->isEmpty()) return 0; int beginIndex = mDataPlottable->interface1D()->findBegin(sortKey, expandedRange); if (beginIndex >= mDataContainer->size()) beginIndex = mDataContainer->size()-1; return beginIndex; } else qDebug() << Q_FUNC_INFO << "no data plottable set"; return 0; } /* inherits documentation from base class */ int QCPErrorBars::findEnd(double sortKey, bool expandedRange) const { if (mDataPlottable) { if (mDataContainer->isEmpty()) return 0; int endIndex = mDataPlottable->interface1D()->findEnd(sortKey, expandedRange); if (endIndex > mDataContainer->size()) endIndex = mDataContainer->size(); return endIndex; } else qDebug() << Q_FUNC_INFO << "no data plottable set"; return 0; } /*! Implements a selectTest specific to this plottable's point geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod \ref QCPAbstractPlottable::selectTest */ double QCPErrorBars::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if (!mDataPlottable) return -1; if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint()) || mParentPlot->interactions().testFlag(QCP::iSelectPlottablesBeyondAxisRect)) { QCPErrorBarsDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); double result = pointDistance(pos, closestDataPoint); if (details) { int pointIndex = int(closestDataPoint-mDataContainer->constBegin()); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return result; } else return -1; } /* inherits documentation from base class */ void QCPErrorBars::draw(QCPPainter *painter) { if (!mDataPlottable) return; if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (mKeyAxis.data()->range().size() <= 0 || mDataContainer->isEmpty()) return; // if the sort key isn't the main key, we must check the visibility for each data point/error bar individually // (getVisibleDataBounds applies range restriction, but otherwise can only return full data range): bool checkPointVisibility = !mDataPlottable->interface1D()->sortKeyIsMainKey(); // check data validity if flag set: #ifdef QCUSTOMPLOT_CHECK_DATA QCPErrorBarsDataContainer::const_iterator it; for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) { if (QCP::isInvalidData(it->errorMinus, it->errorPlus)) qDebug() << Q_FUNC_INFO << "Data point at index" << it-mDataContainer->constBegin() << "invalid." << "Plottable name:" << name(); } #endif applyDefaultAntialiasingHint(painter); painter->setBrush(Qt::NoBrush); // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; QVector backbones, whiskers; for (int i=0; i= unselectedSegments.size(); if (isSelectedSegment && mSelectionDecorator) mSelectionDecorator->applyPen(painter); else painter->setPen(mPen); if (painter->pen().capStyle() == Qt::SquareCap) { QPen capFixPen(painter->pen()); capFixPen.setCapStyle(Qt::FlatCap); painter->setPen(capFixPen); } backbones.clear(); whiskers.clear(); for (QCPErrorBarsDataContainer::const_iterator it=begin; it!=end; ++it) { if (!checkPointVisibility || errorBarVisible(int(it-mDataContainer->constBegin()))) getErrorBarLines(it, backbones, whiskers); } painter->drawLines(backbones); painter->drawLines(whiskers); } // draw other selection decoration that isn't just line/scatter pens and brushes: if (mSelectionDecorator) mSelectionDecorator->drawDecoration(painter, selection()); } /* inherits documentation from base class */ void QCPErrorBars::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const { applyDefaultAntialiasingHint(painter); painter->setPen(mPen); if (mErrorType == etValueError && mValueAxis && mValueAxis->orientation() == Qt::Vertical) { painter->drawLine(QLineF(rect.center().x(), rect.top()+2, rect.center().x(), rect.bottom()-1)); painter->drawLine(QLineF(rect.center().x()-4, rect.top()+2, rect.center().x()+4, rect.top()+2)); painter->drawLine(QLineF(rect.center().x()-4, rect.bottom()-1, rect.center().x()+4, rect.bottom()-1)); } else { painter->drawLine(QLineF(rect.left()+2, rect.center().y(), rect.right()-2, rect.center().y())); painter->drawLine(QLineF(rect.left()+2, rect.center().y()-4, rect.left()+2, rect.center().y()+4)); painter->drawLine(QLineF(rect.right()-2, rect.center().y()-4, rect.right()-2, rect.center().y()+4)); } } /* inherits documentation from base class */ QCPRange QCPErrorBars::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { if (!mDataPlottable) { foundRange = false; return {}; } QCPRange range; bool haveLower = false; bool haveUpper = false; QCPErrorBarsDataContainer::const_iterator it; for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) { if (mErrorType == etValueError) { // error bar doesn't extend in key dimension (except whisker but we ignore that here), so only use data point center const double current = mDataPlottable->interface1D()->dataMainKey(int(it-mDataContainer->constBegin())); if (qIsNaN(current)) continue; if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current < range.lower || !haveLower) { range.lower = current; haveLower = true; } if (current > range.upper || !haveUpper) { range.upper = current; haveUpper = true; } } } else // mErrorType == etKeyError { const double dataKey = mDataPlottable->interface1D()->dataMainKey(int(it-mDataContainer->constBegin())); if (qIsNaN(dataKey)) continue; // plus error: double current = dataKey + (qIsNaN(it->errorPlus) ? 0 : it->errorPlus); if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current > range.upper || !haveUpper) { range.upper = current; haveUpper = true; } } // minus error: current = dataKey - (qIsNaN(it->errorMinus) ? 0 : it->errorMinus); if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current < range.lower || !haveLower) { range.lower = current; haveLower = true; } } } } if (haveUpper && !haveLower) { range.lower = range.upper; haveLower = true; } else if (haveLower && !haveUpper) { range.upper = range.lower; haveUpper = true; } foundRange = haveLower && haveUpper; return range; } /* inherits documentation from base class */ QCPRange QCPErrorBars::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { if (!mDataPlottable) { foundRange = false; return {}; } QCPRange range; const bool restrictKeyRange = inKeyRange != QCPRange(); bool haveLower = false; bool haveUpper = false; QCPErrorBarsDataContainer::const_iterator itBegin = mDataContainer->constBegin(); QCPErrorBarsDataContainer::const_iterator itEnd = mDataContainer->constEnd(); if (mDataPlottable->interface1D()->sortKeyIsMainKey() && restrictKeyRange) { itBegin = mDataContainer->constBegin()+findBegin(inKeyRange.lower, false); itEnd = mDataContainer->constBegin()+findEnd(inKeyRange.upper, false); } for (QCPErrorBarsDataContainer::const_iterator it = itBegin; it != itEnd; ++it) { if (restrictKeyRange) { const double dataKey = mDataPlottable->interface1D()->dataMainKey(int(it-mDataContainer->constBegin())); if (dataKey < inKeyRange.lower || dataKey > inKeyRange.upper) continue; } if (mErrorType == etValueError) { const double dataValue = mDataPlottable->interface1D()->dataMainValue(int(it-mDataContainer->constBegin())); if (qIsNaN(dataValue)) continue; // plus error: double current = dataValue + (qIsNaN(it->errorPlus) ? 0 : it->errorPlus); if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current > range.upper || !haveUpper) { range.upper = current; haveUpper = true; } } // minus error: current = dataValue - (qIsNaN(it->errorMinus) ? 0 : it->errorMinus); if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current < range.lower || !haveLower) { range.lower = current; haveLower = true; } } } else // mErrorType == etKeyError { // error bar doesn't extend in value dimension (except whisker but we ignore that here), so only use data point center const double current = mDataPlottable->interface1D()->dataMainValue(int(it-mDataContainer->constBegin())); if (qIsNaN(current)) continue; if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) { if (current < range.lower || !haveLower) { range.lower = current; haveLower = true; } if (current > range.upper || !haveUpper) { range.upper = current; haveUpper = true; } } } } if (haveUpper && !haveLower) { range.lower = range.upper; haveLower = true; } else if (haveLower && !haveUpper) { range.upper = range.lower; haveUpper = true; } foundRange = haveLower && haveUpper; return range; } /*! \internal Calculates the lines that make up the error bar belonging to the data point \a it. The resulting lines are added to \a backbones and \a whiskers. The vectors are not cleared, so calling this method with different \a it but the same \a backbones and \a whiskers allows to accumulate lines for multiple data points. This method assumes that \a it is a valid iterator within the bounds of this \ref QCPErrorBars instance and within the bounds of the associated data plottable. */ void QCPErrorBars::getErrorBarLines(QCPErrorBarsDataContainer::const_iterator it, QVector &backbones, QVector &whiskers) const { if (!mDataPlottable) return; int index = int(it-mDataContainer->constBegin()); QPointF centerPixel = mDataPlottable->interface1D()->dataPixelPosition(index); if (qIsNaN(centerPixel.x()) || qIsNaN(centerPixel.y())) return; QCPAxis *errorAxis = mErrorType == etValueError ? mValueAxis.data() : mKeyAxis.data(); QCPAxis *orthoAxis = mErrorType == etValueError ? mKeyAxis.data() : mValueAxis.data(); const double centerErrorAxisPixel = errorAxis->orientation() == Qt::Horizontal ? centerPixel.x() : centerPixel.y(); const double centerOrthoAxisPixel = orthoAxis->orientation() == Qt::Horizontal ? centerPixel.x() : centerPixel.y(); const double centerErrorAxisCoord = errorAxis->pixelToCoord(centerErrorAxisPixel); // depending on plottable, this might be different from just mDataPlottable->interface1D()->dataMainKey/Value const double symbolGap = mSymbolGap*0.5*errorAxis->pixelOrientation(); // plus error: double errorStart, errorEnd; if (!qIsNaN(it->errorPlus)) { errorStart = centerErrorAxisPixel+symbolGap; errorEnd = errorAxis->coordToPixel(centerErrorAxisCoord+it->errorPlus); if (errorAxis->orientation() == Qt::Vertical) { if ((errorStart > errorEnd) != errorAxis->rangeReversed()) backbones.append(QLineF(centerOrthoAxisPixel, errorStart, centerOrthoAxisPixel, errorEnd)); whiskers.append(QLineF(centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5, errorEnd)); } else { if ((errorStart < errorEnd) != errorAxis->rangeReversed()) backbones.append(QLineF(errorStart, centerOrthoAxisPixel, errorEnd, centerOrthoAxisPixel)); whiskers.append(QLineF(errorEnd, centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5)); } } // minus error: if (!qIsNaN(it->errorMinus)) { errorStart = centerErrorAxisPixel-symbolGap; errorEnd = errorAxis->coordToPixel(centerErrorAxisCoord-it->errorMinus); if (errorAxis->orientation() == Qt::Vertical) { if ((errorStart < errorEnd) != errorAxis->rangeReversed()) backbones.append(QLineF(centerOrthoAxisPixel, errorStart, centerOrthoAxisPixel, errorEnd)); whiskers.append(QLineF(centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5, errorEnd)); } else { if ((errorStart > errorEnd) != errorAxis->rangeReversed()) backbones.append(QLineF(errorStart, centerOrthoAxisPixel, errorEnd, centerOrthoAxisPixel)); whiskers.append(QLineF(errorEnd, centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5)); } } } /*! \internal This method outputs the currently visible data range via \a begin and \a end. The returned range will also never exceed \a rangeRestriction. Since error bars with type \ref etKeyError may extend to arbitrarily positive and negative key coordinates relative to their data point key, this method checks all outer error bars whether they truly don't reach into the visible portion of the axis rect, by calling \ref errorBarVisible. On the other hand error bars with type \ref etValueError that are associated with data plottables whose sort key is equal to the main key (see \ref qcpdatacontainer-datatype "QCPDataContainer DataType") can be handled very efficiently by finding the visible range of error bars through binary search (\ref QCPPlottableInterface1D::findBegin and \ref QCPPlottableInterface1D::findEnd). If the plottable's sort key is not equal to the main key, this method returns the full data range, only restricted by \a rangeRestriction. Drawing optimization then has to be done on a point-by-point basis in the \ref draw method. */ void QCPErrorBars::getVisibleDataBounds(QCPErrorBarsDataContainer::const_iterator &begin, QCPErrorBarsDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const { QCPAxis *keyAxis = mKeyAxis.data(); QCPAxis *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; end = mDataContainer->constEnd(); begin = end; return; } if (!mDataPlottable || rangeRestriction.isEmpty()) { end = mDataContainer->constEnd(); begin = end; return; } if (!mDataPlottable->interface1D()->sortKeyIsMainKey()) { // if the sort key isn't the main key, it's not possible to find a contiguous range of visible // data points, so this method then only applies the range restriction and otherwise returns // the full data range. Visibility checks must be done on a per-datapoin-basis during drawing QCPDataRange dataRange(0, mDataContainer->size()); dataRange = dataRange.bounded(rangeRestriction); begin = mDataContainer->constBegin()+dataRange.begin(); end = mDataContainer->constBegin()+dataRange.end(); return; } // get visible data range via interface from data plottable, and then restrict to available error data points: const int n = qMin(mDataContainer->size(), mDataPlottable->interface1D()->dataCount()); int beginIndex = mDataPlottable->interface1D()->findBegin(keyAxis->range().lower); int endIndex = mDataPlottable->interface1D()->findEnd(keyAxis->range().upper); int i = beginIndex; while (i > 0 && i < n && i > rangeRestriction.begin()) { if (errorBarVisible(i)) beginIndex = i; --i; } i = endIndex; while (i >= 0 && i < n && i < rangeRestriction.end()) { if (errorBarVisible(i)) endIndex = i+1; ++i; } QCPDataRange dataRange(beginIndex, endIndex); dataRange = dataRange.bounded(rangeRestriction.bounded(QCPDataRange(0, mDataContainer->size()))); begin = mDataContainer->constBegin()+dataRange.begin(); end = mDataContainer->constBegin()+dataRange.end(); } /*! \internal Calculates the minimum distance in pixels the error bars' representation has from the given \a pixelPoint. This is used to determine whether the error bar was clicked or not, e.g. in \ref selectTest. The closest data point to \a pixelPoint is returned in \a closestData. */ double QCPErrorBars::pointDistance(const QPointF &pixelPoint, QCPErrorBarsDataContainer::const_iterator &closestData) const { closestData = mDataContainer->constEnd(); if (!mDataPlottable || mDataContainer->isEmpty()) return -1.0; if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1.0; } QCPErrorBarsDataContainer::const_iterator begin, end; getVisibleDataBounds(begin, end, QCPDataRange(0, dataCount())); // calculate minimum distances to error backbones (whiskers are ignored for speed) and find closestData iterator: double minDistSqr = (std::numeric_limits::max)(); QVector backbones, whiskers; for (QCPErrorBarsDataContainer::const_iterator it=begin; it!=end; ++it) { getErrorBarLines(it, backbones, whiskers); foreach (const QLineF &backbone, backbones) { const double currentDistSqr = QCPVector2D(pixelPoint).distanceSquaredToLine(backbone); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestData = it; } } } return qSqrt(minDistSqr); } /*! \internal \note This method is identical to \ref QCPAbstractPlottable1D::getDataSegments but needs to be reproduced here since the \ref QCPErrorBars plottable, as a special case that doesn't have its own key/value data coordinates, doesn't derive from \ref QCPAbstractPlottable1D. See the documentation there for details. */ void QCPErrorBars::getDataSegments(QList &selectedSegments, QList &unselectedSegments) const { selectedSegments.clear(); unselectedSegments.clear(); if (mSelectable == QCP::stWhole) // stWhole selection type draws the entire plottable with selected style if mSelection isn't empty { if (selected()) selectedSegments << QCPDataRange(0, dataCount()); else unselectedSegments << QCPDataRange(0, dataCount()); } else { QCPDataSelection sel(selection()); sel.simplify(); selectedSegments = sel.dataRanges(); unselectedSegments = sel.inverse(QCPDataRange(0, dataCount())).dataRanges(); } } /*! \internal Returns whether the error bar at the specified \a index is visible within the current key axis range. This method assumes for performance reasons without checking that the key axis, the value axis, and the data plottable (\ref setDataPlottable) are not \c nullptr and that \a index is within valid bounds of this \ref QCPErrorBars instance and the bounds of the data plottable. */ bool QCPErrorBars::errorBarVisible(int index) const { QPointF centerPixel = mDataPlottable->interface1D()->dataPixelPosition(index); const double centerKeyPixel = mKeyAxis->orientation() == Qt::Horizontal ? centerPixel.x() : centerPixel.y(); if (qIsNaN(centerKeyPixel)) return false; double keyMin, keyMax; if (mErrorType == etKeyError) { const double centerKey = mKeyAxis->pixelToCoord(centerKeyPixel); const double errorPlus = mDataContainer->at(index).errorPlus; const double errorMinus = mDataContainer->at(index).errorMinus; keyMax = centerKey+(qIsNaN(errorPlus) ? 0 : errorPlus); keyMin = centerKey-(qIsNaN(errorMinus) ? 0 : errorMinus); } else // mErrorType == etValueError { keyMax = mKeyAxis->pixelToCoord(centerKeyPixel+mWhiskerWidth*0.5*mKeyAxis->pixelOrientation()); keyMin = mKeyAxis->pixelToCoord(centerKeyPixel-mWhiskerWidth*0.5*mKeyAxis->pixelOrientation()); } return ((keyMax > mKeyAxis->range().lower) && (keyMin < mKeyAxis->range().upper)); } /*! \internal Returns whether \a line intersects (or is contained in) \a pixelRect. \a line is assumed to be either perfectly horizontal or perfectly vertical, as is the case for error bar lines. */ bool QCPErrorBars::rectIntersectsLine(const QRectF &pixelRect, const QLineF &line) const { if (pixelRect.left() > line.x1() && pixelRect.left() > line.x2()) return false; else if (pixelRect.right() < line.x1() && pixelRect.right() < line.x2()) return false; else if (pixelRect.top() > line.y1() && pixelRect.top() > line.y2()) return false; else if (pixelRect.bottom() < line.y1() && pixelRect.bottom() < line.y2()) return false; else return true; } /* end of 'src/plottables/plottable-errorbar.cpp' */ /* including file 'src/items/item-straightline.cpp' */ /* modified 2021-03-29T02:30:44, size 7596 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemStraightLine //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemStraightLine \brief A straight line that spans infinitely in both directions \image html QCPItemStraightLine.png "Straight line example. Blue dotted circles are anchors, solid blue discs are positions." It has two positions, \a point1 and \a point2, which define the straight line. */ /*! Creates a straight line item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemStraightLine::QCPItemStraightLine(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), point1(createPosition(QLatin1String("point1"))), point2(createPosition(QLatin1String("point2"))) { point1->setCoords(0, 0); point2->setCoords(1, 1); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue,2)); } QCPItemStraightLine::~QCPItemStraightLine() { } /*! Sets the pen that will be used to draw the line \see setSelectedPen */ void QCPItemStraightLine::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the line when selected \see setPen, setSelected */ void QCPItemStraightLine::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /* inherits documentation from base class */ double QCPItemStraightLine::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; return QCPVector2D(pos).distanceToStraightLine(point1->pixelPosition(), point2->pixelPosition()-point1->pixelPosition()); } /* inherits documentation from base class */ void QCPItemStraightLine::draw(QCPPainter *painter) { QCPVector2D start(point1->pixelPosition()); QCPVector2D end(point2->pixelPosition()); // get visible segment of straight line inside clipRect: int clipPad = qCeil(mainPen().widthF()); QLineF line = getRectClippedStraightLine(start, end-start, clipRect().adjusted(-clipPad, -clipPad, clipPad, clipPad)); // paint visible segment, if existent: if (!line.isNull()) { painter->setPen(mainPen()); painter->drawLine(line); } } /*! \internal Returns the section of the straight line defined by \a base and direction vector \a vec, that is visible in the specified \a rect. This is a helper function for \ref draw. */ QLineF QCPItemStraightLine::getRectClippedStraightLine(const QCPVector2D &base, const QCPVector2D &vec, const QRect &rect) const { double bx, by; double gamma; QLineF result; if (vec.x() == 0 && vec.y() == 0) return result; if (qFuzzyIsNull(vec.x())) // line is vertical { // check top of rect: bx = rect.left(); by = rect.top(); gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); if (gamma >= 0 && gamma <= rect.width()) result.setLine(bx+gamma, rect.top(), bx+gamma, rect.bottom()); // no need to check bottom because we know line is vertical } else if (qFuzzyIsNull(vec.y())) // line is horizontal { // check left of rect: bx = rect.left(); by = rect.top(); gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); if (gamma >= 0 && gamma <= rect.height()) result.setLine(rect.left(), by+gamma, rect.right(), by+gamma); // no need to check right because we know line is horizontal } else // line is skewed { QList pointVectors; // check top of rect: bx = rect.left(); by = rect.top(); gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); if (gamma >= 0 && gamma <= rect.width()) pointVectors.append(QCPVector2D(bx+gamma, by)); // check bottom of rect: bx = rect.left(); by = rect.bottom(); gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); if (gamma >= 0 && gamma <= rect.width()) pointVectors.append(QCPVector2D(bx+gamma, by)); // check left of rect: bx = rect.left(); by = rect.top(); gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); if (gamma >= 0 && gamma <= rect.height()) pointVectors.append(QCPVector2D(bx, by+gamma)); // check right of rect: bx = rect.right(); by = rect.top(); gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); if (gamma >= 0 && gamma <= rect.height()) pointVectors.append(QCPVector2D(bx, by+gamma)); // evaluate points: if (pointVectors.size() == 2) { result.setPoints(pointVectors.at(0).toPointF(), pointVectors.at(1).toPointF()); } else if (pointVectors.size() > 2) { // line probably goes through corner of rect, and we got two points there. single out the point pair with greatest distance: double distSqrMax = 0; QCPVector2D pv1, pv2; for (int i=0; i distSqrMax) { pv1 = pointVectors.at(i); pv2 = pointVectors.at(k); distSqrMax = distSqr; } } } result.setPoints(pv1.toPointF(), pv2.toPointF()); } } return result; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemStraightLine::mainPen() const { return mSelected ? mSelectedPen : mPen; } /* end of 'src/items/item-straightline.cpp' */ /* including file 'src/items/item-line.cpp' */ /* modified 2021-03-29T02:30:44, size 8525 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemLine //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemLine \brief A line from one point to another \image html QCPItemLine.png "Line example. Blue dotted circles are anchors, solid blue discs are positions." It has two positions, \a start and \a end, which define the end points of the line. With \ref setHead and \ref setTail you may set different line ending styles, e.g. to create an arrow. */ /*! Creates a line item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemLine::QCPItemLine(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), start(createPosition(QLatin1String("start"))), end(createPosition(QLatin1String("end"))) { start->setCoords(0, 0); end->setCoords(1, 1); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue,2)); } QCPItemLine::~QCPItemLine() { } /*! Sets the pen that will be used to draw the line \see setSelectedPen */ void QCPItemLine::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the line when selected \see setPen, setSelected */ void QCPItemLine::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the line ending style of the head. The head corresponds to the \a end position. Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g. \code setHead(QCPLineEnding::esSpikeArrow) \endcode \see setTail */ void QCPItemLine::setHead(const QCPLineEnding &head) { mHead = head; } /*! Sets the line ending style of the tail. The tail corresponds to the \a start position. Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g. \code setTail(QCPLineEnding::esSpikeArrow) \endcode \see setHead */ void QCPItemLine::setTail(const QCPLineEnding &tail) { mTail = tail; } /* inherits documentation from base class */ double QCPItemLine::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; return qSqrt(QCPVector2D(pos).distanceSquaredToLine(start->pixelPosition(), end->pixelPosition())); } /* inherits documentation from base class */ void QCPItemLine::draw(QCPPainter *painter) { QCPVector2D startVec(start->pixelPosition()); QCPVector2D endVec(end->pixelPosition()); if (qFuzzyIsNull((startVec-endVec).lengthSquared())) return; // get visible segment of straight line inside clipRect: int clipPad = int(qMax(mHead.boundingDistance(), mTail.boundingDistance())); clipPad = qMax(clipPad, qCeil(mainPen().widthF())); QLineF line = getRectClippedLine(startVec, endVec, clipRect().adjusted(-clipPad, -clipPad, clipPad, clipPad)); // paint visible segment, if existent: if (!line.isNull()) { painter->setPen(mainPen()); painter->drawLine(line); painter->setBrush(Qt::SolidPattern); if (mTail.style() != QCPLineEnding::esNone) mTail.draw(painter, startVec, startVec-endVec); if (mHead.style() != QCPLineEnding::esNone) mHead.draw(painter, endVec, endVec-startVec); } } /*! \internal Returns the section of the line defined by \a start and \a end, that is visible in the specified \a rect. This is a helper function for \ref draw. */ QLineF QCPItemLine::getRectClippedLine(const QCPVector2D &start, const QCPVector2D &end, const QRect &rect) const { bool containsStart = rect.contains(qRound(start.x()), qRound(start.y())); bool containsEnd = rect.contains(qRound(end.x()), qRound(end.y())); if (containsStart && containsEnd) return {start.toPointF(), end.toPointF()}; QCPVector2D base = start; QCPVector2D vec = end-start; double bx, by; double gamma, mu; QLineF result; QList pointVectors; if (!qFuzzyIsNull(vec.y())) // line is not horizontal { // check top of rect: bx = rect.left(); by = rect.top(); mu = (by-base.y())/vec.y(); if (mu >= 0 && mu <= 1) { gamma = base.x()-bx + mu*vec.x(); if (gamma >= 0 && gamma <= rect.width()) pointVectors.append(QCPVector2D(bx+gamma, by)); } // check bottom of rect: bx = rect.left(); by = rect.bottom(); mu = (by-base.y())/vec.y(); if (mu >= 0 && mu <= 1) { gamma = base.x()-bx + mu*vec.x(); if (gamma >= 0 && gamma <= rect.width()) pointVectors.append(QCPVector2D(bx+gamma, by)); } } if (!qFuzzyIsNull(vec.x())) // line is not vertical { // check left of rect: bx = rect.left(); by = rect.top(); mu = (bx-base.x())/vec.x(); if (mu >= 0 && mu <= 1) { gamma = base.y()-by + mu*vec.y(); if (gamma >= 0 && gamma <= rect.height()) pointVectors.append(QCPVector2D(bx, by+gamma)); } // check right of rect: bx = rect.right(); by = rect.top(); mu = (bx-base.x())/vec.x(); if (mu >= 0 && mu <= 1) { gamma = base.y()-by + mu*vec.y(); if (gamma >= 0 && gamma <= rect.height()) pointVectors.append(QCPVector2D(bx, by+gamma)); } } if (containsStart) pointVectors.append(start); if (containsEnd) pointVectors.append(end); // evaluate points: if (pointVectors.size() == 2) { result.setPoints(pointVectors.at(0).toPointF(), pointVectors.at(1).toPointF()); } else if (pointVectors.size() > 2) { // line probably goes through corner of rect, and we got two points there. single out the point pair with greatest distance: double distSqrMax = 0; QCPVector2D pv1, pv2; for (int i=0; i distSqrMax) { pv1 = pointVectors.at(i); pv2 = pointVectors.at(k); distSqrMax = distSqr; } } } result.setPoints(pv1.toPointF(), pv2.toPointF()); } return result; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemLine::mainPen() const { return mSelected ? mSelectedPen : mPen; } /* end of 'src/items/item-line.cpp' */ /* including file 'src/items/item-curve.cpp' */ /* modified 2021-03-29T02:30:44, size 7273 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemCurve //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemCurve \brief A curved line from one point to another \image html QCPItemCurve.png "Curve example. Blue dotted circles are anchors, solid blue discs are positions." It has four positions, \a start and \a end, which define the end points of the line, and two control points which define the direction the line exits from the start and the direction from which it approaches the end: \a startDir and \a endDir. With \ref setHead and \ref setTail you may set different line ending styles, e.g. to create an arrow. Often it is desirable for the control points to stay at fixed relative positions to the start/end point. This can be achieved by setting the parent anchor e.g. of \a startDir simply to \a start, and then specify the desired pixel offset with QCPItemPosition::setCoords on \a startDir. */ /*! Creates a curve item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemCurve::QCPItemCurve(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), start(createPosition(QLatin1String("start"))), startDir(createPosition(QLatin1String("startDir"))), endDir(createPosition(QLatin1String("endDir"))), end(createPosition(QLatin1String("end"))) { start->setCoords(0, 0); startDir->setCoords(0.5, 0); endDir->setCoords(0, 0.5); end->setCoords(1, 1); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue,2)); } QCPItemCurve::~QCPItemCurve() { } /*! Sets the pen that will be used to draw the line \see setSelectedPen */ void QCPItemCurve::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the line when selected \see setPen, setSelected */ void QCPItemCurve::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the line ending style of the head. The head corresponds to the \a end position. Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g. \code setHead(QCPLineEnding::esSpikeArrow) \endcode \see setTail */ void QCPItemCurve::setHead(const QCPLineEnding &head) { mHead = head; } /*! Sets the line ending style of the tail. The tail corresponds to the \a start position. Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g. \code setTail(QCPLineEnding::esSpikeArrow) \endcode \see setHead */ void QCPItemCurve::setTail(const QCPLineEnding &tail) { mTail = tail; } /* inherits documentation from base class */ double QCPItemCurve::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; QPointF startVec(start->pixelPosition()); QPointF startDirVec(startDir->pixelPosition()); QPointF endDirVec(endDir->pixelPosition()); QPointF endVec(end->pixelPosition()); QPainterPath cubicPath(startVec); cubicPath.cubicTo(startDirVec, endDirVec, endVec); QList polygons = cubicPath.toSubpathPolygons(); if (polygons.isEmpty()) return -1; const QPolygonF polygon = polygons.first(); QCPVector2D p(pos); double minDistSqr = (std::numeric_limits::max)(); for (int i=1; ipixelPosition()); QCPVector2D startDirVec(startDir->pixelPosition()); QCPVector2D endDirVec(endDir->pixelPosition()); QCPVector2D endVec(end->pixelPosition()); if ((endVec-startVec).length() > 1e10) // too large curves cause crash return; QPainterPath cubicPath(startVec.toPointF()); cubicPath.cubicTo(startDirVec.toPointF(), endDirVec.toPointF(), endVec.toPointF()); // paint visible segment, if existent: const int clipEnlarge = qCeil(mainPen().widthF()); QRect clip = clipRect().adjusted(-clipEnlarge, -clipEnlarge, clipEnlarge, clipEnlarge); QRect cubicRect = cubicPath.controlPointRect().toRect(); if (cubicRect.isEmpty()) // may happen when start and end exactly on same x or y position cubicRect.adjust(0, 0, 1, 1); if (clip.intersects(cubicRect)) { painter->setPen(mainPen()); painter->drawPath(cubicPath); painter->setBrush(Qt::SolidPattern); if (mTail.style() != QCPLineEnding::esNone) mTail.draw(painter, startVec, M_PI-cubicPath.angleAtPercent(0)/180.0*M_PI); if (mHead.style() != QCPLineEnding::esNone) mHead.draw(painter, endVec, -cubicPath.angleAtPercent(1)/180.0*M_PI); } } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemCurve::mainPen() const { return mSelected ? mSelectedPen : mPen; } /* end of 'src/items/item-curve.cpp' */ /* including file 'src/items/item-rect.cpp' */ /* modified 2021-03-29T02:30:44, size 6472 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemRect //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemRect \brief A rectangle \image html QCPItemRect.png "Rectangle example. Blue dotted circles are anchors, solid blue discs are positions." It has two positions, \a topLeft and \a bottomRight, which define the rectangle. */ /*! Creates a rectangle item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemRect::QCPItemRect(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), topLeft(createPosition(QLatin1String("topLeft"))), bottomRight(createPosition(QLatin1String("bottomRight"))), top(createAnchor(QLatin1String("top"), aiTop)), topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), right(createAnchor(QLatin1String("right"), aiRight)), bottom(createAnchor(QLatin1String("bottom"), aiBottom)), bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), left(createAnchor(QLatin1String("left"), aiLeft)) { topLeft->setCoords(0, 1); bottomRight->setCoords(1, 0); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue,2)); setBrush(Qt::NoBrush); setSelectedBrush(Qt::NoBrush); } QCPItemRect::~QCPItemRect() { } /*! Sets the pen that will be used to draw the line of the rectangle \see setSelectedPen, setBrush */ void QCPItemRect::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the line of the rectangle when selected \see setPen, setSelected */ void QCPItemRect::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the brush that will be used to fill the rectangle. To disable filling, set \a brush to Qt::NoBrush. \see setSelectedBrush, setPen */ void QCPItemRect::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the brush that will be used to fill the rectangle when selected. To disable filling, set \a brush to Qt::NoBrush. \see setBrush */ void QCPItemRect::setSelectedBrush(const QBrush &brush) { mSelectedBrush = brush; } /* inherits documentation from base class */ double QCPItemRect::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; QRectF rect = QRectF(topLeft->pixelPosition(), bottomRight->pixelPosition()).normalized(); bool filledRect = mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0; return rectDistance(rect, pos, filledRect); } /* inherits documentation from base class */ void QCPItemRect::draw(QCPPainter *painter) { QPointF p1 = topLeft->pixelPosition(); QPointF p2 = bottomRight->pixelPosition(); if (p1.toPoint() == p2.toPoint()) return; QRectF rect = QRectF(p1, p2).normalized(); double clipPad = mainPen().widthF(); QRectF boundingRect = rect.adjusted(-clipPad, -clipPad, clipPad, clipPad); if (boundingRect.intersects(clipRect())) // only draw if bounding rect of rect item is visible in cliprect { painter->setPen(mainPen()); painter->setBrush(mainBrush()); painter->drawRect(rect); } } /* inherits documentation from base class */ QPointF QCPItemRect::anchorPixelPosition(int anchorId) const { QRectF rect = QRectF(topLeft->pixelPosition(), bottomRight->pixelPosition()); switch (anchorId) { case aiTop: return (rect.topLeft()+rect.topRight())*0.5; case aiTopRight: return rect.topRight(); case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; case aiBottomLeft: return rect.bottomLeft(); case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; } qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; return {}; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemRect::mainPen() const { return mSelected ? mSelectedPen : mPen; } /*! \internal Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is. */ QBrush QCPItemRect::mainBrush() const { return mSelected ? mSelectedBrush : mBrush; } /* end of 'src/items/item-rect.cpp' */ /* including file 'src/items/item-text.cpp' */ /* modified 2021-03-29T02:30:44, size 13335 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemText //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemText \brief A text label \image html QCPItemText.png "Text example. Blue dotted circles are anchors, solid blue discs are positions." Its position is defined by the member \a position and the setting of \ref setPositionAlignment. The latter controls which part of the text rect shall be aligned with \a position. The text alignment itself (i.e. left, center, right) can be controlled with \ref setTextAlignment. The text may be rotated around the \a position point with \ref setRotation. */ /*! Creates a text item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemText::QCPItemText(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), position(createPosition(QLatin1String("position"))), topLeft(createAnchor(QLatin1String("topLeft"), aiTopLeft)), top(createAnchor(QLatin1String("top"), aiTop)), topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), right(createAnchor(QLatin1String("right"), aiRight)), bottomRight(createAnchor(QLatin1String("bottomRight"), aiBottomRight)), bottom(createAnchor(QLatin1String("bottom"), aiBottom)), bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), left(createAnchor(QLatin1String("left"), aiLeft)), mText(QLatin1String("text")), mPositionAlignment(Qt::AlignCenter), mTextAlignment(Qt::AlignTop|Qt::AlignHCenter), mRotation(0) { position->setCoords(0, 0); setPen(Qt::NoPen); setSelectedPen(Qt::NoPen); setBrush(Qt::NoBrush); setSelectedBrush(Qt::NoBrush); setColor(Qt::black); setSelectedColor(Qt::blue); } QCPItemText::~QCPItemText() { } /*! Sets the color of the text. */ void QCPItemText::setColor(const QColor &color) { mColor = color; } /*! Sets the color of the text that will be used when the item is selected. */ void QCPItemText::setSelectedColor(const QColor &color) { mSelectedColor = color; } /*! Sets the pen that will be used do draw a rectangular border around the text. To disable the border, set \a pen to Qt::NoPen. \see setSelectedPen, setBrush, setPadding */ void QCPItemText::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used do draw a rectangular border around the text, when the item is selected. To disable the border, set \a pen to Qt::NoPen. \see setPen */ void QCPItemText::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the brush that will be used do fill the background of the text. To disable the background, set \a brush to Qt::NoBrush. \see setSelectedBrush, setPen, setPadding */ void QCPItemText::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the brush that will be used do fill the background of the text, when the item is selected. To disable the background, set \a brush to Qt::NoBrush. \see setBrush */ void QCPItemText::setSelectedBrush(const QBrush &brush) { mSelectedBrush = brush; } /*! Sets the font of the text. \see setSelectedFont, setColor */ void QCPItemText::setFont(const QFont &font) { mFont = font; } /*! Sets the font of the text that will be used when the item is selected. \see setFont */ void QCPItemText::setSelectedFont(const QFont &font) { mSelectedFont = font; } /*! Sets the text that will be displayed. Multi-line texts are supported by inserting a line break character, e.g. '\n'. \see setFont, setColor, setTextAlignment */ void QCPItemText::setText(const QString &text) { mText = text; } /*! Sets which point of the text rect shall be aligned with \a position. Examples: \li If \a alignment is Qt::AlignHCenter | Qt::AlignTop, the text will be positioned such that the top of the text rect will be horizontally centered on \a position. \li If \a alignment is Qt::AlignLeft | Qt::AlignBottom, \a position will indicate the bottom left corner of the text rect. If you want to control the alignment of (multi-lined) text within the text rect, use \ref setTextAlignment. */ void QCPItemText::setPositionAlignment(Qt::Alignment alignment) { mPositionAlignment = alignment; } /*! Controls how (multi-lined) text is aligned inside the text rect (typically Qt::AlignLeft, Qt::AlignCenter or Qt::AlignRight). */ void QCPItemText::setTextAlignment(Qt::Alignment alignment) { mTextAlignment = alignment; } /*! Sets the angle in degrees by which the text (and the text rectangle, if visible) will be rotated around \a position. */ void QCPItemText::setRotation(double degrees) { mRotation = degrees; } /*! Sets the distance between the border of the text rectangle and the text. The appearance (and visibility) of the text rectangle can be controlled with \ref setPen and \ref setBrush. */ void QCPItemText::setPadding(const QMargins &padding) { mPadding = padding; } /* inherits documentation from base class */ double QCPItemText::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; // The rect may be rotated, so we transform the actual clicked pos to the rotated // coordinate system, so we can use the normal rectDistance function for non-rotated rects: QPointF positionPixels(position->pixelPosition()); QTransform inputTransform; inputTransform.translate(positionPixels.x(), positionPixels.y()); inputTransform.rotate(-mRotation); inputTransform.translate(-positionPixels.x(), -positionPixels.y()); QPointF rotatedPos = inputTransform.map(pos); QFontMetrics fontMetrics(mFont); QRect textRect = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); QRect textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); QPointF textPos = getTextDrawPoint(positionPixels, textBoxRect, mPositionAlignment); textBoxRect.moveTopLeft(textPos.toPoint()); return rectDistance(textBoxRect, rotatedPos, true); } /* inherits documentation from base class */ void QCPItemText::draw(QCPPainter *painter) { QPointF pos(position->pixelPosition()); QTransform transform = painter->transform(); transform.translate(pos.x(), pos.y()); if (!qFuzzyIsNull(mRotation)) transform.rotate(mRotation); painter->setFont(mainFont()); QRect textRect = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); QRect textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); QPointF textPos = getTextDrawPoint(QPointF(0, 0), textBoxRect, mPositionAlignment); // 0, 0 because the transform does the translation textRect.moveTopLeft(textPos.toPoint()+QPoint(mPadding.left(), mPadding.top())); textBoxRect.moveTopLeft(textPos.toPoint()); int clipPad = qCeil(mainPen().widthF()); QRect boundingRect = textBoxRect.adjusted(-clipPad, -clipPad, clipPad, clipPad); if (transform.mapRect(boundingRect).intersects(painter->transform().mapRect(clipRect()))) { painter->setTransform(transform); if ((mainBrush().style() != Qt::NoBrush && mainBrush().color().alpha() != 0) || (mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0)) { painter->setPen(mainPen()); painter->setBrush(mainBrush()); painter->drawRect(textBoxRect); } painter->setBrush(Qt::NoBrush); painter->setPen(QPen(mainColor())); painter->drawText(textRect, Qt::TextDontClip|mTextAlignment, mText); } } /* inherits documentation from base class */ QPointF QCPItemText::anchorPixelPosition(int anchorId) const { // get actual rect points (pretty much copied from draw function): QPointF pos(position->pixelPosition()); QTransform transform; transform.translate(pos.x(), pos.y()); if (!qFuzzyIsNull(mRotation)) transform.rotate(mRotation); QFontMetrics fontMetrics(mainFont()); QRect textRect = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); QRectF textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); QPointF textPos = getTextDrawPoint(QPointF(0, 0), textBoxRect, mPositionAlignment); // 0, 0 because the transform does the translation textBoxRect.moveTopLeft(textPos.toPoint()); QPolygonF rectPoly = transform.map(QPolygonF(textBoxRect)); switch (anchorId) { case aiTopLeft: return rectPoly.at(0); case aiTop: return (rectPoly.at(0)+rectPoly.at(1))*0.5; case aiTopRight: return rectPoly.at(1); case aiRight: return (rectPoly.at(1)+rectPoly.at(2))*0.5; case aiBottomRight: return rectPoly.at(2); case aiBottom: return (rectPoly.at(2)+rectPoly.at(3))*0.5; case aiBottomLeft: return rectPoly.at(3); case aiLeft: return (rectPoly.at(3)+rectPoly.at(0))*0.5; } qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; return {}; } /*! \internal Returns the point that must be given to the QPainter::drawText function (which expects the top left point of the text rect), according to the position \a pos, the text bounding box \a rect and the requested \a positionAlignment. For example, if \a positionAlignment is Qt::AlignLeft | Qt::AlignBottom the returned point will be shifted upward by the height of \a rect, starting from \a pos. So if the text is finally drawn at that point, the lower left corner of the resulting text rect is at \a pos. */ QPointF QCPItemText::getTextDrawPoint(const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const { if (positionAlignment == 0 || positionAlignment == (Qt::AlignLeft|Qt::AlignTop)) return pos; QPointF result = pos; // start at top left if (positionAlignment.testFlag(Qt::AlignHCenter)) result.rx() -= rect.width()/2.0; else if (positionAlignment.testFlag(Qt::AlignRight)) result.rx() -= rect.width(); if (positionAlignment.testFlag(Qt::AlignVCenter)) result.ry() -= rect.height()/2.0; else if (positionAlignment.testFlag(Qt::AlignBottom)) result.ry() -= rect.height(); return result; } /*! \internal Returns the font that should be used for drawing text. Returns mFont when the item is not selected and mSelectedFont when it is. */ QFont QCPItemText::mainFont() const { return mSelected ? mSelectedFont : mFont; } /*! \internal Returns the color that should be used for drawing text. Returns mColor when the item is not selected and mSelectedColor when it is. */ QColor QCPItemText::mainColor() const { return mSelected ? mSelectedColor : mColor; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemText::mainPen() const { return mSelected ? mSelectedPen : mPen; } /*! \internal Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is. */ QBrush QCPItemText::mainBrush() const { return mSelected ? mSelectedBrush : mBrush; } /* end of 'src/items/item-text.cpp' */ /* including file 'src/items/item-ellipse.cpp' */ /* modified 2021-03-29T02:30:44, size 7881 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemEllipse //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemEllipse \brief An ellipse \image html QCPItemEllipse.png "Ellipse example. Blue dotted circles are anchors, solid blue discs are positions." It has two positions, \a topLeft and \a bottomRight, which define the rect the ellipse will be drawn in. */ /*! Creates an ellipse item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemEllipse::QCPItemEllipse(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), topLeft(createPosition(QLatin1String("topLeft"))), bottomRight(createPosition(QLatin1String("bottomRight"))), topLeftRim(createAnchor(QLatin1String("topLeftRim"), aiTopLeftRim)), top(createAnchor(QLatin1String("top"), aiTop)), topRightRim(createAnchor(QLatin1String("topRightRim"), aiTopRightRim)), right(createAnchor(QLatin1String("right"), aiRight)), bottomRightRim(createAnchor(QLatin1String("bottomRightRim"), aiBottomRightRim)), bottom(createAnchor(QLatin1String("bottom"), aiBottom)), bottomLeftRim(createAnchor(QLatin1String("bottomLeftRim"), aiBottomLeftRim)), left(createAnchor(QLatin1String("left"), aiLeft)), center(createAnchor(QLatin1String("center"), aiCenter)) { topLeft->setCoords(0, 1); bottomRight->setCoords(1, 0); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue, 2)); setBrush(Qt::NoBrush); setSelectedBrush(Qt::NoBrush); } QCPItemEllipse::~QCPItemEllipse() { } /*! Sets the pen that will be used to draw the line of the ellipse \see setSelectedPen, setBrush */ void QCPItemEllipse::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the line of the ellipse when selected \see setPen, setSelected */ void QCPItemEllipse::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the brush that will be used to fill the ellipse. To disable filling, set \a brush to Qt::NoBrush. \see setSelectedBrush, setPen */ void QCPItemEllipse::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the brush that will be used to fill the ellipse when selected. To disable filling, set \a brush to Qt::NoBrush. \see setBrush */ void QCPItemEllipse::setSelectedBrush(const QBrush &brush) { mSelectedBrush = brush; } /* inherits documentation from base class */ double QCPItemEllipse::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; QPointF p1 = topLeft->pixelPosition(); QPointF p2 = bottomRight->pixelPosition(); QPointF center((p1+p2)/2.0); double a = qAbs(p1.x()-p2.x())/2.0; double b = qAbs(p1.y()-p2.y())/2.0; double x = pos.x()-center.x(); double y = pos.y()-center.y(); // distance to border: double c = 1.0/qSqrt(x*x/(a*a)+y*y/(b*b)); double result = qAbs(c-1)*qSqrt(x*x+y*y); // filled ellipse, allow click inside to count as hit: if (result > mParentPlot->selectionTolerance()*0.99 && mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0) { if (x*x/(a*a) + y*y/(b*b) <= 1) result = mParentPlot->selectionTolerance()*0.99; } return result; } /* inherits documentation from base class */ void QCPItemEllipse::draw(QCPPainter *painter) { QPointF p1 = topLeft->pixelPosition(); QPointF p2 = bottomRight->pixelPosition(); if (p1.toPoint() == p2.toPoint()) return; QRectF ellipseRect = QRectF(p1, p2).normalized(); const int clipEnlarge = qCeil(mainPen().widthF()); QRect clip = clipRect().adjusted(-clipEnlarge, -clipEnlarge, clipEnlarge, clipEnlarge); if (ellipseRect.intersects(clip)) // only draw if bounding rect of ellipse is visible in cliprect { painter->setPen(mainPen()); painter->setBrush(mainBrush()); #ifdef __EXCEPTIONS try // drawEllipse sometimes throws exceptions if ellipse is too big { #endif painter->drawEllipse(ellipseRect); #ifdef __EXCEPTIONS } catch (...) { qDebug() << Q_FUNC_INFO << "Item too large for memory, setting invisible"; setVisible(false); } #endif } } /* inherits documentation from base class */ QPointF QCPItemEllipse::anchorPixelPosition(int anchorId) const { QRectF rect = QRectF(topLeft->pixelPosition(), bottomRight->pixelPosition()); switch (anchorId) { case aiTopLeftRim: return rect.center()+(rect.topLeft()-rect.center())*1/qSqrt(2); case aiTop: return (rect.topLeft()+rect.topRight())*0.5; case aiTopRightRim: return rect.center()+(rect.topRight()-rect.center())*1/qSqrt(2); case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; case aiBottomRightRim: return rect.center()+(rect.bottomRight()-rect.center())*1/qSqrt(2); case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; case aiBottomLeftRim: return rect.center()+(rect.bottomLeft()-rect.center())*1/qSqrt(2); case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; case aiCenter: return (rect.topLeft()+rect.bottomRight())*0.5; } qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; return {}; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemEllipse::mainPen() const { return mSelected ? mSelectedPen : mPen; } /*! \internal Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is. */ QBrush QCPItemEllipse::mainBrush() const { return mSelected ? mSelectedBrush : mBrush; } /* end of 'src/items/item-ellipse.cpp' */ /* including file 'src/items/item-pixmap.cpp' */ /* modified 2021-03-29T02:30:44, size 10622 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemPixmap //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemPixmap \brief An arbitrary pixmap \image html QCPItemPixmap.png "Pixmap example. Blue dotted circles are anchors, solid blue discs are positions." It has two positions, \a topLeft and \a bottomRight, which define the rectangle the pixmap will be drawn in. Depending on the scale setting (\ref setScaled), the pixmap will be either scaled to fit the rectangle or be drawn aligned to the topLeft position. If scaling is enabled and \a topLeft is further to the bottom/right than \a bottomRight (as shown on the right side of the example image), the pixmap will be flipped in the respective orientations. */ /*! Creates a rectangle item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemPixmap::QCPItemPixmap(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), topLeft(createPosition(QLatin1String("topLeft"))), bottomRight(createPosition(QLatin1String("bottomRight"))), top(createAnchor(QLatin1String("top"), aiTop)), topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), right(createAnchor(QLatin1String("right"), aiRight)), bottom(createAnchor(QLatin1String("bottom"), aiBottom)), bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), left(createAnchor(QLatin1String("left"), aiLeft)), mScaled(false), mScaledPixmapInvalidated(true), mAspectRatioMode(Qt::KeepAspectRatio), mTransformationMode(Qt::SmoothTransformation) { topLeft->setCoords(0, 1); bottomRight->setCoords(1, 0); setPen(Qt::NoPen); setSelectedPen(QPen(Qt::blue)); } QCPItemPixmap::~QCPItemPixmap() { } /*! Sets the pixmap that will be displayed. */ void QCPItemPixmap::setPixmap(const QPixmap &pixmap) { mPixmap = pixmap; mScaledPixmapInvalidated = true; if (mPixmap.isNull()) qDebug() << Q_FUNC_INFO << "pixmap is null"; } /*! Sets whether the pixmap will be scaled to fit the rectangle defined by the \a topLeft and \a bottomRight positions. */ void QCPItemPixmap::setScaled(bool scaled, Qt::AspectRatioMode aspectRatioMode, Qt::TransformationMode transformationMode) { mScaled = scaled; mAspectRatioMode = aspectRatioMode; mTransformationMode = transformationMode; mScaledPixmapInvalidated = true; } /*! Sets the pen that will be used to draw a border around the pixmap. \see setSelectedPen, setBrush */ void QCPItemPixmap::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw a border around the pixmap when selected \see setPen, setSelected */ void QCPItemPixmap::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /* inherits documentation from base class */ double QCPItemPixmap::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; return rectDistance(getFinalRect(), pos, true); } /* inherits documentation from base class */ void QCPItemPixmap::draw(QCPPainter *painter) { bool flipHorz = false; bool flipVert = false; QRect rect = getFinalRect(&flipHorz, &flipVert); int clipPad = mainPen().style() == Qt::NoPen ? 0 : qCeil(mainPen().widthF()); QRect boundingRect = rect.adjusted(-clipPad, -clipPad, clipPad, clipPad); if (boundingRect.intersects(clipRect())) { updateScaledPixmap(rect, flipHorz, flipVert); painter->drawPixmap(rect.topLeft(), mScaled ? mScaledPixmap : mPixmap); QPen pen = mainPen(); if (pen.style() != Qt::NoPen) { painter->setPen(pen); painter->setBrush(Qt::NoBrush); painter->drawRect(rect); } } } /* inherits documentation from base class */ QPointF QCPItemPixmap::anchorPixelPosition(int anchorId) const { bool flipHorz = false; bool flipVert = false; QRect rect = getFinalRect(&flipHorz, &flipVert); // we actually want denormal rects (negative width/height) here, so restore // the flipped state: if (flipHorz) rect.adjust(rect.width(), 0, -rect.width(), 0); if (flipVert) rect.adjust(0, rect.height(), 0, -rect.height()); switch (anchorId) { case aiTop: return (rect.topLeft()+rect.topRight())*0.5; case aiTopRight: return rect.topRight(); case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; case aiBottomLeft: return rect.bottomLeft(); case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; } qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; return {}; } /*! \internal Creates the buffered scaled image (\a mScaledPixmap) to fit the specified \a finalRect. The parameters \a flipHorz and \a flipVert control whether the resulting image shall be flipped horizontally or vertically. (This is used when \a topLeft is further to the bottom/right than \a bottomRight.) This function only creates the scaled pixmap when the buffered pixmap has a different size than the expected result, so calling this function repeatedly, e.g. in the \ref draw function, does not cause expensive rescaling every time. If scaling is disabled, sets mScaledPixmap to a null QPixmap. */ void QCPItemPixmap::updateScaledPixmap(QRect finalRect, bool flipHorz, bool flipVert) { if (mPixmap.isNull()) return; if (mScaled) { #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED double devicePixelRatio = mPixmap.devicePixelRatio(); #else double devicePixelRatio = 1.0; #endif if (finalRect.isNull()) finalRect = getFinalRect(&flipHorz, &flipVert); if (mScaledPixmapInvalidated || finalRect.size() != mScaledPixmap.size()/devicePixelRatio) { mScaledPixmap = mPixmap.scaled(finalRect.size()*devicePixelRatio, mAspectRatioMode, mTransformationMode); if (flipHorz || flipVert) mScaledPixmap = QPixmap::fromImage(mScaledPixmap.toImage().mirrored(flipHorz, flipVert)); #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED mScaledPixmap.setDevicePixelRatio(devicePixelRatio); #endif } } else if (!mScaledPixmap.isNull()) mScaledPixmap = QPixmap(); mScaledPixmapInvalidated = false; } /*! \internal Returns the final (tight) rect the pixmap is drawn in, depending on the current item positions and scaling settings. The output parameters \a flippedHorz and \a flippedVert return whether the pixmap should be drawn flipped horizontally or vertically in the returned rect. (The returned rect itself is always normalized, i.e. the top left corner of the rect is actually further to the top/left than the bottom right corner). This is the case when the item position \a topLeft is further to the bottom/right than \a bottomRight. If scaling is disabled, returns a rect with size of the original pixmap and the top left corner aligned with the item position \a topLeft. The position \a bottomRight is ignored. */ QRect QCPItemPixmap::getFinalRect(bool *flippedHorz, bool *flippedVert) const { QRect result; bool flipHorz = false; bool flipVert = false; QPoint p1 = topLeft->pixelPosition().toPoint(); QPoint p2 = bottomRight->pixelPosition().toPoint(); if (p1 == p2) return {p1, QSize(0, 0)}; if (mScaled) { QSize newSize = QSize(p2.x()-p1.x(), p2.y()-p1.y()); QPoint topLeft = p1; if (newSize.width() < 0) { flipHorz = true; newSize.rwidth() *= -1; topLeft.setX(p2.x()); } if (newSize.height() < 0) { flipVert = true; newSize.rheight() *= -1; topLeft.setY(p2.y()); } QSize scaledSize = mPixmap.size(); #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED scaledSize /= mPixmap.devicePixelRatio(); scaledSize.scale(newSize*mPixmap.devicePixelRatio(), mAspectRatioMode); #else scaledSize.scale(newSize, mAspectRatioMode); #endif result = QRect(topLeft, scaledSize); } else { #ifdef QCP_DEVICEPIXELRATIO_SUPPORTED result = QRect(p1, mPixmap.size()/mPixmap.devicePixelRatio()); #else result = QRect(p1, mPixmap.size()); #endif } if (flippedHorz) *flippedHorz = flipHorz; if (flippedVert) *flippedVert = flipVert; return result; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemPixmap::mainPen() const { return mSelected ? mSelectedPen : mPen; } /* end of 'src/items/item-pixmap.cpp' */ /* including file 'src/items/item-tracer.cpp' */ /* modified 2021-03-29T02:30:44, size 14645 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemTracer //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemTracer \brief Item that sticks to QCPGraph data points \image html QCPItemTracer.png "Tracer example. Blue dotted circles are anchors, solid blue discs are positions." The tracer can be connected with a QCPGraph via \ref setGraph. Then it will automatically adopt the coordinate axes of the graph and update its \a position to be on the graph's data. This means the key stays controllable via \ref setGraphKey, but the value will follow the graph data. If a QCPGraph is connected, note that setting the coordinates of the tracer item directly via \a position will have no effect because they will be overriden in the next redraw (this is when the coordinate update happens). If the specified key in \ref setGraphKey is outside the key bounds of the graph, the tracer will stay at the corresponding end of the graph. With \ref setInterpolating you may specify whether the tracer may only stay exactly on data points or whether it interpolates data points linearly, if given a key that lies between two data points of the graph. The tracer has different visual styles, see \ref setStyle. It is also possible to make the tracer have no own visual appearance (set the style to \ref tsNone), and just connect other item positions to the tracer \a position (used as an anchor) via \ref QCPItemPosition::setParentAnchor. \note The tracer position is only automatically updated upon redraws. So when the data of the graph changes and immediately afterwards (without a redraw) the position coordinates of the tracer are retrieved, they will not reflect the updated data of the graph. In this case \ref updatePosition must be called manually, prior to reading the tracer coordinates. */ /*! Creates a tracer item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemTracer::QCPItemTracer(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), position(createPosition(QLatin1String("position"))), mSize(6), mStyle(tsCrosshair), mGraph(nullptr), mGraphKey(0), mInterpolating(false) { position->setCoords(0, 0); setBrush(Qt::NoBrush); setSelectedBrush(Qt::NoBrush); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue, 2)); } QCPItemTracer::~QCPItemTracer() { } /*! Sets the pen that will be used to draw the line of the tracer \see setSelectedPen, setBrush */ void QCPItemTracer::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the line of the tracer when selected \see setPen, setSelected */ void QCPItemTracer::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the brush that will be used to draw any fills of the tracer \see setSelectedBrush, setPen */ void QCPItemTracer::setBrush(const QBrush &brush) { mBrush = brush; } /*! Sets the brush that will be used to draw any fills of the tracer, when selected. \see setBrush, setSelected */ void QCPItemTracer::setSelectedBrush(const QBrush &brush) { mSelectedBrush = brush; } /*! Sets the size of the tracer in pixels, if the style supports setting a size (e.g. \ref tsSquare does, \ref tsCrosshair does not). */ void QCPItemTracer::setSize(double size) { mSize = size; } /*! Sets the style/visual appearance of the tracer. If you only want to use the tracer \a position as an anchor for other items, set \a style to \ref tsNone. */ void QCPItemTracer::setStyle(QCPItemTracer::TracerStyle style) { mStyle = style; } /*! Sets the QCPGraph this tracer sticks to. The tracer \a position will be set to type QCPItemPosition::ptPlotCoords and the axes will be set to the axes of \a graph. To free the tracer from any graph, set \a graph to \c nullptr. The tracer \a position can then be placed freely like any other item position. This is the state the tracer will assume when its graph gets deleted while still attached to it. \see setGraphKey */ void QCPItemTracer::setGraph(QCPGraph *graph) { if (graph) { if (graph->parentPlot() == mParentPlot) { position->setType(QCPItemPosition::ptPlotCoords); position->setAxes(graph->keyAxis(), graph->valueAxis()); mGraph = graph; updatePosition(); } else qDebug() << Q_FUNC_INFO << "graph isn't in same QCustomPlot instance as this item"; } else { mGraph = nullptr; } } /*! Sets the key of the graph's data point the tracer will be positioned at. This is the only free coordinate of a tracer when attached to a graph. Depending on \ref setInterpolating, the tracer will be either positioned on the data point closest to \a key, or will stay exactly at \a key and interpolate the value linearly. \see setGraph, setInterpolating */ void QCPItemTracer::setGraphKey(double key) { mGraphKey = key; } /*! Sets whether the value of the graph's data points shall be interpolated, when positioning the tracer. If \a enabled is set to false and a key is given with \ref setGraphKey, the tracer is placed on the data point of the graph which is closest to the key, but which is not necessarily exactly there. If \a enabled is true, the tracer will be positioned exactly at the specified key, and the appropriate value will be interpolated from the graph's data points linearly. \see setGraph, setGraphKey */ void QCPItemTracer::setInterpolating(bool enabled) { mInterpolating = enabled; } /* inherits documentation from base class */ double QCPItemTracer::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; QPointF center(position->pixelPosition()); double w = mSize/2.0; QRect clip = clipRect(); switch (mStyle) { case tsNone: return -1; case tsPlus: { if (clipRect().intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) return qSqrt(qMin(QCPVector2D(pos).distanceSquaredToLine(center+QPointF(-w, 0), center+QPointF(w, 0)), QCPVector2D(pos).distanceSquaredToLine(center+QPointF(0, -w), center+QPointF(0, w)))); break; } case tsCrosshair: { return qSqrt(qMin(QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(clip.left(), center.y()), QCPVector2D(clip.right(), center.y())), QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(center.x(), clip.top()), QCPVector2D(center.x(), clip.bottom())))); } case tsCircle: { if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) { // distance to border: double centerDist = QCPVector2D(center-pos).length(); double circleLine = w; double result = qAbs(centerDist-circleLine); // filled ellipse, allow click inside to count as hit: if (result > mParentPlot->selectionTolerance()*0.99 && mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0) { if (centerDist <= circleLine) result = mParentPlot->selectionTolerance()*0.99; } return result; } break; } case tsSquare: { if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) { QRectF rect = QRectF(center-QPointF(w, w), center+QPointF(w, w)); bool filledRect = mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0; return rectDistance(rect, pos, filledRect); } break; } } return -1; } /* inherits documentation from base class */ void QCPItemTracer::draw(QCPPainter *painter) { updatePosition(); if (mStyle == tsNone) return; painter->setPen(mainPen()); painter->setBrush(mainBrush()); QPointF center(position->pixelPosition()); double w = mSize/2.0; QRect clip = clipRect(); switch (mStyle) { case tsNone: return; case tsPlus: { if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) { painter->drawLine(QLineF(center+QPointF(-w, 0), center+QPointF(w, 0))); painter->drawLine(QLineF(center+QPointF(0, -w), center+QPointF(0, w))); } break; } case tsCrosshair: { if (center.y() > clip.top() && center.y() < clip.bottom()) painter->drawLine(QLineF(clip.left(), center.y(), clip.right(), center.y())); if (center.x() > clip.left() && center.x() < clip.right()) painter->drawLine(QLineF(center.x(), clip.top(), center.x(), clip.bottom())); break; } case tsCircle: { if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) painter->drawEllipse(center, w, w); break; } case tsSquare: { if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) painter->drawRect(QRectF(center-QPointF(w, w), center+QPointF(w, w))); break; } } } /*! If the tracer is connected with a graph (\ref setGraph), this function updates the tracer's \a position to reside on the graph data, depending on the configured key (\ref setGraphKey). It is called automatically on every redraw and normally doesn't need to be called manually. One exception is when you want to read the tracer coordinates via \a position and are not sure that the graph's data (or the tracer key with \ref setGraphKey) hasn't changed since the last redraw. In that situation, call this function before accessing \a position, to make sure you don't get out-of-date coordinates. If there is no graph set on this tracer, this function does nothing. */ void QCPItemTracer::updatePosition() { if (mGraph) { if (mParentPlot->hasPlottable(mGraph)) { if (mGraph->data()->size() > 1) { QCPGraphDataContainer::const_iterator first = mGraph->data()->constBegin(); QCPGraphDataContainer::const_iterator last = mGraph->data()->constEnd()-1; if (mGraphKey <= first->key) position->setCoords(first->key, first->value); else if (mGraphKey >= last->key) position->setCoords(last->key, last->value); else { QCPGraphDataContainer::const_iterator it = mGraph->data()->findBegin(mGraphKey); if (it != mGraph->data()->constEnd()) // mGraphKey is not exactly on last iterator, but somewhere between iterators { QCPGraphDataContainer::const_iterator prevIt = it; ++it; // won't advance to constEnd because we handled that case (mGraphKey >= last->key) before if (mInterpolating) { // interpolate between iterators around mGraphKey: double slope = 0; if (!qFuzzyCompare(double(it->key), double(prevIt->key))) slope = (it->value-prevIt->value)/(it->key-prevIt->key); position->setCoords(mGraphKey, (mGraphKey-prevIt->key)*slope+prevIt->value); } else { // find iterator with key closest to mGraphKey: if (mGraphKey < (prevIt->key+it->key)*0.5) position->setCoords(prevIt->key, prevIt->value); else position->setCoords(it->key, it->value); } } else // mGraphKey is exactly on last iterator (should actually be caught when comparing first/last keys, but this is a failsafe for fp uncertainty) position->setCoords(it->key, it->value); } } else if (mGraph->data()->size() == 1) { QCPGraphDataContainer::const_iterator it = mGraph->data()->constBegin(); position->setCoords(it->key, it->value); } else qDebug() << Q_FUNC_INFO << "graph has no data"; } else qDebug() << Q_FUNC_INFO << "graph not contained in QCustomPlot instance (anymore)"; } } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemTracer::mainPen() const { return mSelected ? mSelectedPen : mPen; } /*! \internal Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is. */ QBrush QCPItemTracer::mainBrush() const { return mSelected ? mSelectedBrush : mBrush; } /* end of 'src/items/item-tracer.cpp' */ /* including file 'src/items/item-bracket.cpp' */ /* modified 2021-03-29T02:30:44, size 10705 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPItemBracket //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPItemBracket \brief A bracket for referencing/highlighting certain parts in the plot. \image html QCPItemBracket.png "Bracket example. Blue dotted circles are anchors, solid blue discs are positions." It has two positions, \a left and \a right, which define the span of the bracket. If \a left is actually farther to the left than \a right, the bracket is opened to the bottom, as shown in the example image. The bracket supports multiple styles via \ref setStyle. The length, i.e. how far the bracket stretches away from the embraced span, can be controlled with \ref setLength. \image html QCPItemBracket-length.png
Demonstrating the effect of different values for \ref setLength, for styles \ref bsCalligraphic and \ref bsSquare. Anchors and positions are displayed for reference.
It provides an anchor \a center, to allow connection of other items, e.g. an arrow (QCPItemLine or QCPItemCurve) or a text label (QCPItemText), to the bracket. */ /*! Creates a bracket item and sets default values. The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. */ QCPItemBracket::QCPItemBracket(QCustomPlot *parentPlot) : QCPAbstractItem(parentPlot), left(createPosition(QLatin1String("left"))), right(createPosition(QLatin1String("right"))), center(createAnchor(QLatin1String("center"), aiCenter)), mLength(8), mStyle(bsCalligraphic) { left->setCoords(0, 0); right->setCoords(1, 1); setPen(QPen(Qt::black)); setSelectedPen(QPen(Qt::blue, 2)); } QCPItemBracket::~QCPItemBracket() { } /*! Sets the pen that will be used to draw the bracket. Note that when the style is \ref bsCalligraphic, only the color will be taken from the pen, the stroke and width are ignored. To change the apparent stroke width of a calligraphic bracket, use \ref setLength, which has a similar effect. \see setSelectedPen */ void QCPItemBracket::setPen(const QPen &pen) { mPen = pen; } /*! Sets the pen that will be used to draw the bracket when selected \see setPen, setSelected */ void QCPItemBracket::setSelectedPen(const QPen &pen) { mSelectedPen = pen; } /*! Sets the \a length in pixels how far the bracket extends in the direction towards the embraced span of the bracket (i.e. perpendicular to the left-right-direction) \image html QCPItemBracket-length.png
Demonstrating the effect of different values for \ref setLength, for styles \ref bsCalligraphic and \ref bsSquare. Anchors and positions are displayed for reference.
*/ void QCPItemBracket::setLength(double length) { mLength = length; } /*! Sets the style of the bracket, i.e. the shape/visual appearance. \see setPen */ void QCPItemBracket::setStyle(QCPItemBracket::BracketStyle style) { mStyle = style; } /* inherits documentation from base class */ double QCPItemBracket::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { Q_UNUSED(details) if (onlySelectable && !mSelectable) return -1; QCPVector2D p(pos); QCPVector2D leftVec(left->pixelPosition()); QCPVector2D rightVec(right->pixelPosition()); if (leftVec.toPoint() == rightVec.toPoint()) return -1; QCPVector2D widthVec = (rightVec-leftVec)*0.5; QCPVector2D lengthVec = widthVec.perpendicular().normalized()*mLength; QCPVector2D centerVec = (rightVec+leftVec)*0.5-lengthVec; switch (mStyle) { case QCPItemBracket::bsSquare: case QCPItemBracket::bsRound: { double a = p.distanceSquaredToLine(centerVec-widthVec, centerVec+widthVec); double b = p.distanceSquaredToLine(centerVec-widthVec+lengthVec, centerVec-widthVec); double c = p.distanceSquaredToLine(centerVec+widthVec+lengthVec, centerVec+widthVec); return qSqrt(qMin(qMin(a, b), c)); } case QCPItemBracket::bsCurly: case QCPItemBracket::bsCalligraphic: { double a = p.distanceSquaredToLine(centerVec-widthVec*0.75+lengthVec*0.15, centerVec+lengthVec*0.3); double b = p.distanceSquaredToLine(centerVec-widthVec+lengthVec*0.7, centerVec-widthVec*0.75+lengthVec*0.15); double c = p.distanceSquaredToLine(centerVec+widthVec*0.75+lengthVec*0.15, centerVec+lengthVec*0.3); double d = p.distanceSquaredToLine(centerVec+widthVec+lengthVec*0.7, centerVec+widthVec*0.75+lengthVec*0.15); return qSqrt(qMin(qMin(a, b), qMin(c, d))); } } return -1; } /* inherits documentation from base class */ void QCPItemBracket::draw(QCPPainter *painter) { QCPVector2D leftVec(left->pixelPosition()); QCPVector2D rightVec(right->pixelPosition()); if (leftVec.toPoint() == rightVec.toPoint()) return; QCPVector2D widthVec = (rightVec-leftVec)*0.5; QCPVector2D lengthVec = widthVec.perpendicular().normalized()*mLength; QCPVector2D centerVec = (rightVec+leftVec)*0.5-lengthVec; QPolygon boundingPoly; boundingPoly << leftVec.toPoint() << rightVec.toPoint() << (rightVec-lengthVec).toPoint() << (leftVec-lengthVec).toPoint(); const int clipEnlarge = qCeil(mainPen().widthF()); QRect clip = clipRect().adjusted(-clipEnlarge, -clipEnlarge, clipEnlarge, clipEnlarge); if (clip.intersects(boundingPoly.boundingRect())) { painter->setPen(mainPen()); switch (mStyle) { case bsSquare: { painter->drawLine((centerVec+widthVec).toPointF(), (centerVec-widthVec).toPointF()); painter->drawLine((centerVec+widthVec).toPointF(), (centerVec+widthVec+lengthVec).toPointF()); painter->drawLine((centerVec-widthVec).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); break; } case bsRound: { painter->setBrush(Qt::NoBrush); QPainterPath path; path.moveTo((centerVec+widthVec+lengthVec).toPointF()); path.cubicTo((centerVec+widthVec).toPointF(), (centerVec+widthVec).toPointF(), centerVec.toPointF()); path.cubicTo((centerVec-widthVec).toPointF(), (centerVec-widthVec).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); painter->drawPath(path); break; } case bsCurly: { painter->setBrush(Qt::NoBrush); QPainterPath path; path.moveTo((centerVec+widthVec+lengthVec).toPointF()); path.cubicTo((centerVec+widthVec-lengthVec*0.8).toPointF(), (centerVec+0.4*widthVec+lengthVec).toPointF(), centerVec.toPointF()); path.cubicTo((centerVec-0.4*widthVec+lengthVec).toPointF(), (centerVec-widthVec-lengthVec*0.8).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); painter->drawPath(path); break; } case bsCalligraphic: { painter->setPen(Qt::NoPen); painter->setBrush(QBrush(mainPen().color())); QPainterPath path; path.moveTo((centerVec+widthVec+lengthVec).toPointF()); path.cubicTo((centerVec+widthVec-lengthVec*0.8).toPointF(), (centerVec+0.4*widthVec+0.8*lengthVec).toPointF(), centerVec.toPointF()); path.cubicTo((centerVec-0.4*widthVec+0.8*lengthVec).toPointF(), (centerVec-widthVec-lengthVec*0.8).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); path.cubicTo((centerVec-widthVec-lengthVec*0.5).toPointF(), (centerVec-0.2*widthVec+1.2*lengthVec).toPointF(), (centerVec+lengthVec*0.2).toPointF()); path.cubicTo((centerVec+0.2*widthVec+1.2*lengthVec).toPointF(), (centerVec+widthVec-lengthVec*0.5).toPointF(), (centerVec+widthVec+lengthVec).toPointF()); painter->drawPath(path); break; } } } } /* inherits documentation from base class */ QPointF QCPItemBracket::anchorPixelPosition(int anchorId) const { QCPVector2D leftVec(left->pixelPosition()); QCPVector2D rightVec(right->pixelPosition()); if (leftVec.toPoint() == rightVec.toPoint()) return leftVec.toPointF(); QCPVector2D widthVec = (rightVec-leftVec)*0.5; QCPVector2D lengthVec = widthVec.perpendicular().normalized()*mLength; QCPVector2D centerVec = (rightVec+leftVec)*0.5-lengthVec; switch (anchorId) { case aiCenter: return centerVec.toPointF(); } qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; return {}; } /*! \internal Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is. */ QPen QCPItemBracket::mainPen() const { return mSelected ? mSelectedPen : mPen; } /* end of 'src/items/item-bracket.cpp' */ /* including file 'src/polar/radialaxis.cpp' */ /* modified 2021-03-29T02:30:44, size 49415 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPolarAxisRadial //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPolarAxisRadial \brief The radial axis inside a radial plot \warning In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future. Each axis holds an instance of QCPAxisTicker which is used to generate the tick coordinates and tick labels. You can access the currently installed \ref ticker or set a new one (possibly one of the specialized subclasses, or your own subclass) via \ref setTicker. For details, see the documentation of QCPAxisTicker. */ /* start of documentation of inline functions */ /*! \fn QSharedPointer QCPPolarAxisRadial::ticker() const Returns a modifiable shared pointer to the currently installed axis ticker. The axis ticker is responsible for generating the tick positions and tick labels of this axis. You can access the \ref QCPAxisTicker with this method and modify basic properties such as the approximate tick count (\ref QCPAxisTicker::setTickCount). You can gain more control over the axis ticks by setting a different \ref QCPAxisTicker subclass, see the documentation there. A new axis ticker can be set with \ref setTicker. Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes. \see setTicker */ /* end of documentation of inline functions */ /* start of documentation of signals */ /*! \fn void QCPPolarAxisRadial::rangeChanged(const QCPRange &newRange) This signal is emitted when the range of this axis has changed. You can connect it to the \ref setRange slot of another axis to communicate the new range to the other axis, in order for it to be synchronized. You may also manipulate/correct the range with \ref setRange in a slot connected to this signal. This is useful if for example a maximum range span shall not be exceeded, or if the lower/upper range shouldn't go beyond certain values (see \ref QCPRange::bounded). For example, the following slot would limit the x axis to ranges between 0 and 10: \code customPlot->xAxis->setRange(newRange.bounded(0, 10)) \endcode */ /*! \fn void QCPPolarAxisRadial::rangeChanged(const QCPRange &newRange, const QCPRange &oldRange) \overload Additionally to the new range, this signal also provides the previous range held by the axis as \a oldRange. */ /*! \fn void QCPPolarAxisRadial::scaleTypeChanged(QCPPolarAxisRadial::ScaleType scaleType); This signal is emitted when the scale type changes, by calls to \ref setScaleType */ /*! \fn void QCPPolarAxisRadial::selectionChanged(QCPPolarAxisRadial::SelectableParts selection) This signal is emitted when the selection state of this axis has changed, either by user interaction or by a direct call to \ref setSelectedParts. */ /*! \fn void QCPPolarAxisRadial::selectableChanged(const QCPPolarAxisRadial::SelectableParts &parts); This signal is emitted when the selectability changes, by calls to \ref setSelectableParts */ /* end of documentation of signals */ /*! Constructs an Axis instance of Type \a type for the axis rect \a parent. Usually it isn't necessary to instantiate axes directly, because you can let QCustomPlot create them for you with \ref QCPAxisRect::addAxis. If you want to use own QCPAxis-subclasses however, create them manually and then inject them also via \ref QCPAxisRect::addAxis. */ QCPPolarAxisRadial::QCPPolarAxisRadial(QCPPolarAxisAngular *parent) : QCPLayerable(parent->parentPlot(), QString(), parent), mRangeDrag(true), mRangeZoom(true), mRangeZoomFactor(0.85), // axis base: mAngularAxis(parent), mAngle(45), mAngleReference(arAngularAxis), mSelectableParts(spAxis | spTickLabels | spAxisLabel), mSelectedParts(spNone), mBasePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedBasePen(QPen(Qt::blue, 2)), // axis label: mLabelPadding(0), mLabel(), mLabelFont(mParentPlot->font()), mSelectedLabelFont(QFont(mLabelFont.family(), mLabelFont.pointSize(), QFont::Bold)), mLabelColor(Qt::black), mSelectedLabelColor(Qt::blue), // tick labels: // mTickLabelPadding(0), in label painter mTickLabels(true), // mTickLabelRotation(0), in label painter mTickLabelFont(mParentPlot->font()), mSelectedTickLabelFont(QFont(mTickLabelFont.family(), mTickLabelFont.pointSize(), QFont::Bold)), mTickLabelColor(Qt::black), mSelectedTickLabelColor(Qt::blue), mNumberPrecision(6), mNumberFormatChar('g'), mNumberBeautifulPowers(true), mNumberMultiplyCross(false), // ticks and subticks: mTicks(true), mSubTicks(true), mTickLengthIn(5), mTickLengthOut(0), mSubTickLengthIn(2), mSubTickLengthOut(0), mTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedTickPen(QPen(Qt::blue, 2)), mSubTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedSubTickPen(QPen(Qt::blue, 2)), // scale and range: mRange(0, 5), mRangeReversed(false), mScaleType(stLinear), // internal members: mRadius(1), // non-zero initial value, will be overwritten in ::update() according to inner rect mTicker(new QCPAxisTicker), mLabelPainter(mParentPlot) { setParent(parent); setAntialiased(true); setTickLabelPadding(5); setTickLabelRotation(0); setTickLabelMode(lmUpright); mLabelPainter.setAnchorReferenceType(QCPLabelPainterPrivate::artTangent); mLabelPainter.setAbbreviateDecimalPowers(false); } QCPPolarAxisRadial::~QCPPolarAxisRadial() { } QCPPolarAxisRadial::LabelMode QCPPolarAxisRadial::tickLabelMode() const { switch (mLabelPainter.anchorMode()) { case QCPLabelPainterPrivate::amSkewedUpright: return lmUpright; case QCPLabelPainterPrivate::amSkewedRotated: return lmRotated; default: qDebug() << Q_FUNC_INFO << "invalid mode for polar axis"; break; } return lmUpright; } /* No documentation as it is a property getter */ QString QCPPolarAxisRadial::numberFormat() const { QString result; result.append(mNumberFormatChar); if (mNumberBeautifulPowers) { result.append(QLatin1Char('b')); if (mNumberMultiplyCross) result.append(QLatin1Char('c')); } return result; } /* No documentation as it is a property getter */ int QCPPolarAxisRadial::tickLengthIn() const { return mTickLengthIn; } /* No documentation as it is a property getter */ int QCPPolarAxisRadial::tickLengthOut() const { return mTickLengthOut; } /* No documentation as it is a property getter */ int QCPPolarAxisRadial::subTickLengthIn() const { return mSubTickLengthIn; } /* No documentation as it is a property getter */ int QCPPolarAxisRadial::subTickLengthOut() const { return mSubTickLengthOut; } /* No documentation as it is a property getter */ int QCPPolarAxisRadial::labelPadding() const { return mLabelPadding; } void QCPPolarAxisRadial::setRangeDrag(bool enabled) { mRangeDrag = enabled; } void QCPPolarAxisRadial::setRangeZoom(bool enabled) { mRangeZoom = enabled; } void QCPPolarAxisRadial::setRangeZoomFactor(double factor) { mRangeZoomFactor = factor; } /*! Sets whether the axis uses a linear scale or a logarithmic scale. Note that this method controls the coordinate transformation. For logarithmic scales, you will likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting the axis ticker to an instance of \ref QCPAxisTickerLog : \snippet documentation/doc-code-snippets/mainwindow.cpp qcpaxisticker-log-creation See the documentation of \ref QCPAxisTickerLog about the details of logarithmic axis tick creation. \ref setNumberPrecision */ void QCPPolarAxisRadial::setScaleType(QCPPolarAxisRadial::ScaleType type) { if (mScaleType != type) { mScaleType = type; if (mScaleType == stLogarithmic) setRange(mRange.sanitizedForLogScale()); //mCachedMarginValid = false; emit scaleTypeChanged(mScaleType); } } /*! Sets the range of the axis. This slot may be connected with the \ref rangeChanged signal of another axis so this axis is always synchronized with the other axis range, when it changes. To invert the direction of an axis, use \ref setRangeReversed. */ void QCPPolarAxisRadial::setRange(const QCPRange &range) { if (range.lower == mRange.lower && range.upper == mRange.upper) return; if (!QCPRange::validRange(range)) return; QCPRange oldRange = mRange; if (mScaleType == stLogarithmic) { mRange = range.sanitizedForLogScale(); } else { mRange = range.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. (When \ref QCustomPlot::setInteractions contains iSelectAxes.) However, even when \a selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling \ref setSelectedParts directly. \see SelectablePart, setSelectedParts */ void QCPPolarAxisRadial::setSelectableParts(const SelectableParts &selectable) { if (mSelectableParts != selectable) { mSelectableParts = selectable; emit selectableChanged(mSelectableParts); } } /*! Sets the selected state of the respective axis parts described by \ref SelectablePart. When a part is selected, it uses a different pen/font. The entire selection mechanism for axes is handled automatically when \ref QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you wish to change the selection state manually. This function can change the selection state of a part, independent of the \ref setSelectableParts setting. emits the \ref selectionChanged signal when \a selected is different from the previous selection state. \see SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor */ void QCPPolarAxisRadial::setSelectedParts(const SelectableParts &selected) { if (mSelectedParts != selected) { mSelectedParts = selected; emit selectionChanged(mSelectedParts); } } /*! \overload Sets the lower and upper bound of the axis range. To invert the direction of an axis, use \ref setRangeReversed. There is also a slot to set a range, see \ref setRange(const QCPRange &range). */ void QCPPolarAxisRadial::setRange(double lower, double upper) { if (lower == mRange.lower && upper == mRange.upper) return; if (!QCPRange::validRange(lower, upper)) return; QCPRange oldRange = mRange; mRange.lower = lower; mRange.upper = upper; if (mScaleType == stLogarithmic) { mRange = mRange.sanitizedForLogScale(); } else { mRange = mRange.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! \overload Sets the range of the axis. The \a position coordinate indicates together with the \a alignment parameter, where the new range will be positioned. \a size defines the size of the new axis range. \a alignment may be Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, or center of the range to be aligned with \a position. Any other values of \a alignment will default to Qt::AlignCenter. */ void QCPPolarAxisRadial::setRange(double position, double size, Qt::AlignmentFlag alignment) { if (alignment == Qt::AlignLeft) setRange(position, position+size); else if (alignment == Qt::AlignRight) setRange(position-size, position); else // alignment == Qt::AlignCenter setRange(position-size/2.0, position+size/2.0); } /*! Sets the lower bound of the axis range. The upper bound is not changed. \see setRange */ void QCPPolarAxisRadial::setRangeLower(double lower) { if (mRange.lower == lower) return; QCPRange oldRange = mRange; mRange.lower = lower; if (mScaleType == stLogarithmic) { mRange = mRange.sanitizedForLogScale(); } else { mRange = mRange.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets the upper bound of the axis range. The lower bound is not changed. \see setRange */ void QCPPolarAxisRadial::setRangeUpper(double upper) { if (mRange.upper == upper) return; QCPRange oldRange = mRange; mRange.upper = upper; if (mScaleType == stLogarithmic) { mRange = mRange.sanitizedForLogScale(); } else { mRange = mRange.sanitizedForLinScale(); } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When \a reversed is set to true, the direction of increasing values is inverted. Note that the range and data interface stays the same for reversed axes, e.g. the \a lower part of the \ref setRange interface will still reference the mathematically smaller number than the \a upper part. */ void QCPPolarAxisRadial::setRangeReversed(bool reversed) { mRangeReversed = reversed; } void QCPPolarAxisRadial::setAngle(double degrees) { mAngle = degrees; } void QCPPolarAxisRadial::setAngleReference(AngleReference reference) { mAngleReference = reference; } /*! The axis ticker is responsible for generating the tick positions and tick labels. See the documentation of QCPAxisTicker for details on how to work with axis tickers. You can change the tick positioning/labeling behaviour of this axis by setting a different QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis ticker, access it via \ref ticker. Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes. \see ticker */ void QCPPolarAxisRadial::setTicker(QSharedPointer ticker) { if (ticker) mTicker = ticker; else qDebug() << Q_FUNC_INFO << "can not set 0 as axis ticker"; // no need to invalidate margin cache here because produced tick labels are checked for changes in setupTickVector } /*! Sets whether tick marks are displayed. Note that setting \a show to false does not imply that tick labels are invisible, too. To achieve that, see \ref setTickLabels. \see setSubTicks */ void QCPPolarAxisRadial::setTicks(bool show) { if (mTicks != show) { mTicks = show; //mCachedMarginValid = false; } } /*! Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks. */ void QCPPolarAxisRadial::setTickLabels(bool show) { if (mTickLabels != show) { mTickLabels = show; //mCachedMarginValid = false; if (!mTickLabels) mTickVectorLabels.clear(); } } /*! Sets the distance between the axis base line (including any outward ticks) and the tick labels. \see setLabelPadding, setPadding */ void QCPPolarAxisRadial::setTickLabelPadding(int padding) { mLabelPainter.setPadding(padding); } /*! Sets the font of the tick labels. \see setTickLabels, setTickLabelColor */ void QCPPolarAxisRadial::setTickLabelFont(const QFont &font) { if (font != mTickLabelFont) { mTickLabelFont = font; //mCachedMarginValid = false; } } /*! Sets the color of the tick labels. \see setTickLabels, setTickLabelFont */ void QCPPolarAxisRadial::setTickLabelColor(const QColor &color) { mTickLabelColor = color; } /*! Sets the rotation of the tick labels. If \a degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by \a degrees clockwise. The specified angle is bound to values from -90 to 90 degrees. If \a degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For other angles, the label is drawn with an offset such that it seems to point toward or away from the tick mark. */ void QCPPolarAxisRadial::setTickLabelRotation(double degrees) { mLabelPainter.setRotation(degrees); } void QCPPolarAxisRadial::setTickLabelMode(LabelMode mode) { switch (mode) { case lmUpright: mLabelPainter.setAnchorMode(QCPLabelPainterPrivate::amSkewedUpright); break; case lmRotated: mLabelPainter.setAnchorMode(QCPLabelPainterPrivate::amSkewedRotated); break; } } /*! Sets the number format for the numbers in tick labels. This \a formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class. \a formatCode is a string of one, two or three characters. The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter. The second and third characters are optional and specific to QCustomPlot:\n If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which is ugly in a plot. So when the second char of \a formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of \a formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot. Examples for \a formatCode: \li \c g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used \li \c gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign \li \c ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign \li \c fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'. \li \c hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed. */ void QCPPolarAxisRadial::setNumberFormat(const QString &formatCode) { if (formatCode.isEmpty()) { qDebug() << Q_FUNC_INFO << "Passed formatCode is empty"; return; } //mCachedMarginValid = false; // interpret first char as number format char: QString allowedFormatChars(QLatin1String("eEfgG")); if (allowedFormatChars.contains(formatCode.at(0))) { mNumberFormatChar = QLatin1Char(formatCode.at(0).toLatin1()); } else { qDebug() << Q_FUNC_INFO << "Invalid number format code (first char not in 'eEfgG'):" << formatCode; return; } if (formatCode.length() < 2) { mNumberBeautifulPowers = false; mNumberMultiplyCross = false; } else { // interpret second char as indicator for beautiful decimal powers: if (formatCode.at(1) == QLatin1Char('b') && (mNumberFormatChar == QLatin1Char('e') || mNumberFormatChar == QLatin1Char('g'))) mNumberBeautifulPowers = true; else qDebug() << Q_FUNC_INFO << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode; if (formatCode.length() < 3) { mNumberMultiplyCross = false; } else { // interpret third char as indicator for dot or cross multiplication symbol: if (formatCode.at(2) == QLatin1Char('c')) mNumberMultiplyCross = true; else if (formatCode.at(2) == QLatin1Char('d')) mNumberMultiplyCross = false; else qDebug() << Q_FUNC_INFO << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode; } } mLabelPainter.setSubstituteExponent(mNumberBeautifulPowers); mLabelPainter.setMultiplicationSymbol(mNumberMultiplyCross ? QCPLabelPainterPrivate::SymbolCross : QCPLabelPainterPrivate::SymbolDot); } /*! Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Formats starting with 'e', see \ref setNumberFormat */ void QCPPolarAxisRadial::setNumberPrecision(int precision) { if (mNumberPrecision != precision) { mNumberPrecision = precision; //mCachedMarginValid = false; } } /*! Sets the length of the ticks in pixels. \a inside is the length the ticks will reach inside the plot and \a outside is the length they will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setSubTickLength, setTickLengthIn, setTickLengthOut */ void QCPPolarAxisRadial::setTickLength(int inside, int outside) { setTickLengthIn(inside); setTickLengthOut(outside); } /*! Sets the length of the inward ticks in pixels. \a inside is the length the ticks will reach inside the plot. \see setTickLengthOut, setTickLength, setSubTickLength */ void QCPPolarAxisRadial::setTickLengthIn(int inside) { if (mTickLengthIn != inside) { mTickLengthIn = inside; } } /*! Sets the length of the outward ticks in pixels. \a outside is the length the ticks will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setTickLengthIn, setTickLength, setSubTickLength */ void QCPPolarAxisRadial::setTickLengthOut(int outside) { if (mTickLengthOut != outside) { mTickLengthOut = outside; //mCachedMarginValid = false; // only outside tick length can change margin } } /*! Sets whether sub tick marks are displayed. Sub ticks are only potentially visible if (major) ticks are also visible (see \ref setTicks) \see setTicks */ void QCPPolarAxisRadial::setSubTicks(bool show) { if (mSubTicks != show) { mSubTicks = show; //mCachedMarginValid = false; } } /*! Sets the length of the subticks in pixels. \a inside is the length the subticks will reach inside the plot and \a outside is the length they will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setTickLength, setSubTickLengthIn, setSubTickLengthOut */ void QCPPolarAxisRadial::setSubTickLength(int inside, int outside) { setSubTickLengthIn(inside); setSubTickLengthOut(outside); } /*! Sets the length of the inward subticks in pixels. \a inside is the length the subticks will reach inside the plot. \see setSubTickLengthOut, setSubTickLength, setTickLength */ void QCPPolarAxisRadial::setSubTickLengthIn(int inside) { if (mSubTickLengthIn != inside) { mSubTickLengthIn = inside; } } /*! Sets the length of the outward subticks in pixels. \a outside is the length the subticks will reach outside the plot. If \a outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setSubTickLengthIn, setSubTickLength, setTickLength */ void QCPPolarAxisRadial::setSubTickLengthOut(int outside) { if (mSubTickLengthOut != outside) { mSubTickLengthOut = outside; //mCachedMarginValid = false; // only outside tick length can change margin } } /*! Sets the pen, the axis base line is drawn with. \see setTickPen, setSubTickPen */ void QCPPolarAxisRadial::setBasePen(const QPen &pen) { mBasePen = pen; } /*! Sets the pen, tick marks will be drawn with. \see setTickLength, setBasePen */ void QCPPolarAxisRadial::setTickPen(const QPen &pen) { mTickPen = pen; } /*! Sets the pen, subtick marks will be drawn with. \see setSubTickCount, setSubTickLength, setBasePen */ void QCPPolarAxisRadial::setSubTickPen(const QPen &pen) { mSubTickPen = pen; } /*! Sets the font of the axis label. \see setLabelColor */ void QCPPolarAxisRadial::setLabelFont(const QFont &font) { if (mLabelFont != font) { mLabelFont = font; //mCachedMarginValid = false; } } /*! Sets the color of the axis label. \see setLabelFont */ void QCPPolarAxisRadial::setLabelColor(const QColor &color) { mLabelColor = color; } /*! Sets the text of the axis label that will be shown below/above or next to the axis, depending on its orientation. To disable axis labels, pass an empty string as \a str. */ void QCPPolarAxisRadial::setLabel(const QString &str) { if (mLabel != str) { mLabel = str; //mCachedMarginValid = false; } } /*! Sets the distance between the tick labels and the axis label. \see setTickLabelPadding, setPadding */ void QCPPolarAxisRadial::setLabelPadding(int padding) { if (mLabelPadding != padding) { mLabelPadding = padding; //mCachedMarginValid = false; } } /*! Sets the font that is used for tick labels when they are selected. \see setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedTickLabelFont(const QFont &font) { if (font != mSelectedTickLabelFont) { mSelectedTickLabelFont = font; // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts } } /*! Sets the font that is used for the axis label when it is selected. \see setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedLabelFont(const QFont &font) { mSelectedLabelFont = font; // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts } /*! Sets the color that is used for tick labels when they are selected. \see setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedTickLabelColor(const QColor &color) { if (color != mSelectedTickLabelColor) { mSelectedTickLabelColor = color; } } /*! Sets the color that is used for the axis label when it is selected. \see setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedLabelColor(const QColor &color) { mSelectedLabelColor = color; } /*! Sets the pen that is used to draw the axis base line when selected. \see setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedBasePen(const QPen &pen) { mSelectedBasePen = pen; } /*! Sets the pen that is used to draw the (major) ticks when selected. \see setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedTickPen(const QPen &pen) { mSelectedTickPen = pen; } /*! Sets the pen that is used to draw the subticks when selected. \see setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisRadial::setSelectedSubTickPen(const QPen &pen) { mSelectedSubTickPen = pen; } /*! If the scale type (\ref setScaleType) is \ref stLinear, \a diff is added to the lower and upper bounds of the range. The range is simply moved by \a diff. If the scale type is \ref stLogarithmic, the range bounds are multiplied by \a diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff). */ void QCPPolarAxisRadial::moveRange(double diff) { QCPRange oldRange = mRange; if (mScaleType == stLinear) { mRange.lower += diff; mRange.upper += diff; } else // mScaleType == stLogarithmic { mRange.lower *= diff; mRange.upper *= diff; } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Scales the range of this axis by \a factor around the center of the current axis range. For example, if \a factor is 2.0, then the axis range will double its size, and the point at the axis range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around the center will have moved symmetrically closer). If you wish to scale around a different coordinate than the current axis range center, use the overload \ref scaleRange(double factor, double center). */ void QCPPolarAxisRadial::scaleRange(double factor) { scaleRange(factor, range().center()); } /*! \overload Scales the range of this axis by \a factor around the coordinate \a center. For example, if \a factor is 2.0, \a center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0). \see scaleRange(double factor) */ void QCPPolarAxisRadial::scaleRange(double factor, double center) { QCPRange oldRange = mRange; if (mScaleType == stLinear) { QCPRange newRange; newRange.lower = (mRange.lower-center)*factor + center; newRange.upper = (mRange.upper-center)*factor + center; if (QCPRange::validRange(newRange)) mRange = newRange.sanitizedForLinScale(); } else // mScaleType == stLogarithmic { if ((mRange.upper < 0 && center < 0) || (mRange.upper > 0 && center > 0)) // make sure center has same sign as range { QCPRange newRange; newRange.lower = qPow(mRange.lower/center, factor)*center; newRange.upper = qPow(mRange.upper/center, factor)*center; if (QCPRange::validRange(newRange)) mRange = newRange.sanitizedForLogScale(); } else qDebug() << Q_FUNC_INFO << "Center of scaling operation doesn't lie in same logarithmic sign domain as range:" << center; } emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Changes the axis range such that all plottables associated with this axis are fully visible in that dimension. \see QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes */ void QCPPolarAxisRadial::rescale(bool onlyVisiblePlottables) { Q_UNUSED(onlyVisiblePlottables) /* TODO QList p = plottables(); QCPRange newRange; bool haveRange = false; for (int i=0; irealVisibility() && onlyVisiblePlottables) continue; QCPRange plottableRange; bool currentFoundRange; QCP::SignDomain signDomain = QCP::sdBoth; if (mScaleType == stLogarithmic) signDomain = (mRange.upper < 0 ? QCP::sdNegative : QCP::sdPositive); if (p.at(i)->keyAxis() == this) plottableRange = p.at(i)->getKeyRange(currentFoundRange, signDomain); else plottableRange = p.at(i)->getValueRange(currentFoundRange, signDomain); if (currentFoundRange) { if (!haveRange) newRange = plottableRange; else newRange.expand(plottableRange); haveRange = true; } } if (haveRange) { if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason if (mScaleType == stLinear) { newRange.lower = center-mRange.size()/2.0; newRange.upper = center+mRange.size()/2.0; } else // mScaleType == stLogarithmic { newRange.lower = center/qSqrt(mRange.upper/mRange.lower); newRange.upper = center*qSqrt(mRange.upper/mRange.lower); } } setRange(newRange); } */ } /*! Transforms \a value, in pixel coordinates of the QCustomPlot widget, to axis coordinates. */ void QCPPolarAxisRadial::pixelToCoord(QPointF pixelPos, double &angleCoord, double &radiusCoord) const { QCPVector2D posVector(pixelPos-mCenter); radiusCoord = radiusToCoord(posVector.length()); angleCoord = mAngularAxis->angleRadToCoord(posVector.angle()); } /*! Transforms \a value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget. */ QPointF QCPPolarAxisRadial::coordToPixel(double angleCoord, double radiusCoord) const { const double radiusPixel = coordToRadius(radiusCoord); const double angleRad = mAngularAxis->coordToAngleRad(angleCoord); return QPointF(mCenter.x()+qCos(angleRad)*radiusPixel, mCenter.y()+qSin(angleRad)*radiusPixel); } double QCPPolarAxisRadial::coordToRadius(double coord) const { if (mScaleType == stLinear) { if (!mRangeReversed) return (coord-mRange.lower)/mRange.size()*mRadius; else return (mRange.upper-coord)/mRange.size()*mRadius; } else // mScaleType == stLogarithmic { if (coord >= 0.0 && mRange.upper < 0.0) // invalid value for logarithmic scale, just return outside visible range return !mRangeReversed ? mRadius+200 : mRadius-200; else if (coord <= 0.0 && mRange.upper >= 0.0) // invalid value for logarithmic scale, just return outside visible range return !mRangeReversed ? mRadius-200 :mRadius+200; else { if (!mRangeReversed) return qLn(coord/mRange.lower)/qLn(mRange.upper/mRange.lower)*mRadius; else return qLn(mRange.upper/coord)/qLn(mRange.upper/mRange.lower)*mRadius; } } } double QCPPolarAxisRadial::radiusToCoord(double radius) const { if (mScaleType == stLinear) { if (!mRangeReversed) return (radius)/mRadius*mRange.size()+mRange.lower; else return -(radius)/mRadius*mRange.size()+mRange.upper; } else // mScaleType == stLogarithmic { if (!mRangeReversed) return qPow(mRange.upper/mRange.lower, (radius)/mRadius)*mRange.lower; else return qPow(mRange.upper/mRange.lower, (-radius)/mRadius)*mRange.upper; } } /*! Returns the part of the axis that is hit by \a pos (in pixels). The return value of this function is independent of the user-selectable parts defined with \ref setSelectableParts. Further, this function does not change the current selection state of the axis. If the axis is not visible (\ref setVisible), this function always returns \ref spNone. \see setSelectedParts, setSelectableParts, QCustomPlot::setInteractions */ QCPPolarAxisRadial::SelectablePart QCPPolarAxisRadial::getPartAt(const QPointF &pos) const { Q_UNUSED(pos) // TODO remove later if (!mVisible) return spNone; /* TODO: if (mAxisPainter->axisSelectionBox().contains(pos.toPoint())) return spAxis; else if (mAxisPainter->tickLabelsSelectionBox().contains(pos.toPoint())) return spTickLabels; else if (mAxisPainter->labelSelectionBox().contains(pos.toPoint())) return spAxisLabel; else */ return spNone; } /* inherits documentation from base class */ double QCPPolarAxisRadial::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if (!mParentPlot) return -1; SelectablePart part = getPartAt(pos); if ((onlySelectable && !mSelectableParts.testFlag(part)) || part == spNone) return -1; if (details) details->setValue(part); return mParentPlot->selectionTolerance()*0.99; } /* inherits documentation from base class */ void QCPPolarAxisRadial::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) SelectablePart part = details.value(); if (mSelectableParts.testFlag(part)) { SelectableParts selBefore = mSelectedParts; setSelectedParts(additive ? mSelectedParts^part : part); if (selectionStateChanged) *selectionStateChanged = mSelectedParts != selBefore; } } /* inherits documentation from base class */ void QCPPolarAxisRadial::deselectEvent(bool *selectionStateChanged) { SelectableParts selBefore = mSelectedParts; setSelectedParts(mSelectedParts & ~mSelectableParts); if (selectionStateChanged) *selectionStateChanged = mSelectedParts != selBefore; } /*! \internal This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis. For the axis to accept this event and perform the single axis drag, the parent \ref QCPAxisRect must be configured accordingly, i.e. it must allow range dragging in the orientation of this axis (\ref QCPAxisRect::setRangeDrag) and this axis must be a draggable axis (\ref QCPAxisRect::setRangeDragAxes) \seebaseclassmethod \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. */ void QCPPolarAxisRadial::mousePressEvent(QMouseEvent *event, const QVariant &details) { Q_UNUSED(details) if (!mParentPlot->interactions().testFlag(QCP::iRangeDrag)) { event->ignore(); return; } if (event->buttons() & Qt::LeftButton) { mDragging = true; // initialize antialiasing backup in case we start dragging: if (mParentPlot->noAntialiasingOnDrag()) { mAADragBackup = mParentPlot->antialiasedElements(); mNotAADragBackup = mParentPlot->notAntialiasedElements(); } // Mouse range dragging interaction: if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) mDragStartRange = mRange; } } /*! \internal This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis. \seebaseclassmethod \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. \see QCPAxis::mousePressEvent */ void QCPPolarAxisRadial::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(event) // TODO remove later Q_UNUSED(startPos) // TODO remove later if (mDragging) { /* TODO const double startPixel = orientation() == Qt::Horizontal ? startPos.x() : startPos.y(); const double currentPixel = orientation() == Qt::Horizontal ? event->pos().x() : event->pos().y(); if (mScaleType == QCPPolarAxisRadial::stLinear) { const double diff = pixelToCoord(startPixel) - pixelToCoord(currentPixel); setRange(mDragStartRange.lower+diff, mDragStartRange.upper+diff); } else if (mScaleType == QCPPolarAxisRadial::stLogarithmic) { const double diff = pixelToCoord(startPixel) / pixelToCoord(currentPixel); setRange(mDragStartRange.lower*diff, mDragStartRange.upper*diff); } */ if (mParentPlot->noAntialiasingOnDrag()) mParentPlot->setNotAntialiasedElements(QCP::aeAll); mParentPlot->replot(QCustomPlot::rpQueuedReplot); } } /*! \internal This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis. \seebaseclassmethod \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. \see QCPAxis::mousePressEvent */ void QCPPolarAxisRadial::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(event) Q_UNUSED(startPos) mDragging = false; if (mParentPlot->noAntialiasingOnDrag()) { mParentPlot->setAntialiasedElements(mAADragBackup); mParentPlot->setNotAntialiasedElements(mNotAADragBackup); } } /*! \internal This mouse event reimplementation provides the functionality to let the user zoom individual axes exclusively, by performing the wheel event on top of the axis. For the axis to accept this event and perform the single axis zoom, the parent \ref QCPAxisRect must be configured accordingly, i.e. it must allow range zooming in the orientation of this axis (\ref QCPAxisRect::setRangeZoom) and this axis must be a zoomable axis (\ref QCPAxisRect::setRangeZoomAxes) \seebaseclassmethod \note The zooming of possibly multiple axes at once by performing the wheel event anywhere in the axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::wheelEvent. */ void QCPPolarAxisRadial::wheelEvent(QWheelEvent *event) { // Mouse range zooming interaction: if (!mParentPlot->interactions().testFlag(QCP::iRangeZoom)) { event->ignore(); return; } // TODO: //const double wheelSteps = event->delta()/120.0; // a single step delta is +/-120 usually //const double factor = qPow(mRangeZoomFactor, wheelSteps); //scaleRange(factor, pixelToCoord(orientation() == Qt::Horizontal ? event->pos().x() : event->pos().y())); mParentPlot->replot(); } void QCPPolarAxisRadial::updateGeometry(const QPointF ¢er, double radius) { mCenter = center; mRadius = radius; if (mRadius < 1) mRadius = 1; } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing axis lines. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \seebaseclassmethod \see setAntialiased */ void QCPPolarAxisRadial::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeAxes); } /*! \internal Draws the axis with the specified \a painter, using the internal QCPAxisPainterPrivate instance. \seebaseclassmethod */ void QCPPolarAxisRadial::draw(QCPPainter *painter) { const double axisAngleRad = (mAngle+(mAngleReference==arAngularAxis ? mAngularAxis->angle() : 0))/180.0*M_PI; const QPointF axisVector(qCos(axisAngleRad), qSin(axisAngleRad)); // semantically should be QCPVector2D, but we save time in loops when we keep it as QPointF const QPointF tickNormal = QCPVector2D(axisVector).perpendicular().toPointF(); // semantically should be QCPVector2D, but we save time in loops when we keep it as QPointF // draw baseline: painter->setPen(getBasePen()); painter->drawLine(QLineF(mCenter, mCenter+axisVector*(mRadius-0.5))); // draw subticks: if (!mSubTickVector.isEmpty()) { painter->setPen(getSubTickPen()); for (int i=0; idrawLine(QLineF(tickPosition-tickNormal*mSubTickLengthIn, tickPosition+tickNormal*mSubTickLengthOut)); } } // draw ticks and labels: if (!mTickVector.isEmpty()) { mLabelPainter.setAnchorReference(mCenter-axisVector); // subtract (normalized) axisVector, just to prevent degenerate tangents for tick label at exact lower axis range mLabelPainter.setFont(getTickLabelFont()); mLabelPainter.setColor(getTickLabelColor()); const QPen ticksPen = getTickPen(); painter->setPen(ticksPen); for (int i=0; idrawLine(QLineF(tickPosition-tickNormal*mTickLengthIn, tickPosition+tickNormal*mTickLengthOut)); // possibly draw tick labels: if (!mTickVectorLabels.isEmpty()) { if ((!mRangeReversed && (i < mTickVectorLabels.count()-1 || mRadius-r > 10)) || (mRangeReversed && (i > 0 || mRadius-r > 10))) // skip last label if it's closer than 10 pixels to angular axis mLabelPainter.drawTickLabel(painter, tickPosition+tickNormal*mSubTickLengthOut, mTickVectorLabels.at(i)); } } } } /*! \internal Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling QCPAxisTicker::generate on the currently installed ticker. If a change in the label text/count is detected, the cached axis margin is invalidated to make sure the next margin calculation recalculates the label sizes and returns an up-to-date value. */ void QCPPolarAxisRadial::setupTickVectors() { if (!mParentPlot) return; if ((!mTicks && !mTickLabels) || mRange.size() <= 0) return; mTicker->generate(mRange, mParentPlot->locale(), mNumberFormatChar, mNumberPrecision, mTickVector, mSubTicks ? &mSubTickVector : 0, mTickLabels ? &mTickVectorLabels : 0); } /*! \internal Returns the pen that is used to draw the axis base line. Depending on the selection state, this is either mSelectedBasePen or mBasePen. */ QPen QCPPolarAxisRadial::getBasePen() const { return mSelectedParts.testFlag(spAxis) ? mSelectedBasePen : mBasePen; } /*! \internal Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this is either mSelectedTickPen or mTickPen. */ QPen QCPPolarAxisRadial::getTickPen() const { return mSelectedParts.testFlag(spAxis) ? mSelectedTickPen : mTickPen; } /*! \internal Returns the pen that is used to draw the subticks. Depending on the selection state, this is either mSelectedSubTickPen or mSubTickPen. */ QPen QCPPolarAxisRadial::getSubTickPen() const { return mSelectedParts.testFlag(spAxis) ? mSelectedSubTickPen : mSubTickPen; } /*! \internal Returns the font that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelFont or mTickLabelFont. */ QFont QCPPolarAxisRadial::getTickLabelFont() const { return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelFont : mTickLabelFont; } /*! \internal Returns the font that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelFont or mLabelFont. */ QFont QCPPolarAxisRadial::getLabelFont() const { return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelFont : mLabelFont; } /*! \internal Returns the color that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelColor or mTickLabelColor. */ QColor QCPPolarAxisRadial::getTickLabelColor() const { return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelColor : mTickLabelColor; } /*! \internal Returns the color that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelColor or mLabelColor. */ QColor QCPPolarAxisRadial::getLabelColor() const { return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelColor : mLabelColor; } /* inherits documentation from base class */ QCP::Interaction QCPPolarAxisRadial::selectionCategory() const { return QCP::iSelectAxes; } /* end of 'src/polar/radialaxis.cpp' */ /* including file 'src/polar/layoutelement-angularaxis.cpp' */ /* modified 2021-03-29T02:30:44, size 57266 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPolarAxisAngular //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPolarAxisAngular \brief The main container for polar plots, representing the angular axis as a circle \warning In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future. */ /* start documentation of inline functions */ /*! \fn QCPLayoutInset *QCPPolarAxisAngular::insetLayout() const Returns the inset layout of this axis rect. It can be used to place other layout elements (or even layouts with multiple other elements) inside/on top of an axis rect. \see QCPLayoutInset */ /*! \fn int QCPPolarAxisAngular::left() const Returns the pixel position of the left border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPPolarAxisAngular::right() const Returns the pixel position of the right border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPPolarAxisAngular::top() const Returns the pixel position of the top border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPPolarAxisAngular::bottom() const Returns the pixel position of the bottom border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPPolarAxisAngular::width() const Returns the pixel width of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn int QCPPolarAxisAngular::height() const Returns the pixel height of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QSize QCPPolarAxisAngular::size() const Returns the pixel size of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPPolarAxisAngular::topLeft() const Returns the top left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPPolarAxisAngular::topRight() const Returns the top right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPPolarAxisAngular::bottomLeft() const Returns the bottom left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPPolarAxisAngular::bottomRight() const Returns the bottom right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /*! \fn QPoint QCPPolarAxisAngular::center() const Returns the center of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner \ref rect. */ /* end documentation of inline functions */ /*! Creates a QCPPolarAxis instance and sets default values. An axis is added for each of the four sides, the top and right axes are set invisible initially. */ QCPPolarAxisAngular::QCPPolarAxisAngular(QCustomPlot *parentPlot) : QCPLayoutElement(parentPlot), mBackgroundBrush(Qt::NoBrush), mBackgroundScaled(true), mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), mInsetLayout(new QCPLayoutInset), mRangeDrag(false), mRangeZoom(false), mRangeZoomFactor(0.85), // axis base: mAngle(-90), mAngleRad(mAngle/180.0*M_PI), mSelectableParts(spAxis | spTickLabels | spAxisLabel), mSelectedParts(spNone), mBasePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedBasePen(QPen(Qt::blue, 2)), // axis label: mLabelPadding(0), mLabel(), mLabelFont(mParentPlot->font()), mSelectedLabelFont(QFont(mLabelFont.family(), mLabelFont.pointSize(), QFont::Bold)), mLabelColor(Qt::black), mSelectedLabelColor(Qt::blue), // tick labels: //mTickLabelPadding(0), in label painter mTickLabels(true), //mTickLabelRotation(0), in label painter mTickLabelFont(mParentPlot->font()), mSelectedTickLabelFont(QFont(mTickLabelFont.family(), mTickLabelFont.pointSize(), QFont::Bold)), mTickLabelColor(Qt::black), mSelectedTickLabelColor(Qt::blue), mNumberPrecision(6), mNumberFormatChar('g'), mNumberBeautifulPowers(true), mNumberMultiplyCross(false), // ticks and subticks: mTicks(true), mSubTicks(true), mTickLengthIn(5), mTickLengthOut(0), mSubTickLengthIn(2), mSubTickLengthOut(0), mTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedTickPen(QPen(Qt::blue, 2)), mSubTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), mSelectedSubTickPen(QPen(Qt::blue, 2)), // scale and range: mRange(0, 360), mRangeReversed(false), // internal members: mRadius(1), // non-zero initial value, will be overwritten in ::update() according to inner rect mGrid(new QCPPolarGrid(this)), mTicker(new QCPAxisTickerFixed), mDragging(false), mLabelPainter(parentPlot) { // TODO: //mInsetLayout->initializeParentPlot(mParentPlot); //mInsetLayout->setParentLayerable(this); //mInsetLayout->setParent(this); if (QCPAxisTickerFixed *fixedTicker = mTicker.dynamicCast().data()) { fixedTicker->setTickStep(30); } setAntialiased(true); setLayer(mParentPlot->currentLayer()); // it's actually on that layer already, but we want it in front of the grid, so we place it on there again setTickLabelPadding(5); setTickLabelRotation(0); setTickLabelMode(lmUpright); mLabelPainter.setAnchorReferenceType(QCPLabelPainterPrivate::artNormal); mLabelPainter.setAbbreviateDecimalPowers(false); mLabelPainter.setCacheSize(24); // so we can cache up to 15-degree intervals, polar angular axis uses a bit larger cache than normal axes setMinimumSize(50, 50); setMinimumMargins(QMargins(30, 30, 30, 30)); addRadialAxis(); mGrid->setRadialAxis(radialAxis()); } QCPPolarAxisAngular::~QCPPolarAxisAngular() { delete mGrid; // delete grid here instead of via parent ~QObject for better defined deletion order mGrid = 0; delete mInsetLayout; mInsetLayout = 0; QList radialAxesList = radialAxes(); for (int i=0; i= 0 && index < mRadialAxes.size()) { return mRadialAxes.at(index); } else { qDebug() << Q_FUNC_INFO << "Axis index out of bounds:" << index; return 0; } } /*! Returns all axes on the axis rect sides specified with \a types. \a types may be a single \ref QCPAxis::AxisType or an or-combination, to get the axes of multiple sides. \see axis */ QList QCPPolarAxisAngular::radialAxes() const { return mRadialAxes; } /*! Adds a new axis to the axis rect side specified with \a type, and returns it. If \a axis is 0, a new QCPAxis instance is created internally. QCustomPlot owns the returned axis, so if you want to remove an axis, use \ref removeAxis instead of deleting it manually. You may inject QCPAxis instances (or subclasses of QCPAxis) by setting \a axis to an axis that was previously created outside QCustomPlot. It is important to note that QCustomPlot takes ownership of the axis, so you may not delete it afterwards. Further, the \a axis must have been created with this axis rect as parent and with the same axis type as specified in \a type. If this is not the case, a debug output is generated, the axis is not added, and the method returns 0. This method can not be used to move \a axis between axis rects. The same \a axis instance must not be added multiple times to the same or different axis rects. If an axis rect side already contains one or more axes, the lower and upper endings of the new axis (\ref QCPAxis::setLowerEnding, \ref QCPAxis::setUpperEnding) are set to \ref QCPLineEnding::esHalfBar. \see addAxes, setupFullAxesBox */ QCPPolarAxisRadial *QCPPolarAxisAngular::addRadialAxis(QCPPolarAxisRadial *axis) { QCPPolarAxisRadial *newAxis = axis; if (!newAxis) { newAxis = new QCPPolarAxisRadial(this); } else // user provided existing axis instance, do some sanity checks { if (newAxis->angularAxis() != this) { qDebug() << Q_FUNC_INFO << "passed radial axis doesn't have this angular axis as parent angular axis"; return 0; } if (radialAxes().contains(newAxis)) { qDebug() << Q_FUNC_INFO << "passed axis is already owned by this angular axis"; return 0; } } mRadialAxes.append(newAxis); return newAxis; } /*! Removes the specified \a axis from the axis rect and deletes it. Returns true on success, i.e. if \a axis was a valid axis in this axis rect. \see addAxis */ bool QCPPolarAxisAngular::removeRadialAxis(QCPPolarAxisRadial *radialAxis) { if (mRadialAxes.contains(radialAxis)) { mRadialAxes.removeOne(radialAxis); delete radialAxis; return true; } else { qDebug() << Q_FUNC_INFO << "Radial axis isn't associated with this angular axis:" << reinterpret_cast(radialAxis); return false; } } QRegion QCPPolarAxisAngular::exactClipRegion() const { return QRegion(mCenter.x()-mRadius, mCenter.y()-mRadius, qRound(2*mRadius), qRound(2*mRadius), QRegion::Ellipse); } /*! If the scale type (\ref setScaleType) is \ref stLinear, \a diff is added to the lower and upper bounds of the range. The range is simply moved by \a diff. If the scale type is \ref stLogarithmic, the range bounds are multiplied by \a diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff). */ void QCPPolarAxisAngular::moveRange(double diff) { QCPRange oldRange = mRange; mRange.lower += diff; mRange.upper += diff; emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Scales the range of this axis by \a factor around the center of the current axis range. For example, if \a factor is 2.0, then the axis range will double its size, and the point at the axis range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around the center will have moved symmetrically closer). If you wish to scale around a different coordinate than the current axis range center, use the overload \ref scaleRange(double factor, double center). */ void QCPPolarAxisAngular::scaleRange(double factor) { scaleRange(factor, range().center()); } /*! \overload Scales the range of this axis by \a factor around the coordinate \a center. For example, if \a factor is 2.0, \a center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0). \see scaleRange(double factor) */ void QCPPolarAxisAngular::scaleRange(double factor, double center) { QCPRange oldRange = mRange; QCPRange newRange; newRange.lower = (mRange.lower-center)*factor + center; newRange.upper = (mRange.upper-center)*factor + center; if (QCPRange::validRange(newRange)) mRange = newRange.sanitizedForLinScale(); emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Changes the axis range such that all plottables associated with this axis are fully visible in that dimension. \see QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes */ void QCPPolarAxisAngular::rescale(bool onlyVisiblePlottables) { QCPRange newRange; bool haveRange = false; for (int i=0; irealVisibility() && onlyVisiblePlottables) continue; QCPRange range; bool currentFoundRange; if (mGraphs.at(i)->keyAxis() == this) range = mGraphs.at(i)->getKeyRange(currentFoundRange, QCP::sdBoth); else range = mGraphs.at(i)->getValueRange(currentFoundRange, QCP::sdBoth); if (currentFoundRange) { if (!haveRange) newRange = range; else newRange.expand(range); haveRange = true; } } if (haveRange) { if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason newRange.lower = center-mRange.size()/2.0; newRange.upper = center+mRange.size()/2.0; } setRange(newRange); } } /*! Transforms \a value, in pixel coordinates of the QCustomPlot widget, to axis coordinates. */ void QCPPolarAxisAngular::pixelToCoord(QPointF pixelPos, double &angleCoord, double &radiusCoord) const { if (!mRadialAxes.isEmpty()) mRadialAxes.first()->pixelToCoord(pixelPos, angleCoord, radiusCoord); else qDebug() << Q_FUNC_INFO << "no radial axis configured"; } /*! Transforms \a value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget. */ QPointF QCPPolarAxisAngular::coordToPixel(double angleCoord, double radiusCoord) const { if (!mRadialAxes.isEmpty()) { return mRadialAxes.first()->coordToPixel(angleCoord, radiusCoord); } else { qDebug() << Q_FUNC_INFO << "no radial axis configured"; return QPointF(); } } /*! Returns the part of the axis that is hit by \a pos (in pixels). The return value of this function is independent of the user-selectable parts defined with \ref setSelectableParts. Further, this function does not change the current selection state of the axis. If the axis is not visible (\ref setVisible), this function always returns \ref spNone. \see setSelectedParts, setSelectableParts, QCustomPlot::setInteractions */ QCPPolarAxisAngular::SelectablePart QCPPolarAxisAngular::getPartAt(const QPointF &pos) const { Q_UNUSED(pos) // TODO remove later if (!mVisible) return spNone; /* TODO: if (mAxisPainter->axisSelectionBox().contains(pos.toPoint())) return spAxis; else if (mAxisPainter->tickLabelsSelectionBox().contains(pos.toPoint())) return spTickLabels; else if (mAxisPainter->labelSelectionBox().contains(pos.toPoint())) return spAxisLabel; else */ return spNone; } /* inherits documentation from base class */ double QCPPolarAxisAngular::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { /* if (!mParentPlot) return -1; SelectablePart part = getPartAt(pos); if ((onlySelectable && !mSelectableParts.testFlag(part)) || part == spNone) return -1; if (details) details->setValue(part); return mParentPlot->selectionTolerance()*0.99; */ Q_UNUSED(details) if (onlySelectable) return -1; if (QRectF(mOuterRect).contains(pos)) { if (mParentPlot) return mParentPlot->selectionTolerance()*0.99; else { qDebug() << Q_FUNC_INFO << "parent plot not defined"; return -1; } } else return -1; } /*! This method is called automatically upon replot and doesn't need to be called by users of QCPPolarAxisAngular. Calls the base class implementation to update the margins (see \ref QCPLayoutElement::update), and finally passes the \ref rect to the inset layout (\ref insetLayout) and calls its QCPInsetLayout::update function. \seebaseclassmethod */ void QCPPolarAxisAngular::update(UpdatePhase phase) { QCPLayoutElement::update(phase); switch (phase) { case upPreparation: { setupTickVectors(); for (int i=0; isetupTickVectors(); break; } case upLayout: { mCenter = mRect.center(); mRadius = 0.5*qMin(qAbs(mRect.width()), qAbs(mRect.height())); if (mRadius < 1) mRadius = 1; // prevent cases where radius might become 0 which causes trouble for (int i=0; iupdateGeometry(mCenter, mRadius); mInsetLayout->setOuterRect(rect()); break; } default: break; } // pass update call on to inset layout (doesn't happen automatically, because QCPPolarAxis doesn't derive from QCPLayout): mInsetLayout->update(phase); } /* inherits documentation from base class */ QList QCPPolarAxisAngular::elements(bool recursive) const { QList result; if (mInsetLayout) { result << mInsetLayout; if (recursive) result << mInsetLayout->elements(recursive); } return result; } bool QCPPolarAxisAngular::removeGraph(QCPPolarGraph *graph) { if (!mGraphs.contains(graph)) { qDebug() << Q_FUNC_INFO << "graph not in list:" << reinterpret_cast(graph); return false; } // remove plottable from legend: graph->removeFromLegend(); // remove plottable: delete graph; mGraphs.removeOne(graph); return true; } /* inherits documentation from base class */ void QCPPolarAxisAngular::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeAxes); } /* inherits documentation from base class */ void QCPPolarAxisAngular::draw(QCPPainter *painter) { drawBackground(painter, mCenter, mRadius); // draw baseline circle: painter->setPen(getBasePen()); painter->drawEllipse(mCenter, mRadius, mRadius); // draw subticks: if (!mSubTickVector.isEmpty()) { painter->setPen(getSubTickPen()); for (int i=0; idrawLine(mCenter+mSubTickVectorCosSin.at(i)*(mRadius-mSubTickLengthIn), mCenter+mSubTickVectorCosSin.at(i)*(mRadius+mSubTickLengthOut)); } } // draw ticks and labels: if (!mTickVector.isEmpty()) { mLabelPainter.setAnchorReference(mCenter); mLabelPainter.setFont(getTickLabelFont()); mLabelPainter.setColor(getTickLabelColor()); const QPen ticksPen = getTickPen(); painter->setPen(ticksPen); for (int i=0; idrawLine(mCenter+mTickVectorCosSin.at(i)*(mRadius-mTickLengthIn), outerTick); // draw tick labels: if (!mTickVectorLabels.isEmpty()) { if (i < mTickVectorLabels.count()-1 || (mTickVectorCosSin.at(i)-mTickVectorCosSin.first()).manhattanLength() > 5/180.0*M_PI) // skip last label if it's closer than approx 5 degrees to first mLabelPainter.drawTickLabel(painter, outerTick, mTickVectorLabels.at(i)); } } } } /* inherits documentation from base class */ QCP::Interaction QCPPolarAxisAngular::selectionCategory() const { return QCP::iSelectAxes; } /*! Sets \a pm as the axis background pixmap. The axis background pixmap will be drawn inside the axis rect. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else. For cases where the provided pixmap doesn't have the same size as the axis rect, scaling can be enabled with \ref setBackgroundScaled and the scaling mode (i.e. whether and how the aspect ratio is preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, consider using the overloaded version of this function. Below the pixmap, the axis rect may be optionally filled with a brush, if specified with \ref setBackground(const QBrush &brush). \see setBackgroundScaled, setBackgroundScaledMode, setBackground(const QBrush &brush) */ void QCPPolarAxisAngular::setBackground(const QPixmap &pm) { mBackgroundPixmap = pm; mScaledBackgroundPixmap = QPixmap(); } /*! \overload Sets \a brush as the background brush. The axis rect background will be filled with this brush. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else. The brush will be drawn before (under) any background pixmap, which may be specified with \ref setBackground(const QPixmap &pm). To disable drawing of a background brush, set \a brush to Qt::NoBrush. \see setBackground(const QPixmap &pm) */ void QCPPolarAxisAngular::setBackground(const QBrush &brush) { mBackgroundBrush = brush; } /*! \overload Allows setting the background pixmap of the axis rect, whether it shall be scaled and how it shall be scaled in one call. \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode */ void QCPPolarAxisAngular::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) { mBackgroundPixmap = pm; mScaledBackgroundPixmap = QPixmap(); mBackgroundScaled = scaled; mBackgroundScaledMode = mode; } /*! Sets whether the axis background pixmap shall be scaled to fit the axis rect or not. If \a scaled is set to true, you may control whether and how the aspect ratio of the original pixmap is preserved with \ref setBackgroundScaledMode. Note that the scaled version of the original pixmap is buffered, so there is no performance penalty on replots. (Except when the axis rect dimensions are changed continuously.) \see setBackground, setBackgroundScaledMode */ void QCPPolarAxisAngular::setBackgroundScaled(bool scaled) { mBackgroundScaled = scaled; } /*! If scaling of the axis background pixmap is enabled (\ref setBackgroundScaled), use this function to define whether and how the aspect ratio of the original pixmap passed to \ref setBackground is preserved. \see setBackground, setBackgroundScaled */ void QCPPolarAxisAngular::setBackgroundScaledMode(Qt::AspectRatioMode mode) { mBackgroundScaledMode = mode; } void QCPPolarAxisAngular::setRangeDrag(bool enabled) { mRangeDrag = enabled; } void QCPPolarAxisAngular::setRangeZoom(bool enabled) { mRangeZoom = enabled; } void QCPPolarAxisAngular::setRangeZoomFactor(double factor) { mRangeZoomFactor = factor; } /*! Sets the range of the axis. This slot may be connected with the \ref rangeChanged signal of another axis so this axis is always synchronized with the other axis range, when it changes. To invert the direction of an axis, use \ref setRangeReversed. */ void QCPPolarAxisAngular::setRange(const QCPRange &range) { if (range.lower == mRange.lower && range.upper == mRange.upper) return; if (!QCPRange::validRange(range)) return; QCPRange oldRange = mRange; mRange = range.sanitizedForLinScale(); emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. (When \ref QCustomPlot::setInteractions contains iSelectAxes.) However, even when \a selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling \ref setSelectedParts directly. \see SelectablePart, setSelectedParts */ void QCPPolarAxisAngular::setSelectableParts(const SelectableParts &selectable) { if (mSelectableParts != selectable) { mSelectableParts = selectable; emit selectableChanged(mSelectableParts); } } /*! Sets the selected state of the respective axis parts described by \ref SelectablePart. When a part is selected, it uses a different pen/font. The entire selection mechanism for axes is handled automatically when \ref QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you wish to change the selection state manually. This function can change the selection state of a part, independent of the \ref setSelectableParts setting. emits the \ref selectionChanged signal when \a selected is different from the previous selection state. \see SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor */ void QCPPolarAxisAngular::setSelectedParts(const SelectableParts &selected) { if (mSelectedParts != selected) { mSelectedParts = selected; emit selectionChanged(mSelectedParts); } } /*! \overload Sets the lower and upper bound of the axis range. To invert the direction of an axis, use \ref setRangeReversed. There is also a slot to set a range, see \ref setRange(const QCPRange &range). */ void QCPPolarAxisAngular::setRange(double lower, double upper) { if (lower == mRange.lower && upper == mRange.upper) return; if (!QCPRange::validRange(lower, upper)) return; QCPRange oldRange = mRange; mRange.lower = lower; mRange.upper = upper; mRange = mRange.sanitizedForLinScale(); emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! \overload Sets the range of the axis. The \a position coordinate indicates together with the \a alignment parameter, where the new range will be positioned. \a size defines the size of the new axis range. \a alignment may be Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, or center of the range to be aligned with \a position. Any other values of \a alignment will default to Qt::AlignCenter. */ void QCPPolarAxisAngular::setRange(double position, double size, Qt::AlignmentFlag alignment) { if (alignment == Qt::AlignLeft) setRange(position, position+size); else if (alignment == Qt::AlignRight) setRange(position-size, position); else // alignment == Qt::AlignCenter setRange(position-size/2.0, position+size/2.0); } /*! Sets the lower bound of the axis range. The upper bound is not changed. \see setRange */ void QCPPolarAxisAngular::setRangeLower(double lower) { if (mRange.lower == lower) return; QCPRange oldRange = mRange; mRange.lower = lower; mRange = mRange.sanitizedForLinScale(); emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets the upper bound of the axis range. The lower bound is not changed. \see setRange */ void QCPPolarAxisAngular::setRangeUpper(double upper) { if (mRange.upper == upper) return; QCPRange oldRange = mRange; mRange.upper = upper; mRange = mRange.sanitizedForLinScale(); emit rangeChanged(mRange); emit rangeChanged(mRange, oldRange); } /*! Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When \a reversed is set to true, the direction of increasing values is inverted. Note that the range and data interface stays the same for reversed axes, e.g. the \a lower part of the \ref setRange interface will still reference the mathematically smaller number than the \a upper part. */ void QCPPolarAxisAngular::setRangeReversed(bool reversed) { mRangeReversed = reversed; } void QCPPolarAxisAngular::setAngle(double degrees) { mAngle = degrees; mAngleRad = mAngle/180.0*M_PI; } /*! The axis ticker is responsible for generating the tick positions and tick labels. See the documentation of QCPAxisTicker for details on how to work with axis tickers. You can change the tick positioning/labeling behaviour of this axis by setting a different QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis ticker, access it via \ref ticker. Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes. \see ticker */ void QCPPolarAxisAngular::setTicker(QSharedPointer ticker) { if (ticker) mTicker = ticker; else qDebug() << Q_FUNC_INFO << "can not set 0 as axis ticker"; // no need to invalidate margin cache here because produced tick labels are checked for changes in setupTickVector } /*! Sets whether tick marks are displayed. Note that setting \a show to false does not imply that tick labels are invisible, too. To achieve that, see \ref setTickLabels. \see setSubTicks */ void QCPPolarAxisAngular::setTicks(bool show) { if (mTicks != show) { mTicks = show; //mCachedMarginValid = false; } } /*! Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks. */ void QCPPolarAxisAngular::setTickLabels(bool show) { if (mTickLabels != show) { mTickLabels = show; //mCachedMarginValid = false; if (!mTickLabels) mTickVectorLabels.clear(); } } /*! Sets the distance between the axis base line (including any outward ticks) and the tick labels. \see setLabelPadding, setPadding */ void QCPPolarAxisAngular::setTickLabelPadding(int padding) { mLabelPainter.setPadding(padding); } /*! Sets the font of the tick labels. \see setTickLabels, setTickLabelColor */ void QCPPolarAxisAngular::setTickLabelFont(const QFont &font) { mTickLabelFont = font; } /*! Sets the color of the tick labels. \see setTickLabels, setTickLabelFont */ void QCPPolarAxisAngular::setTickLabelColor(const QColor &color) { mTickLabelColor = color; } /*! Sets the rotation of the tick labels. If \a degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by \a degrees clockwise. The specified angle is bound to values from -90 to 90 degrees. If \a degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For other angles, the label is drawn with an offset such that it seems to point toward or away from the tick mark. */ void QCPPolarAxisAngular::setTickLabelRotation(double degrees) { mLabelPainter.setRotation(degrees); } void QCPPolarAxisAngular::setTickLabelMode(LabelMode mode) { switch (mode) { case lmUpright: mLabelPainter.setAnchorMode(QCPLabelPainterPrivate::amSkewedUpright); break; case lmRotated: mLabelPainter.setAnchorMode(QCPLabelPainterPrivate::amSkewedRotated); break; } } /*! Sets the number format for the numbers in tick labels. This \a formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class. \a formatCode is a string of one, two or three characters. The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter. The second and third characters are optional and specific to QCustomPlot:\n If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which might be visually unappealing in a plot. So when the second char of \a formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of \a formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot. Examples for \a formatCode: \li \c g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used \li \c gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign \li \c ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign \li \c fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'. \li \c hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed. */ void QCPPolarAxisAngular::setNumberFormat(const QString &formatCode) { if (formatCode.isEmpty()) { qDebug() << Q_FUNC_INFO << "Passed formatCode is empty"; return; } //mCachedMarginValid = false; // interpret first char as number format char: QString allowedFormatChars(QLatin1String("eEfgG")); if (allowedFormatChars.contains(formatCode.at(0))) { mNumberFormatChar = QLatin1Char(formatCode.at(0).toLatin1()); } else { qDebug() << Q_FUNC_INFO << "Invalid number format code (first char not in 'eEfgG'):" << formatCode; return; } if (formatCode.length() < 2) { mNumberBeautifulPowers = false; mNumberMultiplyCross = false; } else { // interpret second char as indicator for beautiful decimal powers: if (formatCode.at(1) == QLatin1Char('b') && (mNumberFormatChar == QLatin1Char('e') || mNumberFormatChar == QLatin1Char('g'))) mNumberBeautifulPowers = true; else qDebug() << Q_FUNC_INFO << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode; if (formatCode.length() < 3) { mNumberMultiplyCross = false; } else { // interpret third char as indicator for dot or cross multiplication symbol: if (formatCode.at(2) == QLatin1Char('c')) mNumberMultiplyCross = true; else if (formatCode.at(2) == QLatin1Char('d')) mNumberMultiplyCross = false; else qDebug() << Q_FUNC_INFO << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode; } } mLabelPainter.setSubstituteExponent(mNumberBeautifulPowers); mLabelPainter.setMultiplicationSymbol(mNumberMultiplyCross ? QCPLabelPainterPrivate::SymbolCross : QCPLabelPainterPrivate::SymbolDot); } /*! Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Formats starting with 'e', see \ref setNumberFormat */ void QCPPolarAxisAngular::setNumberPrecision(int precision) { if (mNumberPrecision != precision) { mNumberPrecision = precision; //mCachedMarginValid = false; } } /*! Sets the length of the ticks in pixels. \a inside is the length the ticks will reach inside the plot and \a outside is the length they will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setSubTickLength, setTickLengthIn, setTickLengthOut */ void QCPPolarAxisAngular::setTickLength(int inside, int outside) { setTickLengthIn(inside); setTickLengthOut(outside); } /*! Sets the length of the inward ticks in pixels. \a inside is the length the ticks will reach inside the plot. \see setTickLengthOut, setTickLength, setSubTickLength */ void QCPPolarAxisAngular::setTickLengthIn(int inside) { if (mTickLengthIn != inside) { mTickLengthIn = inside; } } /*! Sets the length of the outward ticks in pixels. \a outside is the length the ticks will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setTickLengthIn, setTickLength, setSubTickLength */ void QCPPolarAxisAngular::setTickLengthOut(int outside) { if (mTickLengthOut != outside) { mTickLengthOut = outside; //mCachedMarginValid = false; // only outside tick length can change margin } } /*! Sets whether sub tick marks are displayed. Sub ticks are only potentially visible if (major) ticks are also visible (see \ref setTicks) \see setTicks */ void QCPPolarAxisAngular::setSubTicks(bool show) { if (mSubTicks != show) { mSubTicks = show; //mCachedMarginValid = false; } } /*! Sets the length of the subticks in pixels. \a inside is the length the subticks will reach inside the plot and \a outside is the length they will reach outside the plot. If \a outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setTickLength, setSubTickLengthIn, setSubTickLengthOut */ void QCPPolarAxisAngular::setSubTickLength(int inside, int outside) { setSubTickLengthIn(inside); setSubTickLengthOut(outside); } /*! Sets the length of the inward subticks in pixels. \a inside is the length the subticks will reach inside the plot. \see setSubTickLengthOut, setSubTickLength, setTickLength */ void QCPPolarAxisAngular::setSubTickLengthIn(int inside) { if (mSubTickLengthIn != inside) { mSubTickLengthIn = inside; } } /*! Sets the length of the outward subticks in pixels. \a outside is the length the subticks will reach outside the plot. If \a outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks. \see setSubTickLengthIn, setSubTickLength, setTickLength */ void QCPPolarAxisAngular::setSubTickLengthOut(int outside) { if (mSubTickLengthOut != outside) { mSubTickLengthOut = outside; //mCachedMarginValid = false; // only outside tick length can change margin } } /*! Sets the pen, the axis base line is drawn with. \see setTickPen, setSubTickPen */ void QCPPolarAxisAngular::setBasePen(const QPen &pen) { mBasePen = pen; } /*! Sets the pen, tick marks will be drawn with. \see setTickLength, setBasePen */ void QCPPolarAxisAngular::setTickPen(const QPen &pen) { mTickPen = pen; } /*! Sets the pen, subtick marks will be drawn with. \see setSubTickCount, setSubTickLength, setBasePen */ void QCPPolarAxisAngular::setSubTickPen(const QPen &pen) { mSubTickPen = pen; } /*! Sets the font of the axis label. \see setLabelColor */ void QCPPolarAxisAngular::setLabelFont(const QFont &font) { if (mLabelFont != font) { mLabelFont = font; //mCachedMarginValid = false; } } /*! Sets the color of the axis label. \see setLabelFont */ void QCPPolarAxisAngular::setLabelColor(const QColor &color) { mLabelColor = color; } /*! Sets the text of the axis label that will be shown below/above or next to the axis, depending on its orientation. To disable axis labels, pass an empty string as \a str. */ void QCPPolarAxisAngular::setLabel(const QString &str) { if (mLabel != str) { mLabel = str; //mCachedMarginValid = false; } } /*! Sets the distance between the tick labels and the axis label. \see setTickLabelPadding, setPadding */ void QCPPolarAxisAngular::setLabelPadding(int padding) { if (mLabelPadding != padding) { mLabelPadding = padding; //mCachedMarginValid = false; } } /*! Sets the font that is used for tick labels when they are selected. \see setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedTickLabelFont(const QFont &font) { if (font != mSelectedTickLabelFont) { mSelectedTickLabelFont = font; // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts } } /*! Sets the font that is used for the axis label when it is selected. \see setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedLabelFont(const QFont &font) { mSelectedLabelFont = font; // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts } /*! Sets the color that is used for tick labels when they are selected. \see setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedTickLabelColor(const QColor &color) { if (color != mSelectedTickLabelColor) { mSelectedTickLabelColor = color; } } /*! Sets the color that is used for the axis label when it is selected. \see setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedLabelColor(const QColor &color) { mSelectedLabelColor = color; } /*! Sets the pen that is used to draw the axis base line when selected. \see setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedBasePen(const QPen &pen) { mSelectedBasePen = pen; } /*! Sets the pen that is used to draw the (major) ticks when selected. \see setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedTickPen(const QPen &pen) { mSelectedTickPen = pen; } /*! Sets the pen that is used to draw the subticks when selected. \see setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions */ void QCPPolarAxisAngular::setSelectedSubTickPen(const QPen &pen) { mSelectedSubTickPen = pen; } /*! \internal Draws the background of this axis rect. It may consist of a background fill (a QBrush) and a pixmap. If a brush was given via \ref setBackground(const QBrush &brush), this function first draws an according filling inside the axis rect with the provided \a painter. Then, if a pixmap was provided via \ref setBackground, this function buffers the scaled version depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside the axis rect with the provided \a painter. The scaled version is buffered in mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when the axis rect has changed in a way that requires a rescale of the background pixmap (this is dependent on the \ref setBackgroundScaledMode), or when a differend axis background pixmap was set. \see setBackground, setBackgroundScaled, setBackgroundScaledMode */ void QCPPolarAxisAngular::drawBackground(QCPPainter *painter, const QPointF ¢er, double radius) { // draw background fill (don't use circular clip, looks bad): if (mBackgroundBrush != Qt::NoBrush) { QPainterPath ellipsePath; ellipsePath.addEllipse(center, radius, radius); painter->fillPath(ellipsePath, mBackgroundBrush); } // draw background pixmap (on top of fill, if brush specified): if (!mBackgroundPixmap.isNull()) { QRegion clipCircle(center.x()-radius, center.y()-radius, qRound(2*radius), qRound(2*radius), QRegion::Ellipse); QRegion originalClip = painter->clipRegion(); painter->setClipRegion(clipCircle); if (mBackgroundScaled) { // check whether mScaledBackground needs to be updated: QSize scaledSize(mBackgroundPixmap.size()); scaledSize.scale(mRect.size(), mBackgroundScaledMode); if (mScaledBackgroundPixmap.size() != scaledSize) mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mRect.size(), mBackgroundScaledMode, Qt::SmoothTransformation); painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mScaledBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height()) & mScaledBackgroundPixmap.rect()); } else { painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height())); } painter->setClipRegion(originalClip); } } /*! \internal Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling QCPAxisTicker::generate on the currently installed ticker. If a change in the label text/count is detected, the cached axis margin is invalidated to make sure the next margin calculation recalculates the label sizes and returns an up-to-date value. */ void QCPPolarAxisAngular::setupTickVectors() { if (!mParentPlot) return; if ((!mTicks && !mTickLabels && !mGrid->visible()) || mRange.size() <= 0) return; mSubTickVector.clear(); // since we might not pass it to mTicker->generate(), and we don't want old data in there mTicker->generate(mRange, mParentPlot->locale(), mNumberFormatChar, mNumberPrecision, mTickVector, mSubTicks ? &mSubTickVector : 0, mTickLabels ? &mTickVectorLabels : 0); // fill cos/sin buffers which will be used by draw() and QCPPolarGrid::draw(), so we don't have to calculate it twice: mTickVectorCosSin.resize(mTickVector.size()); for (int i=0; ibuttons() & Qt::LeftButton) { mDragging = true; // initialize antialiasing backup in case we start dragging: if (mParentPlot->noAntialiasingOnDrag()) { mAADragBackup = mParentPlot->antialiasedElements(); mNotAADragBackup = mParentPlot->notAntialiasedElements(); } // Mouse range dragging interaction: if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) { mDragAngularStart = range(); mDragRadialStart.clear(); for (int i=0; irange()); } } } /*! \internal Event handler for when the mouse is moved on the axis rect. If range dragging was activated in a preceding \ref mousePressEvent, the range is moved accordingly. \see mousePressEvent, mouseReleaseEvent */ void QCPPolarAxisAngular::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(startPos) bool doReplot = false; // Mouse range dragging interaction: if (mDragging && mParentPlot->interactions().testFlag(QCP::iRangeDrag)) { if (mRangeDrag) { doReplot = true; double angleCoordStart, radiusCoordStart; double angleCoord, radiusCoord; pixelToCoord(startPos, angleCoordStart, radiusCoordStart); pixelToCoord(event->pos(), angleCoord, radiusCoord); double diff = angleCoordStart - angleCoord; setRange(mDragAngularStart.lower+diff, mDragAngularStart.upper+diff); } for (int i=0; irangeDrag()) continue; doReplot = true; double angleCoordStart, radiusCoordStart; double angleCoord, radiusCoord; ax->pixelToCoord(startPos, angleCoordStart, radiusCoordStart); ax->pixelToCoord(event->pos(), angleCoord, radiusCoord); if (ax->scaleType() == QCPPolarAxisRadial::stLinear) { double diff = radiusCoordStart - radiusCoord; ax->setRange(mDragRadialStart.at(i).lower+diff, mDragRadialStart.at(i).upper+diff); } else if (ax->scaleType() == QCPPolarAxisRadial::stLogarithmic) { if (radiusCoord != 0) { double diff = radiusCoordStart/radiusCoord; ax->setRange(mDragRadialStart.at(i).lower*diff, mDragRadialStart.at(i).upper*diff); } } } if (doReplot) // if either vertical or horizontal drag was enabled, do a replot { if (mParentPlot->noAntialiasingOnDrag()) mParentPlot->setNotAntialiasedElements(QCP::aeAll); mParentPlot->replot(QCustomPlot::rpQueuedReplot); } } } /* inherits documentation from base class */ void QCPPolarAxisAngular::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) { Q_UNUSED(event) Q_UNUSED(startPos) mDragging = false; if (mParentPlot->noAntialiasingOnDrag()) { mParentPlot->setAntialiasedElements(mAADragBackup); mParentPlot->setNotAntialiasedElements(mNotAADragBackup); } } /*! \internal Event handler for mouse wheel events. If rangeZoom is Qt::Horizontal, Qt::Vertical or both, the ranges of the axes defined as rangeZoomHorzAxis and rangeZoomVertAxis are scaled. The center of the scaling operation is the current cursor position inside the axis rect. The scaling factor is dependent on the mouse wheel delta (which direction the wheel was rotated) to provide a natural zooming feel. The Strength of the zoom can be controlled via \ref setRangeZoomFactor. Note, that event->delta() is usually +/-120 for single rotation steps. However, if the mouse wheel is turned rapidly, many steps may bunch up to one event, so the event->delta() may then be multiples of 120. This is taken into account here, by calculating \a wheelSteps and using it as exponent of the range zoom factor. This takes care of the wheel direction automatically, by inverting the factor, when the wheel step is negative (f^-1 = 1/f). */ void QCPPolarAxisAngular::wheelEvent(QWheelEvent *event) { bool doReplot = false; // Mouse range zooming interaction: if (mParentPlot->interactions().testFlag(QCP::iRangeZoom)) { #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) const double delta = event->delta(); #else const double delta = event->angleDelta().y(); #endif #if QT_VERSION < QT_VERSION_CHECK(5, 14, 0) const QPointF pos = event->pos(); #else const QPointF pos = event->position(); #endif const double wheelSteps = delta/120.0; // a single step delta is +/-120 usually if (mRangeZoom) { double angleCoord, radiusCoord; pixelToCoord(pos, angleCoord, radiusCoord); scaleRange(qPow(mRangeZoomFactor, wheelSteps), angleCoord); } for (int i=0; irangeZoom()) continue; doReplot = true; double angleCoord, radiusCoord; ax->pixelToCoord(pos, angleCoord, radiusCoord); ax->scaleRange(qPow(ax->rangeZoomFactor(), wheelSteps), radiusCoord); } } if (doReplot) mParentPlot->replot(); } bool QCPPolarAxisAngular::registerPolarGraph(QCPPolarGraph *graph) { if (mGraphs.contains(graph)) { qDebug() << Q_FUNC_INFO << "plottable already added:" << reinterpret_cast(graph); return false; } if (graph->keyAxis() != this) { qDebug() << Q_FUNC_INFO << "plottable not created with this as axis:" << reinterpret_cast(graph); return false; } mGraphs.append(graph); // possibly add plottable to legend: if (mParentPlot->autoAddPlottableToLegend()) graph->addToLegend(); if (!graph->layer()) // usually the layer is already set in the constructor of the plottable (via QCPLayerable constructor) graph->setLayer(mParentPlot->currentLayer()); return true; } /* end of 'src/polar/layoutelement-angularaxis.cpp' */ /* including file 'src/polar/polargrid.cpp' */ /* modified 2021-03-29T02:30:44, size 7493 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPolarGrid //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPolarGrid \brief The grid in both angular and radial dimensions for polar plots \warning In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future. */ /*! Creates a QCPPolarGrid instance and sets default values. You shouldn't instantiate grids on their own, since every axis brings its own grid. */ QCPPolarGrid::QCPPolarGrid(QCPPolarAxisAngular *parentAxis) : QCPLayerable(parentAxis->parentPlot(), QString(), parentAxis), mType(gtNone), mSubGridType(gtNone), mAntialiasedSubGrid(true), mAntialiasedZeroLine(true), mParentAxis(parentAxis) { // warning: this is called in QCPPolarAxisAngular constructor, so parentAxis members should not be accessed/called setParent(parentAxis); setType(gtAll); setSubGridType(gtNone); setAngularPen(QPen(QColor(200,200,200), 0, Qt::DotLine)); setAngularSubGridPen(QPen(QColor(220,220,220), 0, Qt::DotLine)); setRadialPen(QPen(QColor(200,200,200), 0, Qt::DotLine)); setRadialSubGridPen(QPen(QColor(220,220,220), 0, Qt::DotLine)); setRadialZeroLinePen(QPen(QColor(200,200,200), 0, Qt::SolidLine)); setAntialiased(true); } void QCPPolarGrid::setRadialAxis(QCPPolarAxisRadial *axis) { mRadialAxis = axis; } void QCPPolarGrid::setType(GridTypes type) { mType = type; } void QCPPolarGrid::setSubGridType(GridTypes type) { mSubGridType = type; } /*! Sets whether sub grid lines are drawn antialiased. */ void QCPPolarGrid::setAntialiasedSubGrid(bool enabled) { mAntialiasedSubGrid = enabled; } /*! Sets whether zero lines are drawn antialiased. */ void QCPPolarGrid::setAntialiasedZeroLine(bool enabled) { mAntialiasedZeroLine = enabled; } /*! Sets the pen with which (major) grid lines are drawn. */ void QCPPolarGrid::setAngularPen(const QPen &pen) { mAngularPen = pen; } /*! Sets the pen with which sub grid lines are drawn. */ void QCPPolarGrid::setAngularSubGridPen(const QPen &pen) { mAngularSubGridPen = pen; } void QCPPolarGrid::setRadialPen(const QPen &pen) { mRadialPen = pen; } void QCPPolarGrid::setRadialSubGridPen(const QPen &pen) { mRadialSubGridPen = pen; } void QCPPolarGrid::setRadialZeroLinePen(const QPen &pen) { mRadialZeroLinePen = pen; } /*! \internal A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter before drawing the major grid lines. This is the antialiasing state the painter passed to the \ref draw method is in by default. This function takes into account the local setting of the antialiasing flag as well as the overrides set with \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. \see setAntialiased */ void QCPPolarGrid::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aeGrid); } /*! \internal Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning over the complete axis rect. Also draws the zero line, if appropriate (\ref setZeroLinePen). */ void QCPPolarGrid::draw(QCPPainter *painter) { if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } const QPointF center = mParentAxis->mCenter; const double radius = mParentAxis->mRadius; painter->setBrush(Qt::NoBrush); // draw main angular grid: if (mType.testFlag(gtAngular)) drawAngularGrid(painter, center, radius, mParentAxis->mTickVectorCosSin, mAngularPen); // draw main radial grid: if (mType.testFlag(gtRadial) && mRadialAxis) drawRadialGrid(painter, center, mRadialAxis->tickVector(), mRadialPen, mRadialZeroLinePen); applyAntialiasingHint(painter, mAntialiasedSubGrid, QCP::aeGrid); // draw sub angular grid: if (mSubGridType.testFlag(gtAngular)) drawAngularGrid(painter, center, radius, mParentAxis->mSubTickVectorCosSin, mAngularSubGridPen); // draw sub radial grid: if (mSubGridType.testFlag(gtRadial) && mRadialAxis) drawRadialGrid(painter, center, mRadialAxis->subTickVector(), mRadialSubGridPen); } void QCPPolarGrid::drawRadialGrid(QCPPainter *painter, const QPointF ¢er, const QVector &coords, const QPen &pen, const QPen &zeroPen) { if (!mRadialAxis) return; if (coords.isEmpty()) return; const bool drawZeroLine = zeroPen != Qt::NoPen; const double zeroLineEpsilon = qAbs(coords.last()-coords.first())*1e-6; painter->setPen(pen); for (int i=0; icoordToRadius(coords.at(i)); if (drawZeroLine && qAbs(coords.at(i)) < zeroLineEpsilon) { applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); painter->setPen(zeroPen); painter->drawEllipse(center, r, r); painter->setPen(pen); applyDefaultAntialiasingHint(painter); } else { painter->drawEllipse(center, r, r); } } } void QCPPolarGrid::drawAngularGrid(QCPPainter *painter, const QPointF ¢er, double radius, const QVector &ticksCosSin, const QPen &pen) { if (ticksCosSin.isEmpty()) return; painter->setPen(pen); for (int i=0; idrawLine(center, center+ticksCosSin.at(i)*radius); } /* end of 'src/polar/polargrid.cpp' */ /* including file 'src/polar/polargraph.cpp' */ /* modified 2021-03-29T02:30:44, size 44035 */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPolarLegendItem //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPolarLegendItem \brief A legend item for polar plots \warning In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future. */ QCPPolarLegendItem::QCPPolarLegendItem(QCPLegend *parent, QCPPolarGraph *graph) : QCPAbstractLegendItem(parent), mPolarGraph(graph) { setAntialiased(false); } void QCPPolarLegendItem::draw(QCPPainter *painter) { if (!mPolarGraph) return; painter->setFont(getFont()); painter->setPen(QPen(getTextColor())); QSizeF iconSize = mParentLegend->iconSize(); QRectF textRect = painter->fontMetrics().boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPolarGraph->name()); QRectF iconRect(mRect.topLeft(), iconSize); int textHeight = qMax(textRect.height(), iconSize.height()); // if text has smaller height than icon, center text vertically in icon height, else align tops painter->drawText(mRect.x()+iconSize.width()+mParentLegend->iconTextPadding(), mRect.y(), textRect.width(), textHeight, Qt::TextDontClip, mPolarGraph->name()); // draw icon: painter->save(); painter->setClipRect(iconRect, Qt::IntersectClip); mPolarGraph->drawLegendIcon(painter, iconRect); painter->restore(); // draw icon border: if (getIconBorderPen().style() != Qt::NoPen) { painter->setPen(getIconBorderPen()); painter->setBrush(Qt::NoBrush); int halfPen = qCeil(painter->pen().widthF()*0.5)+1; painter->setClipRect(mOuterRect.adjusted(-halfPen, -halfPen, halfPen, halfPen)); // extend default clip rect so thicker pens (especially during selection) are not clipped painter->drawRect(iconRect); } } QSize QCPPolarLegendItem::minimumOuterSizeHint() const { if (!mPolarGraph) return QSize(); QSize result(0, 0); QRect textRect; QFontMetrics fontMetrics(getFont()); QSize iconSize = mParentLegend->iconSize(); textRect = fontMetrics.boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPolarGraph->name()); result.setWidth(iconSize.width() + mParentLegend->iconTextPadding() + textRect.width()); result.setHeight(qMax(textRect.height(), iconSize.height())); result.rwidth() += mMargins.left()+mMargins.right(); result.rheight() += mMargins.top()+mMargins.bottom(); return result; } QPen QCPPolarLegendItem::getIconBorderPen() const { return mSelected ? mParentLegend->selectedIconBorderPen() : mParentLegend->iconBorderPen(); } QColor QCPPolarLegendItem::getTextColor() const { return mSelected ? mSelectedTextColor : mTextColor; } QFont QCPPolarLegendItem::getFont() const { return mSelected ? mSelectedFont : mFont; } //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPolarGraph //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPolarGraph \brief A radial graph used to display data in polar plots \warning In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future. */ /* start of documentation of inline functions */ // TODO /* end of documentation of inline functions */ /*! Constructs a graph which uses \a keyAxis as its angular and \a valueAxis as its radial axis. \a keyAxis and \a valueAxis must reside in the same QCustomPlot, and the radial axis must be associated with the angular axis. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though. The created QCPPolarGraph is automatically registered with the QCustomPlot instance inferred from \a keyAxis. This QCustomPlot instance takes ownership of the QCPPolarGraph, so do not delete it manually but use QCPPolarAxisAngular::removeGraph() instead. To directly create a QCPPolarGraph inside a plot, you shoud use the QCPPolarAxisAngular::addGraph method. */ QCPPolarGraph::QCPPolarGraph(QCPPolarAxisAngular *keyAxis, QCPPolarAxisRadial *valueAxis) : QCPLayerable(keyAxis->parentPlot(), QString(), keyAxis), mDataContainer(new QCPGraphDataContainer), mName(), mAntialiasedFill(true), mAntialiasedScatters(true), mPen(Qt::black), mBrush(Qt::NoBrush), mPeriodic(true), mKeyAxis(keyAxis), mValueAxis(valueAxis), mSelectable(QCP::stWhole) //mSelectionDecorator(0) // TODO { if (keyAxis->parentPlot() != valueAxis->parentPlot()) qDebug() << Q_FUNC_INFO << "Parent plot of keyAxis is not the same as that of valueAxis."; mKeyAxis->registerPolarGraph(this); //setSelectionDecorator(new QCPSelectionDecorator); // TODO setPen(QPen(Qt::blue, 0)); setBrush(Qt::NoBrush); setLineStyle(lsLine); } QCPPolarGraph::~QCPPolarGraph() { /* TODO if (mSelectionDecorator) { delete mSelectionDecorator; mSelectionDecorator = 0; } */ } /*! The name is the textual representation of this plottable as it is displayed in the legend (\ref QCPLegend). It may contain any UTF-8 characters, including newlines. */ void QCPPolarGraph::setName(const QString &name) { mName = name; } /*! Sets whether fills of this plottable are drawn antialiased or not. Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. */ void QCPPolarGraph::setAntialiasedFill(bool enabled) { mAntialiasedFill = enabled; } /*! Sets whether the scatter symbols of this plottable are drawn antialiased or not. Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref QCustomPlot::setNotAntialiasedElements. */ void QCPPolarGraph::setAntialiasedScatters(bool enabled) { mAntialiasedScatters = enabled; } /*! The pen is used to draw basic lines that make up the plottable representation in the plot. For example, the \ref QCPGraph subclass draws its graph lines with this pen. \see setBrush */ void QCPPolarGraph::setPen(const QPen &pen) { mPen = pen; } /*! The brush is used to draw basic fills of the plottable representation in the plot. The Fill can be a color, gradient or texture, see the usage of QBrush. For example, the \ref QCPGraph subclass draws the fill under the graph with this brush, when it's not set to Qt::NoBrush. \see setPen */ void QCPPolarGraph::setBrush(const QBrush &brush) { mBrush = brush; } void QCPPolarGraph::setPeriodic(bool enabled) { mPeriodic = enabled; } /*! The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's value axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis. Normally, the key and value axes are set in the constructor of the plottable (or \ref QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). \see setValueAxis */ void QCPPolarGraph::setKeyAxis(QCPPolarAxisAngular *axis) { mKeyAxis = axis; } /*! The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's key axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis. Normally, the key and value axes are set in the constructor of the plottable (or \ref QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). \see setKeyAxis */ void QCPPolarGraph::setValueAxis(QCPPolarAxisRadial *axis) { mValueAxis = axis; } /*! Sets whether and to which granularity this plottable can be selected. A selection can happen by clicking on the QCustomPlot surface (When \ref QCustomPlot::setInteractions contains \ref QCP::iSelectPlottables), by dragging a selection rect (When \ref QCustomPlot::setSelectionRectMode is \ref QCP::srmSelect), or programmatically by calling \ref setSelection. \see setSelection, QCP::SelectionType */ void QCPPolarGraph::setSelectable(QCP::SelectionType selectable) { if (mSelectable != selectable) { mSelectable = selectable; QCPDataSelection oldSelection = mSelection; mSelection.enforceType(mSelectable); emit selectableChanged(mSelectable); if (mSelection != oldSelection) { emit selectionChanged(selected()); emit selectionChanged(mSelection); } } } /*! Sets which data ranges of this plottable are selected. Selected data ranges are drawn differently (e.g. color) in the plot. This can be controlled via the selection decorator (see \ref selectionDecorator). The entire selection mechanism for plottables is handled automatically when \ref QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when you wish to change the selection state programmatically. Using \ref setSelectable you can further specify for each plottable whether and to which granularity it is selectable. If \a selection is not compatible with the current \ref QCP::SelectionType set via \ref setSelectable, the resulting selection will be adjusted accordingly (see \ref QCPDataSelection::enforceType). emits the \ref selectionChanged signal when \a selected is different from the previous selection state. \see setSelectable, selectTest */ void QCPPolarGraph::setSelection(QCPDataSelection selection) { selection.enforceType(mSelectable); if (mSelection != selection) { mSelection = selection; emit selectionChanged(selected()); emit selectionChanged(mSelection); } } /*! \overload Replaces the current data container with the provided \a data container. Since a QSharedPointer is used, multiple QCPPolarGraphs may share the same data container safely. Modifying the data in the container will then affect all graphs that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: \snippet documentation/doc-code-snippets/mainwindow.cpp QCPPolarGraph-datasharing-1 If you do not wish to share containers, but create a copy from an existing container, rather use the \ref QCPDataContainer::set method on the graph's data container directly: \snippet documentation/doc-code-snippets/mainwindow.cpp QCPPolarGraph-datasharing-2 \see addData */ void QCPPolarGraph::setData(QSharedPointer data) { mDataContainer = data; } /*! \overload Replaces the current data with the provided points in \a keys and \a values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector. If you can guarantee that the passed data points are sorted by \a keys in ascending order, you can set \a alreadySorted to true, to improve performance by saving a sorting run. \see addData */ void QCPPolarGraph::setData(const QVector &keys, const QVector &values, bool alreadySorted) { mDataContainer->clear(); addData(keys, values, alreadySorted); } /*! Sets how the single data points are connected in the plot. For scatter-only plots, set \a ls to \ref lsNone and \ref setScatterStyle to the desired scatter style. \see setScatterStyle */ void QCPPolarGraph::setLineStyle(LineStyle ls) { mLineStyle = ls; } /*! Sets the visual appearance of single data points in the plot. If set to \ref QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only-plots with appropriate line style). \see QCPScatterStyle, setLineStyle */ void QCPPolarGraph::setScatterStyle(const QCPScatterStyle &style) { mScatterStyle = style; } void QCPPolarGraph::addData(const QVector &keys, const QVector &values, bool alreadySorted) { if (keys.size() != values.size()) qDebug() << Q_FUNC_INFO << "keys and values have different sizes:" << keys.size() << values.size(); const int n = qMin(keys.size(), values.size()); QVector tempData(n); QVector::iterator it = tempData.begin(); const QVector::iterator itEnd = tempData.end(); int i = 0; while (it != itEnd) { it->key = keys[i]; it->value = values[i]; ++it; ++i; } mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write } void QCPPolarGraph::addData(double key, double value) { mDataContainer->add(QCPGraphData(key, value)); } /*! Use this method to set an own QCPSelectionDecorator (subclass) instance. This allows you to customize the visual representation of selected data ranges further than by using the default QCPSelectionDecorator. The plottable takes ownership of the \a decorator. The currently set decorator can be accessed via \ref selectionDecorator. */ /* void QCPPolarGraph::setSelectionDecorator(QCPSelectionDecorator *decorator) { if (decorator) { if (decorator->registerWithPlottable(this)) { if (mSelectionDecorator) // delete old decorator if necessary delete mSelectionDecorator; mSelectionDecorator = decorator; } } else if (mSelectionDecorator) // just clear decorator { delete mSelectionDecorator; mSelectionDecorator = 0; } } */ void QCPPolarGraph::coordsToPixels(double key, double value, double &x, double &y) const { if (mValueAxis) { const QPointF point = mValueAxis->coordToPixel(key, value); x = point.x(); y = point.y(); } else { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; } } const QPointF QCPPolarGraph::coordsToPixels(double key, double value) const { if (mValueAxis) { return mValueAxis->coordToPixel(key, value); } else { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } } void QCPPolarGraph::pixelsToCoords(double x, double y, double &key, double &value) const { if (mValueAxis) { mValueAxis->pixelToCoord(QPointF(x, y), key, value); } else { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; } } void QCPPolarGraph::pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const { if (mValueAxis) { mValueAxis->pixelToCoord(pixelPos, key, value); } else { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; } } void QCPPolarGraph::rescaleAxes(bool onlyEnlarge) const { rescaleKeyAxis(onlyEnlarge); rescaleValueAxis(onlyEnlarge); } void QCPPolarGraph::rescaleKeyAxis(bool onlyEnlarge) const { QCPPolarAxisAngular *keyAxis = mKeyAxis.data(); if (!keyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } bool foundRange; QCPRange newRange = getKeyRange(foundRange, QCP::sdBoth); if (foundRange) { if (onlyEnlarge) newRange.expand(keyAxis->range()); if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason newRange.lower = center-keyAxis->range().size()/2.0; newRange.upper = center+keyAxis->range().size()/2.0; } keyAxis->setRange(newRange); } } void QCPPolarGraph::rescaleValueAxis(bool onlyEnlarge, bool inKeyRange) const { QCPPolarAxisAngular *keyAxis = mKeyAxis.data(); QCPPolarAxisRadial *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } QCP::SignDomain signDomain = QCP::sdBoth; if (valueAxis->scaleType() == QCPPolarAxisRadial::stLogarithmic) signDomain = (valueAxis->range().upper < 0 ? QCP::sdNegative : QCP::sdPositive); bool foundRange; QCPRange newRange = getValueRange(foundRange, signDomain, inKeyRange ? keyAxis->range() : QCPRange()); if (foundRange) { if (onlyEnlarge) newRange.expand(valueAxis->range()); if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable { double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason if (valueAxis->scaleType() == QCPPolarAxisRadial::stLinear) { newRange.lower = center-valueAxis->range().size()/2.0; newRange.upper = center+valueAxis->range().size()/2.0; } else // scaleType() == stLogarithmic { newRange.lower = center/qSqrt(valueAxis->range().upper/valueAxis->range().lower); newRange.upper = center*qSqrt(valueAxis->range().upper/valueAxis->range().lower); } } valueAxis->setRange(newRange); } } bool QCPPolarGraph::addToLegend(QCPLegend *legend) { if (!legend) { qDebug() << Q_FUNC_INFO << "passed legend is null"; return false; } if (legend->parentPlot() != mParentPlot) { qDebug() << Q_FUNC_INFO << "passed legend isn't in the same QCustomPlot as this plottable"; return false; } //if (!legend->hasItemWithPlottable(this)) // TODO //{ legend->addItem(new QCPPolarLegendItem(legend, this)); return true; //} else // return false; } bool QCPPolarGraph::addToLegend() { if (!mParentPlot || !mParentPlot->legend) return false; else return addToLegend(mParentPlot->legend); } bool QCPPolarGraph::removeFromLegend(QCPLegend *legend) const { if (!legend) { qDebug() << Q_FUNC_INFO << "passed legend is null"; return false; } QCPPolarLegendItem *removableItem = 0; for (int i=0; iitemCount(); ++i) // TODO: reduce this to code in QCPAbstractPlottable::removeFromLegend once unified { if (QCPPolarLegendItem *pli = qobject_cast(legend->item(i))) { if (pli->polarGraph() == this) { removableItem = pli; break; } } } if (removableItem) return legend->removeItem(removableItem); else return false; } bool QCPPolarGraph::removeFromLegend() const { if (!mParentPlot || !mParentPlot->legend) return false; else return removeFromLegend(mParentPlot->legend); } double QCPPolarGraph::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; if (mKeyAxis->rect().contains(pos.toPoint())) { QCPGraphDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); double result = pointDistance(pos, closestDataPoint); if (details) { int pointIndex = closestDataPoint-mDataContainer->constBegin(); details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); } return result; } else return -1; } /* inherits documentation from base class */ QCPRange QCPPolarGraph::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const { return mDataContainer->keyRange(foundRange, inSignDomain); } /* inherits documentation from base class */ QCPRange QCPPolarGraph::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const { return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); } /* inherits documentation from base class */ QRect QCPPolarGraph::clipRect() const { if (mKeyAxis) return mKeyAxis.data()->rect(); else return QRect(); } void QCPPolarGraph::draw(QCPPainter *painter) { if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (mKeyAxis.data()->range().size() <= 0 || mDataContainer->isEmpty()) return; if (mLineStyle == lsNone && mScatterStyle.isNone()) return; painter->setClipRegion(mKeyAxis->exactClipRegion()); QVector lines, scatters; // line and (if necessary) scatter pixel coordinates will be stored here while iterating over segments // loop over and draw segments of unselected/selected data: QList selectedSegments, unselectedSegments, allSegments; getDataSegments(selectedSegments, unselectedSegments); allSegments << unselectedSegments << selectedSegments; for (int i=0; i= unselectedSegments.size(); // get line pixel points appropriate to line style: QCPDataRange lineDataRange = isSelectedSegment ? allSegments.at(i) : allSegments.at(i).adjusted(-1, 1); // unselected segments extend lines to bordering selected data point (safe to exceed total data bounds in first/last segment, getLines takes care) getLines(&lines, lineDataRange); // check data validity if flag set: #ifdef QCUSTOMPLOT_CHECK_DATA QCPGraphDataContainer::const_iterator it; for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) { if (QCP::isInvalidData(it->key, it->value)) qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "invalid." << "Plottable name:" << name(); } #endif // draw fill of graph: //if (isSelectedSegment && mSelectionDecorator) // mSelectionDecorator->applyBrush(painter); //else painter->setBrush(mBrush); painter->setPen(Qt::NoPen); drawFill(painter, &lines); // draw line: if (mLineStyle != lsNone) { //if (isSelectedSegment && mSelectionDecorator) // mSelectionDecorator->applyPen(painter); //else painter->setPen(mPen); painter->setBrush(Qt::NoBrush); drawLinePlot(painter, lines); } // draw scatters: QCPScatterStyle finalScatterStyle = mScatterStyle; //if (isSelectedSegment && mSelectionDecorator) // finalScatterStyle = mSelectionDecorator->getFinalScatterStyle(mScatterStyle); if (!finalScatterStyle.isNone()) { getScatters(&scatters, allSegments.at(i)); drawScatterPlot(painter, scatters, finalScatterStyle); } } // draw other selection decoration that isn't just line/scatter pens and brushes: //if (mSelectionDecorator) // mSelectionDecorator->drawDecoration(painter, selection()); } QCP::Interaction QCPPolarGraph::selectionCategory() const { return QCP::iSelectPlottables; } void QCPPolarGraph::applyDefaultAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiased, QCP::aePlottables); } /* inherits documentation from base class */ void QCPPolarGraph::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) { Q_UNUSED(event) if (mSelectable != QCP::stNone) { QCPDataSelection newSelection = details.value(); QCPDataSelection selectionBefore = mSelection; if (additive) { if (mSelectable == QCP::stWhole) // in whole selection mode, we toggle to no selection even if currently unselected point was hit { if (selected()) setSelection(QCPDataSelection()); else setSelection(newSelection); } else // in all other selection modes we toggle selections of homogeneously selected/unselected segments { if (mSelection.contains(newSelection)) // if entire newSelection is already selected, toggle selection setSelection(mSelection-newSelection); else setSelection(mSelection+newSelection); } } else setSelection(newSelection); if (selectionStateChanged) *selectionStateChanged = mSelection != selectionBefore; } } /* inherits documentation from base class */ void QCPPolarGraph::deselectEvent(bool *selectionStateChanged) { if (mSelectable != QCP::stNone) { QCPDataSelection selectionBefore = mSelection; setSelection(QCPDataSelection()); if (selectionStateChanged) *selectionStateChanged = mSelection != selectionBefore; } } /*! \internal Draws lines between the points in \a lines, given in pixel coordinates. \see drawScatterPlot, drawImpulsePlot, QCPAbstractPlottable1D::drawPolyline */ void QCPPolarGraph::drawLinePlot(QCPPainter *painter, const QVector &lines) const { if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) { applyDefaultAntialiasingHint(painter); drawPolyline(painter, lines); } } /*! \internal Draws the fill of the graph using the specified \a painter, with the currently set brush. Depending on whether a normal fill or a channel fill (\ref setChannelFillGraph) is needed, \ref getFillPolygon or \ref getChannelFillPolygon are used to find the according fill polygons. In order to handle NaN Data points correctly (the fill needs to be split into disjoint areas), this method first determines a list of non-NaN segments with \ref getNonNanSegments, on which to operate. In the channel fill case, \ref getOverlappingSegments is used to consolidate the non-NaN segments of the two involved graphs, before passing the overlapping pairs to \ref getChannelFillPolygon. Pass the points of this graph's line as \a lines, in pixel coordinates. \see drawLinePlot, drawImpulsePlot, drawScatterPlot */ void QCPPolarGraph::drawFill(QCPPainter *painter, QVector *lines) const { applyFillAntialiasingHint(painter); if (painter->brush().style() != Qt::NoBrush && painter->brush().color().alpha() != 0) painter->drawPolygon(QPolygonF(*lines)); } /*! \internal Draws scatter symbols at every point passed in \a scatters, given in pixel coordinates. The scatters will be drawn with \a painter and have the appearance as specified in \a style. \see drawLinePlot, drawImpulsePlot */ void QCPPolarGraph::drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const { applyScattersAntialiasingHint(painter); style.applyTo(painter, mPen); for (int i=0; ifillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); } // draw line vertically centered: if (mLineStyle != lsNone) { applyDefaultAntialiasingHint(painter); painter->setPen(mPen); painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens } // draw scatter symbol: if (!mScatterStyle.isNone()) { applyScattersAntialiasingHint(painter); // scale scatter pixmap if it's too large to fit in legend icon rect: if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) { QCPScatterStyle scaledStyle(mScatterStyle); scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); scaledStyle.applyTo(painter, mPen); scaledStyle.drawShape(painter, QRectF(rect).center()); } else { mScatterStyle.applyTo(painter, mPen); mScatterStyle.drawShape(painter, QRectF(rect).center()); } } } void QCPPolarGraph::applyFillAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiasedFill, QCP::aeFills); } void QCPPolarGraph::applyScattersAntialiasingHint(QCPPainter *painter) const { applyAntialiasingHint(painter, mAntialiasedScatters, QCP::aeScatters); } double QCPPolarGraph::pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const { closestData = mDataContainer->constEnd(); if (mDataContainer->isEmpty()) return -1.0; if (mLineStyle == lsNone && mScatterStyle.isNone()) return -1.0; // calculate minimum distances to graph data points and find closestData iterator: double minDistSqr = (std::numeric_limits::max)(); // determine which key range comes into question, taking selection tolerance around pos into account: double posKeyMin, posKeyMax, dummy; pixelsToCoords(pixelPoint-QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMin, dummy); pixelsToCoords(pixelPoint+QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMax, dummy); if (posKeyMin > posKeyMax) qSwap(posKeyMin, posKeyMax); // iterate over found data points and then choose the one with the shortest distance to pos: QCPGraphDataContainer::const_iterator begin = mDataContainer->findBegin(posKeyMin, true); QCPGraphDataContainer::const_iterator end = mDataContainer->findEnd(posKeyMax, true); for (QCPGraphDataContainer::const_iterator it=begin; it!=end; ++it) { const double currentDistSqr = QCPVector2D(coordsToPixels(it->key, it->value)-pixelPoint).lengthSquared(); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; closestData = it; } } // calculate distance to graph line if there is one (if so, will probably be smaller than distance to closest data point): if (mLineStyle != lsNone) { // line displayed, calculate distance to line segments: QVector lineData; getLines(&lineData, QCPDataRange(0, dataCount())); QCPVector2D p(pixelPoint); for (int i=0; isize(); } void QCPPolarGraph::getDataSegments(QList &selectedSegments, QList &unselectedSegments) const { selectedSegments.clear(); unselectedSegments.clear(); if (mSelectable == QCP::stWhole) // stWhole selection type draws the entire plottable with selected style if mSelection isn't empty { if (selected()) selectedSegments << QCPDataRange(0, dataCount()); else unselectedSegments << QCPDataRange(0, dataCount()); } else { QCPDataSelection sel(selection()); sel.simplify(); selectedSegments = sel.dataRanges(); unselectedSegments = sel.inverse(QCPDataRange(0, dataCount())).dataRanges(); } } void QCPPolarGraph::drawPolyline(QCPPainter *painter, const QVector &lineData) const { // if drawing solid line and not in PDF, use much faster line drawing instead of polyline: if (mParentPlot->plottingHints().testFlag(QCP::phFastPolylines) && painter->pen().style() == Qt::SolidLine && !painter->modes().testFlag(QCPPainter::pmVectorized) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) { int i = 0; bool lastIsNan = false; const int lineDataSize = lineData.size(); while (i < lineDataSize && (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()))) // make sure first point is not NaN ++i; ++i; // because drawing works in 1 point retrospect while (i < lineDataSize) { if (!qIsNaN(lineData.at(i).y()) && !qIsNaN(lineData.at(i).x())) // NaNs create a gap in the line { if (!lastIsNan) painter->drawLine(lineData.at(i-1), lineData.at(i)); else lastIsNan = false; } else lastIsNan = true; ++i; } } else { int segmentStart = 0; int i = 0; const int lineDataSize = lineData.size(); while (i < lineDataSize) { if (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()) || qIsInf(lineData.at(i).y())) // NaNs create a gap in the line. Also filter Infs which make drawPolyline block { painter->drawPolyline(lineData.constData()+segmentStart, i-segmentStart); // i, because we don't want to include the current NaN point segmentStart = i+1; } ++i; } // draw last segment: painter->drawPolyline(lineData.constData()+segmentStart, lineDataSize-segmentStart); } } void QCPPolarGraph::getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const { if (rangeRestriction.isEmpty()) { end = mDataContainer->constEnd(); begin = end; } else { QCPPolarAxisAngular *keyAxis = mKeyAxis.data(); QCPPolarAxisRadial *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } // get visible data range: if (mPeriodic) { begin = mDataContainer->constBegin(); end = mDataContainer->constEnd(); } else { begin = mDataContainer->findBegin(keyAxis->range().lower); end = mDataContainer->findEnd(keyAxis->range().upper); } // limit lower/upperEnd to rangeRestriction: mDataContainer->limitIteratorsToDataRange(begin, end, rangeRestriction); // this also ensures rangeRestriction outside data bounds doesn't break anything } } /*! \internal This method retrieves an optimized set of data points via \ref getOptimizedLineData, an branches out to the line style specific functions such as \ref dataToLines, \ref dataToStepLeftLines, etc. according to the line style of the graph. \a lines will be filled with points in pixel coordinates, that can be drawn with the according draw functions like \ref drawLinePlot and \ref drawImpulsePlot. The points returned in \a lines aren't necessarily the original data points. For example, step line styles require additional points to form the steps when drawn. If the line style of the graph is \ref lsNone, the \a lines vector will be empty. \a dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in \a dataRange, e.g. when extending ranges coming from \ref getDataSegments. \see getScatters */ void QCPPolarGraph::getLines(QVector *lines, const QCPDataRange &dataRange) const { if (!lines) return; QCPGraphDataContainer::const_iterator begin, end; getVisibleDataBounds(begin, end, dataRange); if (begin == end) { lines->clear(); return; } QVector lineData; if (mLineStyle != lsNone) getOptimizedLineData(&lineData, begin, end); switch (mLineStyle) { case lsNone: lines->clear(); break; case lsLine: *lines = dataToLines(lineData); break; } } void QCPPolarGraph::getScatters(QVector *scatters, const QCPDataRange &dataRange) const { QCPPolarAxisAngular *keyAxis = mKeyAxis.data(); QCPPolarAxisRadial *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } if (!scatters) return; QCPGraphDataContainer::const_iterator begin, end; getVisibleDataBounds(begin, end, dataRange); if (begin == end) { scatters->clear(); return; } QVector data; getOptimizedScatterData(&data, begin, end); scatters->resize(data.size()); for (int i=0; icoordToPixel(data.at(i).key, data.at(i).value); } } void QCPPolarGraph::getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const { lineData->clear(); // TODO: fix for log axes and thick line style const QCPRange range = mValueAxis->range(); bool reversed = mValueAxis->rangeReversed(); const double clipMargin = range.size()*0.05; // extra distance from visible circle, so optimized outside lines can cover more angle before having to place a dummy point to prevent tangents const double upperClipValue = range.upper + (reversed ? 0 : range.size()*0.05+clipMargin); // clip slightly outside of actual range to avoid line thicknesses to peek into visible circle const double lowerClipValue = range.lower - (reversed ? range.size()*0.05+clipMargin : 0); // clip slightly outside of actual range to avoid line thicknesses to peek into visible circle const double maxKeySkip = qAsin(qSqrt(clipMargin*(clipMargin+2*range.size()))/(range.size()+clipMargin))/M_PI*mKeyAxis->range().size(); // the maximum angle between two points on outer circle (r=clipValue+clipMargin) before connecting line becomes tangent to inner circle (r=clipValue) double skipBegin = 0; bool belowRange = false; bool aboveRange = false; QCPGraphDataContainer::const_iterator it = begin; while (it != end) { if (it->value < lowerClipValue) { if (aboveRange) // jumped directly from above to below visible range, draw previous point so entry angle is correct { aboveRange = false; if (!reversed) // TODO: with inner radius, we'll need else case here with projected border point lineData->append(*(it-1)); } if (!belowRange) { skipBegin = it->key; lineData->append(QCPGraphData(it->key, lowerClipValue)); belowRange = true; } if (it->key-skipBegin > maxKeySkip) // add dummy point if we're exceeding the maximum skippable angle (to prevent unintentional intersections with visible circle) { skipBegin += maxKeySkip; lineData->append(QCPGraphData(skipBegin, lowerClipValue)); } } else if (it->value > upperClipValue) { if (belowRange) // jumped directly from below to above visible range, draw previous point so entry angle is correct (if lower means outer, so if reversed axis) { belowRange = false; if (reversed) lineData->append(*(it-1)); } if (!aboveRange) { skipBegin = it->key; lineData->append(QCPGraphData(it->key, upperClipValue)); aboveRange = true; } if (it->key-skipBegin > maxKeySkip) // add dummy point if we're exceeding the maximum skippable angle (to prevent unintentional intersections with visible circle) { skipBegin += maxKeySkip; lineData->append(QCPGraphData(skipBegin, upperClipValue)); } } else // value within bounds where we don't optimize away points { if (aboveRange) { aboveRange = false; if (!reversed) lineData->append(*(it-1)); // just entered from above, draw previous point so entry angle is correct (if above means outer, so if not reversed axis) } if (belowRange) { belowRange = false; if (reversed) lineData->append(*(it-1)); // just entered from below, draw previous point so entry angle is correct (if below means outer, so if reversed axis) } lineData->append(*it); // inside visible circle, add point normally } ++it; } // to make fill not erratic, add last point normally if it was outside visible circle: if (aboveRange) { aboveRange = false; if (!reversed) lineData->append(*(it-1)); // just entered from above, draw previous point so entry angle is correct (if above means outer, so if not reversed axis) } if (belowRange) { belowRange = false; if (reversed) lineData->append(*(it-1)); // just entered from below, draw previous point so entry angle is correct (if below means outer, so if reversed axis) } } void QCPPolarGraph::getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const { scatterData->clear(); const QCPRange range = mValueAxis->range(); bool reversed = mValueAxis->rangeReversed(); const double clipMargin = range.size()*0.05; const double upperClipValue = range.upper + (reversed ? 0 : clipMargin); // clip slightly outside of actual range to avoid scatter size to peek into visible circle const double lowerClipValue = range.lower - (reversed ? clipMargin : 0); // clip slightly outside of actual range to avoid scatter size to peek into visible circle QCPGraphDataContainer::const_iterator it = begin; while (it != end) { if (it->value > lowerClipValue && it->value < upperClipValue) scatterData->append(*it); ++it; } } /*! \internal Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style \ref lsLine. The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a getLines if the line style is set accordingly. \see dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot */ QVector QCPPolarGraph::dataToLines(const QVector &data) const { QVector result; QCPPolarAxisAngular *keyAxis = mKeyAxis.data(); QCPPolarAxisRadial *valueAxis = mValueAxis.data(); if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } // transform data points to pixels: result.resize(data.size()); for (int i=0; icoordToPixel(data.at(i).key, data.at(i).value); return result; } /* end of 'src/polar/polargraph.cpp' */ qcustomplot-2.1.0+dfsg1/documentation/0000755000175000017500000000000014314324723017706 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/documentation/html/0000755000175000017500000000000014314324736020656 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/documentation/html/classQCPGraph__inherit__graph.png0000644000175000017500000000472414030601041027205 0ustar rusconirusconi‰PNG  IHDRPû±pgAMA† 1è–_0PLTEÿÿÿÒÒÔiiiQQQ««·………ççè000ÕÕä,!!Wii™­­ÊCCz?BtbKGDˆH pHYsHHFÉk>ËIDATxÚí=lGÇçîÖö™Øæb ‰æÀ&Js2á(ÍøvÎËQYä"(Rœ"RÑX°è@4VLBPH'Aé‚.)òMš@ªDrãÞA¢HG“Ô4™7»g/çݽÙÏÙKÞá›»õ¾ýefçÇü_– •¼f…ÖQ% õð ºÐð§ (‚æTãi>@Ûl…”X“0ÖÑò Z2nꤾø¡ŸÒ\ƒj5ÞZ L7Iyy–­jmª±šÖ[&´0oä´B‘%uzÔÔjcÕãëTãËÐÕîß!´x¾ž#PÆ;‘ß ŒqºcTÛ uøú€ðže9ÝzqCj‹7ˆ¾äüþ¹Z!êA÷&“ zµGÌerìõ*cÜr†þè¬zÐÝô Œ±Ѫd–O#~¨Eɤç”Lž8ðIÇï”|­LZÓ÷”|AAG”…–Ðõ“>zï{¿#‹J@}uý'Õ’ÚÚTM §²e­©fÒ´em«fÒ”e=UÍ ¥/,ëgÕ RÚ±¬Çª¤´eY#1íX\ª)$4  Ûª)$4 OUSHè€~«šBBt4Vû©§ª AAAAAG@Š y‚"hÞ… šw!(‚æ]ù•pß¿ý]8Gþð>y‰ØÜ÷Ãù,aP;v'‰—tŸvr±AÝÒ|N¡ßC‚€jqö_¢Äd@]îû ½ÅL#[¶Á¨ý2 tŒG#u¶çõ=ýš²ª¹¯¢­º.ÇÀd½²Ôí¾/6¼AËíP õ«f­¤Vç9ô`РëÍý n÷ý k`æÁ˜m¾/ÌSÞ$7aK y#_w¾–(KÄyàéÿ‹UÀ}F˜NZÐÃàíç­c¥éšep@€’º¨Ë}¿P\˵Q¨òæûâý~Á‹ äÈ·ÛK¤ ìå»=zâVÕîQ“´  Þ~Ò‚/¥Q±Xƒ6èƒPÆVçJU0±÷îm¾¯ˆ{Ô TÛ8$@ù ü<áé?Ãßó8%~Ê™¼ CNø>r-Cèžû¾Àøðrˆñ¶Ý`¾¯8w×.h #pè{Òg¿Þ~*@+ð-ö¡%":Ìoè]îû±*9Ãú&T4Øæ{z1mÅÐ/ó?ŽüÉÔ…¡ïð?W{öÐ o?€v Šå‡øÐóô¦Çdr¹ïy–0a¢´Ym’Ùæ{>™DSL&Ò£=èÈHO}P>™&Ù¤pö;“©&@'DP8$&S nÏôäá¾'¯„ß[‹rp„’ ¶¿ Š 4¼û~˜#?™ˆƒ±}Ý÷ûÜøÖGÝŽüËC"})¶ÛƲo$1’¦mžgîvì(3[©ûf¿Ûã?1ƒ| Až¤ÊIÂ5¬ßˆ‘² ½,.Ï@þš•…y.òw¬‘º}*‹¼à1~Mtœ_䛘1¦3qv'P:°³•…©ÿˆõèú±"|2•vr—±žÏX•8¶¶ÉV2åßy¯Æ™ ·ò¿Ûéƒ Ø­ÕÈç¬çÙ@ MEOùeÈIÈË¿#ž8½¹–)ètÔù¿0ª"¦¨÷LDGJQežš²V¤uDAOy«úœ˜+EDÝ»íÄ[{£*ôŽœ*b*ôu_n« ;’î•„.Eˆ0û’R¨õ"õ݇¿ÂtÒøæ†:Ð0·¢ÔÔ—tŠ:˜Áæ#HÒ)JÁ"ÿª$Gô뇊9%çÈL¦ûoIeŒ÷ž’IQYï?¼%‘¢2ßDÄÈ~ÿá­a)JÅþÃ[CRT¬ß«$ªà¥fÿá­À¥x‘EA)JÕþÃ[)JÙþÃ[¾[ÝþÃ[Ó>?Å©ÜxËgʨÜxË;E©Ýx˳ïò”šú*xäõiUûdM Fz ­P¦…aJñÿµ˜lhEÐŒ@©÷÷/HÔ]`Öú .^ê_°¿ EPwÀ|ÕÔ¯8À£ EPW@yù4x•K¬©1ÚtÌþ¼éWàaOÔUPªîïUp|7*ŽÙŸúxXë³eF±¶~úÉܪgúfê[-¨« àcA>nˆÇìO}‹²zWÀYR\áÃZì˜ê‡³ÿ²oq€G @Š ®*ƒLP>QÆø|éQÚ7ûCÓ§8` @Š IUàúÕ†~G¶ ®‚BrÉmÇ¢±ç&-=PwAá„~øÒ« Î²®ô :ð8Ÿmî®í=]äv *ÿˆèëfEhy¡±:ð8à°|Hð÷ëöj9AíõžKE¿h)‚ÎÏ­‘ÇùT4æ,ø°d®iJÅg\ëü§BU îÇùÔD¡ßîÚ®‰¡‡Bñ™*ÐòYz÷ã|Júá ΂߲ƒeJÅzCÞ/ZŠ ödr?·²Aì_¬íšHOíµ×{U“©/Ï‚B5ZŠ žPÑAG ´ñA’JTòwÞ?(ÿÕ¸œòõ¯Ÿš‰ÇP({ÙV §ØO)ƒò¯D4“z)eB‚jJÕ R‚jÊŽj]Œ]™‘^&P瘉Få¡.™ÔÑ& ñà¡Q˜ö3Ïžm>{¦šBN9³:!(‚"(‚"(‚ª@PEPEPEPEP!(‚æ]ú÷²6üâñÙ9Å EéR@Õ FWN=EÐœ‚ù½ÆZœ…Ý3Y³{…±{¹m¿ß>w¥yò-ór¯Û¾ûŽ‘[ÐV÷šaò~4»uÞæ¯=ÃdçÌy½Ûpº7' z÷²ažâ€¼Guëv¯æÜ|·ñ®‘KP~ê]í6|­ów¹Ýzhw þÚ:)@|òÉtOL&hóÉÄ_› bèsº›žD›O#þ®aÀdÊh·;j²7GeeБZëATtTv¡%ÙgÒžP ŠB¡öô/JŽ/gúØ~ô%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_b.html0000644000175000017500000001101014030601037024031 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- b -

qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_8.png0000644000175000017500000000133214030601042024414 0ustar rusconirusconi‰PNG  IHDRu#ÚÝgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk> IDAThÞ홽RÛ@…ŒW x^@3iéœ &)hã<€QQ؇*EBá:M:hÝ„7ÈŒ(i¤Šps(´»ì.«°ÎXˆ‘÷S¡Ý{ï^Ý£ý±f¼CbKØíº€(5JRƒ¨Æ=Nº®¥ŽñC¶ô¬Þà©ëªZà ¿u{`:ª®+Û8F{‹öj”ÚG¢T›S$HàT[¾Y–D^WVï³7WÒ`53´%c úÉ)8eÉ)smÉYò–)IR,9”ê^NÁ‘'›ÿ)v†Í‘Ê I2@ªà؉Q’íòKCªz!Ê/ä!/Ûêfp}™Ñ»¥ à¡Œ,˜RPð禤²Uè" 'ÂU3ºfêx_[ÝY}ñe,u})3–Ìto$WлIÆ»u¥æÎ\Òk­¯?^_iŒ¬Ÿ]8ãB¤K—θv"VXa…¯–MÅÌ1Á#®u…%€¯ïÍ,å³ß&@ê ÌPa†&Ò2Ç9*Ü5Qa†9¾ÈÞ€#í»óZOXb¯ï…}œ¡Â™îà÷ÿ|š·09’‹dÔ`±Gª%5´bÕîÊär³­*Ãi£¯¾û¥1ý¬¹W‡z×tMøÏ’)u2ó5ÃC[¥þù¾ö¸5¤~BŽ ñ¸D©}d‹¤Z'pò¿Y>0û¯¥^t]SKëÖNü'®‡D©}d€_]—ð^<âõÿ n‹N%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_v.html0000644000175000017500000000354514030601037024073 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- v -

qcustomplot-2.1.0+dfsg1/documentation/html/annotated.html0000644000175000017500000006467514030601042023522 0ustar rusconirusconi Data Structures
Data Structures
 CQCPAbstractItemThe abstract base class for all items in a plot
 CQCPAbstractLegendItemThe abstract base class for all entries in a QCPLegend
 CQCPAbstractPaintBufferThe abstract base class for paint buffers, which define the rendering backend
 CQCPAbstractPlottableThe abstract base class for all data representing objects in a plot
 CQCPAbstractPlottable1DA template base class for plottables with one-dimensional data
 CQCPAxisManages a single axis inside a QCustomPlot
 CQCPAxisRectHolds multiple axes and arranges them in a rectangular shape
 CQCPAxisTickerThe base class tick generator used by QCPAxis to create tick positions and tick labels
 CQCPAxisTickerDateTimeSpecialized axis ticker for calendar dates and times as axis ticks
 CQCPAxisTickerFixedSpecialized axis ticker with a fixed tick step
 CQCPAxisTickerLogSpecialized axis ticker suited for logarithmic axes
 CQCPAxisTickerPiSpecialized axis ticker to display ticks in units of an arbitrary constant, for example pi
 CQCPAxisTickerTextSpecialized axis ticker which allows arbitrary labels at specified coordinates
 CQCPAxisTickerTimeSpecialized axis ticker for time spans in units of milliseconds to days
 CQCPBarsA plottable representing a bar chart in a plot
 CQCPBarsDataHolds the data of one single data point (one bar) for QCPBars
 CQCPBarsGroupGroups multiple QCPBars together so they appear side by side
 CQCPColorGradientDefines a color gradient for use with e.g. QCPColorMap
 CQCPColorMapA plottable representing a two-dimensional color map in a plot
 CQCPColorMapDataHolds the two-dimensional data of a QCPColorMap plottable
 CQCPColorScaleA color scale for use with color coding data such as QCPColorMap
 CQCPCurveA plottable representing a parametric curve in a plot
 CQCPCurveDataHolds the data of one single data point for QCPCurve
 CQCPDataContainerThe generic data container for one-dimensional plottables
 CQCPDataRangeDescribes a data range given by begin and end index
 CQCPDataSelectionDescribes a data set by holding multiple QCPDataRange instances
 CQCPErrorBarsA plottable that adds a set of error bars to other plottables
 CQCPErrorBarsDataHolds the data of one single error bar for QCPErrorBars
 CQCPFinancialA plottable representing a financial stock chart
 CQCPFinancialDataHolds the data of one single data point for QCPFinancial
 CQCPGraphA plottable representing a graph in a plot
 CQCPGraphDataHolds the data of one single data point for QCPGraph
 CQCPGridResponsible for drawing the grid of a QCPAxis
 CQCPItemAnchorAn anchor of an item to which positions can be attached to
 CQCPItemBracketA bracket for referencing/highlighting certain parts in the plot
 CQCPItemCurveA curved line from one point to another
 CQCPItemEllipseAn ellipse
 CQCPItemLineA line from one point to another
 CQCPItemPixmapAn arbitrary pixmap
 CQCPItemPositionManages the position of an item
 CQCPItemRectA rectangle
 CQCPItemStraightLineA straight line that spans infinitely in both directions
 CQCPItemTextA text label
 CQCPItemTracerItem that sticks to QCPGraph data points
 CQCPLayerA layer that may contain objects, to control the rendering order
 CQCPLayerableBase class for all drawable objects
 CQCPLayoutThe abstract base class for layouts
 CQCPLayoutElementThe abstract base class for all objects that form the layout system
 CQCPLayoutGridA layout that arranges child elements in a grid
 CQCPLayoutInsetA layout that places child elements aligned to the border or arbitrarily positioned
 CQCPLegendManages a legend inside a QCustomPlot
 CQCPLineEndingHandles the different ending decorations for line-like items
 CQCPMarginGroupA margin group allows synchronization of margin sides if working with multiple layout elements
 CQCPPaintBufferGlFboA paint buffer based on OpenGL frame buffers objects, using hardware accelerated rendering
 CQCPPaintBufferGlPbufferA paint buffer based on OpenGL pixel buffers, using hardware accelerated rendering
 CQCPPaintBufferPixmapA paint buffer based on QPixmap, using software raster rendering
 CQCPPainterQPainter subclass used internally
 CQCPPlottableInterface1DDefines an abstract interface for one-dimensional plottables
 CQCPPlottableLegendItemA legend item representing a plottable with an icon and the plottable name
 CQCPPolarAxisAngularThe main container for polar plots, representing the angular axis as a circle
 CQCPPolarAxisRadialThe radial axis inside a radial plot
 CQCPPolarGraphA radial graph used to display data in polar plots
 CQCPPolarGridThe grid in both angular and radial dimensions for polar plots
 CQCPPolarLegendItemA legend item for polar plots
 CQCPRangeRepresents the range an axis is encompassing
 CQCPScatterStyleRepresents the visual appearance of scatter points
 CQCPSelectionDecoratorControls how a plottable's data selection is drawn
 CQCPSelectionDecoratorBracketA selection decorator which draws brackets around each selected data segment
 CQCPSelectionRectProvides rect/rubber-band data selection and range zoom interaction
 CQCPStatisticalBoxA plottable representing a single statistical box in a plot
 CQCPStatisticalBoxDataHolds the data of one single data point for QCPStatisticalBox
 CQCPTextElementA layout element displaying a text
 CQCPVector2DRepresents two doubles as a mathematical 2D vector
 CQCustomPlotThe central class of the library. This is the QWidget which displays the plot and interacts with the user
qcustomplot-2.1.0+dfsg1/documentation/html/QCPCurve.png0000644000175000017500000000623414030601040022776 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_±PLTEÿÿÿ“““llŸGG®LLÿÎ Ü ÿæíÿõàÿÒ33ÿ22¹SSªÓÓÿttœ““ÿBB±++½ÿÆccÿ……—ôôÿ;;ÿ,,ÿttÿ„„ÿœœÿ¤¤ÿººÿÊÊÿÛÛÿllÿ[[ÿDDÿÂÂÿ‹‹ÿ´´ÿääÿSSÿ##ÿ««ÿììÿ::µ{{ÿMM¬aa£66·€€˜||š##ÕÉZZ¦–žcbKGDˆH pHYsÃÃÇo¨d IDATxÚí]kwÚHÅÅmn+C˜éa%Bâ!A˜ÝÌÌÿÿa+ì`]-•NÝãO9áêvwUõ»z0¨‚»Jÿ›™»ÇLR433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwÌL^433úŠvÇÌäE33£_ hwýg¾»Cùû×'ëó½xx„á`Oòù³ýå—Òçºõ÷uüëoöó=<‹Ÿý=Ü«ß›üòo”Ïé‡3v%HÏšÎüy°gø³eÛJåN|Í~[Æjz,¼^­7AŒÂ0Ü.üiâ¦2+}šÌ[.ûÍ&_% À[î u†ã(oIá-Õ˜ñ4kbžG^ÖFÒ^n àøyõkÔžæÔ£@E‹<ÛYn¬Ê¿65í&ÜYyqâYX¦ìS2Ú¶¤ù*üÔ¸Ê6QZ¶É»Œ ÷,­*üd?‘ ×íÈ-´g"À­Ñ‹D‚°Çd½píeÍ—Õ& Š±…@:1©ÛM;³¼¾íMkn çS ÂÝÕþ}²(j¤ “f AÖ—¨)¥qê~©@Ä5Üï NrÓˆ¡.Y‡ƒ·­Ìôyd Hg†47„³Ì¿µjÎìXÒ|…z#DýXò–y ð*ˆjjn†lÜ&’‘&æ¦Fé ,t;j ‹Œ!Ÿ8Ù:£ŸcÃÔd>XG šbßOæq ò€©¹>òª~Ž#51¯ÁFÔ|ƒz¯D³ý2óÖª7C)¥¹>V6ˆ7Sr]Ì¡HßäŒÒPÈæã˜ËÐíŠÍ1“àa ·B¿±Ž½H‘˜s„™+Æ:,D‡Eo€äƒ}¾²—òͼØP u¤Bb~ÁX׎æ8¸ô€1£@«Ž›Ì¡ ^í%t$ÍbH•Öc£-cCÚ½C«6jWu7ÀÚ¸kà #z$Íc@ ¤;œñhM8Ñðð?–fÐp[£‰¡C:èÈfò˶5!Åì¬îTÒœä23žæ ÿ¶«3“7¦9R˜iJa¶ ³y„«cCKó›pÕÄÖm00£kÿ@ššóB'…q•G+à?hµ1ø/ÚhÆPfÃP¿ûšå7´Ú¸´H}aö:f]`N¤&¼p¥4ª@Ó=£ÕÆàíÔ z†žöý4ÍÓ{´Ú Í)°áÄv{zŽ5Ú¨q0ê½ s\/\6\ 5¬yþ€VD›p,ˆY=¢ÕÆ@ó4#Ø(Ðøaµ”J h‡ÿk;ánÕ¿?½á÷}û2*þ ñ²S ¤ù(æ+–d¼@Ñ4S ¤”Q >Ä¥hR^¸þ1ŠéÀ9ñªÀ‘> µöêØÈÓ(†`®ŸÐ4:–‘©#M[‚í`Šxçá35ÒýùZ A/Ä\#ýŽ¶„®³:ÞŽb6¡ý;šæADàôÓ i-Æ dÃ<Ù×Ðý]û¹|Ÿ'œ bîÚÿ‰6aÑS+Öû-AzM¸…¿Ð4w|·)ôÀîÐ¥Ú#î5uú©SpA‚ž&¨çHÑÆ3E.¦ÑkÂÔÂ<¿éèAÒƒmç-ÕÔÜZwhôìîê r^ˆ|³i t§@l^;yuO—\Ú6îÑæh©²yDÜ…d#ú€’×çwhÓŠšv7º= æ…èwíž×êØ–¹)O­ óŒ¸IKÐîùVÆ>Õ¿¼¨X)E^pÌþ„²gXÙîò,UXb^h ûN"Ī¢÷È’ Þ‰5áÑCÓè9ºKk !k@¿m88`÷SG똴œ4?ÕGaÆÓ\"ÁÕ|¢Æ¸¤WZtþ~K¥d#¤šð”=±ó´½é}Ööh1ôcñ𯰾dÈ׿åTÊîòx*§û¡ä…¶© ùƒ¹þ÷JˆmP5žªUI™§õŸ}}ÙD0ðfS,Œ/K.Š<,™yù&‚¬SD¾ÒõîEmD¼±÷]ûô<"¨Ã¢÷Ñ¥÷„µ¾kÿÆ Ò¬ŸR[øNôZÒÔ»kªŽlTœ¾ÛŸÔVÑ[ñ.  ¤œ0fÛ¹ÆÝËÕ´pAX7ÕG:ÃÙ-|°ŽD×[†?™sÔ¹#©Ñ¢©9}uMÌøpkÓX ͱ=KO̾§ÝõVG˜ðv™÷Þ…-ts4ÇJ]OÜo\[v^Pu»šƒ2›æ¢uXà5Wq·Š3ónøpDyÍÍTÍ™÷ñåƒèFiŽQã,g»ø ÒÎ4)¯Ô!…·ÙyAÇ*Ên6±"ª;‡ÛOS€tIïP½³Î:nÛ¯ýó¤ô!<(´g)À®Ñ?–áú´öÖϘ}@Z5œqtõžñ@ú»d¥X8O€š„È¢±™Q^Œ¤ÊyIP×úýéI™%2“,s&#<Ø"/w÷‡Ÿå›Ñ=”YÑ —ä²µÔT7­c”—%ø… o«YâIaOÃjÌxš51o&v^0o²+ EûqœUŒnà[ ¤¯˜Ç*s1‘ÆËÃÚߣ0\íÖÓIâzòôﻚÌxšu1y#©|?È•³^Zvš•^¤Â=¤¼¶_ÿHþ¾Oð8„áîÕóßî·¶­'Ü5’Šxþé‹û|/áñ1/þÓ}úýËôŸ¿P>×a‹ffZÔÌl†™A펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@Ñ¼hffô 펙ɋffF¿@ÑÑuüèxž÷ÍX@€%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarAxisRadial__inherit__graph.png0000644000175000017500000000166714030601041031166 0ustar rusconirusconi‰PNG  IHDRk¸m gAMA† 1è–_0PLTEÿÿÿÿÿÿjjj222LLL™™™………ççè®®³ÓÓÕ+PnnEE|vŸGtRNSªvå’bKGDˆH pHYsHHFÉk>¡IDATXÃíÙ½oÓ@ðþ \"W Q ù0r7ÒTÁ²ä<÷¤N ²Æü N.ºŽEÍbafBae@¸HÝ»°÷àÝ9UJqrqmD÷'¹_Þ{g)J²FJ‰;kÚYÑ©tsÇ£,§êçv Óéä®ÆÔÎõp 1Vr*àá80`Olº±c²FÅ{Û1jQ!Ç#×hˆÕS¹ ,—L?ôöHS à½AN`¨töIÝ5>"0ËgÃõÈËê+“ø8ÈHpÜ1Èã×îêNÚ\F^8QWœ%jg^—l†÷Æ5š»ÄØž¦Î~ž>§=v7`X}z"œC;­«û©£tÖ/ÏŸcþQàŸÔ{:ë`_ö¹¡t±~=êÚC² òÝÏpPŽ³8´ó7ÈYÎÝæ‚xpºhÆÊrÆf¢^³Šó.–â\$g¥8çÉ×2œZ’|/ÃÙJ’Ó2œÍ$IŽJp>£ó£ç³œst¾wêȨLíl Gy`jç^I†ú6ÔŽv´£íhG;ÚÑNç¹êç½/ªO¤sƒïדNÀ‹ÆêÐ%[Ó9ö»3|´Áar€ÁU'š¿šÍà+¶À‰úÑ`6wYlsÚ¦WÞî<6Uäð1eŽ˜29i ®Å܈CoäŒw©ÈgÄ éc> ŽÇcÊ,tÒ|ØNO¼gÄ}kLƒ8Œ,Êú­4l‰º&t™“ö‡Y˜ÖÇ™cs³ùœ±ä ®åÐ¥uÉâ¥Ãžá…›¸9U¶}NMG J'hÒì>;²Ï3GÔÅú¢¸.턶EGÍûã‰AYWØ¢ËÎ=udŸÇ œO|g4ë3·Å ì³íg9x¼ÖºŸµóO;e}^ÄÍ¢±}›ÿ×»%Ná&˸ÿE‘Cé!‚!%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_15.png0000644000175000017500000000120514030601042024471 0ustar rusconirusconi‰PNG  IHDRu#ÚÝgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>·IDAThÞíY=NÃ0ýŠâ€%=DÇž¹[»¢p„ŒH‘HLl,lÝXàl¹€™z€,!Ž'¶ãVùkê—!Ÿ—Ïïé³?¥ê   ÁÕмUoÕ[uBP?t;´–N°¢gɪ¾Ó~hU`OŸ2Êþ†VÖ:æ¥ø‚Ϊ·:Eœ…Õ°?« )¤6ræ^™ ÅõZÖ,2”Wç†!ƒA [plÁÈ™;D€ãFd0åÑÃ…}\Æ2"¡¬2ÄNaY•Â5V‹™%˜|+E† •¹ÃBÉkc´`5Q*—K+ SUò¸\!‰|V\:æËšU£«ÌP§‚Ï•‘jNͤ2SeÕ&†ÝªS[z¬Ü‰Þ*ŒŒ2ÊèΘa®Œ¾¿™y£ã¶T­¤ZÕò(B„ßÖwmØÌ°WÕÁ*°nm˜©Ê=lP¼¢-Å–íœßõmÉÌhÁjŽ…<'ã¡!Ú­î[ý÷Ô3Ò)ò‹'æVlj̙yßÀíÀ["¼Õ)BéÀíü®ëV†ÖÔV2šùâ&ouŠèch }áÍâ­ÿ›&õÒ%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/qcp-doc-logo.png0000644000175000017500000005055114030601037023641 0ustar rusconirusconi‰PNG  IHDRúÒ¢¦sBIT|dˆ pHYsýý—Ñ6tEXtSoftwarewww.inkscape.org›î< IDATxœìÝwxÕúÀñïI%!!É„$tBGÊH”¢€ 4…« àAñ'âUïµëµ"ˆ6¤(6PQª¢A¡H—^e@IÎïY–$dwg“¼ŸçÙ‡-3ç¼›„}wÎœyÒZ#„Bˆâ)Èé„Bá;!N „ð?Ó4+uÜ·d   D¹ÿ=û~0pÌ};~žû{€ îÛV˲²üö†J¥TpRk}ÊéXDàS2t/Dñešf= !g’z] 6v÷¥SÀfÎ$þ À:`…eY’œ.RÊú×cÿ.kh­³J’è…(FLÓ¬ tpßÚ‰ÎFtŽTàWàGàìÄ/Gþù ”zxÜýð5­õ½NÆ#ŠIôBa¦iV:r&¹Wr6¢; ,Äø-˲Ž'`)¥ÖcÉ´ÒZ/u2QtH¢¢ˆ1M3è ®”³yÕ&`0Ų¬mÇ0”R&°Êýð/­uu'ãE‹$z!ŠÓ4C.À@à ÜÙˆ|N¿`'ý/,ËJq8G)¥žu?¥µ~ÄÉxDÑ"‰^ˆfšfSà6àf ¬³Ñ8æð 0˜mYV‰ûÐRJmÀžD p¹ÖZNqˆ|“D/D2M³ðöùwqÆ:à`ªeY™NãJ©Ë?Ü×i­ë;(z¤`ŽÄ4ÍëMÓ\,@’|^êaço4MóÓ4‹û) °çcœö©cQˆ"KŽè…p˜išA@ì#xÓápŠš=ÀKÀx˲RÆ”RZµÖ›œŒG=’è…piš}€g9sþU\šCÀhàÕâTG)ÕXé~ø»Öº™“ñˆ¢I†î…p€iš5MÓœ|Ž$yoˆÆ«LÓlït0^$Ãö¢Ðäˆ^?2M³ð0ð Åÿ9'}ÜoYÖ>§) ¥Ô& &öå†UµÖ;IA’è…ðÓ4¯Æ5œŽ¥„HÁ.ûfQ,³«”j ¬p?üUkÝÖÉxDÑ%C÷Bø˜išMÓœÌB’¼?•^–›¦ÙÒé`.AÎaû©ŽE!Š<9¢‡LÓìŠ}9X¼Ó±”p™ØG÷£‹JÁ¥Ôfì/†Y@­õ‡CE”$z!|À4ÍàyàŠW-ú¢n0À²¬ƒNr!J©&Àïî‡ó´ÖœŒGm2t/„—™¦Yøø7’äMgàÓ4¯r:‹a{á5rD/„™¦yð`8Š¸°,à¿Àó–ee;Ë9”R[€ê@¤µ>âpH¢“D/„˜¦Œ}÷}NÇ" d>Ð/†ò•RMåî‡ßh­{:(údè^ˆB2M3ø IòEÑ5À"Ó4“$)’#¼JŽè…(Ó4 à[ µÓ±ˆBÙ t±,Ëñå_•R[j@*ö°}±¬á/üGŽè…¸D¦iV~A’|qPøÙéIzJ©æØIà+IòÂ$Ñ q LÓ¬,Æ^6U1ÀÓ4{9ÃÍ9îOq, Q¬Èнdšæ•ØÃõqNÇ"|" ¸Ë²¬wýÙ©R*؉=º°¨¤µ.r¥{Eà‘#z! À4ÍÀ<$ÉgÁÀxÓ4ÿåç~;`'y€O%É o‘D/D>™¦Ùøˆp:á/™¦9Ðý Èqÿc?ö+Š9º"LÓ¬,’œŽEøU&ÐÓ²¬™¾ìD)ì¢ Z뺾ìO”,rD/ÄE˜¦™ÌE’|I|áž—áK7`'y£yáe’è…¸Ó4˳±Ë‘Š’)øÖ4Í>ìã–÷¥¶½ð*ºâ ‰^ˆ<˜¦y7¹‹—PxßËmösÿ› |æ嶅¡{!ÎfšfSìªwaÛV”XÿgYÖ[…mD)UØ}Ðõ“ÖZF„×ɽ9˜¦|Ž$yqa/›¦ÙÈ íÜÌ™Ïa™m/|B½¹}€Ì°|nšfôE·¼°ÓÃöÀ´B¶%Dž$Ñ áfšæàF§ãEF-à’ëá+¥êMÜ¿×ZöJTBœE½€išÍ€±NÇ!Šœ›MÓv‰ûöËq_Vª>#“ñD‰gšf`aϨ¢ Òz–em+ÈNJ©Í@ à(PNk}± !GôB÷#I^\º`\AvPJµÂNòÓ$É _’D/J4Ó4«9‡(ò®7M³G¶ïŸã¾ Û Ÿ’D/JºWH§ƒÅÂk¦i^ôoI)üÃýp°Ð§Q‰O½(±LÓì ôt:QlTÏÇv€÷ýµÖÙ¾ IIô¢„2M³<¯*D>ÜošæeÙFfÛ ¿’D/Jª‡Â8ÂûBó–ÆUJErfé­õ_¤”j­”*laQ„I¢%Žiš€ŽC[íLÓì}ž×z¥Ý÷'û*¥T¨RêN¥Ô* ºÖú˜¯úO½(‰þ ”r:Q¬ïJŽî³€O|ѱR*»nþÛÀx­µœ(á$Ñ‹Å4ÍàR+™ ‘_MÓì–ó ¥TöD<€ùZë}>ê{<ÐxTk]èöDÑ'‰^”4÷!—Ó ÿ8û¨þ Ø}ß'ÃöJ©±ÀíÀ‹Zëç}ч(z¤®(1LÓŒ¶21Iø˵–eÍPJýŽ½ˆÍ1ì’·iÞìH)õð ðžÖZF­„‡Ñ‹’d$’ä…= ”ªÏ™•ê¾ðA’¿;ÉÜéͶEÑ'Gô¢Dp¯¾ˆs:Qâ´]½zuà÷ã«´Ö¿x«q¥Ô`"ð=ÐSk}Ê[m‹â!Äé„ð“»$/œñp¹ûþVàWo5¬”ê|ènó&Iò"/2t/J 9g)qå•WvªY³f9÷ÃIÚKèJ©ŽØCõp½Ö:ÝíŠâG½(öLÓlƒTÁéÝ»·ºë®»4ö{¡)¥Z_µÖ)ÞhWO’èEI0àâ›á}111\}õÕôïߟŸµÖÛ Û¦Rª0 8\«µþ»°mŠâM½(ÖLÓ ú:‡(™®»î:ÂÂÂHLLdøðáÛ ÛžRª08 \£µÞUØ6Eñ'“ñDq׈u:Q2õèÑ€ÔÔTV¬XQ¨åh•RùØŸÛWk­7>BQȽ(îdØ^8¢FÔ¯_€9sæ’’ÒÝ4Í°KiK)•€äcNZëuÞ‹Tw’èE±å®kÓqˆ’©W¯^žû_}õ@<е í(¥b¹@% «Öz¥—B%„$zQœÝŒœž á†n`ëÖ­¬ZµêôKaRJ•ÆžxW¸Ak½Ä›qŠ’A½(κ8€(™ÚµkG\œ]ŸÉ}4Ú5¦iç¹ÓY”R¥€@S —Öú'/‡)JIô¢X2M3hët¢dêÙ³'™™™Ì˜1#çKe€fÛ_)L®új­çø LQBH¢ÅU3dá€ÄÄDÚ´iÀO?ýÄáÇÏÞ¤ý…öWJ…_`¯]ß_ký/â%‡$zQ\up:Q2õìÙ“  û£uÚ´iymrÞ¿M¥Tð)p=0Xký¹/b%‹$zQ\I¢~§”ò̶߷oK–ä9wîʼ.³SJS€^ÀP­õ$_Æ*JIô¢ØqWÃkít¢äiÙ²%+VìIxÙÙyÖȉZæ|B)„]¿/p»ÖúC‡*JIô¢8jD8„(yn¼ñF²³³™>}ú…6õŒ8åHòý$/|@½(ŽdØ^ø]\\:Øz?ÿü3û÷ï¿ÐæÀ“ä'ý‘$/|DŠ‰ˆâ¨©Óˆ’§gÏž„††ðÙgŸ]ló&î$ÿ!p+0Dk=Á·Š’JŽèEqTÇéDÉ¢”⦛n`÷îÝ盄çU®\¹Ï±+åýS’¼ð%Iô¢XqÏf®æt¢diÕª•+Wà‹/¾8ß$<‚‚‚xúé§éܹso`Ì®¾&C÷â’†‡}äl`¦9û¤Çò¸¹€.—ËåƒÐjù*1*„·ôéÓ€ŒŒŒ N âÙgŸ¥k×®üúë¯ó´ÖSü£(¹$Ñ‹ 2 #»Ê\ݳn ^hû °Øàþw=ð»ËåÚWˆfeØ^øUbb"íÛÛÅîæ̙Ñ#GòÜ.((ˆçŸžÎ;óŸÿü‡¹sç®3fŒ?C%”$z‘‹ae«±Ët¶êù°»÷-WMzÃ0þ~tߺ\®ƒhS½ð«>}úl"}úé§yn̨Q£èر#÷ß??üðÈߪðIôÃ0c_ÞÓ h(g#â2÷í.@†±{=î].×ÅÖâ–Oá7!!!žIxëÖ­cõêÕyn3zôh®¾újî»ï>.\xú%ù[~!‰¾„2 £vrˆÜ•ºo÷»“þ$줿'íåÃSø͵×^K||<÷Ñ|hh(/½ôW\q÷Üs‹/ÎùrÓ4KY–uÂ?ÑŠ’J} bF0pðOà˜´Kݺu=·Zµjv¦ì·Öš={ö°jÕ*þøãV¯^ÍñãÇs6ÑŒ2 c>v±‘/].W–ûõZþz/BÜ|óÍ>|˜ï¿ÿ>×kááá¼úê«4mÚ”»ï¾›¥K—ž½{PXëXEÉ%‰¾0 # <ˆýÁâWÕ«W§÷7Ó½{wÔ¯¯}úöí Ø¥D—/_Îûï¿ÏŒ3ÈÈÈ8½I0ÐÙ}ÛjÆh`b¥J•b½ÿ„8Wݺuiܸ1`_RwòäIÏkŒ7Ž 0|øp~ÿý÷ó5#¯Âç”ÖÚ鄆 *ù³ïððpL¿þ©_¯ZÃÞýGÙºýÛwædF&YYÙdgk²²²)_ššÕ¨‘\–˜2¥òlóàÁƒLœ8‘÷ߟœóºRjoÅŠËûú½ ðì³ÏÒ½{w233éܹ3ÚsFK—.Í[o½EÍš5>|8–e]¨™ë,Ëší—€E‰%‰¾2 #¸û>ÑŸ}+¥èÝûFþûߧ9•Ä‹þbÙÊüµÃʼn§òÕFÙøÒ4oT…nêS¿N¹s^OIIá±Çcʔܗ Q¡B¯¼!.$>>ž¹sçʬY³x衇ˆŽŽfüøñT¬X‘;õë×_¬©¾–e}áó€E‰&‰¾˜1 ãjàM ¾¿ûnݺ ÿ7âßt).ÝÉÖm‡ Ýfµ*ñ\ß¹>]Ú×%22÷Þ?ýô#GŽdç΀=»¹\¹s¿ámÇgøðáôë×5kÖË»ï¾K||Iò‡\©<6j&O½8›#GÓsÅðÎ;ï0bÄ”rúòQtéÒÅsIݤI“HJJb„ 3hР‚$y°ËE áS2ë¾3 # øèèﾫT©Â'ŸL%=#Œ}Å‘”ô‹ïä?-ÚÌï«vñȽ×ЪY2`Ï xꩧ¨P¡o½õ2J%|iÀ€ìܹ“ 6ðÑG‘ššÊ°aø„å$Ñ Ÿ“#ú"Ê0ŒŽÀ*Hò­[·fÁ‚¬ÙpŸ™ã·$Ú±ã'xlÔ,¾_ðg®çï¸ãžþyBBäû«ðæÍ›S·n]f͚ń p¹\ <øR’<@”W"’è‹Ã0‚ Ãx»$¬ßOH8¯¾úŠßÿØÂ;“,Ÿ Õ_LVV6cÆ-àã/s_ŸÜ­[7F%ÃøÂ'ØsCúöíËŽ;:t()))—ÚdÞ×’ áE’è‹÷Jr €Çqàw7dÈ^}õU6mÙÉËï® FÈߟ²„qïÿ’+–Ó«ƒ áMUªT¡m[{ý¥ÐÐPÖ¬YÃ]wÝEZZZašMõJpB\€$ú"Â0ŒêÀ"ì•åü®eË–<ÿüóüý÷až»“'3#OÓ¿[Åïÿœë¹þýûsÛm·9(–n½õV‚‚ìÌ%K–0räÈ\Õð.Ññ‹o"DáH¢/ Ãh„äk:ѹrå˜8q"Zkž3—ÞAÈô™Ö9Ãøÿú׿èÖ­›C‰â$66–Þ½{°cÇFŽIf¦W¾ìóF#B\ˆ$úgF;`!àH%˜°°0&NœHbb"ŸN_ÁºYÞ¿ÞŸ²„Ù?œ™ §”â™gž¡yóæF%Šƒ'žx³øÒÈ‘#ÉÎöÚÜIôÂç$Ñ0Ã0nfeœŠáÉ'Ÿ¤yóæMI糬Ùƾù#Kßîy˜1c([¶¬ƒQ‰¢¬_¿~\sÍ5,\¸-[¶x³yº>'‰>@†Ñø w*†êÕ«3tèP>™¶‚´´Œ‹ìἬ¬lžó=›ÿúÛó\||èy]FFF–“áØž}GõÚ¼\Ï <˜«®ºÊ¡ˆDQ¡”âÑGå¶AƒØùÇ„EØÅëÞ{ï=_t'C÷Âç$ÑÃ0ªs€X§cyì±ÇPJ±{¯‹9?üyñТ¥ñéW+<•R<÷Üs²”­8¯àà`ž{î9zöìÁê™oaT® À¦M›øùçŸ/²÷% ÜÙ­¢ØD Ã0°“¼ãYèŠ+®àÚk¯໹ëÉ΀Ê8—èý)ÿÃZ·Çó8&&†1cÆìèY€ÂÃÃyõÕWéÐþjÖ~ûAAAD•­ À|à‹52€¿¼Ý¨g“D ÃPÀ$ ŽÓ±Ü}÷ÝœÌ8Ŭù뎦p²²²yúÅ9¹V¼3M“{î¹ÇÁ¨D ‰ŠŠbüøñ4¹¼k¿y™”}QµiÀ^¼föìÙ¾èv‹eYE뜘(’$цQÙ¥bÅŠtêÔ €~^OʱGTx‡§òÜ+ór•É½í¶ÛhݺµsA‰€Q¶lY>úè#ªU.ÇÚo^"Õµ—˜ò5‰©`קš0a‚7¯›Ïiƒ/âl’èfFkà9§ã8mРAžaísÖ;÷,ÿcS§Ÿ©œ§”bÔ¨Q$$$8•pZ¥J•˜ú{ñÅùÇ?þAZZšWÞpF… xëÍ7 Óéü9ã%2Ožÿ÷YµY‚‚CHMMõÇÑüA`¯;â4Iô~bF0ð˜Óqäåt¢?zô8+¬]ŽÅQ¡\ ýnlLëæÕˆ‹-]àýÃÃBhpYy\VÞóܡéü¹q?nÜÏÒß·³eÛßçì÷ú{?S¿N9ªV6¨Zµ*O<ñ=ôÐ¥¿á¨Fñúë¯qhë*¶üïsô*Û…GÅQî²+˜:uª?Žæ²,«è. !ŠIôþó ¶ÓAœÍ4MjÔ¨ÀâåÛYÀ¦l|iú÷6¹¡K#‚ƒƒ9xð 3gþÄ–-[ؼy³çß””‚‚‚PJyþŽŽ¦Q£F4iÒ„&MšÐ¨Q#bcÏ,þWš6-«Ó¦eu†¸‚»óã¢ÍüôëfþÚq°×¯ÿygl_ÂÃìÿ]»veÙ²eL›6Íï?Q8ݺu㩧þËÖÿ}Ë>kþE·¯Ò¤³çh~âĉ~ˆP†í…I¢÷÷¹ùGŽ#/×_½çþ¢ß¶ùµï˜2¥øG÷Ëè}CsvïÞÅ[o½Å¬Y³X¶lY¾k‹;vŒ={ö0kÖ,Àž]]½zuš4iB›6mhÛ¶-ÉÉÉží+WŒc`ßæ ìÛœí;]‰m;\¼þîÏüûîžmzè!V¯^ÍÆůxPq¤”âÿþï.n4ˆ ó>äÐ_«.ºOxéÊ×oØçæ=êë0A½ð3僥ÅY ø ði‰­Kµxñbê֭ˉôø!'32}Þgdd½ºTãæÞ­ùå—Ÿ;v,+W®ôz?†aI­Zµèܹ3;w¦jÕªyn»uû!fÎ]KÃzhweMÏóÛ¶mãæ›o–óõ.<<œçŸ{ŽVͳaî»?˜¿KDk¶íK¥Ë;pìØ1®»î:RRR|)»-˪äëN„ÈI½¹æW—;ËÙjÔ¨Á²eËøå[xâ…ï}Ú_xXÝ:V¢Ÿ6,Zô cÇŽeõêÕ>ë/""‚øøø\ÏÕ®]Û“ô«T©rÎ>'Of’™•MéÈ0Ïs3gÎäá‡öYœ¢pxó׉ ÏfËqêDj¾ö +C«ÏÊk¯½Æ|àãHxÛ²¬»üÑ‘§Éнïu$“<Øç¡Oûu©ogÛ›õ*ððÈvdœ<ÎÀ·²x±ïë…œ8q‚ììì\‹Ölܸ‘72nÜ8êÖ­Ë7ÞÈõ×_OéÒöä¿ððÂÏj§[·n,[¶ŒéÓ§û“‚¸$7ïFPp(äã?öa”¹LöWGBœ&×ÑûÞ@§8ŸÓçç³²²Y²l›Oú RÜvs ^y¶' æϦM›6~IòZkÒÓÓÏûúúõëyî¹çèر#Ï<óÌÏÅ?þøãžÁÂyJ)̸×^aç¯SÙ¹ì»%ùˆ˜Ê׳ÏÍ?Þ×5íOÛdYÖt$DN2tïC†a”ö¿VÌÇ’’’X·nJ)¬µ{ù¨÷V¢yì¾NԮϰaÃøöÛ^ïãbÂÃà ´æ|£FèÛ·/:u",,ìœ×üñG>øà,+ïêjÂ÷¢¢¢=êyêÕ®Ææyï‘žrî%“S¯óí$ÖjÆÎ;éÑ£™™¾Ÿ›:¡ ‰µšðÆoø+Ék`Š?:âlò)å[;lß±cGÏýßVn÷jÛõë”ãÕçz‘–vœN×vôLøsʥ̘?räãǧOŸ>œbFE`øe*$$„Í›7S¦LMãÆÛ>Ä[M/¯Ì³w%5-•í¯fçNçW ¡\¹r—¼ÇŽyùå—=# y9~ü8_}õü1{öì¹ä¾Ä¹âââxú©'1ÂNqdõ,²NûÅ+ßmUªÃå=ÿ…Öš²jÕůµ÷’¡–e½ï¯Î„È)à’P1Ò‡ýù6"Ïð IDATiÒ„2eÊ°låN¯%ùjUâyæá®+níK@$y€ÌÌL222.¾áy,X°àœK¯²³2ÉÒ•ˆR¡Ü{ïH–.]ê•v½¥°k‹¿ñƹ® !#õ[~ý’ô£gÖµ ¢S§NLž|À½€MÀ^‹u:Ñk­Yî…D¯”âñû;S¡\ ãÆcêÔ©…nÓÛÒÒÒ 5é*;;›|0×°|¤QžØÊuùíã'Y3ëŽîÍŒržÇ8p œÇϧ6­¯`ʇïP6m=û–M/ÔQüiaÑTin_N:~üxþþ»à“ø.Q&ð‚¿:"/rŽÞ Ãh8;í©i—väU:œw_þå“ÊðÐCñî»ïz9RßPJQ®\9¯I¿ð ¹Ö 8uâ8¿þ'ÎSÄ%¶bm*6lGÙêPgMÐËÌÌdÁ‚|ûí·,^¼ØŸG~NÏ7pç°¡pâÛ—Î e¿o.1¯Ü¤35Z÷bïÞ½ôîÝ›ÔÔü-xã¸Ü²,ß­Ú$D>I¢÷2Ã0j¹€y¹råX·nnØÅ]~}Émýçî\wM=/^ 7\_ :ãN‹ŠŠ"66¶Ð턇‡3aÂ4hày.íð>VNË©çÝ°×@oK…úm +sÎë)))ÌŸ?ŸÙ³góÛo¿ôé‚HLL¤¿~ôí{'\»Ù±l¦×às*m”§qßG åÎ;ïôÛ nßX–ÕÓŸ q>²z÷Õu:€óiӦ羵nÿ%·Ó¬Q®»¦iééŒqw‘Jò`Ÿ«ŽŽ.ôQýÉ“'9r$S§N%11€È¸r˜=îaÕW/“™‘÷B)'S²í·ïؾü{ª7"©n+Œ*õPAv;G^V¬XArr2YÙÙtïÿ>ié??ïWÓ㺆ErÈþl „‡Ÿ½úü¥iØ°!ï½÷‘‘‘žç\;Ö²ú»·ÐÙ›éV:†ÄšMI¬Ýœ2IÕòÜ&;;›õë׳bÅ ÏÍårê=Fpp0M›6¥]»vtìОò*rp÷Vüù+®-¿{åZøü*mT IßGPAA 2„ßÿÝo}:–eög§B\ˆ$z/3 cÐÚé8ÎV¹reOÉÏ?7ìà® ¾šœY¿¯>Û›ôé´mÓ†¿þ*Úkt„††’˜˜xÁöÑ¢E Þ|óÍ\_nþus>@ëK;Ï^ªLYk5#¾j¢“’ >ÿÙ¶mÛ¶y’¾eYìÝ»7Ïy +,,Œ*UªP­Z5ªU«FýËêÒ²U+"#KsdÿvŽì\Ëß[ÿàøAÿ—@ ¡a¯ˆ+—Ì믿Îûïû½¼ü?-ËúÈß q!rŽÞûòý•W^鹿f}ÁÏχ‡…ðŸ»;¢<ýÔSE>Éœ:uŠãÇí•ö~ûí7xà^yåBBìÿZ 5›R;ã$~˜Œ=»`N¤üÍŽßg³ã÷Ù‡”Ll…ZÄT¨EL¹ê‡•òl›œœLrr2½{÷ö“’’Bdd¤× ×,\¸Gy„^xÁ“ Ë×kMpH(ëL$;«ex³29ºg3G÷l¾G© ¢*S¾±kQ&©Ú9³øccc‰¥nÝÂÿÔZsüÈAïü“´Ã{9¼cGvo,Ô{ò¦„šM¨ty{öïßNQ#?Èî²,K†HEÀ‘Dï]ç^+ r&úÕë V¯n­Dnê~9ÙÙÙ<ðÀýÅær/°“ב#Gˆ÷Z›³gÏ&22’'Ÿ|ÒsZ ±vs£âX3ëmNðεÜZgsìÀŽØÁ®U  %<*–RÑáQáÑ¥¢â6Š£T´APH:;˾él÷ýì3Ïeg“‘~Œô#H;²Ÿô#ûI;¼Ÿô£&©Ÿ-"&Úí••ÅþóŽ9âï^“kæE ’Dï]Þö2Ã0¨Uˮڶk÷΢QJ1rX;”RLž<™•+Wú*LǤ§§sâÄ J•*uñóiúô餥¥ñì³Ï@L…š4¾ñ?¬þvéç)ªSXÙY§H?z0׊zÅ]Ppõº %4<‚^xÁ‰¿ÑÀýÝ©ù%%p½+ }Ë–-=G–ÖÚ‚Mêvm=êÖJäðá#<ýtñ½4ØårºþÙfϞͰaÃ8zôÌyëȸ$šôyð¼³éEÁÕlÛ‡è„*Lž<™O>ùÄßÝgý,Ë üúϢĒDï]™èsŸß”ÿ«~¢£J1tÀ<óÌÓŽ^¾åkÙÙÙ>y+V¬`À€ìÞ½Ûó\hD4zÝGBÆ^ﯤ©h¶§Bƒ«Y°`>/½ô’!@DLÉ[½®0¢«R·ÓvîÜɈ#|R/à"vd–½( $Ñ{WÀMnlÔ¨‘g2غõ;òuÉ‘Rv¼ ¥˜2e +V¬ðu˜ÅçëNœ8Á½÷ÞËøñãs}q*S®:Ín~ŒòõÚ\`oqZ©hƒz]ïâØñ4†îÄ û,à˲|3£R/“Dï]7!§iÓ¦žûë7çïúùn×Ö§n­$RRRŠõ¼óñÕùúÓm¿ùæ› 4ˆ;ÏLŒ  §N‡[iÐm8¡700BK•¦îuÿGPh)î¾ûî\?C?zÒ²¬_œèXˆK!‰Þ»Ž9ÀÙš5k湿aËÅ|¢£Â=ð^}õU*xqâàäÉ“¹fË{ÛªU«èÓ§Ó¦MËõ|Ùj—Óü–ljOnè³¾‹ªÐR¥¹¬Û£ FŒÁêÕŽ\¶þ 0ʉŽ…¸T’è½+ ýºû.ºý€>Í)]Š={öðÎ;ïø2´€wìØ1Žóݯ4--§žzŠ#FäA‹,CÃëÿË®ý'áy¬W_…–*Íe×ßChT<Æ ãÿûŸaü ÜlYVɘ°"Š IôÞP‰>11‘J•*°{ÏAŽM¿àöåËг«}$ùüóÏûdRZQsôèQŸ/»páBz÷îÍÂ… s=ŸT§%-n}šªÍ®#(8Ô§1²ÐRQÔ»~$*,šÁƒ{gò³U@w˲ä?…(r$Ñ{W@%ú\Góv_`KÛþ- fíÚµ|ú駾 ­Hq¹\>ÿÒãr¹1b=ôœ¹284œj­zÐâÖ§H¨Ùô-O¡¥¢¨ÃH2cà AlØ°Á‰0¶],ËrvÅ!.‘$zï ØD¿é¯ _^«F¯ªÀ“O>Yb.§Ë¯C‡‘‘‘áó~fÍšÅõ×_ϻﾛ뒱RÑõ» ¥qïˆN¨âó8Ai£< {ÞÇö½‡è׿?Û·ow"Œý@g˲.~ÞKˆ%‰Þ»¾ÏùÔ¸ñ™Êk·\xR݃®D){ù‡~ðuhEŽÖš¿ÿþ›S§Nù¼¯'NðÆoУGæÍ›—뵘 5iÒ÷aêtH©2e}‹S*ÔoK“>3gÁÏüsð`t¤v peY›è\oQ~^ʱØ3 c-PÏé8¶nÝJll,Zk®ï÷iéyiѤ £ŸèŽÖšvíÚ95›¹H&!!Á³Þ¼?4kÖŒ|:uêäz^ëll\ÎŽsH=tñS3EAHx$uÚßJ\•ú<óÌÓ|õÍ·N…r ¸Á²¬…ÝRˆp^Šõ@¢ONN&66€m;öŸ7É+¥¸cà•|þùç’ä/"++‹P¶lYO!"_[¾|9ÿøÇ?èÝ»7C‡¥|ùò(DR$ÕiΡmkØñûlŽîÝâ—˜|!¦| ê^;˜”ÔÜܯ?7nt*”ØGò%«R”(¶$Ñ{ßz§ÿ°g§öu¨žOff/¼ð‚?B+ò²³³9xð ñññ^]Úöb}~ùå—|ýõ×tëÖ!C†œœì~UŸÜøä†Ù³‰ËgãÚ±Ö/qyCHx$Ušv¡BÃv|üñǼùÖÛN^ññÐI†ëEq"‰Þû"Ñ7jÔÈsÓ¶¼ 儆3¸Ÿ½àÍ—_~áÔd§"IkÍ¡C‡ˆ‹‹#22ÒoýfffòÍ7ßðí·ßÒ±cGn¿ýv.»ì2Ïë±jÛ½©‡ö°ÃRl^Ή”À,zFE³=•›tbóæÍôéû¶lqtDböìz™x'ŠIôÞçÈõ?gË™è7lÎ{ź®/#±lÙÙÙ¼üòËþ ­ØÐZãr¹ÈÎÎ&**ʯ}ggg3oÞ<æ͛ǕW^ÉСCiÒ¤‰çõÒñ¨ÞºÕ[÷"eßVlZÎMËÉHóþê|¥‚‚)_¯ Uš]G–V~g‰ Ñ|õÕW 2Ä¡H‹‡èèhbbœ­b×°aCn¸á:uê„aç¼®µæÈîØ´Œ¿·®âTº¯ Š#©NKÊÖiMpXŸñ%~ø¡OK çÓt ŸeY~_ODï†a¬L§ú¯R¥ üñ;wýÍÀ»Ï-~Óõšzüûîh­iÛ¶-ëÖ­ów˜ÅNDDqqq9{ÕjPP­Zµ¢k×®tèÐá¼£ i‡÷stïRömæèÞ­¤öþˆuph8e«7"±N+ŒÊuÙ¹c;“&OaÆŒPy1 x xNÊÚŠâL†î}ãGLô¦y¦ë-ÛÎ]…-88ˆ[ûØÅtfÍš%IÞKÒÓÓÉÈÈ >>Þo3òó’ÍâÅ‹Y¼x1ááá´mÛ–®]»Ò¶m[ÂÃÃ=ÛEÆ%—Dùz­8u"•”½[8ºÏNúi)œJK!#-…¬Ì‹—‡PAA„ED˜L©²U‰(›LB儆†±xÑ"&??œ%K–äk©d?؃}/—ωbO½oüŒtªó xîoÎ#Ñw¼ª6å“ÊðÒK/ù-®’àôåw111DGGk>…sòäIæÏŸÏüùó £~ýú4iÒ„ÆÓ¸qc¢£Ï,‰Zª4ñÕLâ«û53ã„'égf¤NHXÁa¥ì[h8Á!g¾Ü¸\.–/_βO¿bñâÅN-'{>s€–e9R…G“Dï lª<Ø°á™%N7ÿ•û³L)Å­7Ù5Ó,XàâÞuôèQÑ/$$ä Þéx222X¹r%+W®ì!þš5kÒ¸qcš6mJrr2IIIÄÆÆ¢Tîï'!a¥ +EDlbžm>|˜å˲lÙ2–-[æôìùóÉ^°,+ †„ð9Gï#†aü4¹è†>`Y–gÕº›Oà+ÕóZǶµyìþNtéÒ…ß~û͉K‚?\.WcÓ4+ŸW:P~…„„@bb¢çßÈÈHŽ?îYº÷رc¤¤¤x_xeÄ° ¸Å²¬_D“#zßù}ll¬'É>’š+É+…çÜü²eË$ÉûÖ–eí2Mójà.à à˜ÏÌÌdïÞ½ìÝ»×éP¼! xxLVŸ%•,jã;3œè4ç°ýÖí¹ÏÏ_Ù¢:ÉUìË®Þ~ûm¿ÆU}súŽeYY–eêŸ8R‰³hnYÖIò¢$“Dï;¿ÛüÝiΉx[¶ýëµ>Ýí":»wïæ»ï¾ók\%Ì6ìß.–eí³,«?Щ XL¹€aÀ–e­t:!œ&‰ÞG\.—&û»ß܉þLéÓšÕÊbÖ¯À{ï½Gff¦¿C+I&»ÿy²,ëGàrà ÍoQø¨mYÖ{2áN›$zßò{¢Ï5tŸãˆþ¦ì£ùôôt&Mšäï°Jš‹þÞ-ËÊ°,köJ‡¾_è¾x›}»eYYÜ_‡H¢÷!—˵ Xâ¯þBCC=k–gee³mçabc"èжS§NåÈ‘¼¹^±Äý{Ï˲¶[–u;Püôõ¢i@S˲®³,k©Ó ˆ$ÑûžßŸëÔ©Chh(;v&33 €×5$44­5ï¼óŽ¿Â)©.é÷mYÖN˲î’Y\åü2±GMê[–u“¬/Ä…I¢÷½©€_füæ:?ÿ—=lL.öó ,`ófYfÛ‡R°ߗ̲¬–e= TÅ.îò÷Ev)INï`ŸƒhYÖŸN$DQ ‰ÞÇ\.×Qà ô•óüüé‰xÚÖ".Ö^/}üøñþ£${Óýû.4˲ŽX–õ,P ¸ ûr½’z10(oYÖp˲þr: !Š)˜ã¯÷¥}ÙI®÷î#ú›®¿€;wòã?ú²û’. û÷ìUî¥S§ÓLÓŒn-½ÝW€Ù L&[–%ÃPB‚$z?p¹\‡ ÃxxÀ—ýœ]ãþ²ÚIÔª‘ÀäÉ“ÉΖ•8}è]—ËåÓERܳÉßÞ4M³6v¿¨éË~ýèöÚð“€EryœÞ!µîýÄ0Œ$à/ Âíç\ƒþÐáTnúçþsw®»¦YYY˜¦Y\Jš¢  ºËåÚíDç¦iVÅ.ÂÓhTt"ŽKüŒ].øG`•$w!¼OŽèýÄårí7 ã}`„/ÚÏ}4ÿ7‘‘a´oc_R7wî\Iò¾õ‘SIìKô€ îî£ýÓI¿=àTlgIq&±/·,+ËÙ„(þ$Ñû×sØí±Þn8×D¼¿þæš«jSª”}©Èñ©cÀÓN‘“eYØ3Ô1M3 ¨ã¾ÕÍq¿ìƒö`—øÝpÖm»eYrþH?“DïGî£úÇðÁ,|Ó4=÷7m=H¿Þöšó{öìaþüùÞîNœñ¤“GóùaYÖ~`?ö0¹‡išaØ…z’2@4åþ÷ìûÁØ_jŽÇÏs°Á²¬ã¾~OBˆü“Dïoÿšz³Ñœ‰>33Û3 oÊ”)deÉ訬^w:ˆKeYVð§û&„(¦ä:z?s¹\ÙØk“{m³lÙ²T¨`/X“–žA‹&UÈÎÎfÊ”)ÞêFä¦;].—|‹B4Iôp¹\¿ïy«½ÜkТãUµ»Þ®]»¼ÕÈí=—Ëõ?§ƒBˆ‹‘D}Þh(ç°}FF‘aLœ8ÑÍ‹síÃþý !DÀ“Dï—Ëu臆ðs&ú åÊ°oß>æÌ™SئŹ²~.—Ëåt ¢lµ•RuÝ·ZNÇ$Dq¦”ŠUJ}¤”jît,g“Éxr¹\?†ñ ðdaÚÉ™èË%Ú‰~òäÉ—4 ¯fÍš´lÙ’'NðÛo¿±sçÎ|íDƒ hÑ¢ûöícõêÕlß¾€°°0222 ‹/„††’™™I! E=ãr¹|^KX)• ”Êã¥ÃZëýùhâ à}ì/óA@9ì™õ>¥” ÑZgúºŸÂPJÅIy¼´Wkí—¨Äù)¥‚µÖ~Ÿûâ…¿ÝH`0X樼C*ã9Ì0Œ `>va“‹ŠŠbûöí(¥ÈÊÎ&8(ˆììl7nœï$ P­Z5&MšDpp0‹-"<<œÖ­[³wï^† Âλïƒ>HÿþýÙ´ikÖ¬Á4MZ·nÍìÙ³yùå—yì±Çèӧϥ¼=¯»çž{رc_ýõ¥ìþ#p{B¥Ï(¥*`X”óO"ŒFi­SóÑ^4°[kíÓD¯”ª¼£µ¾Á—ý–Rêmì…‚¹W¬ì&c´ÖrÍ¿”R÷´Ö~›I¬”ê Ô×Z?Sˆ6’°¯ÄªµþÖkÁyÑ;Ìåre†ÑøûC¼@LÓD)€ÂþwÁ‚JòÍš5còäÉ<úè£LŸ>=×kC‡eþüùôéÓ‡ 6œ³ïÓO?M‹-¸îºëؽûÌåä¥K—¦{÷î|÷Ýw5!°lÙ²¤¥¥]Ê®€þ¾NòZë=@c¥ÔP ¹ÖzØé×”R!@gàvà;¥Ô5Nýœ‡½¼n@ÓZWJíµ֟~^)\‰½&E¥T­uºSq–`åðM!§‹õY®0 ¸GÚ Õ†¯È9úàr¹ö·b©H£F<÷ƒ‚ìD?a„|ïÂk¯½Æˆ#ÎIòï½÷£Gf̘1ç¼Ö©S':wîL÷îÝs%y€ÔÔT¦NÊsÏ=—ïXXp«û÷ä(­u¦Öz&Ð{}öA‡Tlh­Oj­zb¯_ .E± GôÂårÍ3 cðAAöË™èvíÚÅܹsó½¿~ýرcÇ«çM:•aÆѥKfÏžíyþÎ;ïäþûï¿àù÷©S§êyÂOêÔ©Ãå—_NZZÍ›çž/“™™É¨Q£Î7ú0ÌårÍSJc×@è4Äöý§µ^•s¥T;à6ìÒ¯³€±+Ð}©µ~D)U Ô>^/Èùa­µVJMÁ>ºÿ0¿ûå—Rª+v¹æFØCÜ«€Ï´Öç|TJµq@e¥ÔGy4ù½Öú³|ô Á>2¯µÎ÷ДRªv1ªÀ'úÏKj­3”Rÿ¬WJ×ZŸSùPÙÃhC€nÀåØ ôü}êâ‚—]ºßã¿€6@àvÑ¢W€½@¤ÖúO÷¶1À³ØÕ —i­ßÌÑN0ð_ ²û©7´ÖËݯÕNc¯zØ øûo8 ´¾^ÖZoÏ#Ö`àà:w¬©À:`òù†§•Rc—Xž,žr¿×$`50ZkýKû=\æŽ3])Uÿ¬M2gµÖÛÎÓ¯z¹c=]âÙ¾¾ÑZŸóE])5hëÞ>.¿]ýsåyú Æ.s!© Zë…ymŸÇþ À€@u`öÏlŒÖúpÛ·Åþ»Û¦µþ¯RêVàÀÄ®Lù9öçQ®e9¢ .—ëCà¡‚ìÓ¸qã\'NœX åh¯¿þzÞxãÂy³³³yë­·èÖ­›ç¹˜˜Z´hÁ’%K.¸ïÑ£G7nœçqff&3gÎdÕªUtèÐáœíçÏŸÏÌ™3‰ŽŽ¦Fy¶Y§N~øáyùå—©_¿>C† aÕªU,^¼˜§Ÿ>·ôü¼yó˜9s&[·neÍš5ΟÎIDATÌœ93×í»ï¾cÿþ<ç¸=är¹>TJU–×ã°×ƒ¿ X ÌvHå´Ø ¾À^zµp¥Rêìsð3€@c`äù~†œóaPJ©¥ÔDì/&Ó®@ì÷ð”Rê ÷wNŸ€åØ%qÊãöG>C¸ûçû(ø£” ÂþyÞ‡`º]x s'½µØCùg÷U{¾Æ-À»îmn~¾TJº@œ—ciª„ýE¯p7öÚ°Ë÷˱K öÏï8gÍãqŸ²Yè~½>öÉÓö¸Ûº ˜ƒý»éŒ}ÕÈGÀ\ì¿Ï.À ò¨ð¨”ªŒ=©¬ öïä ì¿×¯ç•R“݉îl¿`'¾k°¿äîÅþÒØÕýÞ¿rŸÏk¿Ÿ€ÀVòþ;ºÐ%É-°v`Éi‚ý3®Xî/?g[ænw°û<}n;_‡îßAÎm“ÚˆÑC)ÕÅkv²oŒý¥,X­”º:Ý6a¯‚ÚC)5{ôéyì÷þ.ÐøB>Ÿë&GôÆår6 #ûë‚âââ¨^½ºçñ©S§˜üüóÏ<þ¸çô*k×®eíÚµ¤§§sçwž³ÏêÕ«Y½z5Íš5cÇŽ̘1#?¡¾ìr¹F»ÿÓL¾ÖZ?ŸãõýÀ¥Ô4`‘RjµÖz€Öz¯Rê;ì/nNÃWJ= ,zi­g¸Ÿû7ö‡q¾ÇQJ•Ãþrp[~÷ɧG±Ïµ7ÑZŸÌñü6¥Ô àSàì&Àsnr¢Rª!ÐWkýQ!ú×繟Ÿýrnï¹ß`­~Öóïb'ˆÿä5Ø ü©”šü¤”Z£µþ8çNî/HŸÿrŸ~9íð³RêEà€çCÚÝþ4÷çö-g¨µžïn»ÛYϧ»G|>>8= ”zÀë³ZëçÜÏ=ìTJÅk­¹ŸSØ“?×Z¿pV·[”RŸc)߇ý¥0gß¿*¥Ö÷ÎáxT)u{”búYû-+¥ê úw¤µ^Š=É2§ƒØ?ÛJØ_º÷ÿÃÿ µÖ9ßïîÏœí؉ÿÿÛ;÷ઊ;Ž¶„£ ÄÂÐŽ!ƈ¼Lš€Š"Lk!…¡¤â€-EDiëL >ÆÖ2ŒhµåQ¦ òÐ ÔÀ0¶B)T)Akx…g Jщ¥F„†dûÇoorsrνy\Èk?3wîÙ={ι›óÝÝßcw„Ø}ód",IKK«rÄxë­·"zÇ{ILL¤cÇŽ|öÙgQË“”TŠ@YYÓì]râÄ ºtéBÇŽk[½z5cÇŽE3+ß` òòõ©i­?AwÏáže¼" ($ò†“;b^¦”êö©”z ™mÎ×Zÿ»®7 ãíÿ0Ñ#ò€,i#N€ã•R7xLjEÀCÈ̦ÎþF‡#³›ÑÈrtc9çwQJ}Y~ÊÏ4 µv›¹>³Ý‡€|ȇ×-Cî»®«uáëðå~#äg€9aß•#‚xUX½aˆ Á+ò¡:ÙóSJ©+Ú~.ÀŒ± H X ¸X¼ ô¼„íEcb.ÙéwÐ Vz}ŸÉ t¯CVxª°3úfˆëºÚqœ‰H\fVP9¯9''§^íœ;wŽ¸¸88wî\IJŽãÔXÚ.//'!Á/Ìûâ³jÕ*’’’زe EEE8p€üü|¶oßÎÙ³gë5Ø à `¢ëº¡ùÀšH6_­õv¥T¼Rª›þX‘…˜ @f¬%ˆó.­õ¡¶0xWk]T@kí*¥¶ ¦‹â·`,m`ݣȊD¬hxC4îþ)ÞZk}@)õ)b÷=vè6DpÑZÿ½×k > £¢”+BDe‡Ï±/ý*h­¿2åw¼1(¥n@ìÝW!}ô(Ð=Öm5’AÈ .9§Jÿ*Bøçx´ÝÎè›)®ë^@ì-/•0`@Õ¿Ïœ9æM›‚ŠúRYYɇ~h '99™ÂÂêMÎŽ9BJJ íÚ]ê(¨¨¨`ÆŒddd0sæLJKK«–ósrrj €êÉËÀ}æù‡¸±Eã0ë t+µÖÝ̧»Ö:]kýó‹ ò ×^—û,$ö÷Ù¹ð>çÆ<£ÄŸ¡%Ð qðúi”Ï)ĦÜäß—íˆéad…í?ÈõõŽPõ’¢”ŠG'£-$F«vFߌ11ÛSÇùx&üX||<éééUÿ_·n.Ô?©ÓÖ­[9r$Ë5Š;«W™ÊÊÊøè£èß¿?»wï®w»±@kMaa!………,]*“À¡C‡²fÍÈéÓõŽ†›éº®ßRY!pâÀ‰döÐR)D¼Ö£‘‚,¶Z̲òPj;†úB4R»pN /îX.Í_,vÿÓZÿ¢©/¤.(¥&"+&=ý¢W”RÇ‘™~“c¢:JP¤U±˜ 팾`Äg*aF]ºtaÛ¶m;vŒ©S§2mÚ´àDॗ^bÊ”)tï¼²Õ«W/î¾ûn^y¥æ;oöìÙ¼ð ÄÅE/feeÑ¡CMGíÊÊÊaw^:wîìû}bb"Ó§O¬·eË HMM ,ãqHy®SDijy\$›¢Rj²œÖh»A²¸Íd¸óÅ„ E"¼hbðNQJ]§”J^²V½vJ©;Í56–©À ­õÏ÷Û€1>‘á×q+âÐè}IçÁV߯ŸUybVÛa¥qlF(IÜÔwY807Bˆj]VbnJˆÀ6$!ãM¹Fc…¾…àºîB`,ð ÀéÓ§™?>$''‡òòò÷Ô©SÌ›7U«VÑ£Gí÷{RRÙÙÙ̘1£VF¹µk×rôèQæÏŸÏWÔöÇIHH`ñâÅdffÖŠµ/))¡OŸ>\{mÍDjñññ<ÿüóŒ7?ºwïÎO_rŸ#vo¿ò“{‰Öæp¥”ïì#FƒÇpž&+¥†´7 {6Ù\÷- ÇqnAÂ}RbyÞ§Ÿ~šñãdztéRòòòˆgÀ€L˜0'Ÿ|207|\\Ó§OgôèѬX±‚={öPYYIZZYYYœ}ú°`ÁJKKIOO'33“Í›7Ó©S'zöìIvv6ëׯ¯ªsÝu×ñöÛoóñdzk×.òóó),,$))‰ŒŒ 233Y²d sæÌ©ÕȦ6Û¶mcÿþýlڴ鳕+W>|þüùnÈKb’Xcª·žy™½ŽÌª"ñÀ];‘8èßi­—…•¿ /º˜ ¼¤µ.7ƒ‚}H|ïB­u™y¹”!áu‹¸ÚG‘øìHÈŒùu­uD±ñˆOõ %ø 5£*€%^ÇA>aÊï6í¦!!u›€_逴»J©Wç¬Åˆ}4Å<£AæÙÒZŸˆpíÏRíP·_kÝ/¨¬§^št¥ùêgA¡RJ©ÑT' ÏÈt pW~Ÿ;¿úW"yº#ÏjÐY:þ5ð'­õÜ€ºýœ»‘PÅÈ=¼7ðdã¡aÞä.f€™‹8¾ˆô‘AÈà Š$Ç™oÂÛ®¦ –HÿûÂœ«ù}…lJ©ƒæY,ÔZ1ß} øÅ0Û\³‹8ÞjÎ ýÚÔ¹Ü<ÛшøþI|TiŽw1õfšÏ"íÙ¤É –ö˜ºk?€;¨þý§ÖzŠ§N/Ä>¿XožS:2`(CúícÀjà¯Zëãžú‰È*Õó»ENC}·žˆÆü&“©éè7Â\o~Øwùž(›PýAH?Ú€˜ÂŠÌ³ÍBúÒýÞD=Æ9ò‡æ¾!ÉyN†Ÿ€¼wN#}aX¡o‘8Žs9"6¾3ƒ†’œœÌ¬Y³n¿ývúõëÇÁƒÉÍÍ­Q/))‰’’&NœHjj*×_=gÎœáƒ>`ùòåQý ”RŒ5êȆ Š?ùä“ÈwðŽÖú½(uÇS33Þ^`ödë23ÊPR—j¡ï„ˆÁYª…þ[ˆF95…Þ;“j¨Ðûá+ôa縱i†2ãírt”Œ_fÐ2 ÏŒ$8)@2”åhOÆ.Ÿúßæ!â÷Œ–”´uB)õòlóÇ´Ö¾›¡¿ÅçÐ)`'p(h ãsžPf¼3È3z9$”ê]†ˆNâèYŠÌØßþÝa–шÏSÀj­õ^¥Ôd€µÙý·j‡ô§p¡ŸŽô­WÄþd ³Ú{ýÆê 2ÈÍò¼áaaB¹ùêSü…¾=Ò{…Þ”»øÒnD|##£ï<Ÿ›€éÈïqÁ\ã[ZëµJ©dP¤ñzSÿJÄ0ÌÜëq¤ï¾¯M~ Oy?¡÷ÃWèÍ9:"ÂÊŒw p,Ð>û,¡ ~5þB }}Ï }+ÀqœÁOŒÅù&L˜ÀÌ™3Y¶l{÷¸˜¢¢"Ο?ÏÕW_MïÞ½SÒ¶ κ®»¼©/Äb±X.ÖFß‚1b•†,s5ŠÇœyóæQQQAFF÷Þ{/ÙÙÙ“››K^^]»ÆÚLuÉÙ¤Y‘·X,m ;£o˜=íF²-5ÈK¶sçδoßžÒÒš¹R:uêD=8vìXƒÒÝ6¾D쾋.Å6³‹ÅÒœ°Bߊp§+â¨ó —6T¤9³˜æºnK{³X,–c…¾â8ÎíHV¨¾M}-MÈ!$6>7jI‹ÅbiÅX}+ÄuÝ÷ð—шWx[b?¦Ô׊¼Åb±Ø}›ÀqœáˆºN[(¶PÞžs]w}Ô’‹ÅÒ†°B߆pg0²óh«9•Hþù]×mñq‹År1°Bßq§²göx<û· '»•®ëžjꋱX,–æŒú6Žã8©H†½û‘”®Í•Rdæ×\×mtÞ‹Åbi+X¡·U±øý‘ô¥CüΗG¬tqùxxÙIk¯·X,–úc…Þâ‹ã8í‘üËC€ï!ù¦o@rTÇš ÈŽeÇ€]ˆ¸ïp]·a[òY,‹¥ +ô–:ã8N"ö7"»,%!›\tôù\†lû•ÏÇ>@„ý(Pìºî…Ky/‹ÅÒV°Bo±X,K+¦5„XY,‹Åb àÿ@<è8lw=ñIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisRect.html0000644000175000017500000043505114030601040024645 0ustar rusconirusconi QCPAxisRect Class Reference
Public Functions | Protected Functions
QCPAxisRect Class Reference

Holds multiple axes and arranges them in a rectangular shape. More...

Inheritance diagram for QCPAxisRect:
Inheritance graph

Public Functions

 QCPAxisRect (QCustomPlot *parentPlot, bool setupDefaultAxes=true)
 
QPixmap background () const
 
QBrush backgroundBrush () const
 
bool backgroundScaled () const
 
Qt::AspectRatioMode backgroundScaledMode () const
 
Qt::Orientations rangeDrag () const
 
Qt::Orientations rangeZoom () const
 
QCPAxis * rangeDragAxis (Qt::Orientation orientation)
 
QCPAxis * rangeZoomAxis (Qt::Orientation orientation)
 
QList< QCPAxis * > rangeDragAxes (Qt::Orientation orientation)
 
QList< QCPAxis * > rangeZoomAxes (Qt::Orientation orientation)
 
double rangeZoomFactor (Qt::Orientation orientation)
 
void setBackground (const QPixmap &pm)
 
void setBackground (const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding)
 
void setBackground (const QBrush &brush)
 
void setBackgroundScaled (bool scaled)
 
void setBackgroundScaledMode (Qt::AspectRatioMode mode)
 
void setRangeDrag (Qt::Orientations orientations)
 
void setRangeZoom (Qt::Orientations orientations)
 
void setRangeDragAxes (QCPAxis *horizontal, QCPAxis *vertical)
 
void setRangeDragAxes (QList< QCPAxis *> axes)
 
void setRangeDragAxes (QList< QCPAxis *> horizontal, QList< QCPAxis *> vertical)
 
void setRangeZoomAxes (QCPAxis *horizontal, QCPAxis *vertical)
 
void setRangeZoomAxes (QList< QCPAxis *> axes)
 
void setRangeZoomAxes (QList< QCPAxis *> horizontal, QList< QCPAxis *> vertical)
 
void setRangeZoomFactor (double horizontalFactor, double verticalFactor)
 
void setRangeZoomFactor (double factor)
 
int axisCount (QCPAxis::AxisType type) const
 
QCPAxis * axis (QCPAxis::AxisType type, int index=0) const
 
QList< QCPAxis * > axes (QCPAxis::AxisTypes types) const
 
QList< QCPAxis * > axes () const
 
QCPAxis * addAxis (QCPAxis::AxisType type, QCPAxis *axis=nullptr)
 
QList< QCPAxis * > addAxes (QCPAxis::AxisTypes types)
 
bool removeAxis (QCPAxis *axis)
 
QCPLayoutInset * insetLayout () const
 
void zoom (const QRectF &pixelRect)
 
void zoom (const QRectF &pixelRect, const QList< QCPAxis *> &affectedAxes)
 
void setupFullAxesBox (bool connectRanges=false)
 
QList< QCPAbstractPlottable * > plottables () const
 
QList< QCPGraph * > graphs () const
 
QList< QCPAbstractItem * > items () const
 
int left () const
 
int right () const
 
int top () const
 
int bottom () const
 
int width () const
 
int height () const
 
QSize size () const
 
QPoint topLeft () const
 
QPoint topRight () const
 
QPoint bottomLeft () const
 
QPoint bottomRight () const
 
QPoint center () const
 
virtual void update (UpdatePhase phase)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void wheelEvent (QWheelEvent *event)
 
void drawBackground (QCPPainter *painter)
 
void updateAxesOffset (QCPAxis::AxisType type)
 
- Protected Functions inherited from QCPLayoutElement
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

Holds multiple axes and arranges them in a rectangular shape.

This class represents an axis rect, a rectangular area that is bounded on all sides with an arbitrary number of axes.

Initially QCustomPlot has one axis rect, accessible via QCustomPlot::axisRect(). However, the layout system allows to have multiple axis rects, e.g. arranged in a grid layout (QCustomPlot::plotLayout).

By default, QCPAxisRect comes with four axes, at bottom, top, left and right. They can be accessed via axis by providing the respective axis type (QCPAxis::AxisType) and index. If you need all axes in the axis rect, use axes. The top and right axes are set to be invisible initially (QCPAxis::setVisible). To add more axes to a side, use addAxis or addAxes. To remove an axis, use removeAxis.

The axis rect layerable itself only draws a background pixmap or color, if specified (setBackground). It is placed on the "background" layer initially (see QCPLayer for an explanation of the QCustomPlot layer system). The axes that are held by the axis rect can be placed on other layers, independently of the axis rect.

Every axis rect has a child layout of type QCPLayoutInset. It is accessible via insetLayout and can be used to have other layout elements (or even other layouts with multiple elements) hovering inside the axis rect.

If an axis rect is clicked and dragged, it processes this by moving certain axis ranges. The behaviour can be controlled with setRangeDrag and setRangeDragAxes. If the mouse wheel is scrolled while the cursor is on the axis rect, certain axes are scaled. This is controllable via setRangeZoom, setRangeZoomAxes and setRangeZoomFactor. These interactions are only enabled if QCustomPlot::setInteractions contains QCP::iRangeDrag and QCP::iRangeZoom.

AxisRectSpacingOverview.png
Overview of the spacings and paddings that define the geometry of an axis. The dashed line on the far left indicates the viewport/widget border.

Constructor & Destructor Documentation

§ QCPAxisRect()

QCPAxisRect::QCPAxisRect ( QCustomPlot *  parentPlot,
bool  setupDefaultAxes = true 
)
explicit

Creates a QCPAxisRect instance and sets default values. An axis is added for each of the four sides, the top and right axes are set invisible initially.

Member Function Documentation

§ rangeDragAxis()

QCPAxis * QCPAxisRect::rangeDragAxis ( Qt::Orientation  orientation)

Returns the range drag axis of the orientation provided. If multiple axes were set, returns the first one (use rangeDragAxes to retrieve a list with all set axes).

See also
setRangeDragAxes

§ rangeZoomAxis()

QCPAxis * QCPAxisRect::rangeZoomAxis ( Qt::Orientation  orientation)

Returns the range zoom axis of the orientation provided. If multiple axes were set, returns the first one (use rangeZoomAxes to retrieve a list with all set axes).

See also
setRangeZoomAxes

§ rangeDragAxes()

QList< QCPAxis * > QCPAxisRect::rangeDragAxes ( Qt::Orientation  orientation)

Returns all range drag axes of the orientation provided.

See also
rangeZoomAxis, setRangeZoomAxes

§ rangeZoomAxes()

QList< QCPAxis * > QCPAxisRect::rangeZoomAxes ( Qt::Orientation  orientation)

Returns all range zoom axes of the orientation provided.

See also
rangeDragAxis, setRangeDragAxes

§ rangeZoomFactor()

double QCPAxisRect::rangeZoomFactor ( Qt::Orientation  orientation)

Returns the range zoom factor of the orientation provided.

See also
setRangeZoomFactor

§ setBackground() [1/3]

void QCPAxisRect::setBackground ( const QPixmap &  pm)

Sets pm as the axis background pixmap. The axis background pixmap will be drawn inside the axis rect. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else.

For cases where the provided pixmap doesn't have the same size as the axis rect, scaling can be enabled with setBackgroundScaled and the scaling mode (i.e. whether and how the aspect ratio is preserved) can be set with setBackgroundScaledMode. To set all these options in one call, consider using the overloaded version of this function.

Below the pixmap, the axis rect may be optionally filled with a brush, if specified with setBackground(const QBrush &brush).

See also
setBackgroundScaled, setBackgroundScaledMode, setBackground(const QBrush &brush)

§ setBackground() [2/3]

void QCPAxisRect::setBackground ( const QPixmap &  pm,
bool  scaled,
Qt::AspectRatioMode  mode = Qt::KeepAspectRatioByExpanding 
)

This is an overloaded function.

Allows setting the background pixmap of the axis rect, whether it shall be scaled and how it shall be scaled in one call.

See also
setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode

§ setBackground() [3/3]

void QCPAxisRect::setBackground ( const QBrush &  brush)

This is an overloaded function.

Sets brush as the background brush. The axis rect background will be filled with this brush. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else.

The brush will be drawn before (under) any background pixmap, which may be specified with setBackground(const QPixmap &pm).

To disable drawing of a background brush, set brush to Qt::NoBrush.

See also
setBackground(const QPixmap &pm)

§ setBackgroundScaled()

void QCPAxisRect::setBackgroundScaled ( bool  scaled)

Sets whether the axis background pixmap shall be scaled to fit the axis rect or not. If scaled is set to true, you may control whether and how the aspect ratio of the original pixmap is preserved with setBackgroundScaledMode.

Note that the scaled version of the original pixmap is buffered, so there is no performance penalty on replots. (Except when the axis rect dimensions are changed continuously.)

See also
setBackground, setBackgroundScaledMode

§ setBackgroundScaledMode()

void QCPAxisRect::setBackgroundScaledMode ( Qt::AspectRatioMode  mode)

If scaling of the axis background pixmap is enabled (setBackgroundScaled), use this function to define whether and how the aspect ratio of the original pixmap passed to setBackground is preserved.

See also
setBackground, setBackgroundScaled

§ setRangeDrag()

void QCPAxisRect::setRangeDrag ( Qt::Orientations  orientations)

Sets which axis orientation may be range dragged by the user with mouse interaction. What orientation corresponds to which specific axis can be set with setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical). By default, the horizontal axis is the bottom axis (xAxis) and the vertical axis is the left axis (yAxis).

To disable range dragging entirely, pass nullptr as orientations or remove QCP::iRangeDrag from QCustomPlot::setInteractions. To enable range dragging for both directions, pass Qt::Horizontal | Qt::Vertical as orientations.

In addition to setting orientations to a non-zero value, make sure QCustomPlot::setInteractions contains QCP::iRangeDrag to enable the range dragging interaction.

See also
setRangeZoom, setRangeDragAxes, QCustomPlot::setNoAntialiasingOnDrag

§ setRangeZoom()

void QCPAxisRect::setRangeZoom ( Qt::Orientations  orientations)

Sets which axis orientation may be zoomed by the user with the mouse wheel. What orientation corresponds to which specific axis can be set with setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical). By default, the horizontal axis is the bottom axis (xAxis) and the vertical axis is the left axis (yAxis).

To disable range zooming entirely, pass nullptr as orientations or remove QCP::iRangeZoom from QCustomPlot::setInteractions. To enable range zooming for both directions, pass Qt::Horizontal | Qt::Vertical as orientations.

In addition to setting orientations to a non-zero value, make sure QCustomPlot::setInteractions contains QCP::iRangeZoom to enable the range zooming interaction.

See also
setRangeZoomFactor, setRangeZoomAxes, setRangeDrag

§ setRangeDragAxes() [1/3]

void QCPAxisRect::setRangeDragAxes ( QCPAxis *  horizontal,
QCPAxis *  vertical 
)

This is an overloaded function.

Sets the axes whose range will be dragged when setRangeDrag enables mouse range dragging on the QCustomPlot widget. Pass nullptr if no axis shall be dragged in the respective orientation.

Use the overload taking a list of axes, if multiple axes (more than one per orientation) shall react to dragging interactions.

See also
setRangeZoomAxes

§ setRangeDragAxes() [2/3]

void QCPAxisRect::setRangeDragAxes ( QList< QCPAxis *>  axes)

This is an overloaded function.

This method allows to set up multiple axes to react to horizontal and vertical dragging. The drag orientation that the respective axis will react to is deduced from its orientation (QCPAxis::orientation).

In the unusual case that you wish to e.g. drag a vertically oriented axis with a horizontal drag motion, use the overload taking two separate lists for horizontal and vertical dragging.

§ setRangeDragAxes() [3/3]

void QCPAxisRect::setRangeDragAxes ( QList< QCPAxis *>  horizontal,
QList< QCPAxis *>  vertical 
)

This is an overloaded function.

This method allows to set multiple axes up to react to horizontal and vertical dragging, and define specifically which axis reacts to which drag orientation (irrespective of the axis orientation).

§ setRangeZoomAxes() [1/3]

void QCPAxisRect::setRangeZoomAxes ( QCPAxis *  horizontal,
QCPAxis *  vertical 
)

Sets the axes whose range will be zoomed when setRangeZoom enables mouse wheel zooming on the QCustomPlot widget. Pass nullptr if no axis shall be zoomed in the respective orientation.

The two axes can be zoomed with different strengths, when different factors are passed to setRangeZoomFactor(double horizontalFactor, double verticalFactor).

Use the overload taking a list of axes, if multiple axes (more than one per orientation) shall react to zooming interactions.

See also
setRangeDragAxes

§ setRangeZoomAxes() [2/3]

void QCPAxisRect::setRangeZoomAxes ( QList< QCPAxis *>  axes)

This is an overloaded function.

This method allows to set up multiple axes to react to horizontal and vertical range zooming. The zoom orientation that the respective axis will react to is deduced from its orientation (QCPAxis::orientation).

In the unusual case that you wish to e.g. zoom a vertically oriented axis with a horizontal zoom interaction, use the overload taking two separate lists for horizontal and vertical zooming.

§ setRangeZoomAxes() [3/3]

void QCPAxisRect::setRangeZoomAxes ( QList< QCPAxis *>  horizontal,
QList< QCPAxis *>  vertical 
)

This is an overloaded function.

This method allows to set multiple axes up to react to horizontal and vertical zooming, and define specifically which axis reacts to which zoom orientation (irrespective of the axis orientation).

§ setRangeZoomFactor() [1/2]

void QCPAxisRect::setRangeZoomFactor ( double  horizontalFactor,
double  verticalFactor 
)

Sets how strong one rotation step of the mouse wheel zooms, when range zoom was activated with setRangeZoom. The two parameters horizontalFactor and verticalFactor provide a way to let the horizontal axis zoom at different rates than the vertical axis. Which axis is horizontal and which is vertical, can be set with setRangeZoomAxes.

When the zoom factor is greater than one, scrolling the mouse wheel backwards (towards the user) will zoom in (make the currently visible range smaller). For zoom factors smaller than one, the same scrolling direction will zoom out.

§ setRangeZoomFactor() [2/2]

void QCPAxisRect::setRangeZoomFactor ( double  factor)

This is an overloaded function.

Sets both the horizontal and vertical zoom factor.

§ axisCount()

int QCPAxisRect::axisCount ( QCPAxis::AxisType  type) const

Returns the number of axes on the axis rect side specified with type.

See also
axis

§ axis()

QCPAxis * QCPAxisRect::axis ( QCPAxis::AxisType  type,
int  index = 0 
) const

Returns the axis with the given index on the axis rect side specified with type.

See also
axisCount, axes

§ axes() [1/2]

QList< QCPAxis * > QCPAxisRect::axes ( QCPAxis::AxisTypes  types) const

Returns all axes on the axis rect sides specified with types.

types may be a single QCPAxis::AxisType or an or-combination, to get the axes of multiple sides.

See also
axis

§ axes() [2/2]

QList< QCPAxis * > QCPAxisRect::axes ( ) const

This is an overloaded function.

Returns all axes of this axis rect.

§ addAxis()

QCPAxis * QCPAxisRect::addAxis ( QCPAxis::AxisType  type,
QCPAxis *  axis = nullptr 
)

Adds a new axis to the axis rect side specified with type, and returns it. If axis is 0, a new QCPAxis instance is created internally. QCustomPlot owns the returned axis, so if you want to remove an axis, use removeAxis instead of deleting it manually.

You may inject QCPAxis instances (or subclasses of QCPAxis) by setting axis to an axis that was previously created outside QCustomPlot. It is important to note that QCustomPlot takes ownership of the axis, so you may not delete it afterwards. Further, the axis must have been created with this axis rect as parent and with the same axis type as specified in type. If this is not the case, a debug output is generated, the axis is not added, and the method returns nullptr.

This method can not be used to move axis between axis rects. The same axis instance must not be added multiple times to the same or different axis rects.

If an axis rect side already contains one or more axes, the lower and upper endings of the new axis (QCPAxis::setLowerEnding, QCPAxis::setUpperEnding) are set to QCPLineEnding::esHalfBar.

See also
addAxes, setupFullAxesBox

§ addAxes()

QList< QCPAxis * > QCPAxisRect::addAxes ( QCPAxis::AxisTypes  types)

Adds a new axis with addAxis to each axis rect side specified in types. This may be an or-combination of QCPAxis::AxisType, so axes can be added to multiple sides at once.

Returns a list of the added axes.

See also
addAxis, setupFullAxesBox

§ removeAxis()

bool QCPAxisRect::removeAxis ( QCPAxis *  axis)

Removes the specified axis from the axis rect and deletes it.

Returns true on success, i.e. if axis was a valid axis in this axis rect.

See also
addAxis

§ insetLayout()

QCPLayoutInset * QCPAxisRect::insetLayout ( ) const
inline

Returns the inset layout of this axis rect. It can be used to place other layout elements (or even layouts with multiple other elements) inside/on top of an axis rect.

See also
QCPLayoutInset

§ zoom() [1/2]

void QCPAxisRect::zoom ( const QRectF &  pixelRect)

Zooms in (or out) to the passed rectangular region pixelRect, given in pixel coordinates.

All axes of this axis rect will have their range zoomed accordingly. If you only wish to zoom specific axes, use the overloaded version of this method.

See also
QCustomPlot::setSelectionRectMode

§ zoom() [2/2]

void QCPAxisRect::zoom ( const QRectF &  pixelRect,
const QList< QCPAxis *> &  affectedAxes 
)

This is an overloaded function.

Zooms in (or out) to the passed rectangular region pixelRect, given in pixel coordinates.

Only the axes passed in affectedAxes will have their ranges zoomed accordingly.

See also
QCustomPlot::setSelectionRectMode

§ setupFullAxesBox()

void QCPAxisRect::setupFullAxesBox ( bool  connectRanges = false)

Convenience function to create an axis on each side that doesn't have any axes yet and set their visibility to true. Further, the top/right axes are assigned the following properties of the bottom/left axes:

Tick label visibility (QCPAxis::setTickLabels) of the right and top axes are set to false.

If connectRanges is true, the rangeChanged signals of the bottom and left axes are connected to the QCPAxis::setRange slots of the top and right axes.

§ plottables()

QList< QCPAbstractPlottable * > QCPAxisRect::plottables ( ) const

Returns a list of all the plottables that are associated with this axis rect.

A plottable is considered associated with an axis rect if its key or value axis (or both) is in this axis rect.

See also
graphs, items

§ graphs()

QList< QCPGraph * > QCPAxisRect::graphs ( ) const

Returns a list of all the graphs that are associated with this axis rect.

A graph is considered associated with an axis rect if its key or value axis (or both) is in this axis rect.

See also
plottables, items

§ items()

QList< QCPAbstractItem * > QCPAxisRect::items ( ) const

Returns a list of all the items that are associated with this axis rect.

An item is considered associated with an axis rect if any of its positions has key or value axis set to an axis that is in this axis rect, or if any of its positions has QCPItemPosition::setAxisRect set to the axis rect, or if the clip axis rect (QCPAbstractItem::setClipAxisRect) is set to this axis rect.

See also
plottables, graphs

§ left()

int QCPAxisRect::left ( ) const
inline

Returns the pixel position of the left border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ right()

int QCPAxisRect::right ( ) const
inline

Returns the pixel position of the right border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ top()

int QCPAxisRect::top ( ) const
inline

Returns the pixel position of the top border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ bottom()

int QCPAxisRect::bottom ( ) const
inline

Returns the pixel position of the bottom border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ width()

int QCPAxisRect::width ( ) const
inline

Returns the pixel width of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ height()

int QCPAxisRect::height ( ) const
inline

Returns the pixel height of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ size()

QSize QCPAxisRect::size ( ) const
inline

Returns the pixel size of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ topLeft()

QPoint QCPAxisRect::topLeft ( ) const
inline

Returns the top left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ topRight()

QPoint QCPAxisRect::topRight ( ) const
inline

Returns the top right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ bottomLeft()

QPoint QCPAxisRect::bottomLeft ( ) const
inline

Returns the bottom left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ bottomRight()

QPoint QCPAxisRect::bottomRight ( ) const
inline

Returns the bottom right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ center()

QPoint QCPAxisRect::center ( ) const
inline

Returns the center of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ update()

void QCPAxisRect::update ( UpdatePhase  phase)
virtual

This method is called automatically upon replot and doesn't need to be called by users of QCPAxisRect.

Calls the base class implementation to update the margins (see QCPLayoutElement::update), and finally passes the rect to the inset layout (insetLayout) and calls its QCPInsetLayout::update function.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayoutElement.

§ elements()

QList< QCPLayoutElement * > QCPAxisRect::elements ( bool  recursive) const
virtual

Returns a list of all child elements in this layout element. If recursive is true, all sub-child elements are included in the list, too.

Warning
There may be nullptr entries in the returned list. For example, QCPLayoutGrid may have empty cells which yield nullptr at the respective index.

Reimplemented from QCPLayoutElement.

§ applyDefaultAntialiasingHint()

void QCPAxisRect::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Reimplemented from QCPLayoutElement.

§ draw()

void QCPAxisRect::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Reimplemented from QCPLayoutElement.

§ calculateAutoMargin()

int QCPAxisRect::calculateAutoMargin ( QCP::MarginSide  side)
protectedvirtual

Returns the margin size for this side. It is used if automatic margins is enabled for this side (see setAutoMargins). If a minimum margin was set with setMinimumMargins, the returned value will not be smaller than the specified minimum margin.

The default implementation just returns the respective manual margin (setMargins) or the minimum margin, whichever is larger.

Reimplemented from QCPLayoutElement.

§ layoutChanged()

void QCPAxisRect::layoutChanged ( )
protectedvirtual

Reacts to a change in layout to potentially set the convenience axis pointers QCustomPlot::xAxis, QCustomPlot::yAxis, etc. of the parent QCustomPlot to the respective axes of this axis rect. This is only done if the respective convenience pointer is currently zero and if there is no QCPAxisRect at position (0, 0) of the plot layout.

This automation makes it simpler to replace the main axis rect with a newly created one, without the need to manually reset the convenience pointers.

Reimplemented from QCPLayoutElement.

§ mousePressEvent()

void QCPAxisRect::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

Event handler for when a mouse button is pressed on the axis rect. If the left mouse button is pressed, the range dragging interaction is initialized (the actual range manipulation happens in the mouseMoveEvent).

The mDragging flag is set to true and some anchor points are set that are needed to determine the distance the mouse was dragged in the mouse move/release events later.

See also
mouseMoveEvent, mouseReleaseEvent

Reimplemented from QCPLayerable.

§ mouseMoveEvent()

void QCPAxisRect::mouseMoveEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

Event handler for when the mouse is moved on the axis rect. If range dragging was activated in a preceding mousePressEvent, the range is moved accordingly.

See also
mousePressEvent, mouseReleaseEvent

Reimplemented from QCPLayerable.

§ mouseReleaseEvent()

void QCPAxisRect::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This event gets called when the user releases the mouse button, after this layerable has become the mouse grabber by accepting the preceding mousePressEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter startPos indicates the position where the initial mousePressEvent occurred, that started the mouse interaction.

The default implementation does nothing.

See also
mousePressEvent, mouseMoveEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented from QCPLayerable.

§ wheelEvent()

void QCPAxisRect::wheelEvent ( QWheelEvent *  event)
protectedvirtual

Event handler for mouse wheel events. If rangeZoom is Qt::Horizontal, Qt::Vertical or both, the ranges of the axes defined as rangeZoomHorzAxis and rangeZoomVertAxis are scaled. The center of the scaling operation is the current cursor position inside the axis rect. The scaling factor is dependent on the mouse wheel delta (which direction the wheel was rotated) to provide a natural zooming feel. The Strength of the zoom can be controlled via setRangeZoomFactor.

Note, that event->angleDelta() is usually +/-120 for single rotation steps. However, if the mouse wheel is turned rapidly, many steps may bunch up to one event, so the delta may then be multiples of 120. This is taken into account here, by calculating wheelSteps and using it as exponent of the range zoom factor. This takes care of the wheel direction automatically, by inverting the factor, when the wheel step is negative (f^-1 = 1/f).

Reimplemented from QCPLayerable.

§ drawBackground()

void QCPAxisRect::drawBackground ( QCPPainter *  painter)
protected

Draws the background of this axis rect. It may consist of a background fill (a QBrush) and a pixmap.

If a brush was given via setBackground(const QBrush &brush), this function first draws an according filling inside the axis rect with the provided painter.

Then, if a pixmap was provided via setBackground, this function buffers the scaled version depending on setBackgroundScaled and setBackgroundScaledMode and then draws it inside the axis rect with the provided painter. The scaled version is buffered in mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when the axis rect has changed in a way that requires a rescale of the background pixmap (this is dependent on the setBackgroundScaledMode), or when a differend axis background pixmap was set.

See also
setBackground, setBackgroundScaled, setBackgroundScaledMode

§ updateAxesOffset()

void QCPAxisRect::updateAxesOffset ( QCPAxis::AxisType  type)
protected

This function makes sure multiple axes on the side specified with type don't collide, but are distributed according to their respective space requirement (QCPAxis::calculateMargin).

It does this by setting an appropriate offset (QCPAxis::setOffset) on all axes except the one with index zero.

This function is called by calculateAutoMargin.

The documentation for this class was generated from the following files:
  • src/layoutelements/layoutelement-axisrect.h
  • src/layoutelements/layoutelement-axisrect.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_o.html0000644000175000017500000000614614030601037025077 0ustar rusconirusconi Data Fields - Functions
 

- o -

qcustomplot-2.1.0+dfsg1/documentation/html/ssCross.png0000644000175000017500000000043014030601041022776 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+JIDAT(ϵÁ 0Ä2•8‘s;D_¯ý´þ$Aî„wcçÝH¼ìNvÅ‹2઼•Ð HBã}Á5¶Wkц&—O~œ|³1%k-m%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayerable__inherit__graph.png0000644000175000017500000006347414030601041030053 0ustar rusconirusconi‰PNG  IHDRh¤äµ4OgAMA† 1è–_0PLTEÿÿÿ///jjjPPUŽŽ—çç믯ËÑÑÖ××ådd•K*,,c6}™¶YbKGDˆH pHYsHHFÉk>f3IDATxÚí½{ŒÇçìì®'Ýô©µ&ÖÀb›¢ä“p˜½lf³E çÝ–Z#aþZŽÚcwG£µ-'5UZ‰ݦ 2ì¹ñQ Ö;cH”Ê@”T8àüu±û»–m±HŸ É–ÕÕݘÅúE–š‡ƒdÉì"/#"«*‘™Y‘õø}uUfFfeä—ùûEDþ~Â\wCDv©>ó!ƈ*š¡ú̇˜é¨;Ω>ó!DëC@´>DëCDÓK š:¨hcÆ^Sã€fÌ Ý&Žf³íú¡ÓMT´¹‡fG§ŸšÔ’óNÑкm`­ÑÔ1mýÕµY¬ËãH7Œôî4eÜnÌbÑ´y]3fÓ»u-=mnР좩ƒŠvÊèZÉÞi#÷Ρ©'¦LÁ #§Ý‚PBÙ‰´çfñÃ%}¦™Z¡[Íÿ̯‡ðú9ÿÕ¦ÉÃÝ<""Z?ºtü5‰qÓID›+Ð M.CaÑ #·œjŠv‹6óiG÷á ûèŽ š:l&ÿ¼iò›ßõm¦!2m‰†Ÿiæ–)"hþoÌ :ÙDSGÓ¹ž( º±ú­Ñú­ÿHƒh}Çá*ˆÖg$—j¿Ñú‹ÔæêwÕ§?”®¾UBè‹wFä.Õç?Œ¼XûµêS9±þ[Õ§rl½¬úAN€f}Çk«eÕ§’½VV} € ©ê¯TŸ H²þÕ§ˆòèÕgˆ2¾VR} € ©jYõ)¢T~¨ú QŽ¾§ú QÒʪOåQ°öûŽìj^õ)¢Ô7TŸ Ê°BúŽôµ‚êSD9ù‘ê3DI€ÒT6TŸ Ê8X!ýG½ì³a4JàÀYÕÕ üo´‘=âšížT]Ÿ¡ žóÛ22)~´(û¢ñ7÷A´%y¡à» DëQn4­G ºÑ@´%èFk àò¯óÛˆÀ­)€_ÈG¼Îo >o´¦¾!É: í5ö£ç¾i®µíÄFðÖÀ7äc‰Š¶§¸ ]‡×ÚöbcüÀÍnÑÜ!KT´ÛКѬW­A´¸ñï !xšGWÈÇY«ÉDÚ:^kÛˆ‹°î}·!‚œ!ɺ»'̯£Æ,^kÛˆ‹J9x»Ýäg„|ÄëF ,2^kÛˆ‰lØ8ZK Z¼,n„€‘ž#µVDë9N®„•ÑzÌV>¬ˆÖkù}X‰TeRü° ZœÔ !N4“â‡Ñbd,¸ Þ\ý54=Fˆc}°ñ_ h$J°ÇIÕ5\‚íýôý«ßÃ…¢D{,¨®ÚàòÒJÀÆÃÕ+EÕ'xHžËûo<Ñø¾êóŒÿÜÛ‰õߨ>=€E%ç»i ‚ö&‰·}7-­æTŸÀä¥ ¿-ËkÕ'°¹÷Ù°¼VT}n_3äØjAõ¹>øõ†¼ϳžÅ¯7÷0GV˜«!€q/³Yd®®@H³ÞÅgÖ1ˆqÐÃß`­Í‚áØËœc­LW¨>/À¶“´žf±ÌXyt-¯ú¼’[Œ•©k9Õç0Κ9ÑÝ{ÖHÚÑÐ â€JÒWë º{o³ýwÞuݽǩ<«ÆÁrìmRÞyI_·:R¸Gø(í+žU/|èW8J¸Gø(oë˜Ø*úŽ6-&óK&åíɯ¼é[Dë ¼­ãx€‹¢õÞÖÑ7è4Ñzïä#Ao©q\~G$Aî½<­c†'r _¸G Ë\ÖÙ{’ð´Ž/v‡„{´BeùìÈ!ínSÁÂÂ=""š®MìÃ7b>ƧßñÑ7ˇ…{´šGíÓס™ô$|Œ÷¨L"dD&,Ü#²î´ÒËhâzã ã• KæîµEKÍOBÀÇ8pYgÆ>CÂ=¶DÛyº9¡CÀÇ88^v.‡E{ ÷Øz¦™†È¼1 ãÀ5£g,tF1g¸GÍg/ s²®ùŽ÷•Ãöà¼ü Z|œÞp,r¤'„¾Gålæ‹A=Å šjÎ;‹'(ˆ¦Wg1Ç¢)ÇÙYÌ•pDSŒ«³˜çFC§&£üˆ&qGgqhD~“ÔR-J¸Gø(ç N¡!8JçÕ/G ÷åáxý3ûvXñÔæú/UŸòÐãì M}ñÆÕ‚êSžÞ°-„£¥—×­ú„ÓZ,ÙØá Zd«keÕç ˜÷Žý!–Ú ,ûJã­¼êóËà)pfÈÃíìãŸÉ %ÿ‚É¥Õï¨>Y€b7ø·ì_.]«±Wpü›ßr™úyÕç XìØhÈ’œª_Q}¦@ {¿hÖK$mýëtý-Õ' ´ÿEû»¯c©C®’^âÕrëkÚϱNBÛØ[ئôøæ”\~;Ïs( K¤m#ž~öþ±µ’êÓìŒ_nõÉ¢ð$+é1l}X>öþÑõœê“œl¶¾ùdQH4 a øÂÎ)™©CˆÎ^£=K5ÉNæTù÷P@·h?ÒÆ?bm?‘{ö° 3§äQH¢Ð{$Z½ú Ö ÕD£¸ûubqw©®î`Ð~¤±rJ&ÃŒCL4CuuƒÅœõ…™Úz9¬ÇqZì×æTWw0h=ÒÆÓ ^ 5B@4´iŒÞŽÔ„ šZ4FoH²þÛÐýA4ÏY_^_ñl{”c DS@ë‘æíxtµ¾?Í7ä£; ˆ&VÇã˜gP&â¡Q¨hA!€h_±¾x³¦ñ¥¹›¶þú†|ÔÌo³ÍX š šÞ¼@gøº©h¾!‰hOèÍX š šcižøœ Î4w.Ѽ!5òiÅzÑ$Кr_Áµ¥þ#¾#¸›GOÈG|­â Zç4§‡xúŠ¹“Z» ä ùHDkÆzÑ$ÐœñèvÒxG‡ÉÏùHDkÆzÑ$ÐœñèvÒxǶsò±ˆÖ1ÍIüY×›2/ð6ŽÐ#Ò}²Ö$~×þĵ÷!@´nc½—æNm]˜1¢uë½4×HšP‚d­Ûœ§Α4±ìñ Z—IÐNbW–Xöx­ËX Î.¬q±ìñ Z—±z‹Ó3Õ²È!^ ö¨ºÎ}í-vÎ38)2<õgµ-±Xw©®s¿“¡.´#âtbµÈ½z©v>§ºÃÆ}–Õ ¶uõ îÝ6Ö¾§º Ãu­üG¹û¯ž¯®BhUTŠøïÓ+í5™jŽo×ÄfíbQõù%ÔµÞ,¶×œüˆkÇäÙÆUˆE§êZÛ[Ç,Ïœ9Ó̯¯þ©ê“VèD¬×7Úk¸¬”Ù2–TŸûÐrºŒÿn–Z+¸¬UhB\k[똹 ÝÂñ«…ŽZÛB»sX!!¿Z²ïâ¿íÖ1µU ÙÃ¼Í ¿Z¶o GëX ®>·™rÈ;NmÏ:,©5Üf½±CÚžuH´Wªp›©'‰Æv„¥`s?¹Tƒ¬=@ögÈ6*“¹P(›Ú„ =±CZQÂ_ 2÷O4Þ*©>]s¼`kƒÌý äÝê.![ë¸èŸ(Q_-«>W€Bìfë`îšÆÞÛ!™æ|ÇʆO©ä4=¶CšIÓ|‘'êk9Õ' ´ÁvH3 Ÿ_ýJãJQõy6pˆÕ:úÝhKµ¦qT,j`›YÕµïO°2F_NK²'óp8Ô#{¢i¶{Ruõûü6!¹FG˜~õaŽ¾Æ‘Éh?u¿aÛ!4*VšÙõ"O†]­»Ï5ß³>ÉÊÊgéƒhÝe³9Ñ u­èÙ˜Úä³ôA´îbŽ÷•ð—“ÞØÙ*§¥¢u•ÄÏ­K©­¼{›ù8ã<Šuñ}c=âå€ý1ÆW¬ÎâãžžbŽ+ëâûÆz4—ƒöÄøJ™¾þ™XÍ;7¤E†;­‹ïëÑ\¾Ý®MLOL›÷ݬ6±Ï¾ @bõ;õõ¸¸âÜ”š b]|ßXxyä®ImçÜÎ9óguíÓ×Ù÷ÈÖjµ+cïš®š{Hæ0wÖÆ-š;Ö#^NE-oþg>ôÌB/Û÷À¢ÕåÅ5÷̉°ÎFžæÑëé £`®2ÿ›þK­ˆhµTko9o´¥uÁÙ;nCyb="ýñ;o¥¢Í<¦k;¡yŒ  ³AWðŸ4§GmÃnò³b=âå›Ð=T´ù) ‘è´E£öþüra¢.>µuñ9c=jîýnÚ¢ƒ?S]Ãú&£Š^|-:mÑj+æâKµZþÅF”© ÐÕ=l¢ý繨ÕÞ_ÿðQžzøýêd´ÑÄ!¢­ã?WòÇÍdYìÿÆ¥ µÚV}2Ú €hâѪX3s!ø#£ô³g/5j«çßøršÇ.‚E[«SÍP…$|;¦~ß`ï¿ñ·tDëX´ïXšYÏ·‚³Ä_{wzê ,ع‹ß¶mѺG¶ÖxoŒjFo´–—mñˆ«¹üúf‹¸~þâwKÎõ#¢±›Lª¾=HXêéŸÖnøƒŸo`Y‘Ž‰Kµv÷VÒöó õئ ú õ ¡©§ÒúVû‰cž‘¸\³DK=|öBÃ|„}ûoUWh +lcd2¹L “Ö#¬ º2ÃB¢ýˤ¹Ä‚ý÷oUWd˜è@´ÿ™>ã.~7¯ºÃFtÑ>a&EÕU>˜¢é<{Žü«*-§º Ç7õôÂlS4½]LwLx#˜†È—ÌçY­¬º Ç7õ´iÊët›Þ.ÆÍüóì&ˆÖ}<©§“ûnESFaÔØ«ú^Óè”a~µÏR$ûXLO–TWaø𤞼 M}kRËá)7{Š- ]yz§µf)’} WPžÔÓ#³w Û2ú¶)üh» †ù—ŠÖš¥HöÑ”áI=ýœaMÑÐ×öyRÚÝ·E+Z³É> š2<©§ïA#¦›), }X´‡&pó¸Ï1K‘ì¢)Ózz%tÓ3 ]7·L˜†þj›¥HöÑ”!˜zÚ-u¶ º ÃG'½ü¦½ÿgà\+ ÑÞ¬Aˆ :­Æœ3ÄO碕TWaøè@´EE[?ñ˪k1dtòL;L4;{ŽL¿bÍæâ¡#ëñpƒN^ý‡7èÌT˜%ÒBçþ´õ­öSÏŒDSµæº§\SŠøø¢ÿŒÃ:ù[û/ÿvýsøËZ†Ç±ÏH<ÜxÛv° ™ùèÿ ›déb—ê‹Ó‡\"««‡k«üí$­ì(tØŸ<ùõ³ì9ƈc’¥È(/ ¦Z¯}Ü ï7eD´<Ç®>9Áèœê+Ðdh¸ÀJm½bÚˆeóë¬Ùïþ­‡\û5 -nH‚ò"!~©«–¬Š½ŸæyÈhq3~™||¥ù¢|Ù\…#ÁðÆkÒ~ÈåA´¸!YÚÑ|燞®×jÖ¯…e ¢ÅÍ'Êäc¼)^«­£ôòj.Òÿþ ï$KwÌGëýÑ„Á)Ö‰BŸe÷ááKM¼“,Ù1A´¨,ÓlÍîžeIöÑhfM<“,=1O¹ôns%)¢ C}k”ÆFˆi=:…6GžI–ž˜7=¡ì„;-2XŸø.«×þÑ’?Q½R?¤g’¥+æã~dàH ZT,ß¡jmiåô{îä©Aͼ“,1ÓÓh¿¹D‹Œå[›fþoïeË(éÊ~‘\OØê™déŠùø\ñ†oNâæ‘þˆ&ÊøŠõåCh3yfÄÍÏ$KWÌDZÉSƬiˆlC$–oMxOV ®"Â1'Y‚h¢X¾5!‹Cs¢íï¸Ëˆ>Ø G$f,ßšB“:y“§e–…‚Òh1³l_ É%·3zøŠdoÑbæ’}ÁJãÊJú¼€Ÿ ¢ÅÌö… údf=\ý ÈyL-^ÒN«ÃJMÎLrâÎ#¢ÅKË·¦Ð¼N~éäÏrzl Z¼´|kJÂj}òÉ?ßàêŠõ¨ú"ôvßC:Eù¸,øòÉL²dq—ê‹Ðo|¥ì\~}ƒ~ž|“]>¹!ô; ‡oš"8ÇdÉgb¹¹ù,»Wœ³>OþÐožå@œ\r¯8^¦Ÿìå„”H¾I@>WÜ+Æ­öyǯ¥Ú/UŸø“ö*³ÕüÂêÌjb6‘9Õç>´¸|k í4F¾6%½,Òƒ ÈÄå[“U¿o~óñ°-ÖÀŠTƒÛ·6¡‰“1~¶ÅáêØ#*pûÖ˜VûˆNþ(pçäRí¢ê #‹Eïºvû˜¾VÞýypÙ°ÌX—iµè̇!û§6Áé:çX++åæ·dµv„g«WCËR¹ÂZ¹ýw­¯ãá/„¦—ÖáÉÖMÒÌ^t»}D•_…åDãêCªk2D0|kL»}D©­bøaRV»˜W]—¡á[“Õ¿oá#ž½R_ƒ¤K0|kLf«ýÃ!ÅÎ6ÎTWg8`ùÖ[ûˆÆ9#Š$6×/–TWh`ùÖ˜qûû <¶á•ú:ŒØÄÏý>듶ö‘Ï¡¬®~Oužó~Úý&/„õ‹´IŸ­Á@[Ì\ñÛàh9mJâRí­¢êz 2©ŸûmI:ú·¸l‘VÇ?°åÈB?†âã[cŽoØ—–v(á ú1">¾5&ëèàJ]Ë…,z”d0­?ßšp!o_:Þq ¢u?ßÓœnQuÖ@´îàç[cÎ{+Kã¢u‡ûƒ6n‹/„5‚¢i̵ Z(çƒ6>½â\k ƒƒ<¦vãðs­ù‡äÕÓíÑB¹´1årβ[…Àƒ…yüçON:n®–h@´0ü}k‚½«s2Pã° ü‚¨6¯køŽûê”®MLã¬Ú8lÖN±#»ƒhad¸ÙÑ•e’¬oò8¶çS¦Ú-¦…c®Þõ-]Û9g5øÛMVRm-ŒßãèêÇd§AyDÿqâ“8g˜«o3 嵦hæ7ÃÐÉî ZA¾5æ¸{{ ä¡4^4 ü¥%j‰f~ÛoD #È·Æd=sµêóăƒ<ŽF¤Ú×í†oNÒÝU_“žg±RÀ媙ϣ€28È㨱§°Í0×Λ61DL©&LSE'ßN³dw-ŒÍ°¯¯¸×œyÛ·°PÇC:{=ˆÆù°)ï8Úòü ‹ôˆh–…ïD ãJh ·«fš¾£ØÐ÷Ø B|k̸w¦êøj‰]Dë!¾5&y.ïYwÌçѺAˆoMxió*Yÿ-³(ˆÖ vl„—I0ÜéT£Ì* ¢uƒWË…î+x×]-2J‚hÝ Ô·Ælÿ=c壬ǚhGý…Pß“Ùb¬LÖÞš`Gý‰Pßšàé5Ƥª¼/erá˯›`Ë^+«>ý¡„÷&Ü—c­}a­¤ºÃ‡oMg¿¿»Þ H‡Ç·Æ$s[T@µîÃã[^Za®N×Ày@¯æ8 &|^tJ4À„ì6•wÉ2{}ö„ì2\¾5aÜ/šñkëeÕµ2ø|kB½à³áÅÕœêj |¾5aûÇ~[Ž­T×c˜àõ­1~V¿É# ZÉ^(üÒ›¾›Ê t¯oMH„7X‚çZ×àö­ ‹¥—ÖÁòïܾ5!d¶œXÿ‚êÚ •¼Pñ &èÅÆ÷UWg8à÷­ ãïmÍògæ:@À·&ÔsA[S›`Dvßš°=8,nr b=ÆŽˆoMH^(x±AcFÈ·&ù}HÐ7B¾5!ã›ÚµÅ× ^¬ì8 ¼ËÉ7C‹¤—jo:%/ðÕ£_8Þ%µ•/ô|uõ×hNL4)ʇAßšÀq«™ËÁÆÕÿ&v\“KöáºÕ̇ßÙŸŠDãDÔ·&pÝjHøݤ¨oMà¼Õ@´xö­)œ·ˆ â¾5óV³D›7 Qc/2Œœf ¨µ^C³Öh|ˆûÖ¾[Š6:óä4š»û¤Ò5GdGÝù ¢ñÁ·&ðÝjT4mÖü‚Ñ“º¦ú)󆛘ž0×èéÝ3ÛfG'¬Ðs |kÊKs²D+¡—ÑmæëN»é Úq§¹QÇa o|î41¢øÖ„ô…Bx!—hÖ3Í0phǼ†Ï™OµçöƒhbDñ­)g8ÒMº›GDb;îÇ$棎Ã@.ìÑĈä[’·šÛA$¶ã ßœlŠ6rË©äô\~-¢qÍ·¦y'´ˆÍäÇñuDb;žÂ!§©héÝÓ#Æ&'tRDã"Í·&pdSk:×Ûnã:"ˆÆEDßšžezDâ`ûJ'{W6B €hq°£ÜÉÞÙÕ|p-"ûÖ”“!‰ A´8ˆì[SˆqøÖv@´øD9Þãƒh1o݆Š†ƒ¾ 9ã€fÌ ]ko5 +ôœ-˜˜|ëT´¹‡fG§ŸšÔ’óÑÆÜ D &6ßÚbÚú;ªk³X£Ç‘néÝ3hʸݘ5Wì51N€œ×Iq-˜ø|k í6”ѵ’)½Óp€Ç©'¦žÐMÑöZ@»ò$¤•ýD $Vßã>Óp€Ç[Íÿ°h·¡Qsé6D@–èN Z ÙX}käm­ˆÃ>êD4óÿ»Ç¢ío?á@´@âö­Ý†¢Fn9eí¡ Ü<’-¸}k»É?ošüæw}›iˆLÛD3&¨!2 ¢q·oÝr®'J;hÄí[CH Äí[ƒh1·o ¢Å@ܾ5ˆ&ŸLx¬ïѤ“ýYÜ¿¢I'vßD“Oì¾5‹õØDõuéib÷­ÑÅ‚=RîR}]zšØ}k@>˪O'vßϪO&»o H'~ßNÔTÉ€Bâ÷­éÄï[ÒߺߺߺߺÿߺߺߺߺùJYõ€o݇€o݇€o݇@âƒþ|ë>|ë>$.ßz[´YÅ~|Rõuê)âò­G¦£Ì*öcnRõuê)âò­G&{÷h}Ïb1žã‚h1—o ¢Åȹ˜Ž ¢ÅH\¾5û2ëìš«Œ'– ˆf'—om]f{`Î…Ù¦hz»œŽ #GDÒ,­tK4ÍÀo#° Äæ[[—Ù˜s÷$S4ýÎ ÿÕŸØk?@ˆmÜں̶ÀœÉ}·¢)£0jìÕ ½•Óüª'MѾjÉ»æJ³Œ†ƒuѬ7¯A4;±[[—Ù˜stò&4õ­I-‡ƒÏµ¢rZwÚ.s¹ÁH¬“Šö²ýh!¶qk·hÆÌÈì趌¾m ?ÚZQ9­gš¹‹FVâ¯85ˆæC\¾µ·yDÏFÑ}mH£rêôf‰FVâ¯û‚æÑûã:°ÛAè4r`ê±É‘ÂÚ׎ʹŠ¶ë±I­`þg®4Ëh8X'íI0D¼HN•ÜÆnòÓÀœ3(¡›FƘikLè­¨œø+"†È6c›WZ†È,Žq &?‹ØÆ­[—Y(0gèÑÓ·þy\G†n¬ØˆoÜD‹ø愃h±ßœð€Ë¬Ô$ÔñŸì@üG>â›$ZrîþÔéR‡G>bó­ý.ó7t,Ó¨ŽŒiÍÐ5œh%÷™f>΄ÐÞ¢Èц“Ø|köeNÞ³'‡EË踓Ñü“0lmvlrê[“8_Bì¹—ûhÃJl¾5û2ï¾1¨h¸“QGs¸‡1¡kÜuE£r>±{’÷hÃJ|sÂEÕq'£Ž¦ÿw O“Ždœ/háÄç[6É…¸“qšy ‹¶0ƒûq¾ h9Èþ8¶C"¦É;'ôù),š6‰ˆ!‚ÃSƒ!JŒï[ \æÿó›ðåhÏŽØÍ™µ½DàÕrl‡†n¬¸X,Åvh-.6ã;4ˆñùÖ ZlĘ*D‹‰}k4²÷O$2?©úZõ 1úÖÖë»?…×wew,³×Ö˪«8xÄè[c@³8ˆÑ·6É^ûŽê "1úÖ%¿R]¿$Fßeê?P]½Á$FßU>T]»%FßúÌZ^uí“}ëìzAuí”ø|ëdŒ˜ˆÏ·> ´¸ˆÍ·Î®–T×m`y5Ïq“õ²êª .•|<Ç=£U:ôÄä[§¯T×l€‰É·~ôGª+6ÈÄÓŠeÁ­Ž‘˜|ëú†êŠ 2ÙËqu¬8‰Ç·s?Vbñ­@n†X‰Ã·N^(¨®Ö`‡o}æ#Õµpbð­áF‹›|ë#p£ÅŒ|Û—Ã×”s¤Ÿa0rËRÄæÑf¾’;mæ1,ÚÍ Ýÿ,{™¾uf+ï]ɼ¾¦œ3ý óh'‘D³™¯ä™6?…E›7fýϲgÙ¾"ñX¿g¬t_Žô< 0åœégöÆÑ¢™üÁæk‰¶£,ïXõc¥ërÚý`Ê9ÓÏ Äî›òŒ£Eq®ƒé/Ñ$úÖY¦Mã¼#{îƾ¦œ3ýŒi'ݱ‡u´!ïÆ’è[³ÌÑ|M9gú_Ñ„<ÑäùÖÉ-æjfóèkÊ9ÓÏø5b žhò|ëñ™«™†ˆ¯)çL?Ã6DD8Ñ$ú֌ތÏåˆØ ¢™$Þ•v$ùÕO¡Û3hQÈÇ.Ë:Òë+ìõêE¸)tòR%_ȳ׫màæ[ùõa‚hÒ9^u ²ÏM:²|k' h1 Ë·fö ׌tdùÖ>Nj½¾ûYx}W²|ëÔZðölõûª«:8Èò­Ÿ^ ÜœmüZuMY¾5s$­E¶ñÕ$$ùÖ‰ÀV6Ûø­êz’|ë×76f«Ð6JE’o}¡ä¿-U…¶Q.)GÉ´ŽÉ:Ø’‘ã[¿´á¿mùŠê:r|ë€ÖñØZ‰û0r|ë¬Õ±Õ‚ê:‰_È8Êé ¿-©jYuñË2Žâ7üi!YR>R|kÿÖñ…·UWp‘â[ûzÖYÈ5R|k¿Ö²ƃ ßÚ·u<)0bA†oýô{}¬ýx¸*á›%özhã!#¡ó•,…1!÷öy“4–cLÈð­ï+0WW KaLHð­Óì=ãk‚ÇxùD¹ãClÿk-äJŽ ¾õbŽµö $O‹Î}kölp‡¹fäÒ¹oeΛtX!kF.ûÖÌ¡4g®dxC*|ëÍ­cßšñr|úZѵFu®™­cßúœwÕIOï¾ê\3&Z§¾uÖ:$å ˆ«:×Ì`‰–é´W—1;ä¤'†ò\3ƒ%Zög Rt¯aÜhÊsÍ0¬×Q+$¹ƒþ­Sß:ém^7šò\3 ëuîîg¼åúC´N}k¯ÁŸ ñ®(׌×z%ú˜­±6oÓû±yJ ôúÖ§=û³n4å¹f¼Ö+~‚Ñnùä¶IlžbúC´N}ëM÷ æ¦<×̦¿oOÞ­”еœA¢’÷‹hËížòôð3o4å¹fþ‰þ¾=>9i±'¦çˆyŠP¿ˆÖ¡oí™ðȾј¢™ 1áLÏ 53˜5±L 1Ï5ãµ^‰!2Mâ“ÏMóÓ¢}ÐÙîž)=/1o4–h£3ON“+§Òñ…tl´zýDÎ5ãµ^É÷9Ÿ\Ó±yJ ô…hé}kwVæZ‰YÎ%Ú7tóRÍš®r³š¥=Ä{ýè¹oîž!n´fÌÒîG„ö=G‹dò‡Z¯}!Z‡¾µ§ë ;,¿S´ä={r¦H%ô2µQãÀüoOqºnäÞ9Úa•Ði÷#Bì¹×{´Îu(}!Z‡©’wl8—“Þl ÇEÛ}cÙDý%*Úm¦D3É2ó2I=CºMžØ=é=Ú°vcuè[»û°Ž|äS%Z«y$ßiB.¤Ý©kEÚËHRÏàîGä#š%ÚWÊìíéÃrX·`4mCÄüŽ-º»'̯£ÆìÈ-§H/#N=Cº}šGJ´Î|k÷L®q_³†aˆ“›pÖ÷Q‹† ”Þ=MLþù)v?2 1J´Î|k÷°ŒÿÌ‹¶í¶ˆ¿;ä¢uæ[WJŽÅ€8tª§ÐñF+ï Ñ:ò­Ý4ç¤bçE›”yÖÃ=…®3ßzÌ9,,\µhƒDg¾õÓ‹'Wü‹‚hòèÌ·¾?o_Ê°»Š) š<:ò­]ïÛù8 ,ˆ&Ž|k×LƒÀ¨ükF‹…v~µl_ ´iÚÖÛOáõÝéÈ·v¾KX)sì’\ZÿGÕuî{Îu°¯3ôqXr Zhs-§ºÊýO'‘×^ÚK+á{®¾•W]ãþ§#ßÚÑñ˜ ²÷-þdT@G¾µ£ãqûÇ¡å®Cætä[;:ë¹°â¬GuuƒN|kÇXZ64®ÅÒjYum„N|kÇôãÁ…“›kÕ•‹Ñ÷µÇ4Èl—M.ƒfÒèÄ·¶gòO•lýÎZQuU‡|ë„}Æcp2Pó>+©®éÑomŸÄb†€f2Iuà[ÏÙ¾o•|ÚF™tâ[ÛZÖ`3ä¤SJ¾µý½´@3äEÐL.øÖö÷ëƒzC­—U×rÀèÀ·¶ €å$Ï^ƒ¾+Étà[ÛæôdÝMU!ÕŒlmšjÒ7¯$Ê@bIùDO•lë-ÿ¹o)Ènѯ©­·Ønd·ŽÔÏ#ïÚžÅå?7ä(û1ÐoÝv­¼éS${­¬º‚ƒHtßÚÖÿå×Wœ®Ãä‚8ˆî[·]kß¾âå‹kFÑ}ë¶kí礹“îB®ID÷­Û®õ¹<³À¸Û0$Ý·n¹Öcl4U-»Ö€h’ˆì[·ãô0»c*žžM‘}ëÖ¨µÏH#‹<ˆ&‡è¾uëþgŽ¤eW‹žu*s͈Z®½ü²|öÇQ÷lES­ä[½4¤6׌¨åÚËa)"ûÖ­wœØ]XV×¾Ê\3¢i/‹æŽ ÇM«‹;« 릻­2×Ì ‰æ|ûV€VO +|–ÝM¬2×Ì ‰¶XŠºc~¦÷TÚg¬Ze®™Am3êŽÍxZO¯x·=ú!{•¹f¸E³¬Ô^-ªoÝ ²Yôl;êÈ“lCe®†åjÐx­m´ÖŸÞ-jªä¬õ®5cVÊw Me®†åª3 ö¾h‘}ë¦Õùú†gSåG~;©Ì5ÃÈ3ƒŸSÆ,µNgÓ»qclþ»@VÁž%²oÝ´C¼)ÉÏt-Þ£P®FžÜûS÷[JŸµ¢.ò˜t*sÍpW±§íR·o=Åc±ýáçß-Д H4ƒDsÍ0«ˆ›wì¿àåûz^4ï¸uÓóì̲#vø&—héybÊ$šAÑM~víý½*šÇ·–Úì\Síþ 1åÍ èÎ5›~­"T#~š}Kù€ôûž»ñG )hÅÑÅ:Ï^Â;'¼{Æô;-Д H4öSLú]´«ž5]ÍjM¹€D3a?ŤÏEËx§¼u[4jˆšr‰fÂ~ŠIŸ‹–ø…gU×E³3å¢ý“>mü²gÕžh1»ÿøø¿¯á‰=ÿŒ#„7÷ňI4Þ*öhr¯oÍ;¿ì³†á˜E×ùº¨ ݺO”wh…0«|ˆªíyü0Yµ‹x}ëZ¯kœ®•k«¹ö–£D´·y¢uDEx‡‚õeGmm{­¶þÛ&x£;ˆ¾oÝ a†LžUúMk[º ¯:u…«‚åÇßü6fÞfD¥öKãx‰'äšé„ŒèûÖíˆî‰Z“Rk룸Wÿ•Íõ‹!G×w;á[ÓŽèžijf{#¾(NTW!¸R|0|ë@¶Ôñ K´ Ûv+$Eælí|Nu݆oˆ=9rÕs£¡vð—'Í62¯ºvŠ¨o])¶¿ßGE[-±‹Bhθô­Óv×yÑ4ÏÖV_ð‹Ð™9Û¸šS]ÁADз¶'¸Ã‘–>J×ÞLúç‚hK± è[ÛÜá.‘·pŒ ÜÏ×W©ºŽ‡ o}ξ0þž%bP"ÐäÁÆÕï @"‚¾uÖE+Y²úG²±C V§d²b¾õë®VOde#p·W6ס”‡ omEt·QÉá¿Ù°ìÖÐE"1ß:åmL·SsrñG!»¦¡‹Db¾5#\]š>ÎR× a;C‰,Ä|ëJÁwÝŽ¬äÐE"!ß:Éò¬»/dö7.)ùÖíñOÍçÜ8WÈÀÔ%È;Ó1B¾u{üÓN½@?CÌþ&ú½SÒ>Ç\ûô ýä̘ ]$‚³zòf+œhú¼¹É¡‹¤3„|kûø§z‘~r˜ýM ‹¤„|ëûJìõGV¬/VÀ1É?ØYë<¹-cI›!߷Ά&UÿØ^|«Z{IifÚ ‰hü¾µßøg›¤ã^<4²Öy0ò æ1 †h;µGDã÷­7K¡EŽ°-N¨ë<¹-ÍL"Z¢ði£çi‹ê|Ydßå*Öš*B9vŧ\„Úëe,ÑVýÌX nìaÉMÓ•F Çj¥æ'-ÑÈ ƒ5a¢žv\á,wúW1{W h µ7MÓÛ‹}²Ônü$ÁXICô–XæS§•|Æ2A<&ùÜ+U¾æÑ–ü3eE 7íSts‚|˜Í#^Aî4Óv}üÎ[½§­ nß:hüÓFÆÕŠf· ÌröÚÎ<9æî~†ô~üó''[Œ¶D‚ô?Ñ\²z½¢áYy<¢ÙÃ’Ï7ÓäÛL dÞ˜ÝF ¦œ<ÓLCä&Ó%qŸ¶:x}ëïËôŽ®,“Ø;6kÿ ݼô³æÅÆ+p?cßF4£ŒN;"õônœb†Š–2öo›ý$v«‰¹‡ˆµ·hŽÛäh·ö†h¼¾5—ÁOèîìªÿÊ¿öÉ{öäLÑJèeüÁwÚØžOYŒ8?éˆÔGvÒfó˜ùôuèÆhVB§%z`Ͻô°ÜÎuDzC4^ß:xüÓŽÓUók iíw߈ ·D3EAÿqâ“´“ÑT‹vDb+¬ÐÐ!’Áä¹ýD4bÝÒYsOìž$”ÜåsÚªáô­3üï°9]5äÓ@:Dk5x]Z§ŒØ¡‘¦hd…†’D´…}¤×‘š{æä-€Am±ÈUlüw\Å0)O¤ðÊüjO›Ç¶!b^Ó‡¾¥ÓNFS«#Òlñ r§ì¼.9=—ǽŽÔÜ{Out6 ‚h÷ó ÿ´C£ŠØHU½{Û bòcsNÇ föh'ã„®[‘¦!‚WgšiˆŒ›Ä&?1÷ð—!Ì ˆÆé[óºàǨá¨7¤³öÛn“TáÏ·ÿ´‘ÜÊ»WôÉÈ,Ñ: QÞ¢¥ø|ëðñO;Ç=¥“u÷ä,e¢ À:NßšcüÓ~P¯¹˜h”+`²jtø|kžñO;®^cÌÑUç:-:|¾5wwH³üÇÞu:Ÿž Ztø|kBÆkŠ˜5‡·¢E‡Ë·æÿ´ã5E°·fï„Œ˜1ŒÝª/h7àò­ÇøÆ?mdYÁìz®½ ï…Ýá{}÷£[éfHÑa-Ä·–ÒÒä¥ÂËxÒÏÑHš’ÛÈ:ý†IÝJ7CŠ£hÁ¾u¶ÓñO™ …Ð2žô3dMK4„ô…œn¥›!E‡Q´`7,útp&GÂÿ xÒÏC§™¡pdAÝJ7C‹*¸hŠ ñ­ï+Êý¹ lAOúò½eˆPѬt3¤èŠ–½´5ý6çaxí_áN?£[ŸC(Z°o=~Yöï…öswcéÖçŠì[Ëÿt:D}áœÎmÝ’ÿƒ|Y”BÑ}k9ãŸNø²( 0„¢¦J–4þéäOe†P´@ßZÒø§ ž,Ê ŸhÉ öÒÆ?% Ñ8ô­¥ºx4È1ndøfcúÖòÆ?¤®åü7^'*Ú.uWOA¾µÄñOG;Ÿh>Ìì8à¿Mæø§‹ÊUW¼Ÿ ò­eŽºl ‚|k©ãŸ. ì€ß:Žî6a½Y€?¾µäñOÐ@F&È·®—býé×]lÀŸ„˜Ž§;¤Íò‡ªkߧøÖqu‡´ÈTÕùA†‘esqÿxk‘ð­cÿtó<Ö¢àï[g…ÓE€•EÃß·>½Ñ…Ÿ‡TQð÷­ãÿt©0"àë['â6ø-ŽB* Qü}ëØ þ& C”„¯µ×ø§—¤S _ß:b: H<-¤¾ ŒpX܃{M„eŸ 1Ž28±þïT_‰>âxÎgCœãŸ ^l@Ø@nü|ëxÇ?®~PT|-ú?ß:ÞñO©ÍÕT{-ú?ß:z: È$—jóæ§p¸Ça øèç[Ç4<„Wªøfƒüñ!øùÖ]ëq’<[»ZžÊ?l“ùÇ.³×WrŠNèp}D Á'Ur|ÓÁCIžÑBðñ­Çº1þéˆÂñsõé Ï D ÁÇ·æÉ Þp†¡Û¶k†1ëÚe¸DcûÖÝÿdã ÷¨;¶kè ݵËp‰Æö­;NÔÞpºù1¯ï5RÆ~´× ¢Óæ7+àê‰æã[woü“…7ܣ٠ѥ[­ÉêÝÍã[sŽº›G”6Œý ܨ¤æ'm%zŸY•–hVöl í'Û´"ͯ]Ä¥Z¢Ñ%5¢y}kÎñO·!‚Æ&ÑMßy«†nNè¶=‰Ï¬Jœ@»`þG³gkè†oâm#·œ2·èøÃid'n Ö’Ñ<¾5ïø§ÍäǦ³Ž´Z¸ Ý£™«fí%zï¬J‹f"ÛŒm†•="³¶9¦©!2E"†È6ÃZR#šÇ·æMÔ”dÛma%zñY•‡ô ­]Íã[óN¼‘ 4üŽŽ?]Íã[óN.ÑBè²hnß:Ë1þIÑltY4·oÍ=D³ÑeÑܾ5Ïø'D³ÑeÑ\~úmÎýÿ¡EzA´7Ükžzøý þ-íz„±f®2H.ÕúB´5G}þá÷/Ôj[çßèoѲ?s./–yö:\]ûÎ\ÌC|¤VkÖ/õðÙsÚúù‹_.¡H³*Ù=ÙÍj¹ï,.ƒÿDã­zFvâiÉs?ÐR­VÃcƒ_ã¾ÁÞÿöß6+¬Ê`f»)šË·æÿL/¯/ŽS‘=-›šÕÞ;{‰Ü`ß.vó²Æ‹Ë·æÿ<\½ZˆåT$?gæˆfµuû 6 ¸|ëðñO³i - É¢ÝG4«ñZÃýIJc)tü3¹´ú¸NE²hó "Ú æÑvúÖa㟙û× ±Šìæ1ùpÕm5¶óUÇŽ¥ñÏDõJ>¾SaŠ¦óíË(fz‰É/Ukëñ°*œ¾uÈøg¶×ãŒà‹¸0ÛTCoÓY éšg-uíŸ}?Æ3V„Ó·ÿÌ6~ë¹xç"š.«N·éíbb¢ "ã+ö¥ÀñÏ£˜óvzæ"&÷ÝŠGýG½š¡ï%³OæWá ‰xØÏKœ s4s=]šø KNß:¨;ä赸s­zæ"ŽNÞD¦æðš=E<qWžÞi7Ñù‡x^âN2)ßiti§¥ÖàŠö•²m!¨;äµõØLý&ž¹ˆ#³wà©k8ž£n®§Ñ©hxBbéeò‘·f¾éÖRÞš²=¸¢9|ë€ñÏìµø3›yæ">gESÏ+Ef#Z¢á ‰¦hûéÜ{K4kiàEsøÖ÷•üŠe¿Šÿ\}À±þ5ž±jOóH.É+,Zfyý ]­¹ýôÜA‰0$vO†zlùÖÎñÏT£Ì±³ÛÁßÿèI"ž‘h»*¡¤ê1¾õ3è#É¢Mh÷d¨Ç¦opšŠ¡Ö¾ý\í!Gi˜tQCä•Ø^ô‘"4vO†zlúÖNƒÿ¾Æ­s ˜¦È%Úk1¿AåïDËž õØô­㟉k®eucX—ÚÕ(gëÝ[¡ÏÓŒÃà¯sÎÚ—$Ú±õrWë,xz’.„D,ßÚ1þÞ"p®áWåØj¹«U<=YB)k8Æ>þÉÑ"p®¡WåE•šõ¥hÙÓOûø'oã(G´×¶§'ïBÈÃò­í㟜–#﹆\•£j5ëKÑvlÛøgb«À¹oòlƒã\ƒ¯JWÞTŒ~z¼tW´WËäÃ6þÉÝ8>__ÿ§=á³Ø¯JªÚʼn°LäL´ìn¨Gê[ÛÆ?yÇÛµ· £õ¹9à ÉзÞxfVv4ýð:Ž*p0ÛMÑ6Éßvw§[^ª]}¨ó_Ÿ¼Ì3³Ra¦i5PߺÝRùÇNɃ )óH…$ˆ=,ºžiZ ¤1l剌ø|uý—y ¿}‚ÃѼPßz¬™Ô)u-ºK?Ìdüö‹<><ˆæ…úÖ§ËÖbø€ ~˜É ÛsøZ™£ˆæ…ú֛ͥÐgŒ¤‡™Éa> DóB|ë„5·'67õyi/E ×ÖùBÉ0fV.Ìâ5:þc´Lt{é‡øÖ;VèÂÉË&.Iz˜!|Ÿq†ÿa̬´9²zkhR·—pK¨eð''îgÎ6®J©|±Æ²É;³2¹ïÖm³£ŸÔq{=If#’¶ÒƒLêâC›è¯QÚz¼ô‘ô†åþ„Þ™•8ä D€å À`êø™%áùÐ#â¦Þ­V¶­¯ndü0“e柩­àäk9±ÝþÓÿõO“"å‡A´ûÌfÑÔk«f%ó³8SÃÖÿ³’`0‰Fí]t°&ò8Ëd!´\òY+u§-ZˆææµÿÕ´@^5oƒvËE$¬mÈü™“žC¦=-eêá³ÌfÙ$Ds³c-Q{Ç´!mÙ"ÓÔ ¸,ñWè?û!Óu‡‡Ñz„1r­Žp̬T5ý0Fùϼÿí?®ýÉŸÔÖm«þ½Â¾Y‚"„G´\øÿ§531Uo»…ôv®ùóÀ3³RÕôÙš8øYz…}{ü#„B´ÁŸ6g&¦ª4|wûVR}zŽ¹…¸óÿüýÿåÒ[~GëtêûÈ$Ö¬¶þuK0[¸L  h˜e:í3VßÙ¦ —H‰f5–’º4•Þ­ ú²ô6\¢-˜ÿÏÈM÷Y?rËÙ†»ð`‰6a|êÁ¿0¦4ŒÏ/ð‰öüÆѼáuW 6ʽ¶‚Ït3g« ZT´/íýéç?wǃ3·Ïp‰–YbzØŒðˆ®Z3À”{5ôY$¾PV}Yz*Ú§œxp KóE"š±wþÁ/NÏ™·ÝÄÌ‚ùw÷´¹ÅØÛí•j-@4GxDxß1öÞa57ÞAEû7´÷Ê^˜ágÓFIœ~L× dm+¢õE+=A4.\&?Í0þÂØýàẪwŸ2E›Ø3C ‘ÝSÖ3-±Ü<ÚÃ#†>?¥£=$HâÜ”¾Í Ï´VÐ#r0P4ï4ÄägøÎDã¯Gda*°Ë´ù/3Žæ×#bà;*ZúlAõeém¢ö=¦—VGë|h‘„¸T_–Þ¦Ç:Œ'ŸÝ„¾ÇPzL´uê:äT_–Þ¦ÇDƒ¡zL´ÿ©5p=`IŒ¥".Ú{ßð«Úù3í0öÜ×ÿœ$1vÏr,"ÍÆòMÁ!@çºqáT‚o«‘‘ÚoDK|¥ ñW ›h+¾ÅðCŽN`-Zk@4Äû[rM[sŠSxñ‚¼·@M^À?SårÐZ9\DcAäz‡6_¥æJó´Ž#QÈ˳„ßS\«›¥6ZÂh,h»µäzåâQ|i“g’¢q"ò¶ÓÏÓu^Ñ0ä!ç+š°fHD[u½ó—©‹?µ$ïµëJí²Õ‰'°uó<¼“,qè9Ԗ裩ëЉV£Þn›ì ý|es]RjÕTca3µVé*öN²œ»û¼ª)ÑÔß=`}>ÑÌÇOÄégeE ×2#óÑöµ—~÷ȺÀûÜÞI–·™Ë»¾5©‘?· ù]9Í %t Ýd¥œÑÖòÉÆ;þ!:S—jo%ý^ºˆN4ÖK¼Å½“,±h8{1ùSBéÛ§ðª9Ã\cÐàªÃ!Úú–i'”Qb«èWÊ|´I Dw¸ñvž³¨w’%^Ó o|‹†ç]’Tö˜!­±^>^FióûÉ€ ò'ª«ß“ö£ÙÚÕ"_Iï$Klˆìz 7øúÌ_Màæqæ1S´¾9I‹+¹’]äÚ/Ÿ~“îÀàµ«9Y¿z|3¶ªw’%þÞ2Dp»x36Dæ§tlˆÌ’â/Z_FÉ-º0èø&ä=ÚRµM>ÕxsP;xÑÌ húÑ‹eú=$£ÓóuY¶ãkK\ªA7–çÛé’S!¹Ó’W¥<ÚµGx"†ƒh>TòíÄägÂßÔRí|NÆ®¡%ŽœN š8qI%g-Ô7Š?)%Bÿxízd­V Dóg–Ü~ÙZÈn•Bw2hS7ïéGBsHh>à ×éV~ g­‰ŒA›#2J†fÑüøÀüÿ¾‚µ ËÆEè|Ð&µjþ[ÉÔ\ Dóg¼kgßÍú%Upr¸ÓA›Ê…Žûœ1RꟅ9žsä¹n ÛÁ#ÿecýŸu0-qüÚ Â3 ï úµ“,o¸aW´Ë ˜PÛâ^®c8bëˆÛ7­} IW(6]9`Zbr‹ü;9¼ôkÝD0¡¶_.rÕ&¹Ž˜ý²·Á‰A;`4°X/à×DR<ÅI´÷Š9E“~iüO>eËo½`Èm|k…| w׺B‰†Îá?íö¥WÉ-sÕzŽ.­•:>¨úL´År´è¨)O4T©é—GzBµ>¤M¶·hÙׂôýy ùcmÓGر¹Ñü¹JBW*DE£µ‘(š&tcØi¦à%¤}-Hëççd ¢aäðÌ Ô-1ÝZ²¶à%½]ÍV²ï5ãÈ'—{à¹ÆH¨­{/ëÄ^lÇF¤¢}­|lÆUó-C.ööÑt±KA??:óä4ù×éxŽj‹6²§}t‹ß†ÎŸk~3U+t~Ù;ƒ‘P[wÑÌ’­‰–t#-½ö’ãªy ‰‰†.á?ŽöÑ7O9ýymÖü‚Ï—Ä/{œŽýãɇóúã_Í_n×È?Vs‹¹2eL˜5$¹ ÛGÀTl7÷Òª´yzñ&ÔfE²4· ½††¾:¥[ÅIdÌ•àc³®Âq0ÍÃXá0ñU²F8ıÛþ.¶õó%ô2™ÍfÝid&"ž|x ºcäÀÈ]æÒLšüc5WŽ|‹†<¢í¸d«ëÒúº/”oBmV$Ë¢¹jOO»¤µ±"c®›qÕÌÄ º¿Õ ‡‰¯’í4Â!–Úþ;ûº,{ŒÒõóÖ3ÌgÓKèÆÑÉ4¾ï&®7ÿ•î§+_Fúh+¬q[´öC ó|Ã7CWð&ÔfE²,j8«6™ÁGŠÿë*Ï;˜Œ«†H(S|á¬p˜æOØN#Ò'‚ÒW+O2ÇMÜ7:mŠ‰hdòaÚ0ö'Œ‚†Ró“Zzš¬Ä5Öî~Ü#ZòÊyû¡W93¬Åƒ7¡6+’å,±ªÚ¢}¶õ2D?e]5’ ;Ó ‡)*µDðŒU;Ìx÷#•ÖŽLB$“Ç&ÑMßy«†nÆ3µŸ+š+GvšÍ£öЄG4´Y)ÙÚ\•˜h/¢hÁ‘,G§ÿnˆ¶ë1Z›SóŒi㿱®IÐýX3&¾JB¢‘Ñ„Æ?v¬L]+{KÚŒWl[¢C„L>Ôrhá&t¹„߉›4WCdÌ`ˆvüÑ çÑ &ÁŽA´àH–fs9CDk"‰:wóè¸j†ã`C„„Ã6DÈè jÍlÂêi^òm·E½86Ѷ¿Ùµñp}­ÜÉ•ïß„Ú‘,§Qò,·hŒ«vH÷;P,íøçêe¯Ý/±Ë|–~ä™ý•H÷*ß«ÉÒŠŒ¹Â]g'šõzÇixÈþÜþÑ"]õœ¯TÑÒïón?Ñ7ÿ\„ÿ0e/óþî:‡!ЛfŽòÎÕc»_ªhè|¥è-`Þl’^?å%M‚˜LFÙUY‡±Érž|¼¾áZÌýX“+ÚòÓeV‘ç«òÞc 㩇ÿü ^òNFÙ]¥hxƪIÂ󌩸krE;~â2³LjIÆŒØ0è †#ªáÀ\}64c2¾B?é{ŪÎD劶ãOýÆ>_]ýÓŽ*šðwõü­°Ný'Zs6ÖÓ+î-YçôrE_¹êW ¿ìOIóÇÖ¬¬Eÿ‰†,3.å}EíŒã±6eR›ï´Äì7ýO)õgò˜4¡7˜;n½Z{¢Ô†S4þŠdê^´.«+ ãðÖžéX4û´ÄÔÏ©[ïƒÆ„;êc`¤Çä×ÏâŒÚ¾ùcj[ÜÌuuE®Ú,¿hdò£É¸w¢Aºþþãò^ów}x¶ºþ˼à”Ê„÷O=üþ…̨¥ï]£ä¹¼g[¢ñ+±ƒñsž0øƒ_öàžÑO‰ªÓ¸iÞ`o ^‚ædÓ"xiû1»ž‹ég/¥Cã÷¤–„DË6Ú¡|SŸ¥>ØwK1¿bîËÓÏ,ë*¾×$· :^HD4ÔšÔàëo\º0 7X˽f¸j˜Ð7É"²Xt©1„_û:±é‡ òÿøeë‹sÖE2ìM²ˆ¼šûJ9´¿hGÉò:¾Á†"àëe§Ìss5rG¹ÙOjmÂF^ô¬MËÍ=¾ÁÚœ¨þ6†ݾ‘úyh!žÔÚ´m½—«78^¶¾dÙ]öZ ½Jæ}v5´OjmRd.u–´Ý¿xªhÏ0fš"ñ¼ÿ—½ŒÂ-žÔÚÓz$²å»záT’j¹7G~Ç.ñ"G¸A²?FO+Ä“Z›@œëÌYü6÷°Ðò˜Ò[>%ŽIŸqŸx·ãÉžÔÚ„¡ˆkàd1×üÆ6E~ÿ¯ ÷7M3$¼O„'µ6-By6ßÕë¦[X ßëøˆä7¤“ïY¯Á“Z›Á¢½r©V+vÿâ©Â6«žó+$[µ+6³ÕîÔÚsɇ/ —õˆlÆ÷vÿX"\!ÿø±.ô…;µö\uØü4û» I÷\:'Öeöœ·æò¿Ëê‰éúô$¶wAOnø{±&q0~ m–‚Ëð‹öUíÜø®â¶‡Z"(œña‰¯I`ÑžÞ.#ÐËŒÜi$'Ôùï2ˆØƶsEÚdå½Iv? 2V)"ãi'h~ªdk8mà{ûmï@_Èô¦¬W¤—ñŸöQhäúD;©ØS­ë¢ôKÕ;Øø[ý„ƒµ‹R~²‚ÿ„´bsDNÔìã4/ó ßr [¢äñ«ÏËi"K(´}äŽúH]ì=.¾åj{ËÙjÉ€nWñÅã=2‚#/à¿>ã ×E™Ré¦}˱'D ÷Èð1NÚݽþ¦o±h¡™ÁO¹¶‡vË¡}Ë•b¬S—±?ÔR[¾Å¢M{g>œè‘ô–à‘: }ËI˜Ê1̲TRö‡ËÉ¿b+ø‰2ùðWˆ‰ö-——_§nc"åë`K¬àŽ2ùHð&å•H²9Óî诧õ„hŽ÷Å ŸR+ØœË_Ù9<þž¦Ô>ÿÆòêÔm=îY¿ž\ÑtÖÊVĵѲ nµ&™¯G~åº'DË8tòëËb„F4hlÝ*ñ€Ýª ­5íQÕ­Öä”·Nº«ˆæˆDªùÖ©ëÔK¶…q§—‘F1±êi ‹ˆ8EKøE˜ì\á{T4gR½TAÇLĤž"sÍ[lo3,"^˜2 ÚÄ´o³—›ßx²ÜÄ_¸G™ÇF=e䬹–½ š3þ‹Ï­Æ xH§sÑŽ‡XD8,"^˜úÖ¤¶Óš&ÅíÇÍo™€å]€/Ü#ŽÌ¨åNáœÚ=t§¹&ü²o5FhD°×ñ¶fXÄQ+¢aÞ¿‚‰_´¾Uh‹ð†{Ä‘·MÍâ™E½$š=þ´ß­Æh‹ëØ ‹h.Pþ´Oå¯Äóf|á±vèk{pNí^ÍÚg„†ÏA´â:6Ã"š S8¤“¶©ê†ºzs…{$¢pNmk®eOˆ–rÞ[Ì[Ѭ 1D¬¸Ž4,"^À†HпJûÛŠñ½&W¸G"Ú˜i^2f·õŽ!‚ÐfÞ±Èzªù†Fd Û¾³*興{,4ádlD ÷Ø+¢¹‚š±(Eº±ô :DC•˜^'Z¸Ç^Íô‘ÑU!³sÕ9)­çÀ"ë±dVÐÝ ÛPr¯õ¹h)·éqòG1VpÇ÷šlUE*Œ> 5“Ñ5I]+ÄWAFH Sµ|×+Ýï¢íXq­8ãꀑqì²w]¢ÞýÌ\2ë¤O$ãd5çXŽ‘1ñ®wÝ¡?ùÑrhw0%Qf”àêAèhè{Ñ‘I2-’º§§$vO¤wTß? '罫$E).ѲžÐGÙø&0¢ƒhQðaŒo2@3z² - §Ëî5ß|¼²Ã{`- c^“n<®É G-R2mo!-É Wù‘øqxÈþ³J$™6Z˜µí9Ì¢±²¤œ©0¤Á°ùE’i#Gö¡mœáòÆ5[ÊfI$™vrß­Í4ÑtÂ)@0l¢%YA¼cš-å5E’iNÞÔLMc’„a°*I³lÛI¦=2{G3M4 hã¬ÐÂGc ÏïM‚!’Lû9Ã(Zi¢I3J P†N4v’ƒXÂó{-‘dÚ÷ ‘Všh<5‘  ŸhÌ€~IfÂòNñtd‰$Óž1bVšè9¼  ŸhcÌÐëÙFYþOyþ}DI¦M}Ã'šO˜£’ƒtbÜ“R"ucQïÛÁŠæpà„|Õí1z@´èÜWðÛ²$+F§…ËèÑ¢³ý÷¾›Ê >íq ;O¦ÝSS»J& 6Ü‹µÿWæ,DgHùgäˆÖ3S»ÊbÙw“xxÄÀ÷ÝŽB7ÀŒûgŸú(ZXÀp€›€¸’E ‹s ðãçªÉ-Àèħ3X´ÌV^ueßD"!éšü䛃¯)ÂòQCœ¢¥àV“†Ÿ)"ò‘® su}ƒï¢<½Â^ÏòQC_Ò­¢Á¨ˆ== ø™"¼!5´ë[:)Ú©´O5Yø˜"¼!5<ó  žjÒg`s‡|äÍúˆ ;ywÈG´ë1 ÍúˆÊöYkyC>ò"&g RÉsyÆZ‘Ñ’1¾?d¼´ÂX)»‹’…RÌœ\ñˆ†ŽA) ÖeL¢%ë*#†¬ä=1‰×;pCÃÁŽK4”]/ó‚aLˆM4ô¢üiçÉ÷V‹O4t,†s†‘1Ï­&‘âÜkRð¤T(0 ñ:ùKQ=~^õåê Æ»ë?=²þG5ˆŠêËÕ#øN‰‡µïw0_Ò»}O·g“®^-€hr_¹»¿—Ú\Ñ:Å7rlœÑ:¦û9ÃDóþ¢5I¬æ»ü‹T4ÛÔJ­e궬œ6tú¢µx´Û³¥¨hö©•­™°z3Œk3ˆÖ"u­ØÝœ¶þ¶§V"=½{fÛìè„¡ëxÍ)#§MLOL[_4C'»€hmÎ|ØÝߣ¢Ù§V"}äÞ9tãÍ槛Þ9·sÎúwš—¤O‚ù¸p‰†)éæc =·¿Ù‹ßˆ¦­Ñú­ñ-4 5ÑÁˆôøŒaË;Mþ-¬¨5» DS#Òã íØ­…hjaDzÄS3ðÌCü'½[7p”G£¨MLãéÝ3æúæ”DM ŒHó»rdæ!þ3²“48)5žˆxˆÌTÜ•‡;M)ŒHéÛ§èäQƒ$™ÖhÀ@:±¨‘ð šR‘zŽÎ<ÜORŠ7Eß›Å3A4Å0"=~æ¯&èÌCón MJmŠ–Þ?rË)ÜDëC@´>DëC@´>DëC@´>D<Òc´¨€DÄ#=FŒútÿtغt6³øü%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPStatisticalBox.html0000644000175000017500000033101114030601040026047 0ustar rusconirusconi QCPStatisticalBox Class Reference
Public Functions | Protected Functions
QCPStatisticalBox Class Reference

A plottable representing a single statistical box in a plot. More...

Inheritance diagram for QCPStatisticalBox:
Inheritance graph

Public Functions

 QCPStatisticalBox (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QSharedPointer< QCPStatisticalBoxDataContainer > data () const
 
double width () const
 
double whiskerWidth () const
 
QPen whiskerPen () const
 
QPen whiskerBarPen () const
 
bool whiskerAntialiased () const
 
QPen medianPen () const
 
QCPScatterStyle outlierStyle () const
 
void setData (QSharedPointer< QCPStatisticalBoxDataContainer > data)
 
void setData (const QVector< double > &keys, const QVector< double > &minimum, const QVector< double > &lowerQuartile, const QVector< double > &median, const QVector< double > &upperQuartile, const QVector< double > &maximum, bool alreadySorted=false)
 
void setWidth (double width)
 
void setWhiskerWidth (double width)
 
void setWhiskerPen (const QPen &pen)
 
void setWhiskerBarPen (const QPen &pen)
 
void setWhiskerAntialiased (bool enabled)
 
void setMedianPen (const QPen &pen)
 
void setOutlierStyle (const QCPScatterStyle &style)
 
void addData (const QVector< double > &keys, const QVector< double > &minimum, const QVector< double > &lowerQuartile, const QVector< double > &median, const QVector< double > &upperQuartile, const QVector< double > &maximum, bool alreadySorted=false)
 
void addData (double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector< double > &outliers=QVector< double >())
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
- Public Functions inherited from QCPAbstractPlottable1D< QCPStatisticalBoxData >
 QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual QPointF dataPixelPosition (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
virtual void drawStatisticalBox (QCPPainter *painter, QCPStatisticalBoxDataContainer::const_iterator it, const QCPScatterStyle &outlierStyle) const
 
void getVisibleDataBounds (QCPStatisticalBoxDataContainer::const_iterator &begin, QCPStatisticalBoxDataContainer::const_iterator &end) const
 
QRectF getQuartileBox (QCPStatisticalBoxDataContainer::const_iterator it) const
 
QVector< QLineF > getWhiskerBackboneLines (QCPStatisticalBoxDataContainer::const_iterator it) const
 
QVector< QLineF > getWhiskerBarLines (QCPStatisticalBoxDataContainer::const_iterator it) const
 
- Protected Functions inherited from QCPAbstractPlottable1D< QCPStatisticalBoxData >
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A plottable representing a single statistical box in a plot.

QCPStatisticalBox.png

To plot data, assign it with the setData or addData functions. Alternatively, you can also access and modify the data via the data method, which returns a pointer to the internal QCPStatisticalBoxDataContainer.

Additionally each data point can itself have a list of outliers, drawn as scatter points at the key coordinate of the respective statistical box data point. They can either be set by using the respective addData method or accessing the individual data points through data, and setting the QVector<double> outliers of the data points directly.

Changing the appearance

The appearance of each data point box, ranging from the lower to the upper quartile, is controlled via setPen and setBrush. You may change the width of the boxes with setWidth in plot coordinates.

Each data point's visual representation also consists of two whiskers. Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum. The appearance of the whiskers can be modified with: setWhiskerPen, setWhiskerBarPen, setWhiskerWidth. The whisker width is the width of the bar perpendicular to the whisker at the top (for maximum) and bottom (for minimum). If the whisker pen is changed, make sure to set the capStyle to Qt::FlatCap. Otherwise the backbone line might exceed the whisker bars by a few pixels due to the pen cap being not perfectly flat.

The median indicator line inside the box has its own pen, setMedianPen.

The outlier data points are drawn as normal scatter points. Their look can be controlled with setOutlierStyle

Usage

Like all data representing objects in QCustomPlot, the QCPStatisticalBox is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.)

Usually, you first create an instance:

QCPStatisticalBox *newStatistical = new QCPStatisticalBox(customPlot->xAxis, customPlot->yAxis);

which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.:

newStatistical->setName("Measurement Series 1");
newStatistical->addData(1000, 1, 3, 4, 5, 7);

Constructor & Destructor Documentation

§ QCPStatisticalBox()

QCPStatisticalBox::QCPStatisticalBox ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs a statistical box which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

The created QCPStatisticalBox is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPStatisticalBox, so do not delete it manually but use QCustomPlot::removePlottable() instead.

Member Function Documentation

§ data()

QSharedPointer< QCPStatisticalBoxDataContainer > QCPStatisticalBox::data ( ) const
inline

Returns a shared pointer to the internal data storage of type QCPStatisticalBoxDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular setData or addData methods.

§ setData() [1/2]

void QCPStatisticalBox::setData ( QSharedPointer< QCPStatisticalBoxDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPStatisticalBoxes may share the same data container safely. Modifying the data in the container will then affect all statistical boxes that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

statBox2->setData(statBox1->data()); // statBox1 and statBox2 now share data container

If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the statistical box data container directly:

statBox2->data()->set(*statBox1->data()); // statBox2 now has copy of statBox1's data in its container
See also
addData

§ setData() [2/2]

void QCPStatisticalBox::setData ( const QVector< double > &  keys,
const QVector< double > &  minimum,
const QVector< double > &  lowerQuartile,
const QVector< double > &  median,
const QVector< double > &  upperQuartile,
const QVector< double > &  maximum,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data with the provided points in keys, minimum, lowerQuartile, median, upperQuartile and maximum. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

See also
addData

§ setWidth()

void QCPStatisticalBox::setWidth ( double  width)

Sets the width of the boxes in key coordinates.

See also
setWhiskerWidth

§ setWhiskerWidth()

void QCPStatisticalBox::setWhiskerWidth ( double  width)

Sets the width of the whiskers in key coordinates.

Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum.

See also
setWidth

§ setWhiskerPen()

void QCPStatisticalBox::setWhiskerPen ( const QPen &  pen)

Sets the pen used for drawing the whisker backbone.

Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum.

Make sure to set the capStyle of the passed pen to Qt::FlatCap. Otherwise the backbone line might exceed the whisker bars by a few pixels due to the pen cap being not perfectly flat.

See also
setWhiskerBarPen

§ setWhiskerBarPen()

void QCPStatisticalBox::setWhiskerBarPen ( const QPen &  pen)

Sets the pen used for drawing the whisker bars. Those are the lines parallel to the key axis at each end of the whisker backbone.

Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower quartile to the minimum.

See also
setWhiskerPen

§ setWhiskerAntialiased()

void QCPStatisticalBox::setWhiskerAntialiased ( bool  enabled)

Sets whether the statistical boxes whiskers are drawn with antialiasing or not.

Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

§ setMedianPen()

void QCPStatisticalBox::setMedianPen ( const QPen &  pen)

Sets the pen used for drawing the median indicator line inside the statistical boxes.

§ setOutlierStyle()

void QCPStatisticalBox::setOutlierStyle ( const QCPScatterStyle &  style)

Sets the appearance of the outlier data points.

Outliers can be specified with the method addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector<double> &outliers)

§ addData() [1/2]

void QCPStatisticalBox::addData ( const QVector< double > &  keys,
const QVector< double > &  minimum,
const QVector< double > &  lowerQuartile,
const QVector< double > &  median,
const QVector< double > &  upperQuartile,
const QVector< double > &  maximum,
bool  alreadySorted = false 
)

This is an overloaded function.

Adds the provided points in keys, minimum, lowerQuartile, median, upperQuartile and maximum to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ addData() [2/2]

void QCPStatisticalBox::addData ( double  key,
double  minimum,
double  lowerQuartile,
double  median,
double  upperQuartile,
double  maximum,
const QVector< double > &  outliers = QVector<double>() 
)

This is an overloaded function.

Adds the provided data point as key, minimum, lowerQuartile, median, upperQuartile and maximum to the current data.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ selectTestRect()

QCPDataSelection QCPStatisticalBox::selectTestRect ( const QRectF &  rect,
bool  onlySelectable 
) const
virtual

Returns a data selection containing all the data points of this plottable which are contained (or hit by) rect. This is used mainly in the selection rect interaction for data selection (data selection mechanism).

If onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not selectable (i.e. if QCPAbstractPlottable::setSelectable is QCP::stNone).

Note
rect must be a normalized rect (positive or zero width and height). This is especially important when using the rect of QCPSelectionRect::accepted, which is not necessarily normalized. Use QRect::normalized() when passing a rect which might not be normalized.

Reimplemented from QCPAbstractPlottable1D< QCPStatisticalBoxData >.

§ selectTest()

double QCPStatisticalBox::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a selectTest specific to this plottable's point geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation. QCPAbstractPlottable::selectTest

Reimplemented from QCPAbstractPlottable1D< QCPStatisticalBoxData >.

§ getKeyRange()

QCPRange QCPStatisticalBox::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPStatisticalBox::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ draw()

void QCPStatisticalBox::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPStatisticalBox::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

§ drawStatisticalBox()

void QCPStatisticalBox::drawStatisticalBox ( QCPPainter *  painter,
QCPStatisticalBoxDataContainer::const_iterator  it,
const QCPScatterStyle &  outlierStyle 
) const
protectedvirtual

Draws the graphical representation of a single statistical box with the data given by the iterator it with the provided painter.

If the statistical box has a set of outlier data points, they are drawn with outlierStyle.

See also
getQuartileBox, getWhiskerBackboneLines, getWhiskerBarLines

§ getVisibleDataBounds()

void QCPStatisticalBox::getVisibleDataBounds ( QCPStatisticalBoxDataContainer::const_iterator &  begin,
QCPStatisticalBoxDataContainer::const_iterator &  end 
) const
protected

called by draw to determine which data (key) range is visible at the current key axis range setting, so only that needs to be processed. It also takes into account the bar width.

begin returns an iterator to the lowest data point that needs to be taken into account when plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, lower may still be just outside the visible range.

end returns an iterator one higher than the highest visible data point. Same as before, end may also lie just outside of the visible range.

if the plottable contains no data, both begin and end point to constEnd.

§ getQuartileBox()

QRectF QCPStatisticalBox::getQuartileBox ( QCPStatisticalBoxDataContainer::const_iterator  it) const
protected

Returns the box in plot coordinates (keys in x, values in y of the returned rect) that covers the value range from the lower to the upper quartile, of the data given by it.

See also
drawStatisticalBox, getWhiskerBackboneLines, getWhiskerBarLines

§ getWhiskerBackboneLines()

QVector< QLineF > QCPStatisticalBox::getWhiskerBackboneLines ( QCPStatisticalBoxDataContainer::const_iterator  it) const
protected

Returns the whisker backbones (keys in x, values in y of the returned lines) that cover the value range from the minimum to the lower quartile, and from the upper quartile to the maximum of the data given by it.

See also
drawStatisticalBox, getQuartileBox, getWhiskerBarLines

§ getWhiskerBarLines()

QVector< QLineF > QCPStatisticalBox::getWhiskerBarLines ( QCPStatisticalBoxDataContainer::const_iterator  it) const
protected

Returns the whisker bars (keys in x, values in y of the returned lines) that are placed at the end of the whisker backbones, at the minimum and maximum of the data given by it.

See also
drawStatisticalBox, getQuartileBox, getWhiskerBackboneLines
The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerText.html0000644000175000017500000011071014030601040026026 0ustar rusconirusconi QCPAxisTickerText Class Reference
Public Functions | Protected Functions
QCPAxisTickerText Class Reference

Specialized axis ticker which allows arbitrary labels at specified coordinates. More...

Inheritance diagram for QCPAxisTickerText:
Inheritance graph

Public Functions

 QCPAxisTickerText ()
 
QMap< double, QString > & ticks ()
 
int subTickCount () const
 
void setTicks (const QMap< double, QString > &ticks)
 
void setTicks (const QVector< double > &positions, const QVector< QString > &labels)
 
void setSubTickCount (int subTicks)
 
void clear ()
 
void addTick (double position, const QString &label)
 
void addTicks (const QMap< double, QString > &ticks)
 
void addTicks (const QVector< double > &positions, const QVector< QString > &labels)
 
- Public Functions inherited from QCPAxisTicker
 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Protected Functions

virtual double getTickStep (const QCPRange &range)
 
virtual int getSubTickCount (double tickStep)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
- Protected Functions inherited from QCPAxisTicker
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Additional Inherited Members

- Public Types inherited from QCPAxisTicker
enum  TickStepStrategy
 

Detailed Description

Specialized axis ticker which allows arbitrary labels at specified coordinates.

axisticker-text.png

This QCPAxisTicker subclass generates ticks which can be directly specified by the user as coordinates and associated strings. They can be passed as a whole with setTicks or one at a time with addTick. Alternatively you can directly access the internal storage via ticks and modify the tick/label data there.

This is useful for cases where the axis represents categories rather than numerical values.

If you are updating the ticks of this ticker regularly and in a dynamic fasion (e.g. dependent on the axis range), it is a sign that you should probably create an own ticker by subclassing QCPAxisTicker, instead of using this one.

The ticker can be created and assigned to an axis like this:

QSharedPointer<QCPAxisTickerText> textTicker(new QCPAxisTickerText);
customPlot->xAxis->setTicker(textTicker);
textTicker->addTick(1.0, "Bacteria");
textTicker->addTick(2.0, "Protozoa");
textTicker->addTick(3.0, "Chromista");
textTicker->addTick(4.0, "Plants");
textTicker->addTick(5.0, "Fungi");
textTicker->addTick(6.0, "Animals");
textTicker->addTick(8.0, "Vogons");

Constructor & Destructor Documentation

§ QCPAxisTickerText()

QCPAxisTickerText::QCPAxisTickerText ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ ticks()

QMap< double, QString > & QCPAxisTickerText::ticks ( )
inline

Returns a non-const reference to the internal map which stores the tick coordinates and their labels.

You can access the map directly in order to add, remove or manipulate ticks, as an alternative to using the methods provided by QCPAxisTickerText, such as setTicks and addTick.

§ setTicks() [1/2]

void QCPAxisTickerText::setTicks ( const QMap< double, QString > &  ticks)

This is an overloaded function.

Sets the ticks that shall appear on the axis. The map key of ticks corresponds to the axis coordinate, and the map value is the string that will appear as tick label.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See also
addTicks, addTick, clear

§ setTicks() [2/2]

void QCPAxisTickerText::setTicks ( const QVector< double > &  positions,
const QVector< QString > &  labels 
)

This is an overloaded function.

Sets the ticks that shall appear on the axis. The entries of positions correspond to the axis coordinates, and the entries of labels are the respective strings that will appear as tick labels.

See also
addTicks, addTick, clear

§ setSubTickCount()

void QCPAxisTickerText::setSubTickCount ( int  subTicks)

Sets the number of sub ticks that shall appear between ticks. For QCPAxisTickerText, there is no automatic sub tick count calculation. So if sub ticks are needed, they must be configured with this method.

§ clear()

void QCPAxisTickerText::clear ( )

Clears all ticks.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See also
setTicks, addTicks, addTick

§ addTick()

void QCPAxisTickerText::addTick ( double  position,
const QString &  label 
)

Adds a single tick to the axis at the given axis coordinate position, with the provided tick label.

See also
addTicks, setTicks, clear

§ addTicks() [1/2]

void QCPAxisTickerText::addTicks ( const QMap< double, QString > &  ticks)

This is an overloaded function.

Adds the provided ticks to the ones already existing. The map key of ticks corresponds to the axis coordinate, and the map value is the string that will appear as tick label.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See also
addTick, setTicks, clear

§ addTicks() [2/2]

void QCPAxisTickerText::addTicks ( const QVector< double > &  positions,
const QVector< QString > &  labels 
)

This is an overloaded function.

Adds the provided ticks to the ones already existing. The entries of positions correspond to the axis coordinates, and the entries of labels are the respective strings that will appear as tick labels.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See also
addTick, setTicks, clear

§ getTickStep()

double QCPAxisTickerText::getTickStep ( const QCPRange &  range)
protectedvirtual

Since the tick coordinates are provided externally, this method implementation does nothing.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getSubTickCount()

int QCPAxisTickerText::getSubTickCount ( double  tickStep)
protectedvirtual

Returns the sub tick count that was configured with setSubTickCount.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getTickLabel()

QString QCPAxisTickerText::getTickLabel ( double  tick,
const QLocale &  locale,
QChar  formatChar,
int  precision 
)
protectedvirtual

Returns the tick label which corresponds to the key tick in the internal tick storage. Since the labels are provided externally, locale, formatChar, and precision are ignored.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ createTickVector()

QVector< double > QCPAxisTickerText::createTickVector ( double  tickStep,
const QCPRange &  range 
)
protectedvirtual

Returns the externally provided tick coordinates which are in the specified range. If available, one tick above and below the range is provided in addition, to allow possible sub tick calculation. The parameter tickStep is ignored.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

The documentation for this class was generated from the following files:
  • src/axis/axistickertext.h
  • src/axis/axistickertext.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/plottable-bars_8h.html0000644000175000017500000001335014030601036025042 0ustar rusconirusconi src/plottables/plottable-bars.h File Reference
Data Structures | Typedefs | Functions
plottable-bars.h File Reference

Data Structures

class  QCPBarsGroup
 Groups multiple QCPBars together so they appear side by side. More...
 
class  QCPBarsData
 Holds the data of one single data point (one bar) for QCPBars. More...
 
class  QCPBars
 A plottable representing a bar chart in a plot. More...
 

Typedefs

typedef QCPDataContainer< QCPBarsData > QCPBarsDataContainer
 

Functions

 Q_DECLARE_TYPEINFO (QCPBarsData, Q_PRIMITIVE_TYPE)
 

Typedef Documentation

§ QCPBarsDataContainer

QCPBarsDataContainer

Container for storing QCPBarsData points. The data is stored sorted by key.

This template instantiation is the container in which QCPBars holds its data. For details about the generic container, see the documentation of the class template QCPDataContainer.

See also
QCPBarsData, QCPBars::setData
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPCurveData.html0000644000175000017500000003703514030601036025006 0ustar rusconirusconi QCPCurveData Class Reference
Public Functions | Public Members | Static Public Functions
QCPCurveData Class Reference

Holds the data of one single data point for QCPCurve. More...

Public Functions

 QCPCurveData ()
 
 QCPCurveData (double t, double key, double value)
 
double sortKey () const
 
double mainKey () const
 
double mainValue () const
 
QCPRange valueRange () const
 

Public Members

double t
 
double key
 
double value
 

Static Public Functions

static QCPCurveData fromSortKey (double sortKey)
 
static bool sortKeyIsMainKey ()
 

Detailed Description

Holds the data of one single data point for QCPCurve.

The stored data is:

  • t: the free ordering parameter of this curve point, like in the mathematical vector (x(t), y(t)). (This is the sortKey)
  • key: coordinate on the key axis of this curve point (this is the mainKey)
  • value: coordinate on the value axis of this curve point (this is the mainValue)

The container for storing multiple data points is QCPCurveDataContainer. It is a typedef for QCPDataContainer with QCPCurveData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods.

See also
QCPCurveDataContainer

Constructor & Destructor Documentation

§ QCPCurveData() [1/2]

QCPCurveData::QCPCurveData ( )

Constructs a curve data point with t, key and value set to zero.

§ QCPCurveData() [2/2]

QCPCurveData::QCPCurveData ( double  t,
double  key,
double  value 
)

Constructs a curve data point with the specified t, key and value.

Member Function Documentation

§ sortKey()

double QCPCurveData::sortKey ( ) const
inline

Returns the t member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ fromSortKey()

static QCPCurveData QCPCurveData::fromSortKey ( double  sortKey)
inlinestatic

Returns a data point with the specified sortKey (assigned to the data point's t member). All other members are set to zero.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ sortKeyIsMainKey()

static static bool QCPCurveData::sortKeyIsMainKey ( )
inlinestatic

Since the member key is the data point key coordinate and the member t is the data ordering parameter, this method returns false.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainKey()

double QCPCurveData::mainKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainValue()

double QCPCurveData::mainValue ( ) const
inline

Returns the value member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ valueRange()

QCPRange QCPCurveData::valueRange ( ) const
inline

Returns a QCPRange with both lower and upper boundary set to value of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemBracket.html0000644000175000017500000015333514030601040025317 0ustar rusconirusconi QCPItemBracket Class Reference
Public Types | Public Functions | Public Members | Protected Types | Protected Functions
QCPItemBracket Class Reference

A bracket for referencing/highlighting certain parts in the plot. More...

Inheritance diagram for QCPItemBracket:
Inheritance graph

Public Types

enum  BracketStyle
 

Public Functions

 QCPItemBracket (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
double length () const
 
BracketStyle style () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setLength (double length)
 
void setStyle (BracketStyle style)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const left
 
QCPItemPosition *const right
 
QCPItemAnchor *const center
 

Protected Types

enum  AnchorIndex
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
QPen mainPen () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A bracket for referencing/highlighting certain parts in the plot.

QCPItemBracket.png
Bracket example. Blue dotted circles are anchors, solid blue discs are positions.

It has two positions, left and right, which define the span of the bracket. If left is actually farther to the left than right, the bracket is opened to the bottom, as shown in the example image.

The bracket supports multiple styles via setStyle. The length, i.e. how far the bracket stretches away from the embraced span, can be controlled with setLength.

QCPItemBracket-length.png
Demonstrating the effect of different values for setLength, for styles bsCalligraphic and bsSquare. Anchors and positions are displayed for reference.

It provides an anchor center, to allow connection of other items, e.g. an arrow (QCPItemLine or QCPItemCurve) or a text label (QCPItemText), to the bracket.

Member Enumeration Documentation

§ BracketStyle

enum QCPItemBracket::BracketStyle

Defines the various visual shapes of the bracket item. The appearance can be further modified by setLength and setPen.

See also
setStyle
Enumerator
bsSquare 

A brace with angled edges.

bsRound 

A brace with round edges.

bsCurly 

A curly brace.

bsCalligraphic 

A curly brace with varying stroke width giving a calligraphic impression.

Constructor & Destructor Documentation

§ QCPItemBracket()

QCPItemBracket::QCPItemBracket ( QCustomPlot *  parentPlot)
explicit

Creates a bracket item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemBracket::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the bracket.

Note that when the style is bsCalligraphic, only the color will be taken from the pen, the stroke and width are ignored. To change the apparent stroke width of a calligraphic bracket, use setLength, which has a similar effect.

See also
setSelectedPen

§ setSelectedPen()

void QCPItemBracket::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the bracket when selected

See also
setPen, setSelected

§ setLength()

void QCPItemBracket::setLength ( double  length)

Sets the length in pixels how far the bracket extends in the direction towards the embraced span of the bracket (i.e. perpendicular to the left-right-direction)

QCPItemBracket-length.png
Demonstrating the effect of different values for setLength, for styles bsCalligraphic and bsSquare. Anchors and positions are displayed for reference.

§ setStyle()

void QCPItemBracket::setStyle ( QCPItemBracket::BracketStyle  style)

Sets the style of the bracket, i.e. the shape/visual appearance.

See also
setPen

§ selectTest()

double QCPItemBracket::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemBracket::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ anchorPixelPosition()

QPointF QCPItemBracket::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Returns the pixel position of the anchor with Id anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor).

For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor.

See also
createAnchor

Reimplemented from QCPAbstractItem.

§ mainPen()

QPen QCPItemBracket::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

The documentation for this class was generated from the following files:
  • src/items/item-bracket.h
  • src/items/item-bracket.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemAnchor__inherit__graph.png0000644000175000017500000000153314030601041030170 0ustar rusconirusconi‰PNG  IHDR}k¨!gAMA† 1è–_-PLTEÿÿÿµµ¹fff………222LLNwwwççé+P™™™nnÑÑÓ~}rbKGDˆH pHYsHHFÉk>UIDATXÃíØ?oÓ@ðSrj©ªFQ„Ä¢€:¡ŠP7Ë~vŒTU(ñkaEöÀÆJŒÊÄЙ…«@;ñ˜;ñQxÏb*lSù„Šàž¥øÝŸ_|~¶bÅBØ0V§Zì,}ªEû‡ÇJýwÞ/õ1$xE?O=\ÉŽ8~uý×þ%?t¯ä£c xÖS?ŠÀïÓ2ºA7ÀéxF ö]HFàÑ.×ÏpŠ!{}ü€vÛñvŒq”P‚î ]îê¢û Ô/ÏÀf´apÀ …H™žT¶~ÊéÃãm#“GRïÕ/Ðõcèa§ç§~x;œÐúÙÓúóýêú¥¾ëO!I}t„cN¨~ä¹~‡á¾ÿ¬ÿ;½áïï¢WN‹ÇzÍß?Z6•Ù£éD}1òêÌÈŸ«&|C©O&~K©S¿©”šøò_ üù3NþsuÞ nr¶Ø\€uCOatûXo½õÖ[o½õÖçÇó²w<Êo§*¾>êt¼Ô{•OÎúì³ÿ|)aO82›ÃíeP·,ôÓgÑäFø¶-7Æ—=µWyÉñ=Qwä„ç¼@£»'xnß„fÜ-9—qø«ß G~ÓÇ£ã×v§"X ‡Ûwß·å“–^?ç/ú%^Ÿ¿is¸½ßpÖ܉ö”˹,[¿.}•Ã·Éˆ[næEŽ_Õ/õÍÚ½Væi͵fÄÝzýy~yývR¿Fõó2O5[§aêÖõËóBÄóë¼ÿ¬¿._ñí…ö£^ÕØ­¼ò'ÞÅä;{?v²à­(û%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_17.png0000644000175000017500000000122414030601042024474 0ustar rusconirusconi‰PNG  IHDRc#*j|rgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>ÆIDATXÃ혽NA…†ÙÊŠfyK|{y+è,„žf-M $¶jA4±)¥±²°´2XÓ, @s,fgÆf“ »Â~[0÷rïÌ=ó³(‘øÿ ²®  ybGd”£f£¬«IÄ3NT[[æYW–€95«¬UA˜uuÎx†µ#g£‘'öKF.1ÃU‡üC§k#Æ€ Îðw§>-\6Ù‹ÝXáÖ‚ÿÍ­Y›J¬YG¼ÓËúMUŠ~‹W WÃc|aºb;lç¸YÃr’ÔϬk_É~]FòN!#O2ò„ñ§qóÏZÆ^²®&WZ»Tü£ž# y¢ŒaÖ%¤ÀÇ!¶‰ÍïºX%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_i.html0000644000175000017500000001300414030601037025060 0ustar rusconirusconi Data Fields - Functions
 

- i -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemBracket.png0000644000175000017500000000304514030601041024102 0ustar rusconirusconi‰PNG  IHDRæ /µàøgAMA† 1è–_ÀPLTEÿÿÿô³ÿ ÿœìÿöºÿ›YòµòÿÉ[ÿ -ÿÜþÿþéÿq&ÿÿ³RÿÊ»ÿ÷öúü†åÿ*þVÄÿYÿ ÿJ¶ÿ cÿ•-ÿÿ3šÿèþÿé“ÿÇõÿï¯ÿ¡1ÿ JÿrÔÿþÙÿázÿÌÌý÷ÆÿoqÿˆÛÿÐfÿ°±ÿPPÿDƒýèèò’’’hhhPPQÑÑÑxxx--- ¬¬¬( ÔŽŽÿ b..þ «aa‹·¤Æ\:SÔbKGDˆH pHYsÃÃÇo¨dŒIDATxÚíšíVâ:F3„qÚÃPPAQ8ý*¥pæþïê$i…–°¶°žýCY\d÷MŸ¤¼CNà‡ô3zUˆ^]ů’\®Ti‘\Ëå¬çøüR’šõñ«ö»R—µ"{q“õO¤ ÕiƒÉÝR*7ËI•h‹T©&· ¹Óîɯ¦I:]åôÊT“6Ú¬†Ò#©2MæXj–Ÿ$QÍwššg¾j ̈i–šmîÂ-«a¤yÛ%‘æVüþ©]­fIîÕÙ¢+\ì3š÷ßnDl öû¹ß~ªµŽˆŠHó¾Û˜æ#ÿ·ëå¢}eW!e®%*·ù" UŠ"`ùÑZ^ëz눨ˆ4YiêR“}Dhø3Ò¬6Ò¶äá ð­Þ(Ðv]E@¼4øUQAîØÐIQñg£dì žÃꦉX/¯T“h7v缬î¡çZ딨0)y]³0 G^ÿMÛ’ðp˜æj Ò|ªñuutTTj”6_R—Ù _´•é†Tîc± "*BË£¢B7LÓ´,Ó°3´dÛGAô&Ë"¢¢Crû°¨°w4žÄ™šîãð¨P +i1γèaQá™nÂp_üôð5~uœùÔ0<ñ,×Ý<¸±…z¸b®èžËMÞf“íŒ,ï춽 s<ÙÉù1Dr¶˜ÿÍÆk‚Öeb¸‘ÓÜÖi@tvg²bÇð.Ĉ“÷²rfÖ“I‡Ä™ml¾l°v ™Œ/á±7‰½ö˜ÔvŸcϱÜõmcdæál²¤°ìý^SíeÕ÷íPÚmïiælõÛý¨Ÿ ÍJ­ëûþ+»›9;üÄ·5F.#‡kŠFN••oÕ÷åß“wºÊz3Gø&Ûó|fcša#‡WnÕ÷åýœ’Ü^5stc§ŸåxY[|F3lä(+ÍÛ.‰4y3GñÌ-‚\/ëoøÓ 9•„&ootdåj¶ñÐÄN£æù×ÄXàœPó½ï[ÿN“ù"¶EðÕ™ãÛoŸ&‘ªË¾¯=ŸÎù¡;\Ÿgì÷µ¨ˆo³Ky"Ü‚=ZDE¼J¿ï›fø`ag=ô-Ýüo„§[º¹:t§‚žïðWa/¿”½!YL{YÏ"m(V.éÒóÕ\´ÐReàë¢õœUë÷`†aëwxáËÖŠÖï îTaå ˆ~á[Š®õÝ¿øZ_%¾tÙgÏÿÓòب§M&%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPFinancial.png0000644000175000017500000000713414030601040023576 0ustar rusconirusconi‰PNG  IHDRÂú˜·gAMA† 1è–_ÀPLTEÿÿÿ“““ÜÜܧ§§ããã ‹‹‹TTT'''<<<›››xxxJJJéééccclllÄÄÄööô¹¹¹’‹³KKóÝÝkJ—6Âà¹k šÊ‹^—NêÄÄã²²Šxg«Ta¨N8ˆ$vµc XqÄ~ÏçÆâòÞ&y“Àcc¦44ÕªÓ†¾t˜&&ƒ ÊvváïÚˆSS$gxòîè2ƒ~))9r)ƒŽR|FI%÷XbKGDˆH pHYsÃÃÇo¨d ÃIDATxÚí [Ú:†«E |É¢xtLÅ9ÝtL·¹svþÿ¿:kÒ”&Ò¤Mš”ç¾¼†¥õÙkž¾/išTÏöÓ…°1}÷Ä=aÐ…î kÖw¯AÜMYè®°.ý}_oÜÖNd!0†Â)Ò:ÈÚ‹,4&¬®ßîdí……Æ„Õ)d!0²Ð]au}X¨AxoÏäW»›µwß7Œ3_ú@º+¬® -V=R»¨0 ƒ6Á§/={nª°º¾`a}ãóØpS…Õ,Ñ7f,"å³Ð°…î%‹ý…Ö%¬NlagŒÈËà…´dN‘1×å½ã-ë! +èO‚A¿3…ü1“° +0é&h·è»è‘ÖŒTÚ`¡{ÉbU!uÛÂÞ s·³Ê`……%Âלν#™ŸÌ±ÐÙ,tÚB¹¼jª…Rm`ƒ…\@c}G»²P¥%”#®[–Ž¸n¬° hœò>È(çh×idúƒÖ†=?çh…–PŽ¸n}Û-LX$­DœGM·P+,äs›V2 §Ç„ѼH]Kº@£²0ÅBá6X'_X[Äuë+Y8¨ø¬W°0àä k‹¸n”, Tþ«‚¹Í…ï:-t–òYxÔb gÄÂ"YÈÏh4< ¥,œ ø-a·=²€öékÃ-”ap »í)¤, ) ¥ÂSYhX¸ˆþá~’iŽ,4,\þWoKBjŠÌSÄOö@÷ì°p[óÿóäP–X@¼—µ—·0o¶h!}¿=¬vÅs2àI~Óm'Ž¢üýF´°a µ3‘Ë€ΠöéÌàá!™lwõL²,ìðÆc (¤’Râ…ÚBÃk¸R íÎè³pÄ7\«ÐO ¼ Þ¼ ¥P±ðÝ´«ÂÂñ$s7 iHåYëj²Y(¥oÞ€¿™ Ëâ÷R¾)¤ýaR¬—ÒC®"õÒ©A'ëɱ-ÍBþ‡}öDF]òr°Û4XøI i¯±;¢^ )=¦Ž«°Ð-ä²ðPe8ãÍ©'g¡ÐÌì™|~$,ô1‡;œ…ÓýAx’·É¿û‡Û-¬&n9 ÷¢îcÔ—Œ/`aÄf™ÿÛt«³ð 9²ÇEÖíGO–jÓgÜ°¿ŒÁŽÖa¡[Ķ…¦¨/ ƒ 1{·³©ì¼²a£…Ãä-iáxû'g °P‘ª,¤Gób£ã$9£žŽÒ 7Ö4lHf>,ü Žgá€\g÷|z½ÝR3£NÄhÍ{¡Ä3Á*‰VJÚ¥ýôÆ Ft8ëP^9< ù«ˆè×îy‘´B*‰ã…”’vi‘×¥+‚lîÓ«‡v¼ü•¢š’…rç¹Rö'ùÂE›¢ ,´0"gâ0³ð 2<È4<% ;’7¼³š¢ Ò iD¾A´Þ{èú´f³iù&Q{ ‰R!-a¡lÈB®ç4*8}ßç…÷UBkZ³Ð‹ºJmšvûþQ¢ÚR³P¦YH0QH#6w-, i1ÒN½ {Ù§,²q´9ó,³0‡ž9 }nÓ6 E†üš• © ŠÒ€›²­&ÐuŠäg!7Z[¼Lealá€t¿zÑÕÂ";›ZR…nláQ?¤ã“—~ñ–Ñn¡põ3à®~Ú ƒ4þ9æR_à ·ÙñÍÇ Z(‰'a¶Ú·°¤;²o•¯é,´@8' {AÒ³ÑП$Ж…µ¶ˆá¸M[8“ûrAtŽuü|“¥äôHE é»bTÂBÝì`îó²žgZÒwc …‰u6…f}‹-ÌαзÎB R¹…ºA2Ø“ËBXÈ`k‚³x=n¨/@!Õ¬«AX·…(¤¦„ýxµ:GtÏÉb Ãç'â¤Ýlê%绪Œ·U²QÐB‹"Ö¬ õG ´Y¨d!ÃÙ,„… g-Œl [•®—­d!#ÛB#֬ܦ;‚„©Àƒ,tWX³¾{ âž0h ÈBw…5ë»× î ëb:«;‚]£òSäd®GW[Àî ëÒ‡…Æ„Õ9=ËÚYŒ¡pŠ,γö" «ëÃBK„Õ)d!0²Ða]Žyû×â﬽'s½Ë¬¶âË*PHí…Ô]auýT /.C`¡)auR-|¿ A!5Lù,üpÊm¢V×,¼ºæ6a¡1au YŒ,tWX]qsÂ6¯W·!ÌWXhLXÅóΈw«ÅÇ»h/ ©iÊÒOÄ»ë{n/²Ð˜°º>> -VÇÕéåEÝèa‡²ðá³&amkÓ‡…¦"Ö†=…ôË£ÌÑ9:‹ÓY(gJS³–h ùˆ-ÁžBZ©…ÎÒä,¼"COv6 ›l!¼½.x´³*`m!½ûÊï^}Ê:º14) ¿ò£µ’:›…;aáã:dù¥ê–ج-¤©^ÎB¾5tñªö,\?ê …TQ_°ð&{Ûûg}§Zxz²ºãv7ÕBä&äWma’T ÏoBV/YG7©SäŠN¹øuŒYHA!}Ë ™÷tþ’u ,4&¬ + )—öŒ³ÛÓ›b‚ÈBcÂÅõŸVįùG†Ôhá‡Å‡x\Û% õ®Pý{%s¼¸Êwù]_lknójõãúÇëxòªÃÿsÝÌU¾´ïV2‚s²Dí'ÛF!µ ÊYx2 ùîyÏtd²âa-X¨€¬…ì;:2YÊ»ÌQôH ²×-UHoîß¼…,TЗ³pzÉëÂBç ©ˆœ…OüÈÏ “ †Tž…¢®œ…÷üÕ'²°´þ=[J¨®AŸ‡±ÌþMXøú%d½–i‰Ô[HïÈ°v5…tJžJ3{È<:ßÂ$9Þò.—ïC.¼)é*?dŸL–s²™E²íùEsïc´Yi!ý\ʹT ¼ÿB®X_£Íç÷)Wá‹Í Hô×—Üî«_/!Óh³¤…ŸOBØf^œp›±ðí‘ÛfÔë‘.çÖ|‚…¯B«§Z¸Þöd)9 D ÝBÌB ¦z‚…ŸíT /Iœ¯×?×ë™ç=’‰0òSÎBg³°ˆ…‹ ã–³ðtAîsÅÃlóÙl=›ýùt}Ü6x·£²-¬”¢NŸB®©…ñ@RÆÆÂ矤 ñMQ……ŠYx{E¬›þIý•PJugš’…ÿ‚Äwük´pEœ[° ºJ{¤M±ba!¥l±0Ilá”Ì=•úÐnJ!-ÒQ¢ê)%- _ÉìíÛÝÈBÒ9ÞœÍÍ°Pg-Œ¾Lˆ[sùí!äOA"s}OéúmtRšUH—_>‡xÞU¹ÎÂÒ]ð³U‘…iØøYxC¯"øeRÓWþ§ £ë©§‚œ…/Ož*»Ý# é’¢öx<¹Bz^Aeª³’oaM…´„…M+¤³rïis#‹ bKGDˆH pHYsÃÃÇo¨dzIDATxÚíœ w¢:Ç©Òj5¶ºÒ-ö¹‹Š\ l…â£Û»÷û«tíKQ™$æäzjË 4?2I&ÉL CZÔD×@cjL©1U—ÆTIS%iL•¤1U’ÆTIS%iL•¤1U’ÆTIS%iL•¤1U’ÆTIS%iL•¤8fÝ<5ÎF½¹yÞjŸ!Ôi_´Ú¢kY]—ÝžùÍ0ú[˜=ëªn~ïY×äÑ•¤TݶL›TúÂDƒo7i+Òš·ÈnÝ‘Ö\]¬›–®³²÷vã|Ð6:݇VWtÅ)1Ñ•ñh7îÌïÆà 3Æ6Á¼!­IŒv}ñ2+1h²­6ù2*¹CtÅ)1IO¼1d­tgöÍÁU÷ssñ4kÇ ³cüż?RÌÇÑi÷Ìì¼c>nav³KÄb“t» »Q_ÙçϬ©mÏü‘a®/^¾a›^AFF+¿œáhìºîx2ôꦉÐf:GȾÊÚ÷}‚6˜wö?ÆB­†qÛp@#?1Q…QD>=MýñÎ’;܃Ûëõç ify5ôcŒã ™8o—œûçiŠq8Á¬Ï׶úxÝÍ’§Å,±¿E“™äš?Ä”^Iˆc×ÙWb™âÈ÷ŽÓ›‚—ƒÅò.‚űb.. –Ä8ÝØîQazN'凤üâè0}(oY¤8 }t~R›÷EW¿˜–8—¸mâÄBýÚõDi–¤ä­KüëÄzšwE#P²éde4žBó¾Å¨2¿¡ôúúZáîæï&Á|þ·É¦2ÆM§ÓJ÷7ÿ¬0Ÿ›lªc¯^Š‹Î”ùf‹PsúŸÌcíÇå{å_YdBù9gðºÀ”`¿úCúv¿†¬ž‹g¢qvËI1ד¯“Z—|Fáao˜¿Hµ*ìsõÁìµ±Ô¬õæÓ&¥½ (%Øeö¬w×}ÂîÝ1QÀÒ¾>¬P†QìUx[yqĨ[~Ådýè*Z0~åŸ×›L ¥‚F¬;Зeµ/…§0f>Ý=p%pê°µI2fá]UR`QÛ{AÌû¥|ˆñaǖק)g˜v[«$&ÍS‡þIlàaõ‡Ã4^¢Pg 4sïÞ§õÂP„CäÄÐB)g;šüAþœp”¹»î€2Ÿ΄ò ºI.e8 ì9CáËé„1à°·ï¨(Åü8a)÷ŸˆÜ8)üñâô€)oò᧔Å"Ià89Q ˜òûxQ ‚áäFY8ü ‚“¬¼xmRŽòJ™¯?!×—¥1™sò¤¤‰ÙcËÉ•’*4‘%'_JºLvãï-5º@SVœÜ7)ãiÙØ-ÿíQÚ°aíéðß즎Ž®ÎÉÏ÷©€Y™Ó@Y&Ö½ÚzÅ‹8¬¢Y`V:œt¨X*s!(}ÔJ(@–MИ•<8Š:ð/™‡âãRÉÂÂʦÛ$%8Ù‡û€c.u|äR`ÈQùä)Ú"ˆp˜”‘© á><0©ˆRp.˜d,胿„‚CX«%6’U‡H|@rÕüÍ"¸„—WNS=x/C²@õlÜåþIß J9LÒa£}=o!zða†™¥äÍc,.˜“5f¶bqs®‹ï– 1IM· —¬PŸ€=æ.¤¥$Ë33ÐO¿¾¤ S¼$Â4>ù .ƒ$Z91?hËÔ”@˜Î §’e½`ºåþ«ÆqaŽCYæJ@ÌeˆgÒÌ"P˜n„}y2]Á0# ÍS^iL•¤1U’ÆTIS%iL•¤1U’ÆTIS%iL•¤1U’ÆTIS%iL­Ýúö„ñú_f%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/hierarchy.html0000644000175000017500000007743614030601042023522 0ustar rusconirusconi Class Hierarchy
Class Hierarchy

Switch to graphical view

 ▼CQCPAbstractPaintBufferThe abstract base class for paint buffers, which define the rendering backend
 CQCPPaintBufferGlFboA paint buffer based on OpenGL frame buffers objects, using hardware accelerated rendering
 CQCPPaintBufferGlPbufferA paint buffer based on OpenGL pixel buffers, using hardware accelerated rendering
 CQCPPaintBufferPixmapA paint buffer based on QPixmap, using software raster rendering
 ▼CQCPAxisTickerThe base class tick generator used by QCPAxis to create tick positions and tick labels
 CQCPAxisTickerDateTimeSpecialized axis ticker for calendar dates and times as axis ticks
 CQCPAxisTickerFixedSpecialized axis ticker with a fixed tick step
 CQCPAxisTickerLogSpecialized axis ticker suited for logarithmic axes
 CQCPAxisTickerPiSpecialized axis ticker to display ticks in units of an arbitrary constant, for example pi
 CQCPAxisTickerTextSpecialized axis ticker which allows arbitrary labels at specified coordinates
 CQCPAxisTickerTimeSpecialized axis ticker for time spans in units of milliseconds to days
 CQCPBarsDataHolds the data of one single data point (one bar) for QCPBars
 CQCPBarsGroupGroups multiple QCPBars together so they appear side by side
 CQCPColorGradientDefines a color gradient for use with e.g. QCPColorMap
 CQCPColorMapDataHolds the two-dimensional data of a QCPColorMap plottable
 CQCPCurveDataHolds the data of one single data point for QCPCurve
 CQCPDataContainer< DataType >The generic data container for one-dimensional plottables
 CQCPDataRangeDescribes a data range given by begin and end index
 CQCPDataSelectionDescribes a data set by holding multiple QCPDataRange instances
 CQCPErrorBarsDataHolds the data of one single error bar for QCPErrorBars
 CQCPFinancialDataHolds the data of one single data point for QCPFinancial
 CQCPGraphDataHolds the data of one single data point for QCPGraph
 ▼CQCPItemAnchorAn anchor of an item to which positions can be attached to
 CQCPItemPositionManages the position of an item
 CQCPLayerA layer that may contain objects, to control the rendering order
 ▼CQCPLayerableBase class for all drawable objects
 ▼CQCPAbstractItemThe abstract base class for all items in a plot
 CQCPItemBracketA bracket for referencing/highlighting certain parts in the plot
 CQCPItemCurveA curved line from one point to another
 CQCPItemEllipseAn ellipse
 CQCPItemLineA line from one point to another
 CQCPItemPixmapAn arbitrary pixmap
 CQCPItemRectA rectangle
 CQCPItemStraightLineA straight line that spans infinitely in both directions
 CQCPItemTextA text label
 CQCPItemTracerItem that sticks to QCPGraph data points
 ▼CQCPAbstractPlottableThe abstract base class for all data representing objects in a plot
 CQCPAbstractPlottable1D< DataType >A template base class for plottables with one-dimensional data
 ▼CQCPAbstractPlottable1D< QCPBarsData >
 CQCPBarsA plottable representing a bar chart in a plot
 ▼CQCPAbstractPlottable1D< QCPCurveData >
 CQCPCurveA plottable representing a parametric curve in a plot
 ▼CQCPAbstractPlottable1D< QCPFinancialData >
 CQCPFinancialA plottable representing a financial stock chart
 ▼CQCPAbstractPlottable1D< QCPGraphData >
 CQCPGraphA plottable representing a graph in a plot
 ▼CQCPAbstractPlottable1D< QCPStatisticalBoxData >
 CQCPStatisticalBoxA plottable representing a single statistical box in a plot
 CQCPColorMapA plottable representing a two-dimensional color map in a plot
 CQCPErrorBarsA plottable that adds a set of error bars to other plottables
 CQCPAxisManages a single axis inside a QCustomPlot
 CQCPGridResponsible for drawing the grid of a QCPAxis
 ▼CQCPLayoutElementThe abstract base class for all objects that form the layout system
 ▼CQCPAbstractLegendItemThe abstract base class for all entries in a QCPLegend
 CQCPPlottableLegendItemA legend item representing a plottable with an icon and the plottable name
 CQCPPolarLegendItemA legend item for polar plots
 CQCPAxisRectHolds multiple axes and arranges them in a rectangular shape
 CQCPColorScaleA color scale for use with color coding data such as QCPColorMap
 ▼CQCPLayoutThe abstract base class for layouts
 ▼CQCPLayoutGridA layout that arranges child elements in a grid
 CQCPLegendManages a legend inside a QCustomPlot
 CQCPLayoutInsetA layout that places child elements aligned to the border or arbitrarily positioned
 CQCPPolarAxisAngularThe main container for polar plots, representing the angular axis as a circle
 CQCPTextElementA layout element displaying a text
 CQCPPolarAxisRadialThe radial axis inside a radial plot
 CQCPPolarGraphA radial graph used to display data in polar plots
 CQCPPolarGridThe grid in both angular and radial dimensions for polar plots
 CQCPSelectionRectProvides rect/rubber-band data selection and range zoom interaction
 CQCPLineEndingHandles the different ending decorations for line-like items
 CQCPMarginGroupA margin group allows synchronization of margin sides if working with multiple layout elements
 CQCPPainterQPainter subclass used internally
 ▼CQCPPlottableInterface1DDefines an abstract interface for one-dimensional plottables
 CQCPAbstractPlottable1D< DataType >A template base class for plottables with one-dimensional data
 CQCPAbstractPlottable1D< QCPBarsData >
 CQCPAbstractPlottable1D< QCPCurveData >
 CQCPAbstractPlottable1D< QCPFinancialData >
 CQCPAbstractPlottable1D< QCPGraphData >
 CQCPAbstractPlottable1D< QCPStatisticalBoxData >
 CQCPErrorBarsA plottable that adds a set of error bars to other plottables
 CQCPRangeRepresents the range an axis is encompassing
 CQCPScatterStyleRepresents the visual appearance of scatter points
 ▼CQCPSelectionDecoratorControls how a plottable's data selection is drawn
 CQCPSelectionDecoratorBracketA selection decorator which draws brackets around each selected data segment
 CQCPStatisticalBoxDataHolds the data of one single data point for QCPStatisticalBox
 CQCPVector2DRepresents two doubles as a mathematical 2D vector
 CQCustomPlotThe central class of the library. This is the QWidget which displays the plot and interacts with the user
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemPosition__inherit__graph.png0000644000175000017500000000157214030601041030565 0ustar rusconirusconi‰PNG  IHDR}k¨!gAMA† 1è–_0PLTEÿÿÿÿÿÿ±±¶fffMMN˜˜˜………wwwèèéÑÑÒ444+Pnn–8­tRNSªvå’bKGDˆH pHYsHHFÉk>dIDATXÃíÙAkAà^¼ûL·h+-¥¿ ¶) ^B³ÅËtûÂn“kÀû$Ù@Šªô¨EBéI<……˜»e"ý=ø ¾·›4“IÙARpÞBæÍÎ|ÌÛÙ%!ÉÅÍ)ëai9]ä{ÞMÇsÙ¾OW{æ¿óBë]ÌÃ4–qÛùsêíàJþŽÿ!€½wK ŽÄ%Ÿñ®ä<%¼”˜Žƒâ˜Êˆ6¢Þßh8Ô#TðÕ-\‡õM82ûdýÕÂé¸Ö2yJàa*‡"Ói×ÔúÞõ# §A¬Lg¹¡¡MN3™¤«Ÿrz)sCÇb™“2Ä^ŒÙ?†ë°ü9û™,¬rBõ“çú‡{¨öî_ì#Ú¿|ìç 99Aö¼#<ÜÝüÇÏŸõ×ÓcºèûÃÂÈxÔ=VXÿù3¯ôããü'µmäÏÕ©‘?SßMü¬R?Mü‚R]?¯”jø/äøsò§þŒüô~Ž¸þèýûnz?cè)ôõÖ[o½õÖ[o}*ßÒýHóM7x/ö)¿}Plľ¦ ë~©°-±úr0‡û½ Ór¤¯nUÛ/JoîËztÙSÿ"׬_ w}Ùæ9{¡¸CËzØ¢z¨ïb‘Ë£Ó’s™«ü탰îËýd=.ôkzÞÏ}ïµ/·Ö’ú9i|rý‘N”R?¨û5ïYâž&uõ'U¤†î“ ŸzñQÿb_¬­¸O5×WùtRÿ0qÿØ×°ÎûÕ÷ýý«õöo˜ÃÜþ$Ÿ?ë'åMßw iãÉõøÿb¢þ­Q¼ü äÅFãUn%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_c.html0000644000175000017500000002101714030601037025055 0ustar rusconirusconi Data Fields - Functions
 

- c -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPaintBufferGlFbo.html0000644000175000017500000004510714030601040026241 0ustar rusconirusconi QCPPaintBufferGlFbo Class Reference
Public Functions | Protected Functions
QCPPaintBufferGlFbo Class Reference

A paint buffer based on OpenGL frame buffers objects, using hardware accelerated rendering. More...

Inheritance diagram for QCPPaintBufferGlFbo:
Inheritance graph

Public Functions

 QCPPaintBufferGlFbo (const QSize &size, double devicePixelRatio, QWeakPointer< QOpenGLContext > glContext, QWeakPointer< QOpenGLPaintDevice > glPaintDevice)
 
virtual QCPPainter * startPainting ()
 
virtual void donePainting ()
 
virtual void draw (QCPPainter *painter) const
 
void clear (const QColor &color)
 
- Public Functions inherited from QCPAbstractPaintBuffer
 QCPAbstractPaintBuffer (const QSize &size, double devicePixelRatio)
 
QSize size () const
 
bool invalidated () const
 
double devicePixelRatio () const
 
void setSize (const QSize &size)
 
void setInvalidated (bool invalidated=true)
 
void setDevicePixelRatio (double ratio)
 

Protected Functions

virtual void reallocateBuffer ()
 

Detailed Description

A paint buffer based on OpenGL frame buffers objects, using hardware accelerated rendering.

This paint buffer is one of the OpenGL paint buffers which facilitate hardware accelerated plot rendering. It is based on OpenGL frame buffer objects (fbo) and is used in Qt versions 5.0 and higher. (See QCPPaintBufferGlPbuffer used in older Qt versions.)

The OpenGL paint buffers are used if QCustomPlot::setOpenGl is set to true, and if they are supported by the system.

Constructor & Destructor Documentation

§ QCPPaintBufferGlFbo()

QCPPaintBufferGlFbo::QCPPaintBufferGlFbo ( const QSize &  size,
double  devicePixelRatio,
QWeakPointer< QOpenGLContext >  glContext,
QWeakPointer< QOpenGLPaintDevice >  glPaintDevice 
)
explicit

Creates a QCPPaintBufferGlFbo instance with the specified size and devicePixelRatio, if applicable.

All frame buffer objects shall share one OpenGL context and paint device, which need to be set up externally and passed via glContext and glPaintDevice. The set-up is done in QCustomPlot::setupOpenGl and the context and paint device are managed by the parent QCustomPlot instance.

Member Function Documentation

§ startPainting()

QCPPainter * QCPPaintBufferGlFbo::startPainting ( )
virtual

Returns a QCPPainter which is ready to draw to this buffer. The ownership and thus the responsibility to delete the painter after the painting operations are complete is given to the caller of this method.

Once you are done using the painter, delete the painter and call donePainting.

While a painter generated with this method is active, you must not call setSize, setDevicePixelRatio or clear.

This method may return 0, if a painter couldn't be activated on the buffer. This usually indicates a problem with the respective painting backend.

Implements QCPAbstractPaintBuffer.

§ donePainting()

void QCPPaintBufferGlFbo::donePainting ( )
virtual

If you have acquired a QCPPainter to paint onto this paint buffer via startPainting, call this method as soon as you are done with the painting operations and have deleted the painter.

paint buffer subclasses may use this method to perform any type of cleanup that is necessary. The default implementation does nothing.

Reimplemented from QCPAbstractPaintBuffer.

§ draw()

void QCPPaintBufferGlFbo::draw ( QCPPainter *  painter) const
virtual

Draws the contents of this buffer with the provided painter. This is the method that is used to finally join all paint buffers and draw them onto the screen.

Implements QCPAbstractPaintBuffer.

§ clear()

void QCPPaintBufferGlFbo::clear ( const QColor &  color)
virtual

Fills the entire buffer with the provided color. To have an empty transparent buffer, use the named color Qt::transparent.

This method must not be called if there is currently a painter (acquired with startPainting) active.

Implements QCPAbstractPaintBuffer.

§ reallocateBuffer()

void QCPPaintBufferGlFbo::reallocateBuffer ( )
protectedvirtual

Reallocates the internal buffer with the currently configured size (setSize) and device pixel ratio, if applicable (setDevicePixelRatio). It is called as soon as any of those properties are changed on this paint buffer.

Note
Subclasses of QCPAbstractPaintBuffer must call their reimplementation of this method in their constructor, to perform the first allocation (this can not be done by the base class because calling pure virtual methods in base class constructors is not possible).

Implements QCPAbstractPaintBuffer.

The documentation for this class was generated from the following files:
  • src/paintbuffer.h
  • src/paintbuffer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_b.html0000644000175000017500000000521414030601037025055 0ustar rusconirusconi Data Fields - Functions
 

- b -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemRect.png0000644000175000017500000000460614030601041023430 0ustar rusconirusconi‰PNG  IHDRæ /µàøgAMA† 1è–_ÀPLTEÿÿÿççÿ,,ógXíÿÒÒý ÷ ýøøÿÿ ¯¸¸¸]c¨ ϚёŸçŠãf©žåƒy­` &›Z‘[œpy¨m²Sÿµòÿþæÿp×ÿ µXÆg׊æŸÅ¢ ÿ*›‚ó´ÿ‘éÿ /ÿâŸÿ. ûÿèþÿXГæH´ÿúÕÿ/–ÿn*õÔÿWï‘cäÐùÿ£3ÿ—0ÿÑgÿ¤©ÐdÿWÿkÖÿI‡ÿ5Xs+£•%ÝbKGDˆH pHYsÃÃÇo¨díIDATxÚí‰v¢J†[öÆ0̸e!Æ “cc¼sçýßêVwƒ`De‘xîLý'›JAtQ’“þS„ P( …B¡P( …BT5I&’¢ŽWèR­d¼Q5¦,Õj5©8¦ˆj L Õê1átR]#Å9¹Œ3Ç“¤I”R³N¿“YçßfÑxøDY©“j:ô¨ULfø½T0Wl¸ýœìÝI{£v"î|¸“¾oÖ7!æÐH²3z (w;£INÊžò°Ó1ï›wö6Ǿ¯Û×ð{.Uá†[‚¨»öÓÝž¨x•7nëi3dOyžj¤¼ô‚眘3ª&ŸŽ_‡¾¤èÏfÇ6½›9µ=öùÔl¾ nß¼[wæÁÇSêd² aúaþë¶mÚ ¢ØKÁ}ZÔnã®Û?`6ݹMGãÉÐ|úbðAò¨/ºòL~ŽrÞïNá| ý>YŽUúLÞõ®ÀúÖ÷ ÏfÈIø$†ž>70á°Ùʼwß ñš!Ü ^I‹Ú‰`³9Üæj`‘™>Òò1^LŤþÖwJ×ðu¼Èù1ž¡®ÁOS¿/0?è¦39oG˜«ÁÍ^L˜p¸²ZbRx¼Pg ›µqç›tpÍ®Í7Ï– KZ˜Ãs¹æ#Öð\÷4˜ãík“ ø 0gù1ïLÆš Óþ±²a’åh"Ò7‡zÊ?ÞÌ&$œ{½Ûàñ:'e¬è=*Ô§Û7ÇYOyßø¤ú&A³FÕwRú’'íöùKt¥õ+Âl®Ú<ëÜF»yL‰AgŒÚÁt¯,c¾s0”Ä3ï¿ SÃÌ¡úž"•#Â1m¸ŽŠÃdÖvO‹˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜ˆ‰˜eȲUjxI9ƒ+K‘«·ÛèªuUbxY±EàšRÜ®“u6 ±Êë\˜Â¹@*žNYåצcž‰Ò˜ÕÛmD ¢çI[‡ŠTµÝæ/™Í³_›Î—\›Pi5ëß3WZYù»WÒUf6=ö¾Y9%ù;î‚111 +^hÚ¡úk‡cº²7ç«›÷šlN§x±id·Ù˜l&„,i“ÍAÌ^ðBz ÇtøZnWX5*3ÙlaÆ&BÞu½›ßd³“-zïÎ(]Ïè 4ÙˆÃî3Ùœl&%³ÍŽbÚöà–›o¬¤ÉfªüÒ»ùM6{0áدÙY›úü7Ç—ãï3ÙœÓl?1¿‚}íΓù~'M6óõ0s›lö`~P]§ëZŒ)ì2l9þ*÷Âî\˜ÌªÁÜ'·ì|²Gß ÷ \• 3·Éf&÷ ô¶1Å”VŒ {O`£$¦°2¨?ä6ÙìMÚgÒ[0LQ‚˜]¦)ªÏ[¥¥6Ä\1»Í36ÙîA)`²IÇd%ˆ>óŠ6D&aj›÷e”Çtç¦mn0c“MˆYÂd³Wâ}3‡ÉæD k]|{p“ÍaÌ<&›ÈmÁ‰ï\‰» S˜lŽ`~­“?aVª?õž1111111111111ˆ-.ó·¾v«ÔéwÛW–Tý²áÓô\(/z.Tn·©ÕÊ%­SÒ à´¼\9edÐ(ÜÏD¸Ë ÷Ci»6¥T®º ·Û”íNS*ž¯©ÚnÃzN©ß¾îU$•îUd¦T¹Ý&Ôù:Gi:UÔª;OYQÉ™ûˆÕÔª;•ï W“4¢”ê §~EW8 …B¡P±¶ÿ‡;³µtvWËG `Ä6Ì‚³±¿Lª÷ùêìL{Q5Öæà¡3ÎvlØöWbï;}n&½í’Ãœ­Á1[ËN“›O˜Â‚Ù_Œ`=Kÿ³íID‰WzÍxìŽÞ%jt'´ÓçƘàõÃœ¡Ïµn¯ye¶–d“›À§’âQŸ›Ø‚Ù_ÄòsnÉ´'BD»µ¤-Œ1°}zŸ•û5Zpx×½+ÚÚÔx#”d“›%ï͵ ‰-8‘ýå}øcaÉ´'5ôy÷‹¬Çþ9^0RÚOïs#Öú´à E‹Ñïå5hߘ v:3íIDƒw¦y‡qg86üZýycÒÀp̃œ<˜ Ntˆwqh–:y0ÃTȆÙôû™0Í&Oœ…hkSƒ¬J4¹ù„™´àDö—)ü4[|lYöF©¼3M'ë±—,ÏékjŸ›ó g¨Ã•nkI4¹I&ës[p6ö—V–¸ý%Ӟĩ×æŒf:6L¹ò"JPjŸ›ðK®bö—R¦™júÜQ1ûKQÓŒ¡‘ŠúÜü_õ9§ç¾4Og%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_23.png0000644000175000017500000000130014030601042024464 0ustar rusconirusconi‰PNG  IHDRk#9½<†gAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>òIDATXÃí™;nÛ@†Ç†uºuÀ˪o¿b%?£Ú$îúÕ·op%7QíDÏÖ(kH`IDATÓc` (!8FJ*...p˜@Øaå`P 曕¹ƒ9%@–‹kh8œ 唆‚A:˜Sd¥¥¥A9i`唥§¥#Ë”¥—C8…‚` æBy¾œÐyÆQ[%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_q.html0000644000175000017500000002460114030601037024062 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- q -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorGradient-periodic.png0000644000175000017500000004141514030601040026242 0ustar rusconirusconi‰PNG  IHDR´0ÊÜgAMA† 1è–_PLTEÿÿÿþÜsK²ñöøÕL  bÑðË`U°ûþø NÀøÿï¥4  f–ëÿœgj³òÿ–)Öûþñúò›Ïô…åâ N% 0”oÿõ».šêT_, TþÿúV§Çf'´K 8n¸rkÖý PÂþåj·çÐòù²·µÔh æ‰áyâ-÷Ù‘øËj“6 |âÿÿÿ+ÿDÿkÿ•þÕçýsÿKÿ+ÿÿ ÿÿ ÿÿ,ÿKÿtÿ¬ÿèüÿ›ÿkÿCÿ,ÿÿ ÿÿÿÿ#ÿ3ÿcÿsÿŒÿ«ÿÂÿÚþýèÿËÿ¼ÿ´ÿ«ÿ›ÿ•ÿ‹ÿ¤þÖûúìýËÿ£ÿœÿ„ÿSÿ;ÿ+ÿÿ ÿÿÿÿÿ;ÿKÿ[ÿtÿ«ÿÒùøÃÿ£ÿÿcÿSÿ ÿ“ÿºÿÿ‚ÿ[ÿ+ÿÿ ÿÿÿÿ3ÿUÿƒÿ´úúºÿTÿ3ÿÿ{ÿ³ÿÿÃÿ$ÿÒÿÿsÿkÿcÿTÿKÿ|äþ´ÿ[ÿDÿÿ3ÿƒÿ£ýçÊÿÿ{ÿ#ÿÿ#ÿœÖþ›ÿdÿ<ÿ ÿÿÿÿ»êôÿDÿ<ÿ3ÿÿÃÿ“ÿ³þÜ|ÿÿÿ ÿ ÿ¼ªÿ|ÿÿÿ$ÿlÿÿ‹Kÿýé“ÿ[ÿ ÿCÿkÿÿ|Cÿ#ÿÿ;ÿÿ ÿ<ÿcÆþ‹ÿ[ÿœÿÿJÿtkÿŒÿÓþÿËÿ[ÿ‹ÿ¬ÿÇÿ¥´ÿ4ÿ¤ÿÜþƒÿ“ÿcÿ»ÿƒÿSÿìèëçìÛéç¦öëÛÜÞçØÖëöÈÙîô6~bKGDˆH pHYsÃÃÇo¨d?4IDATxÚí\–Ù•ÿg&“ì›™Ýd7›l2›²“º%›ÝÿæŸ])R¥W•*MzG.EšR¤ (©‚@)¢ˆ€  €ÒÁ‚ 8™ÿþËþϹ÷y_xPxñE™ çóÉŒ¨LÞßçœ{î}î9çƒvlÇvlÇvlÇvlÇvlÇvlÇvlÇvlÇ>øàþÁúêão~kÅoüÙG¼oBÿÞ§þ¾?ê–©ü:Ù_|‡Çã}÷/Ù¿õñ_}o¥8öo|ò×ßýþ˜ÂסÐ*ÿêoÞ÷GFÜ?ùÑgûÉkÿˆ[ñå_~­ §ò'ßüéûþÈB‰#žõ£x?ûÆþìï>ÿùŸ}úç¿€/?ÿå~ñ«Oy¿þì[2¿ñS$Èãýì/ó9ïg?E„ñMïïÿòúÍÛØ6£òèßúGøêŸ>ÙÎ ÉóùÑ·ûÙ·ð›¿ÿÞ‡ŸþúŸZ~ûÑ·ð£Oú!üëWŸ£¸ß~öËßýËï> ^ø‹ýÍÇðó€ßþןïãù>óÍï[ŠUþö3|Báo1·µB\%>ÿÛßý_ÿ%|æo|øéI€Ä/?þë¿Åýä›ßb~ƒ?þÛÏá'ñç¿ÿü—ßÿàæ›ß·ª¤áo1·µB 1`ÿË=ïóoI½ Ïßþ þÌà7€ýûˆðãúéçá'¿ú"óÍï[ŠUR„ß ü×í¬Ç<$Cá?Ÿ?~þë¯ÿ‘ñBÈÝ~õé7¸mMX•áŸ3¿ùOÛZ!#VïêƇ±ŸY%~OV‰?úå÷ÿ'&Ú€ðXþâ›!üÖ>úóÍï[ŠUþÅw¾õ ù[¿ýè‡üèóÚÖ q˜Tò¾û=¾¸–sµ¿ÿÉÕ~Os5â…~‡÷³¿cÖBXb¾Ï|óû–"B•ŸüêóŸý 2ŸþëïŒt{+ܱ­¡3üúŸñW?ùñçÛw?¶£ñõkÔÇÿN’Ã?|÷Ÿ?þñÏÿ;°ÿæÉ.Lpèüûíœ îh\Ûþõçß$ üâ7?ߦ™àÖkämK{óÇc}÷û°Qûú÷ ëýâ}«Ùb¼]ĘízÍ—bâ’»¥¤y2²rò{xŠJÊ*ªjê< M-í½:<]]½}ûèó ŒMòLMÍÌ-,y‡¬¬¬ÁxV‡ll,Íyf¶¦vöxŽNΆ.¡øè[¯¿ðÏ7(XËK›ç¢ãÿw¼ÃÇÜÝ\]x¡aö¶–á¼Èã'¢¾Î7‚0š{2.>!‘—”|j‚Ô¥¤ª§ñ‚¼NŸñÐåéíÉ!Ï8ÝÞÔÌ‚gž‘™ÁËÎ!ÆËÎŽÈÊÊäåZ²´0³åÙå9œu4â为ØÏ;¬‡y:!{OjóŠŠÓJαäEqùÓß/¯øìÛo ø¯”‹° Ÿçdbgv(#›Wv>êk­q­G€õ0P„bå’R•UªO]TP¨¹„êj‹x…{uàé<¼ß­ÀÀÙÑá [‹Cá™Ùuõ ‘‘e¼²ËÄÊÊÊ"#êër²³2Qã[;ûtž£<§®úÜQ:gð! *mljØ<’­ýý÷~ûo|øÙ/÷ƒ¼"¯T3ØÛKû4ƒP"lqL·»b•™Ã»ÚõµÖ¸„Ñ×ð½žÐvCV®ý&¨ë êJ½yðxêqFgóLÍ­r³rê#Ë.?ßÚzâÿƒ8q¢µõüñ«—Ë"AcvH´1·åÙ§Ÿ uît)€XCzè„xÂCêãÛåçÏ’w‚kü?¥oçþìÓþ†¬?|BŸ!"Þ2p6>hjaUÇ;~âë­q#ÉÚ]Ùs;ùÔM…;½}jM¾Z§y°@¸»æ;ŸÅE%+§¡ìêùÖQQ+b15”Ùz5‚Ĭ\kž¹­ÝÁ0G"ð€û>*0W‹`Í.¿ÉÛ°ñŠ| ½+"Ë܈zÞù¨¯·Æ7#$v-Füä]x@eîõCˆQì T¯u!ðÓØïvËÐØÞÖ&#»>òj뉨7þ‡@#H$ 3s­,ÌìòLû÷чôÌ^4šE,yç¹&<Â.ß o­ÂÓ{Ï°v…‘ÏÝp㨰£££¯]»vŸü¾Œ~oÁ;×!}?æÁP…ÔðH 1JÊGÕÓJ‰ºÃîúù¡é¦69 —ϯÃoãùã 0'"ÃÚÒÌÔÞÄÉÙà–+?ÒàŠïµ"á>¾ÚغqϬFÙLfNäUøàBiŒ¾v_,&¦¼\œoåå11bb÷‘äûи¾F‹‰Ç'´MTc¦v§CeòÑT‘7Qw Àð¬ynvÉ6j¨ðjY<¦Ö6f¦yaN-ùøòÍéBo–¼«\acéj„\BB ÙL]$Y 7ª1úšXL¹ø‰±“CC’ãh’’CÓ'Ç$<ˆ’2ú]k\!.ô¥*éª8Ыz´¹+Õí;pËÙÁÔ*«þ²0)Å­ð˜¢@K3»ƒÆF.ðî;Ì×Ç’WÆ5ájiúhjY‰ÐÁÎÜ:«žl)6¨1Z,FüÁÉ¡»+f®ÏJ16{=~¦bwܸäôI‰â€ñ>õÆw¦q}„c$Ÿt?•¹hÍ¥gŠ}´Ï€:7£ƒfá9‘ç…H)¢Àúì + Œ4ð2ÆCÇó4K^$×6‡ò™#ž!l„évæáõeÈfC¯‰‰?˜ß/Õ-]9œØÖö¬­­-q¸R:!¡[êú p:)+^.&Æøâ;Ѹ.Âèûåw¯KWÝNÆBÌ\­f¡§<Ÿ.Ny™õWOl _`C]V®Í»tcg~ },y \a1æ3«:¦›Z@|¼L–Âõ5BÂ36^1Û]™XõBæÂí$YjII·/LÜ©jKݳñ»ã$§ÇˆÇ0õ]h\¡˜8Ƙ²ýäíKmîÒ:âk„K¨½MVÃñM¹ "¬ià! í¼Å×Â’WÏ5áúñC²«à#<{ XâNlD#þ»ñÝ•m/&’î%ËõŸ:%ßÞÞ./êÔ©~9¹ê{²Id^T=–Nº^' ¾•¸Õ×EËÄʉjyò€Î«ûœÖÑÕs¿joÙúQ_ÔùË‘uYá–¶v&N†.®Œ>–¼® °‰.†L>³a$õ°u4Þ/»Ÿ8rážÜ©ö‹{`ç(°›7÷ìi—É÷ãóÄJJ‘¸"BÜrën*®Å<‡#û%x@Nùž½R3ªÛt]†xâx¬‡ÌìøúV$ÜÙ«ms›Š.²¹_v ‘Ç£ÖÕ-+9“ðTF6ùÔEB¯¦F‘ZMM$pwLšxQggKž@ÜZëz!>€³•#$Æ ¨ÌCˆÙ§o˜nQööÁNœ¿Ü“i‹£OW—%/‹kÂ#œÂHŠ‹!MI; /@ˆ‰Ê›5FÇH<–¦'o 5Š—”:”ŸSVîèPº£HAÞÜs±ýTò½Û2#màŠñ»Çâýè­Ö¸þÆ^| `Œ¹£¼ðÒß·0‰ü0³Lø uÄÖ«‘u™Öæv鎆.úŽfËËàšðý1’ká))EèÎGX‡{Š7k¼V~ò‰tÝóßPTYP]œœŸŸLQí{¸Ô;¨Ü1p 8RŒí§ä’e/ܨ–îŽß žXNq 5®‹PL|z7,Éí Jƒ‹êäÝ_jšÛð–ë ‹á‰ã°X >'Ã[úîÇôXò¹&<Âæ4ÈIÉbHSÒ}îú·Øߤ1º|:¾òFõ)<ûVî]˜T;§^RÒì?åïß\ þè¨Úè¢êC•Ág€‘¡xQž¸"@”š‰’ Ž¸…×G;ý$áùm9cKJ½àu3Ì;Tw^TYú gƒý/KžׄGX‘·˜ÏP„n·`_H¶F½QctùÐìð,’©.-¾TŸòƒ ŠO0˜Ofi—FÓTIÀÜKÄØ‹ïÔð]±!&H='Ž¸•7€phFº— Eå¾£µ>§á½elqùmv#ú`­32(pÛÏ’gÃ5á4×b$å/†z‡a' ´ |Æ蘓×o÷C€íx8?7Õ¨é]xúˆç0OϽ§µ µ¼ƒ|»üð®Ú$8£Ào^Dˆ7žWvÇ?G$Át«4®‹0æd¼ôÈ=$— Æhh´å ë-„l†™‡líÏ:ç»`É3çÚ&–¤ùÑHJCú7ÔA€ðõÅÆf†oÃï+õ.Î¥ùzk{’|ˆ1|ípZÛ+8¨T£¶(Î_T¢Áe/ô$JKUŒÑ`ºE×ÛT ¼ë°ÈÃ2Ñ;_Rª­ƒ¨yöqÑ}W#s2lló W$Üf«ms› HhJI$¥ù ì*òLì,rsÈZøZ×쮼гfàaª©ÖòþþØ~w°ýÇöÖÓc¿Š×¨-Q?¸Ø§2Ø1@âéžöþä$tÄ™»'c)Ã-Ѹ/Ÿ–•¾f`)u*è´‡ÞNûðH‘†Q´¨W²s-MB XòL¹&<Â9pÃb’“¡‹á1@èfgžK6¯Õ].ùê†ÜÍšŽ¾G~Á¸Ù‡ÝÈ­üÎNCÃN—W7wæÕ¡ˆïq§ÔSçU—• Ä›{NÉÝ›èîŽgnÆ"„õ¼cᜟ·§îa×P³‘;!æÝ—ë#¬a©pÎgɳãšðÏ©ø75ÒHJCHI]ZŒí¯„g³r4Þ›­JÞ£ÐѧÞŽž»«‘ÉÁ/MmmM¿ü"=Ì©Åà–àM.s£¢\ñèhÊÃAe%±½¿úöÈpB|2Ü"Cˆ)¬ôs äØ-“C¢^ )Ãóe¸TtìdÉËãšð_¢Ò„†DRš’Û›YgãéÌë4F—ÇU&µ+ ,¨—jã.£ÅÁÔ&7 o­eg‘—¹xr;zr¯ãƒ5‹üüÕÏ‚'šHҚ䤉 בᵭѸ~FJåa²–¢^T¨£ëÞiŸQ¶ÉR‘kagbÄ’—Î5áª7ôC7d")æ3Nm­"èöگ͎ô+ÜQyT¤¡ÕáJF]äñV¼ÚÒzürd=2 {2ïrƒbÀÑù>•g$šî†7â‹Eo‰Æ ”¤òî<[ €§QÏÍÙ6[„{B¶A˜É:d–çÈ’Æ5Ꭶ>"näͤ¸BJz(«þjÔk5ÆŒWÊîQx¦V\èqX?Ô4£\”bîÉDµò÷ꎆäe.³*B<ˆÍ/'z;.!Cy¹¤à 3ã„¡è5n`_(y‘7Y¢yZ÷°¾£EýVÄQü±œÌÁG”%ϘkÂ#œ ä»ár$Õw|Æ2£þò‰×iŒŽééWPêköÖÑÓw4Ï9Ž‡©±ccø&‰œ¸@T$›uGöÛÜ3GbSÉ\ ªŠ2Ó=òK‡»Ÿ = ¡TÔé þ7üXï‹ÅWÊ$£¼ù’ #º‡ ‰>eìÄåÕõ¡«ms› 0pÃRtC~$ÅÅÐ<·Ïê×ÖxmìÕ…‹5ÏŽúzêº9Zâ&Qbü‰Ô«W¯¤âKR—‚9½vp2@ÔEˆÞši/>P$±ôvO¥ÔîéXò=¢Ö¸7Ó3Ò7 [yÍA{u÷Ýrßš¥ï†æ¬|ŒçÌ5áª.ŽBFƒI)ì+¨B$5pÊÃ|æüë4ŠIVVß¼Ó7U¨»¿Å¼!*:öñ«6™$YÙ¤‰‘ÄWÌÚ)&lllíMBW@<í\êWrn~a2¬žx.}ýîX9î,D­qýW¾å'+¤_TC¶Aå¹̸ºUéJÁÚñ ¹&<ÂÕIÈhponHI`1$ùÌÚc·É)tÑ»õeNÔ5‰Ù*ÙSoâ›Áþ{O!0’“¹X››æ…Qˆü‹ÚZšþs£”áÅþ{2‰Ýô;D­qý‹1zîµC¶¶ˆòŽ¹äenÁ®ï†Ç#³­¯°äpùÓå"flWðoÒ¸´2M3º!³ÒHjg™Iò™55–?‘WT÷öØ~>Zâ§î()]B·ê—©¼>.Áìê#r!9M?‹7+ŽxùtM©S†7Ûå’z*g7±Æ Üyp·û¹¬IS¼àTŸŽñæ¶AÙ'zœÑîj>—Ò‹¡T¾z"±{÷4ÉD«q51»_½€tí’ÊKB=W“ð­Kg0_[‘p믰×1¯ƒÇë%Ë!„RÈh˜¤‹%ŒÚ†çÐë1\â×'aWÈ1ãœ]O/*óöÐ;¶O×ã´fÉ¢rB{õ éxI¥x| s"2ÂYØšæá­_WtD`è£Q¢¶ð측\R¸íƒ˜hQkÜ@eÓýØq)\(Ÿ¦i…ÀéЖm*À`¡ÈeÉsãšð^Ø¡ü¬w©o1ð%„RÌhN{2nhxÖÎ&«áüÚËgd.*¦t…ì?[·kú…Bo±Ž{ËÙ}=/¿ÔÞ; “e†127†e u9™¹V–WLa‹ÑYà† =½4!𪠞º÷#)ÉIEªq#Åiå'ã‡ñ­¬õ>žºîÎæ [ˆðDYëòï׸EÌë!T†ÒžcB龆æ™åÖ]ŽZS£ØcXÿúŠÏ É(< ÒmÉ03ܯ«ÝuTå¸ÕÄðl=ùŒŠj=NêCñâ©iÞÙ·ýzº:G´ŠšS”a5lOÆH:FC‘jÜÂ]b'Œ$ïQPz8WtZ÷˜iÎVΠ«õ™,yî\ã1¯‹ð’R‡2Miø—B(e¹á!rÙw ×$ûT¦ŽèEì:9¢°¤÷¿Ê®Ú´B—Ä om‚SCŠCÅÜCWìLŒ\ÐC´ƒšÔ{!)½(wûyBÅ´8l+D«q#¯‰Í>M:¥ 8¨Öä Eú–¦¤+åí秈y]„w†d9LÓðõ!-0)Í=x%·†khŒ–xU­ ¬^¨›o%>|±£ÖCÿKó0W½o\ OÉöHÏ = EaëñãW±ì}1"×Æ4ÂʹW««$p©C÷’ø ¸­­Æ ŒŽ«–|­Cµ$ÈS÷@¨Í.†QWXayû¸&üéŒ"ÃRXk™PŠ{CHJmÐ ×ÒX?±çÒh‡Û——¯ÍT×Lúè;°_W‡µb½¶‹Öö¶ž?O <Ár²¬lÓ ÜÑ 5ÓŽb$…Åpò²3©Æ „GTûv…;*Gµu÷å¹…‘t•¼Ã\a ÞÁ¦ Gª—4uaVJB©›‹s:¬†Ä 9ïK>=¥°T»÷°QÖ®ØÄö;£EÚg<µƒèžBîÂSÜSÄÐÚÒ/áüùVl¢@*µë#¬lM õ1 ö›Kœv’/*¯K>à"|Këo*Ð Å$È#Z ùš±õÖm+¢®®H¸õVÛæÞT,3 <ÐìWÄ¥îúŽv–Yxåw ±R²7^ëêÿgY´dÏEEµÿýþoàCˆŠ“'†¥Ÿ\öAR!i ŒÖ« ‡ìœnzj5L*)(ÈWß ¥Æ y!$lC³m‚GôXþnF­\'ô¸&f¾oß~÷ج4ÔÄîJxDmãU–ijqÔã¨2ž¯%=ïÞ}’ÆQ‘j!£Ožž#êè¹9Yˆ<§ÁcɾݥÃ5áÊÉ1™`:Ð1¨Ò7™ªî_Œõfk0\©1:öI[õE¬zRo‚o8í¢£ÃÿaÓÀG{œ…Ù™‡gÊxþjC†­cÁ1tÂæ@•…v<ì E©Q„DM»GÓ¼CtšŠú^7æjf¬Š^ׄGXœL ò‘,ˆ ‹jê%~°?Äœ†0¼ÂgÈÑ(6-ÕƒÜzUÕÔ››4º|5ƒ|‚½µ´¼ µ±d”6Ã. ÎgíÍåffæZ؇ì×õ8âÓt®å„÷E¯Q(„xLÖŠåÅfO¼oiÕ JG$ ½ë::ï ׄG˜${¯šx¢À/ÑñQIS‘ÙB^ÚB×õ5ÆL϶%õc½gx\øòÑ\@@ÉT“_Wi­fj5 œMÒÓÃŒòñ=Å‘àbõÜQУ™XÆ EªQ8„xL³›è,üß.,>h1Í(ĨVX%̆²äíåšð±ßÖ½jôDA4EGTé›Ç¤&È‹,qa¶áuä˜f-1c¯ªncëušØ*?ëUy¨º8*¸ÝHïÞë¢+-²Ð9í㧾8¨TCÞ÷JÅá+{Ñk!Ù;aP¹Ô«– ©«“m¦hÐÐÃ5 »³¬‹°¼#\á ™‰ ".‰$šRG\XLUo.†¤ÏK÷ë8šZå\ŽzÆûâÓ~‘”Ü/¿ì͸GQ}©ÞìWêãE‹n ã!wº÷zù¦=J¼î=)~+4®[SÁ±èòéëX^ÓÑ7׈µx¡ÿ^ÿV½ØøNx¼!ku½ÁéÕ¶éš pE≸$.;¢êü¹’Z&˜î;àb”gAÎÚ^§ñ~¹Äø“?V¶½¸ ›ÜŠº4éFƒ[Í’Zr?nïXÌÎìÕÖòõû ¯>1™K¤¢×(´îÂ`÷j¤+¿*-ÔÑݧßrÐ"«asM-Y1Ù6Ës2peÉÓæšðŸ>¯y!3A!žâC¤+"d5¸»8â‡m†&Ì&ÿµ±÷P\|÷%öÈ$UËjßÃ`„¸ ÎØÔX ©NfQñ”ºšjo‡¢‚B;œ¡ áhÜ BxHɵË= —ç¿*õ:ÃtœËÄJ¯·!˜“knolXÀîáÅ5áVbÿÐç=#7H<]†¬ˆçj‹‚©#º¹„2×Þ¤1ú~Œ¸ÄÐãønéÄž ðG‚QQ©cp©oRíå#uuõ¹—)ñðþEî˜è­Ñ¸)„ä=>¹þLº|4zï%šYG4ß#˜EÐîlË­=Y´¸&<„iiJ]!ö B4]R+Á-"];ÃL­sè{ü7jwŒ=9^1›0ŒI‡=z>¨¢¢Ò;¨<€¢7åå’F*¥èá­Ñ¸I„McÇ¥ž&aSg}çÒ4 Ϡ‚–³_`ëM´z¦•“a-.úî¬k¼`® Pª»»0"Å*êŠÕ˜2+8¦45EÌÄu5RŒO¤¤Ÿ¾¸]-'¿Ü(±†¶:%'{ãiBü] AYšè5n!8›x{[ ¨ÌåDbõ¬ éÕ*F¬ö ‡D¨c·˜óášðã¯ÏÎJI-SDW¬NfA„trSÜ_¡û|#<«9µ!×ÄÊàâXùüÆí{ÉèßÄ.Ê÷ËÝ»0’˜07MK/¶Hã[ dªcù ¿*ÂnÈx™¡Óñ í!¦ûüF¶^nˆ°¾bÕ±åirMx„»+*žÌGðFBêìî ûD–'Ä.~n ¯d`íá†4ÂÚ;6¾{öUe[ ®·÷de“.ÜÀÞOü¾A[§QÈÅj‹Ž{üÇç·i›9Pè§Ižcò †}IÎ ×wFReic{Щ³Àm?<Ÿì„»tµmnS÷x7#,Œ„"uEzbƒk"l œ2žHÃ)¹Û¶AèŒ'%ÏÌv¿’®“~%u½â.¿âj|+€Ä°ÝÑv¬JÏF¿"CV0/p+04Î3³bæ¼Ö±en–5^6 ÍVWô­îâšð‡èP‰»„c<U©HñÆì2äøñôÒlGAbCàëü/™»ÞÓˆS,ÄŒMãÿŽ¯ôUØRoÔ>Ý•¾A&(={8ª^[êMî‡aý—cž-™É²¶3’V«á¦¤Õ*éüáÂ:›àipMx„cc'Ožœž& ïÆꌕ‰ÏGn`@e6éÔ_¤ÁÓÜr …xÊoP#“£óc˜ö&[«QwáÕš±8©DÒyŸSõ´Rš£ã…éÐtS‹ðˆºÈ«çwôvñªÔçdZ™Û4Ær.|ž{µ½Xù/kœ"æu2³•bcc)IÂ1g¾ 3·UaDeQ„€8×Ìßdàù·©UvYë6Õ(:„üö³U·åÚ;zUSaågb3ìP“/L¯XZ…çâí“ÌŒ\ëCf¦_88:wò»Ñá•BoMÖJÀk槈y]„1ÔÊÑ(IyrÜñqÅÄÎ8"sA–¿.ò}OÀ0[EÛðÚfh»i%Â]tYœ¾!Kç(/-žÃg™Ü¹%“:Î:Ìû-/Ý䬓‘a¾`¦é ©åST<Å’Àµ5Ê'×Ñ(¶l|–Hòå·›Áø|Dæ¶Àq]\˜Ç Ø ¬Âˆ!u)%•FKUü°ª}} —TPÚѦ°"áî[m›{Sq‚igp•4¥À’Ά†œõXWG’¡shäW´`0²ì2­úÄqÍqRÃ2ÕíO{ç¿jÔÚ‹áÔÐáJ&i†ù^5n1@òÇÄNWHÁ’Â$xx 'Èu(+ó'È2¥;ü!r 7YòrMx„'øøxËÊÊÌÈÈÅA+«C66––ææWøfaicžQGJÎp6×é‘{òäíoIÞ¦Ùïê|Ђ@|ŸßB²Ç8w?…“ÂIç8‚(:Êqy–ãÅv–¼%® ð<é$RFèÕ×!§ô¾`piñ\ZÐi]÷|›ºV ¦d®…¢ò NÞ'š˜Ú0ß©Æ÷€Þô* qrHo#U<™™‰›™yRQ±{wÜ]–¼K\aV&ä06€Æ¡F,\éÀÏù \\PyÖAFØ‘ëmÊ Šµp¦š±EÎñ]×bïvíÅÒh@£7yå–šŽ7KËŽŸˆz—ß B¤}Ÿ¾À7®CC’xIp\RrhhzúäKÞ® c(ä °÷ʈ1ùd9à|›¬YTœV¢ž:߇ÓëèÉöS°C¸©pgpt ‹ È|Ñhññî*² öNªûi“[ÞNyØõ‚—íÝh|_©3’·;ôßbccÅYò¹&žÆ¤è˜i©r7ŸÑ”Æ5Ô43’TswW†½)ü»‚I"Ò¹Ä(,ÏÔüs1˜öšÚ"mq7Ö)Þb® ¢>‚D/?‘—»7QôÉø˜x ¬dåӳϫ÷( ,Ìuêèîw 3ϾŒm÷'†5ƒª/KÈ}RfÚ³ÑÙƒvf–ÖYÙäÅãÕãçùmŸ‰í  ¡©ø £ÑšéV^£¶„Ù 0>ëàÈpÂìc¬.ƒL$V’v}î Ä6&‡Ý ó¬êŽ“¾ú¯zøOjM´Ê¢©»þ-gc{Ó+6H10ŽÇiöÖÖ„B!´#™ 7Š.oæk›ùKŠ4“IN’y^Ù=7$[^^;'EÎE•SJµÁ m3"[w]+Ç÷À²§˜ª5ZcJFÑ; _`Ðâ–ggknc› ëê$¹ÞqùOáM® Ð>î&–3n}¤6¹¼¿(5ÖO¥¥žÄ =À«ûC U²§j:{{êê¹u¦[f—1EÀ/hÍšòÃùGÍØÿä s­[¿ ß0\Ñ;ÎZçfdEdçäÔÕÕ×KÑiü“@Hvô†ôLt™ f2äzu—ßT€úËyÕ‡L— …=í§’e'z†¤fKNIHŒ =ž•î|ÍÀRê–î/p2 ¯?O¦WÎÓŠ5,°8Zâ‡]¿C–!v:;…¥ÛÛ™š™FR/“…÷sDˆp›o*ö¬¶Ím*èBHãì&ð‚õÑÑLe”H…•°:I¦ Æï¾+94=-7Ó=L î•zGKJ C`5ìt0ÏÂþ41c¥'†*)©µ]äf>¾,Þ‡.-FŽgòìLmÍ®XÚ²²¶¥Æm@\þx¹&ìCT,h©·ï˜»›~Á­| èdæp09šÚŠNãvGxŠk,y›ªÍcrý×;a*¬„½°*2ï&äî%ÉŒ´JÍ‚IuK÷LT“½Ã`Êœ_^·8oLÝðÖVŽÐú˜K½ Ø ÇBá×9s§k†Î¡NÆgMÒæ‰NãvGØÏ5–¼MÕæ‘ ÅëVBtÂsX©2ÈFXtáEÕÓai|C‹ÅÜU2IÄÍSÕjâýÃç<2¢Ë·wcaax+K_LÑ¥$š"Äýîô]Á [œÉåFÑiÜîå¸Æ’·±©Ú<’Ž¾fCAÓQG™¥ ”½-3 +¥±}ÛÓž·É}{r’–FÞÓÓïÄ´—ÉÒ¡' m2÷HqÌÚ…¨Ù¯(H«‰¦¤â\QŸtÓ7莢ӸÝ&s%ocó|yì8*pBÁ ÿ€9rÅ‚¿ÞÄÞ[É÷’.Üéi{š˜˜ø””þ’~ÀŠ*‹si¾XÞ´ÏÍÅ‘Az­\âîué*HK/’¢ŠÁ¥µ9œ“H;>3‰+ºQŒ.¢Ó¸Ý7Õ+lÕÅ¡ NÕ†o¡Gk‚8êÁÞQð—BÁ5‹›Á ‘¡Ì‹‘°lˆA.Úƒ‹-MÎ¥•’bQˆ¤ÍiS1 ¥•=·“±ÒÔw«â0RpĽ! DZü{œQ_”·@qùãÉrþé'ÍãýÓ½ÙÖ¯ˆ£t[Kam l)(BºR7”«¾—t{BmâvRu2Þ½ •¢óêà…GHw(CSëlf‚u1O†!i•ßÃo{2Šƒ»4ƒ!­ñd ò)"FÑiÜî“¸Æ 2›ªÍ{ͦ°ÐÛG³‹d3j“+¢"CÙ¤Û`´ -í;0¸0ª^ë«uD‡é*d“Eªb°òé:,‡²Ë ûæSÕKj5|}¼ !š.C$÷»‹NãvGxk«³µu§jóœù/z¹/™„à…*ϘŒ”¸!2LN®¾F[ëïá÷NP h¢±½Wž9^&n8 ¡´ê½þv¦W†Ê¢Ú\ÀTq8"DS'¢+fOë}[Û¡ ×ØÛÞ MÕ¦™Þ!k Ä@Jª§qDè2C€('—,·<à‚,r‹G˜VˆdÔ“­u6­k*ŸéÄ•aˆý÷ÏáR}]×}VÌ }[Ûá ® :ãÌ݆ìe#„Œta©—Öß*ðÊã»þÇŸ¤x ÷|È›]:q-ÌôPV=iº;ýxVºMP&Ê 39ª^’Vܥ鳢®è4nw„=\!ÝØX!d¤s/GûÈb¨t‡Ïð&-D’oÇÚ$f*iΦîßèãµ—¶,5žÁ…GhR@hbj‘‘Ãï’ÿ`ú.™u¡T~òÈ  $5Lük‹K5±+BÆ펰›k›ÚT¬¾LŽ¹1’–R7<§†I)eH *òïÆ+Òö#ÏzqY›+IëÒôÖÆ„” t6!cC¯ž 5ÚÄ éð˜þv>Cá­:©vt§âðJ Qt·;B)®m!û€¿.»!6×" ùï`¯ü'TF‚¸S÷'3î΄!N~ ‹!&4¦ãfº¥Û^ÐÆ% ËãñúpΡz‰-‰¦Qt·ÕŽ‚ÈN¸¯¯¶Ím* VWRxðËé5Ñ ýÔ½†KIY/@PRºté’’’Ò„haŸÞ„óíhóØcáëˆz~}vì˜$ÎpªÂ‘jL§o>ÔQ ¦ÍSMÅ]¥¾A¢Ô¸íˆËï ×6á…‚ ˆ‚|#)l+Ð K5üÒš ª€#>#ÝšÐàß°w b!LÓ'Ôæ_öÅ–êvW¬²˜‘1˜ÐLÇaÏÒyfCìʆÁ4 9ÍO£«T3Ht·;ÂÝ\!ë"+’2nI) ¥„!iu§Ò‹Ÿ‘î!Ï€ìKÕ ·wE8dryn/ ¤e½'Ø£ÔÈô&Á>Cx ˜ÂŠX‹E§q»#ŒãÚ&诌¤‚Õp™áQµÑÉEUÒò1‚õöª¨@ÕEÌ)Küýº|ƒ'ÔÛGš BfÊN5¢­ƒ&Ó)†ƒÀD¦%ÍiMŢӸݎsMx„¬ËøÇV5—)ÔÂPÚX\‹±tîh*BLÁÆ…I/´‡úúRàËGäˆÅׇvnfÊ—:Cá¡ŒœŠrRØW<‘J~þⶠ”òâr:ªvÑ?ÍOt·;Â!®m!ÿ6>«AqC~ƒ HišÒš‰#¦ŽÎEUUÚWR5eqr40õÜÙ›ûyó¯¥aÝ‹K§“‰ÝDx™ÙTŽ½Ÿh¯¤åiP5wø S&é4õæ)ÑiÜîOrMx„NkDR’”2M³ƒ|¡_šI¨†''áó£j/ÏÑ4„¾øÛK̤0trà#Ä1ØmFb(Žº!d4,†J†àˆsàˆ¢Ó¸Ý7c«ms› V‰ýÊ>]¸R?Ôð«jFˆs玾LMUS TSKM}yôþÄq3à !ã„G]ó[ŒÓ!#Íà7¸ #~§!¡Á¿üyü!Y!*‹Rã¶H .¼\!í´ÜçBÐ(—C>âÆâ&¢úÜ£Gçˆ>õ²viùÒ—ï!Ô ™"Ѓ¦æ,„Ì ÃxÆ ¡”“#CLLç10‹NãvG˵ÍÔTÐúPÁ¾bCØja^ ŽH!–àÐÒTQÒ<•Ö¤AN7½7 ±fÉõV§ÑÙÁZˉêä·89ØÛZ†g-#„ÅLƒ•J¨l#ÓŸøã‚ÉÖ‚2T!ûLÑiÜîc¸&‹!ä¤ÐàˆY¹þå~ùŠüW*¢Ô¸íˆËï×6Ññâ Ó~ B©«››;î,V0¤Á Ɉ%àȘ·áG\ ””|¢Aµµ´ÎÈ®‹\FHCŒ¤ÃÏG&ÈjÈwC6Ã%Ñi|3·øÓ·ú‹¡]^º‰1Ó˜,‡îÇ–ò<Ø E䈿à!¿ÓGðî ¿*â0i‚NèÄËÃþN™Ùõ«ÅU\ïNàµõàpY2ïঠ” üðOáÓ#×,bþÉ?íŒ1m%jÔ"¥,†<&«Aˆ”¢6‚Dƒ_ð¿3!‚{ØH‹çÑ yöü>kWÙdžîb$åABƒcž©.3¤ïE§ñëp¹ˆùßýçüšÙÓLDº9ä0ä1Y 4£ÀŽðöz²R‚F]:[œÂxv¶V¹°§¸ÚºŒò™ñÝ3RÝ<&¡a¡) 2FÞÊ©è¾|«ÿÄŸ°5‹˜Ñ°ŒkM„Ø8Ý„çD—CMixL^ÊÓåÇSB‘‡£)öîåíƒ_ñŸŽ_ Aºñn::ðL±O^D"äцܱ¼éq\ yLBÃ7„Œ†Ç0äQ†¢ÓøõF¸bÖí/~_­‰ÐŒ áárhhà£~Èc†Âð¢+E^Hº#ï üŠ‡5 gøË„ +/¿ÓÙ1ì ÏÖüP8,…¼²ã­Ql„’qabº!OŽ¸!Ój­†GýPtyÛÒÞüñ–—‰§ôéO×$ø'¡ñëhœ"æ?|ô­OÞ÷‡ÚÑ(´±Š˜ÿðÙ·ÿ»©û“и\Äüág¿üÝ~ðßNàŸ€FAóoÈ òÃ÷ýyv4îØŽíØŽíØŽíØŽíØŽíØŽíØŽíØŽíØŽmsûÿ¯0Ë<ÖPš%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-datetime.png0000644000175000017500000000272514030601041025310 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨dIDATxÚí?k#9‡Ÿ;Š@®T¹M•ƒÃB¾€+ÃVS¥;HHçÊUÀ•¿À!¸°…[Wª\,,·O1Õ3¶Çvâ_FÒ›ä÷g¢'’^ýi B!„B!„B!„B!„B!„B!O-`ÄÁŠ…+&6,,x¤7Øóø=µ‹B4E –âÍp\ƒecˆhÁ‚ƒ<äaߢe°„o†ß*¯-´ÇB±O'µ€B!„B!„B!ć Ç¥Vb—pû°úäôŸ¹î#ÂËiW·näø`ÑÌ(Vãô’AFNNÎ(q>lÊ"Ö&Ÿ´eb¯ŽÖªÁʸe™è:œvý[aýlX47JiàqI‡ßçC—ÌDŽXH=E­%Tƒõ³¦(zÔU/âáÉ™O{Ì·òÕÇ\ú­ô(¯±ðeeq­öó‡Ëd“Ö,Xоl°äðÜ—.~«D2|‹£¯CùpÅh맅INF˜RI'V"å(B5X÷5?ŸÓ£Ã#Sº€£Ãé³ÃÓ6ÓþÎà`Ý›ïºÜÒka8þ‹IYY<´MŒâð’‡­æhÊ„“u‰œáèpÑRCz(æbƒ%„B!„B!„{Œ¶NvoŸ¿ß °ÌœÞÀ’‡ K&6<š[øòÀR[Ïj°åÐPGlì.N½¯¾ÛÏMëÏÜIo`ÉÆ…%ÇYôèÐáë;t0ƒÃ¯?ÃêuŸÍÓ…ŠL™{ SzK6,,™Øðhbú¤j }4çœ_TO½/9a÷´»cÈõ;6°äaÃÂ’‰ &][Sµ÷èPËAÿºcDºsö7LžÏJm`ÉÆ…%Í,Š7kÏXyÛv  9ÂrL¹ÄsøIF}p¨ÕŠ%–Llx4³X1†ã ‰qøõœw^ ›yñê¾Cû÷ÒXò°aaÉĆGS‹ íU²à¿µDY|—UÖ›Lp8\€%Íô–¶±à „B!„B!Ä»á?*t4—.%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_10.png0000644000175000017500000000140414030601042024465 0ustar rusconirusconi‰PNG  IHDR‹#_1÷gAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>6IDAThÞíš±nÛ0†§µ(!Ý ç ܱ£_ (ä!@7û 2([‡rÞÁc‡zwÐ-} gÉÐAZòþi’:YŠ‚nÁOËétw<þ¢)ÛЄD"dû*v§I’E%É¢’dQcüD»—ȼƽµíjù†ÇØ}EåΙ¸—êؽEd…s–ö•$‹J’E%É¢2H–2dÈ°°ž•çÉšcíeÏnæy="kÑqulXR¨SPX²bIaa=+îxN’’çM…®:ýªY·Gk~‘¹·Åµ=áúбk…[n;sçŒ2kU2£/½¬Ü»j²fM'¾·oµL̹+lðû¨€xÀ¯‘ëãôñæ¿•á‰÷ÃCÿyÒ—•$‹J’E%É¢’dQI²¨xè‘ÿMü‡XY¾Äî$:ï{’ÞXPHo,è$YT’,*‚mìN÷Ÿþ[Õ´ü*r{Z%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemRect__inherit__graph.png0000644000175000017500000000210214030601041027644 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii111PPR™™™………ççè±±µÓÓÕ*P4nnúí]ütRNSªvå’bKGDˆH pHYsHHFÉk>,IDAThÞíØ1OÛ@p>B_‚#ÒьҭÌÒ­’¥Œœã—˜2Q„ÔŽ|„\#†v¨!ué„KÕµCUCÅÎg¨Ô¡ïrN0i|‰í¥½g)9ûü³ÏçS¤ü§ W=˜Òžª°œºVâ¾ØLíñŽ·RÜüÿ<0”¾„-êÀMÛâäÔÞܪ÷e”·3y ̨Š³Ž{'cÁñG» -tÁîg¸“è7 ÂŒS‚Ñýg˜ [ÅW&4é`Þ‘eÀê!ïåó›ÈX3©£ >©Ùãï=¬û–5K\ñøXúIæOzÿˆÍàNñé‰ðûŽÿò'küû£6sÛcЄŠí’/¡ÓŸ¿ªbý8w_YùIÒbšlýáf>Ÿ\ÚÿIé+îÖjñ"©§÷‰5{©îç߇;¹üMx•Ë_‡_óør~ÏãçÂð"Ÿ Ãð ‡ÿLþgCþ*‡¿&ÿ-»¯W¿µŸþ2»/ý•ãùÔËG{íµ×^{íµ×>‹Wg?_Ôù ÙÏm$¼YËüw=KëãÙOPí{¿"3>žýØVzË~Êkë"«(`Ë@&£Ÿ3¤&C¬ØmêZd·>–ý¬Õ^VòZ'2úY9÷awè 2 ÛÅê¼Èj¦=1 Qô_„Aë´1Åøáñ”<|h $£Ÿ¾?í5FøXö³ÅM±Àó(ú¡ñSÓèÊ0h”e?>Ì0š¿Í›ÃdôsŽ¢92 åÏ~r­?íïÏý 2 ò‰Ù:ÿ‘ΔÝ:ÿÑùδ×^{íµ×^û¿ÓŸ¤ÌªCÞLùÏÃö«Ïùû{XKWÝ!Ÿ±î¿O9oCõè£ïéÎ:×Ñ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayoutGrid.html0000644000175000017500000032005614030601040025204 0ustar rusconirusconi QCPLayoutGrid Class Reference
Public Types | Public Functions | Protected Functions
QCPLayoutGrid Class Reference

A layout that arranges child elements in a grid. More...

Inheritance diagram for QCPLayoutGrid:
Inheritance graph

Public Types

enum  FillOrder
 
- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Public Functions

 QCPLayoutGrid ()
 
int rowCount () const
 
int columnCount () const
 
QList< double > columnStretchFactors () const
 
QList< double > rowStretchFactors () const
 
int columnSpacing () const
 
int rowSpacing () const
 
int wrap () const
 
FillOrder fillOrder () const
 
void setColumnStretchFactor (int column, double factor)
 
void setColumnStretchFactors (const QList< double > &factors)
 
void setRowStretchFactor (int row, double factor)
 
void setRowStretchFactors (const QList< double > &factors)
 
void setColumnSpacing (int pixels)
 
void setRowSpacing (int pixels)
 
void setWrap (int count)
 
void setFillOrder (FillOrder order, bool rearrange=true)
 
virtual void updateLayout ()
 
virtual int elementCount () const
 
virtual QCPLayoutElement * elementAt (int index) const
 
virtual QCPLayoutElement * takeAt (int index)
 
virtual bool take (QCPLayoutElement *element)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
virtual void simplify ()
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
QCPLayoutElement * element (int row, int column) const
 
bool addElement (int row, int column, QCPLayoutElement *element)
 
bool addElement (QCPLayoutElement *element)
 
bool hasElement (int row, int column)
 
void expandTo (int newRowCount, int newColumnCount)
 
void insertRow (int newIndex)
 
void insertColumn (int newIndex)
 
int rowColToIndex (int row, int column) const
 
void indexToRowCol (int index, int &row, int &column) const
 
- Public Functions inherited from QCPLayout
 QCPLayout ()
 
virtual void update (UpdatePhase phase)
 
bool removeAt (int index)
 
bool remove (QCPLayoutElement *element)
 
void clear ()
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

void getMinimumRowColSizes (QVector< int > *minColWidths, QVector< int > *minRowHeights) const
 
void getMaximumRowColSizes (QVector< int > *maxColWidths, QVector< int > *maxRowHeights) const
 
- Protected Functions inherited from QCPLayout
void sizeConstraintsChanged () const
 
void adoptElement (QCPLayoutElement *el)
 
void releaseElement (QCPLayoutElement *el)
 
QVector< int > getSectionSizes (QVector< int > maxSizes, QVector< int > minSizes, QVector< double > stretchFactors, int totalSize) const
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 
- Protected Static Functions inherited from QCPLayout
static QSize getFinalMinimumOuterSize (const QCPLayoutElement *el)
 
static QSize getFinalMaximumOuterSize (const QCPLayoutElement *el)
 

Detailed Description

A layout that arranges child elements in a grid.

Elements are laid out in a grid with configurable stretch factors (setColumnStretchFactor, setRowStretchFactor) and spacing (setColumnSpacing, setRowSpacing).

Elements can be added to cells via addElement. The grid is expanded if the specified row or column doesn't exist yet. Whether a cell contains a valid layout element can be checked with hasElement, that element can be retrieved with element. If rows and columns that only have empty cells shall be removed, call simplify. Removal of elements is either done by just adding the element to a different layout or by using the QCPLayout interface take or remove.

If you use addElement(QCPLayoutElement*) without explicit parameters for row and column, the grid layout will choose the position according to the current setFillOrder and the wrapping (setWrap).

Row and column insertion can be performed with insertRow and insertColumn.

Member Enumeration Documentation

§ FillOrder

enum QCPLayoutGrid::FillOrder

Defines in which direction the grid is filled when using addElement(QCPLayoutElement*). The column/row at which wrapping into the next row/column occurs can be specified with setWrap.

See also
setFillOrder
Enumerator
foRowsFirst 

Rows are filled first, and a new element is wrapped to the next column if the row count would exceed setWrap.

foColumnsFirst 

Columns are filled first, and a new element is wrapped to the next row if the column count would exceed setWrap.

Constructor & Destructor Documentation

§ QCPLayoutGrid()

QCPLayoutGrid::QCPLayoutGrid ( )
explicit

Creates an instance of QCPLayoutGrid and sets default values.

Member Function Documentation

§ rowCount()

int QCPLayoutGrid::rowCount ( ) const
inline

Returns the number of rows in the layout.

See also
columnCount

§ columnCount()

int QCPLayoutGrid::columnCount ( ) const
inline

Returns the number of columns in the layout.

See also
rowCount

§ setColumnStretchFactor()

void QCPLayoutGrid::setColumnStretchFactor ( int  column,
double  factor 
)

Sets the stretch factor of column.

Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see QCPLayoutElement::setMinimumSize, QCPLayoutElement::setMaximumSize, QCPLayoutElement::setSizeConstraintRect.)

The default stretch factor of newly created rows/columns is 1.

See also
setColumnStretchFactors, setRowStretchFactor

§ setColumnStretchFactors()

void QCPLayoutGrid::setColumnStretchFactors ( const QList< double > &  factors)

Sets the stretch factors of all columns. factors must have the size columnCount.

Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see QCPLayoutElement::setMinimumSize, QCPLayoutElement::setMaximumSize, QCPLayoutElement::setSizeConstraintRect.)

The default stretch factor of newly created rows/columns is 1.

See also
setColumnStretchFactor, setRowStretchFactors

§ setRowStretchFactor()

void QCPLayoutGrid::setRowStretchFactor ( int  row,
double  factor 
)

Sets the stretch factor of row.

Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see QCPLayoutElement::setMinimumSize, QCPLayoutElement::setMaximumSize, QCPLayoutElement::setSizeConstraintRect.)

The default stretch factor of newly created rows/columns is 1.

See also
setColumnStretchFactors, setRowStretchFactor

§ setRowStretchFactors()

void QCPLayoutGrid::setRowStretchFactors ( const QList< double > &  factors)

Sets the stretch factors of all rows. factors must have the size rowCount.

Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond their minimum and maximum widths/heights, regardless of the stretch factor. (see QCPLayoutElement::setMinimumSize, QCPLayoutElement::setMaximumSize, QCPLayoutElement::setSizeConstraintRect.)

The default stretch factor of newly created rows/columns is 1.

See also
setRowStretchFactor, setColumnStretchFactors

§ setColumnSpacing()

void QCPLayoutGrid::setColumnSpacing ( int  pixels)

Sets the gap that is left blank between columns to pixels.

See also
setRowSpacing

§ setRowSpacing()

void QCPLayoutGrid::setRowSpacing ( int  pixels)

Sets the gap that is left blank between rows to pixels.

See also
setColumnSpacing

§ setWrap()

void QCPLayoutGrid::setWrap ( int  count)

Sets the maximum number of columns or rows that are used, before new elements added with addElement(QCPLayoutElement*) will start to fill the next row or column, respectively. It depends on setFillOrder, whether rows or columns are wrapped.

If count is set to zero, no wrapping will ever occur.

If you wish to re-wrap the elements currently in the layout, call setFillOrder with rearrange set to true (the actual fill order doesn't need to be changed for the rearranging to be done).

Note that the method addElement(int row, int column, QCPLayoutElement *element) with explicitly stated row and column is not subject to wrapping and can place elements even beyond the specified wrapping point.

See also
setFillOrder

§ setFillOrder()

void QCPLayoutGrid::setFillOrder ( FillOrder  order,
bool  rearrange = true 
)

Sets the filling order and wrapping behaviour that is used when adding new elements with the method addElement(QCPLayoutElement*).

The specified order defines whether rows or columns are filled first. Using setWrap, you can control at which row/column count wrapping into the next column/row will occur. If you set it to zero, no wrapping will ever occur. Changing the fill order also changes the meaning of the linear index used e.g. in elementAt and takeAt. The default fill order for QCPLayoutGrid is foColumnsFirst.

If you want to have all current elements arranged in the new order, set rearrange to true. The elements will be rearranged in a way that tries to preserve their linear index. However, empty cells are skipped during build-up of the new cell order, which shifts the succeeding element's index. The rearranging is performed even if the specified order is already the current fill order. Thus this method can be used to re-wrap the current elements.

If rearrange is false, the current element arrangement is not changed, which means the linear indexes change (because the linear index is dependent on the fill order).

Note that the method addElement(int row, int column, QCPLayoutElement *element) with explicitly stated row and column is not subject to wrapping and can place elements even beyond the specified wrapping point.

See also
setWrap, addElement(QCPLayoutElement*)

§ updateLayout()

void QCPLayoutGrid::updateLayout ( )
virtual

Subclasses reimplement this method to update the position and sizes of the child elements/cells via calling their QCPLayoutElement::setOuterRect. The default implementation does nothing.

The geometry used as a reference is the inner rect of this layout. Child elements should stay within that rect.

getSectionSizes may help with the reimplementation of this function.

See also
update

Reimplemented from QCPLayout.

§ elementCount()

virtual int QCPLayoutGrid::elementCount ( ) const
inlinevirtual

Returns the number of elements/cells in the layout.

See also
elements, elementAt

Implements QCPLayout.

§ elementAt()

QCPLayoutElement * QCPLayoutGrid::elementAt ( int  index) const
virtual

For general information about this virtual method, see the base class implementation.

Note that the association of the linear index to the row/column based cells depends on the current setting of setFillOrder.

See also
rowColToIndex

Implements QCPLayout.

§ takeAt()

QCPLayoutElement * QCPLayoutGrid::takeAt ( int  index)
virtual

For general information about this virtual method, see the base class implementation.

Note that the association of the linear index to the row/column based cells depends on the current setting of setFillOrder.

See also
rowColToIndex

Implements QCPLayout.

§ take()

bool QCPLayoutGrid::take ( QCPLayoutElement *  element)
virtual

Removes the specified element from the layout and returns true on success.

If the element isn't in this layout, returns false.

Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
takeAt

Implements QCPLayout.

§ elements()

QList< QCPLayoutElement * > QCPLayoutGrid::elements ( bool  recursive) const
virtual

Returns a list of all child elements in this layout element. If recursive is true, all sub-child elements are included in the list, too.

Warning
There may be nullptr entries in the returned list. For example, QCPLayoutGrid may have empty cells which yield nullptr at the respective index.

Reimplemented from QCPLayout.

§ simplify()

void QCPLayoutGrid::simplify ( )
virtual

Simplifies the layout by collapsing rows and columns which only contain empty cells.

Reimplemented from QCPLayout.

§ minimumOuterSizeHint()

QSize QCPLayoutGrid::minimumOuterSizeHint ( ) const
virtual

Returns the suggested minimum size this layout element (the outerRect) may be compressed to, if no manual minimum size is set.

if a minimum size (setMinimumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMinimumOuterSize) to determine the minimum allowed size of this layout element.

A manual minimum size is considered set if it is non-zero.

The default implementation simply returns the sum of the horizontal margins for the width and the sum of the vertical margins for the height. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented from QCPLayoutElement.

§ maximumOuterSizeHint()

QSize QCPLayoutGrid::maximumOuterSizeHint ( ) const
virtual

Returns the suggested maximum size this layout element (the outerRect) may be expanded to, if no manual maximum size is set.

if a maximum size (setMaximumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMaximumOuterSize) to determine the maximum allowed size of this layout element.

A manual maximum size is considered set if it is smaller than Qt's QWIDGETSIZE_MAX.

The default implementation simply returns QWIDGETSIZE_MAX for both width and height, implying no suggested maximum size. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented from QCPLayoutElement.

§ element()

QCPLayoutElement * QCPLayoutGrid::element ( int  row,
int  column 
) const

Returns the element in the cell in row and column.

Returns nullptr if either the row/column is invalid or if the cell is empty. In those cases, a qDebug message is printed. To check whether a cell exists and isn't empty, use hasElement.

See also
addElement, hasElement

§ addElement() [1/2]

bool QCPLayoutGrid::addElement ( int  row,
int  column,
QCPLayoutElement *  element 
)

This is an overloaded function.

Adds the element to cell with row and column. If element is already in a layout, it is first removed from there. If row or column don't exist yet, the layout is expanded accordingly.

Returns true if the element was added successfully, i.e. if the cell at row and column didn't already have an element.

Use the overload of this method without explicit row/column index to place the element according to the configured fill order and wrapping settings.

See also
element, hasElement, take, remove

§ addElement() [2/2]

bool QCPLayoutGrid::addElement ( QCPLayoutElement *  element)

This is an overloaded function.

Adds the element to the next empty cell according to the current fill order (setFillOrder) and wrapping (setWrap). If element is already in a layout, it is first removed from there. If necessary, the layout is expanded to hold the new element.

Returns true if the element was added successfully.

See also
setFillOrder, setWrap, element, hasElement, take, remove

§ hasElement()

bool QCPLayoutGrid::hasElement ( int  row,
int  column 
)

Returns whether the cell at row and column exists and contains a valid element, i.e. isn't empty.

See also
element

§ expandTo()

void QCPLayoutGrid::expandTo ( int  newRowCount,
int  newColumnCount 
)

Expands the layout to have newRowCount rows and newColumnCount columns. So the last valid row index will be newRowCount-1, the last valid column index will be newColumnCount-1.

If the current column/row count is already larger or equal to newColumnCount/newRowCount, this function does nothing in that dimension.

Newly created cells are empty, new rows and columns have the stretch factor 1.

Note that upon a call to addElement, the layout is expanded automatically to contain the specified row and column, using this function.

See also
simplify

§ insertRow()

void QCPLayoutGrid::insertRow ( int  newIndex)

Inserts a new row with empty cells at the row index newIndex. Valid values for newIndex range from 0 (inserts a row at the top) to rowCount (appends a row at the bottom).

See also
insertColumn

§ insertColumn()

void QCPLayoutGrid::insertColumn ( int  newIndex)

Inserts a new column with empty cells at the column index newIndex. Valid values for newIndex range from 0 (inserts a column at the left) to columnCount (appends a column at the right).

See also
insertRow

§ rowColToIndex()

int QCPLayoutGrid::rowColToIndex ( int  row,
int  column 
) const

Converts the given row and column to the linear index used by some methods of QCPLayoutGrid and QCPLayout.

The way the cells are indexed depends on setFillOrder. If it is foRowsFirst, the indices increase left to right and then top to bottom. If it is foColumnsFirst, the indices increase top to bottom and then left to right.

For the returned index to be valid, row and column must be valid indices themselves, i.e. greater or equal to zero and smaller than the current rowCount/columnCount.

See also
indexToRowCol

§ indexToRowCol()

void QCPLayoutGrid::indexToRowCol ( int  index,
int &  row,
int &  column 
) const

Converts the linear index to row and column indices and writes the result to row and column.

The way the cells are indexed depends on setFillOrder. If it is foRowsFirst, the indices increase left to right and then top to bottom. If it is foColumnsFirst, the indices increase top to bottom and then left to right.

If there are no cells (i.e. column or row count is zero), sets row and column to -1.

For the retrieved row and column to be valid, the passed index must be valid itself, i.e. greater or equal to zero and smaller than the current elementCount.

See also
rowColToIndex

§ getMinimumRowColSizes()

void QCPLayoutGrid::getMinimumRowColSizes ( QVector< int > *  minColWidths,
QVector< int > *  minRowHeights 
) const
protected

Places the minimum column widths and row heights into minColWidths and minRowHeights respectively.

The minimum height of a row is the largest minimum height of any element's outer rect in that row. The minimum width of a column is the largest minimum width of any element's outer rect in that column.

This is a helper function for updateLayout.

See also
getMaximumRowColSizes

§ getMaximumRowColSizes()

void QCPLayoutGrid::getMaximumRowColSizes ( QVector< int > *  maxColWidths,
QVector< int > *  maxRowHeights 
) const
protected

Places the maximum column widths and row heights into maxColWidths and maxRowHeights respectively.

The maximum height of a row is the smallest maximum height of any element's outer rect in that row. The maximum width of a column is the smallest maximum width of any element's outer rect in that column.

This is a helper function for updateLayout.

See also
getMinimumRowColSizes
The documentation for this class was generated from the following files:
  • src/layout.h
  • src/layout.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_h.html0000644000175000017500000000420614030601037024050 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- h -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarAxisRadial.html0000644000175000017500000050526114030601040026143 0ustar rusconirusconi QCPPolarAxisRadial Class Reference
Public Types | Public Functions | Signals | Protected Functions
QCPPolarAxisRadial Class Reference

The radial axis inside a radial plot. More...

Inheritance diagram for QCPPolarAxisRadial:
Inheritance graph

Public Types

enum  AngleReference
 
enum  ScaleType
 
enum  SelectablePart
 
enum  LabelMode
 

Public Functions

 QCPPolarAxisRadial (QCPPolarAxisAngular *parent)
 
bool rangeDrag () const
 
bool rangeZoom () const
 
double rangeZoomFactor () const
 
QCPPolarAxisAngular * angularAxis () const
 
ScaleType scaleType () const
 
const QCPRange range () const
 
bool rangeReversed () const
 
double angle () const
 
AngleReference angleReference () const
 
QSharedPointer< QCPAxisTicker > ticker () const
 
bool ticks () const
 
bool tickLabels () const
 
int tickLabelPadding () const
 
QFont tickLabelFont () const
 
QColor tickLabelColor () const
 
double tickLabelRotation () const
 
LabelMode tickLabelMode () const
 
QString numberFormat () const
 
int numberPrecision () const
 
QVector< double > tickVector () const
 
QVector< double > subTickVector () const
 
QVector< QString > tickVectorLabels () const
 
int tickLengthIn () const
 
int tickLengthOut () const
 
bool subTicks () const
 
int subTickLengthIn () const
 
int subTickLengthOut () const
 
QPen basePen () const
 
QPen tickPen () const
 
QPen subTickPen () const
 
QFont labelFont () const
 
QColor labelColor () const
 
QString label () const
 
int labelPadding () const
 
SelectableParts selectedParts () const
 
SelectableParts selectableParts () const
 
QFont selectedTickLabelFont () const
 
QFont selectedLabelFont () const
 
QColor selectedTickLabelColor () const
 
QColor selectedLabelColor () const
 
QPen selectedBasePen () const
 
QPen selectedTickPen () const
 
QPen selectedSubTickPen () const
 
void setRangeDrag (bool enabled)
 
void setRangeZoom (bool enabled)
 
void setRangeZoomFactor (double factor)
 
Q_SLOT void setScaleType (QCPPolarAxisRadial::ScaleType type)
 
Q_SLOT void setRange (const QCPRange &range)
 
void setRange (double lower, double upper)
 
void setRange (double position, double size, Qt::AlignmentFlag alignment)
 
void setRangeLower (double lower)
 
void setRangeUpper (double upper)
 
void setRangeReversed (bool reversed)
 
void setAngle (double degrees)
 
void setAngleReference (AngleReference reference)
 
void setTicker (QSharedPointer< QCPAxisTicker > ticker)
 
void setTicks (bool show)
 
void setTickLabels (bool show)
 
void setTickLabelPadding (int padding)
 
void setTickLabelFont (const QFont &font)
 
void setTickLabelColor (const QColor &color)
 
void setTickLabelRotation (double degrees)
 
void setTickLabelMode (LabelMode mode)
 
void setNumberFormat (const QString &formatCode)
 
void setNumberPrecision (int precision)
 
void setTickLength (int inside, int outside=0)
 
void setTickLengthIn (int inside)
 
void setTickLengthOut (int outside)
 
void setSubTicks (bool show)
 
void setSubTickLength (int inside, int outside=0)
 
void setSubTickLengthIn (int inside)
 
void setSubTickLengthOut (int outside)
 
void setBasePen (const QPen &pen)
 
void setTickPen (const QPen &pen)
 
void setSubTickPen (const QPen &pen)
 
void setLabelFont (const QFont &font)
 
void setLabelColor (const QColor &color)
 
void setLabel (const QString &str)
 
void setLabelPadding (int padding)
 
void setSelectedTickLabelFont (const QFont &font)
 
void setSelectedLabelFont (const QFont &font)
 
void setSelectedTickLabelColor (const QColor &color)
 
void setSelectedLabelColor (const QColor &color)
 
void setSelectedBasePen (const QPen &pen)
 
void setSelectedTickPen (const QPen &pen)
 
void setSelectedSubTickPen (const QPen &pen)
 
Q_SLOT void setSelectableParts (const QCPPolarAxisRadial::SelectableParts &selectableParts)
 
Q_SLOT void setSelectedParts (const QCPPolarAxisRadial::SelectableParts &selectedParts)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=0) const
 
void moveRange (double diff)
 
void scaleRange (double factor)
 
void scaleRange (double factor, double center)
 
void rescale (bool onlyVisiblePlottables=false)
 
void pixelToCoord (QPointF pixelPos, double &angleCoord, double &radiusCoord) const
 
QPointF coordToPixel (double angleCoord, double radiusCoord) const
 
double coordToRadius (double coord) const
 
double radiusToCoord (double radius) const
 
SelectablePart getPartAt (const QPointF &pos) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void rangeChanged (const QCPRange &newRange)
 
void rangeChanged (const QCPRange &newRange, const QCPRange &oldRange)
 
void scaleTypeChanged (QCPPolarAxisRadial::ScaleType scaleType)
 
void selectionChanged (const QCPPolarAxisRadial::SelectableParts &parts)
 
void selectableChanged (const QCPPolarAxisRadial::SelectableParts &parts)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual QCP::Interaction selectionCategory () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void wheelEvent (QWheelEvent *event)
 
void updateGeometry (const QPointF &center, double radius)
 
void setupTickVectors ()
 
QPen getBasePen () const
 
QPen getTickPen () const
 
QPen getSubTickPen () const
 
QFont getTickLabelFont () const
 
QFont getLabelFont () const
 
QColor getTickLabelColor () const
 
QColor getLabelColor () const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QRect clipRect () const
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

The radial axis inside a radial plot.

Warning
In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future.

Each axis holds an instance of QCPAxisTicker which is used to generate the tick coordinates and tick labels. You can access the currently installed ticker or set a new one (possibly one of the specialized subclasses, or your own subclass) via setTicker. For details, see the documentation of QCPAxisTicker.

Member Enumeration Documentation

§ AngleReference

enum QCPPolarAxisRadial::AngleReference

Defines the reference of the angle at which a radial axis is tilted (setAngle).

Enumerator
arAbsolute 

The axis tilt is given in absolute degrees. The zero is to the right and positive angles are measured counter-clockwise.

arAngularAxis 

The axis tilt is measured in the angular coordinate system given by the parent angular axis.

§ ScaleType

enum QCPPolarAxisRadial::ScaleType

Defines the scale of an axis.

See also
setScaleType
Enumerator
stLinear 

Linear scaling.

stLogarithmic 

Logarithmic scaling with correspondingly transformed axis coordinates (possibly also setTicker to a QCPAxisTickerLog instance).

§ SelectablePart

enum QCPPolarAxisRadial::SelectablePart

Defines the selectable parts of an axis.

See also
setSelectableParts, setSelectedParts
Enumerator
spNone 

None of the selectable parts.

spAxis 

The axis backbone and tick marks.

spTickLabels 

Tick labels (numbers) of this axis (as a whole, not individually)

spAxisLabel 

The axis label.

Constructor & Destructor Documentation

§ QCPPolarAxisRadial()

QCPPolarAxisRadial::QCPPolarAxisRadial ( QCPPolarAxisAngular *  parent)
explicit

Constructs an Axis instance of Type type for the axis rect parent.

Usually it isn't necessary to instantiate axes directly, because you can let QCustomPlot create them for you with QCPAxisRect::addAxis. If you want to use own QCPAxis-subclasses however, create them manually and then inject them also via QCPAxisRect::addAxis.

Member Function Documentation

§ ticker()

QSharedPointer< QCPAxisTicker > QCPPolarAxisRadial::ticker ( ) const
inline

Returns a modifiable shared pointer to the currently installed axis ticker. The axis ticker is responsible for generating the tick positions and tick labels of this axis. You can access the QCPAxisTicker with this method and modify basic properties such as the approximate tick count (QCPAxisTicker::setTickCount).

You can gain more control over the axis ticks by setting a different QCPAxisTicker subclass, see the documentation there. A new axis ticker can be set with setTicker.

Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes.

See also
setTicker

§ setScaleType()

void QCPPolarAxisRadial::setScaleType ( QCPPolarAxisRadial::ScaleType  type)

Sets whether the axis uses a linear scale or a logarithmic scale.

Note that this method controls the coordinate transformation. For logarithmic scales, you will likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting the axis ticker to an instance of QCPAxisTickerLog :

customPlot->xAxis->setScaleType(QCPAxis::stLogarithmic);
customPlot->xAxis->setTicker(QSharedPointer<QCPAxisTickerLog>(new QCPAxisTickerLog));

See the documentation of QCPAxisTickerLog about the details of logarithmic axis tick creation.

setNumberPrecision

§ setRange() [1/3]

void QCPPolarAxisRadial::setRange ( const QCPRange &  range)

Sets the range of the axis.

This slot may be connected with the rangeChanged signal of another axis so this axis is always synchronized with the other axis range, when it changes.

To invert the direction of an axis, use setRangeReversed.

§ setRange() [2/3]

void QCPPolarAxisRadial::setRange ( double  lower,
double  upper 
)

This is an overloaded function.

Sets the lower and upper bound of the axis range.

To invert the direction of an axis, use setRangeReversed.

There is also a slot to set a range, see setRange(const QCPRange &range).

§ setRange() [3/3]

void QCPPolarAxisRadial::setRange ( double  position,
double  size,
Qt::AlignmentFlag  alignment 
)

This is an overloaded function.

Sets the range of the axis.

The position coordinate indicates together with the alignment parameter, where the new range will be positioned. size defines the size of the new axis range. alignment may be Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, or center of the range to be aligned with position. Any other values of alignment will default to Qt::AlignCenter.

§ setRangeLower()

void QCPPolarAxisRadial::setRangeLower ( double  lower)

Sets the lower bound of the axis range. The upper bound is not changed.

See also
setRange

§ setRangeUpper()

void QCPPolarAxisRadial::setRangeUpper ( double  upper)

Sets the upper bound of the axis range. The lower bound is not changed.

See also
setRange

§ setRangeReversed()

void QCPPolarAxisRadial::setRangeReversed ( bool  reversed)

Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When reversed is set to true, the direction of increasing values is inverted.

Note that the range and data interface stays the same for reversed axes, e.g. the lower part of the setRange interface will still reference the mathematically smaller number than the upper part.

§ setTicker()

void QCPPolarAxisRadial::setTicker ( QSharedPointer< QCPAxisTicker >  ticker)

The axis ticker is responsible for generating the tick positions and tick labels. See the documentation of QCPAxisTicker for details on how to work with axis tickers.

You can change the tick positioning/labeling behaviour of this axis by setting a different QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis ticker, access it via ticker.

Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes.

See also
ticker

§ setTicks()

void QCPPolarAxisRadial::setTicks ( bool  show)

Sets whether tick marks are displayed.

Note that setting show to false does not imply that tick labels are invisible, too. To achieve that, see setTickLabels.

See also
setSubTicks

§ setTickLabels()

void QCPPolarAxisRadial::setTickLabels ( bool  show)

Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks.

§ setTickLabelPadding()

void QCPPolarAxisRadial::setTickLabelPadding ( int  padding)

Sets the distance between the axis base line (including any outward ticks) and the tick labels.

See also
setLabelPadding, setPadding

§ setTickLabelFont()

void QCPPolarAxisRadial::setTickLabelFont ( const QFont &  font)

Sets the font of the tick labels.

See also
setTickLabels, setTickLabelColor

§ setTickLabelColor()

void QCPPolarAxisRadial::setTickLabelColor ( const QColor &  color)

Sets the color of the tick labels.

See also
setTickLabels, setTickLabelFont

§ setTickLabelRotation()

void QCPPolarAxisRadial::setTickLabelRotation ( double  degrees)

Sets the rotation of the tick labels. If degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by degrees clockwise. The specified angle is bound to values from -90 to 90 degrees.

If degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For other angles, the label is drawn with an offset such that it seems to point toward or away from the tick mark.

§ setNumberFormat()

void QCPPolarAxisRadial::setNumberFormat ( const QString &  formatCode)

Sets the number format for the numbers in tick labels. This formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class.

formatCode is a string of one, two or three characters. The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter.

The second and third characters are optional and specific to QCustomPlot:
If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which is ugly in a plot. So when the second char of formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot.

Examples for formatCode:

  • g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used
  • gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign
  • ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign
  • fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'.
  • hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed.

§ setNumberPrecision()

void QCPPolarAxisRadial::setNumberPrecision ( int  precision)

Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Formats starting with 'e', see setNumberFormat

§ setTickLength()

void QCPPolarAxisRadial::setTickLength ( int  inside,
int  outside = 0 
)

Sets the length of the ticks in pixels. inside is the length the ticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setSubTickLength, setTickLengthIn, setTickLengthOut

§ setTickLengthIn()

void QCPPolarAxisRadial::setTickLengthIn ( int  inside)

Sets the length of the inward ticks in pixels. inside is the length the ticks will reach inside the plot.

See also
setTickLengthOut, setTickLength, setSubTickLength

§ setTickLengthOut()

void QCPPolarAxisRadial::setTickLengthOut ( int  outside)

Sets the length of the outward ticks in pixels. outside is the length the ticks will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setTickLengthIn, setTickLength, setSubTickLength

§ setSubTicks()

void QCPPolarAxisRadial::setSubTicks ( bool  show)

Sets whether sub tick marks are displayed.

Sub ticks are only potentially visible if (major) ticks are also visible (see setTicks)

See also
setTicks

§ setSubTickLength()

void QCPPolarAxisRadial::setSubTickLength ( int  inside,
int  outside = 0 
)

Sets the length of the subticks in pixels. inside is the length the subticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setTickLength, setSubTickLengthIn, setSubTickLengthOut

§ setSubTickLengthIn()

void QCPPolarAxisRadial::setSubTickLengthIn ( int  inside)

Sets the length of the inward subticks in pixels. inside is the length the subticks will reach inside the plot.

See also
setSubTickLengthOut, setSubTickLength, setTickLength

§ setSubTickLengthOut()

void QCPPolarAxisRadial::setSubTickLengthOut ( int  outside)

Sets the length of the outward subticks in pixels. outside is the length the subticks will reach outside the plot. If outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setSubTickLengthIn, setSubTickLength, setTickLength

§ setBasePen()

void QCPPolarAxisRadial::setBasePen ( const QPen &  pen)

Sets the pen, the axis base line is drawn with.

See also
setTickPen, setSubTickPen

§ setTickPen()

void QCPPolarAxisRadial::setTickPen ( const QPen &  pen)

Sets the pen, tick marks will be drawn with.

See also
setTickLength, setBasePen

§ setSubTickPen()

void QCPPolarAxisRadial::setSubTickPen ( const QPen &  pen)

Sets the pen, subtick marks will be drawn with.

See also
setSubTickCount, setSubTickLength, setBasePen

§ setLabelFont()

void QCPPolarAxisRadial::setLabelFont ( const QFont &  font)

Sets the font of the axis label.

See also
setLabelColor

§ setLabelColor()

void QCPPolarAxisRadial::setLabelColor ( const QColor &  color)

Sets the color of the axis label.

See also
setLabelFont

§ setLabel()

void QCPPolarAxisRadial::setLabel ( const QString &  str)

Sets the text of the axis label that will be shown below/above or next to the axis, depending on its orientation. To disable axis labels, pass an empty string as str.

§ setLabelPadding()

void QCPPolarAxisRadial::setLabelPadding ( int  padding)

Sets the distance between the tick labels and the axis label.

See also
setTickLabelPadding, setPadding

§ setSelectedTickLabelFont()

void QCPPolarAxisRadial::setSelectedTickLabelFont ( const QFont &  font)

Sets the font that is used for tick labels when they are selected.

See also
setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedLabelFont()

void QCPPolarAxisRadial::setSelectedLabelFont ( const QFont &  font)

Sets the font that is used for the axis label when it is selected.

See also
setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedTickLabelColor()

void QCPPolarAxisRadial::setSelectedTickLabelColor ( const QColor &  color)

Sets the color that is used for tick labels when they are selected.

See also
setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedLabelColor()

void QCPPolarAxisRadial::setSelectedLabelColor ( const QColor &  color)

Sets the color that is used for the axis label when it is selected.

See also
setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedBasePen()

void QCPPolarAxisRadial::setSelectedBasePen ( const QPen &  pen)

Sets the pen that is used to draw the axis base line when selected.

See also
setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedTickPen()

void QCPPolarAxisRadial::setSelectedTickPen ( const QPen &  pen)

Sets the pen that is used to draw the (major) ticks when selected.

See also
setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedSubTickPen()

void QCPPolarAxisRadial::setSelectedSubTickPen ( const QPen &  pen)

Sets the pen that is used to draw the subticks when selected.

See also
setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectableParts()

void QCPPolarAxisRadial::setSelectableParts ( const QCPPolarAxisRadial::SelectableParts &  selectableParts)

Sets whether the user can (de-)select the parts in selectable by clicking on the QCustomPlot surface. (When QCustomPlot::setInteractions contains iSelectAxes.)

However, even when selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling setSelectedParts directly.

See also
SelectablePart, setSelectedParts

§ setSelectedParts()

void QCPPolarAxisRadial::setSelectedParts ( const QCPPolarAxisRadial::SelectableParts &  selectedParts)

Sets the selected state of the respective axis parts described by SelectablePart. When a part is selected, it uses a different pen/font.

The entire selection mechanism for axes is handled automatically when QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you wish to change the selection state manually.

This function can change the selection state of a part, independent of the setSelectableParts setting.

emits the selectionChanged signal when selected is different from the previous selection state.

See also
SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor

§ selectTest()

double QCPPolarAxisRadial::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = 0 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Reimplemented from QCPLayerable.

§ moveRange()

void QCPPolarAxisRadial::moveRange ( double  diff)

If the scale type (setScaleType) is stLinear, diff is added to the lower and upper bounds of the range. The range is simply moved by diff.

If the scale type is stLogarithmic, the range bounds are multiplied by diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff).

§ scaleRange() [1/2]

void QCPPolarAxisRadial::scaleRange ( double  factor)

Scales the range of this axis by factor around the center of the current axis range. For example, if factor is 2.0, then the axis range will double its size, and the point at the axis range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around the center will have moved symmetrically closer).

If you wish to scale around a different coordinate than the current axis range center, use the overload scaleRange(double factor, double center).

§ scaleRange() [2/2]

void QCPPolarAxisRadial::scaleRange ( double  factor,
double  center 
)

This is an overloaded function.

Scales the range of this axis by factor around the coordinate center. For example, if factor is 2.0, center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0).

See also
scaleRange(double factor)

§ rescale()

void QCPPolarAxisRadial::rescale ( bool  onlyVisiblePlottables = false)

Changes the axis range such that all plottables associated with this axis are fully visible in that dimension.

See also
QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes

§ pixelToCoord()

void QCPPolarAxisRadial::pixelToCoord ( QPointF  pixelPos,
double &  angleCoord,
double &  radiusCoord 
) const

Transforms value, in pixel coordinates of the QCustomPlot widget, to axis coordinates.

§ coordToPixel()

QPointF QCPPolarAxisRadial::coordToPixel ( double  angleCoord,
double  radiusCoord 
) const

Transforms value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget.

§ getPartAt()

QCPPolarAxisRadial::SelectablePart QCPPolarAxisRadial::getPartAt ( const QPointF &  pos) const

Returns the part of the axis that is hit by pos (in pixels). The return value of this function is independent of the user-selectable parts defined with setSelectableParts. Further, this function does not change the current selection state of the axis.

If the axis is not visible (setVisible), this function always returns spNone.

See also
setSelectedParts, setSelectableParts, QCustomPlot::setInteractions

§ rangeChanged [1/2]

void QCPPolarAxisRadial::rangeChanged ( const QCPRange &  newRange)
signal

This signal is emitted when the range of this axis has changed. You can connect it to the setRange slot of another axis to communicate the new range to the other axis, in order for it to be synchronized.

You may also manipulate/correct the range with setRange in a slot connected to this signal. This is useful if for example a maximum range span shall not be exceeded, or if the lower/upper range shouldn't go beyond certain values (see QCPRange::bounded). For example, the following slot would limit the x axis to ranges between 0 and 10:

customPlot->xAxis->setRange(newRange.bounded(0, 10))

§ rangeChanged [2/2]

void QCPPolarAxisRadial::rangeChanged ( const QCPRange &  newRange,
const QCPRange &  oldRange 
)
signal

This is an overloaded function.

Additionally to the new range, this signal also provides the previous range held by the axis as oldRange.

§ scaleTypeChanged

void QCPPolarAxisRadial::scaleTypeChanged ( QCPPolarAxisRadial::ScaleType  scaleType)
signal

This signal is emitted when the scale type changes, by calls to setScaleType

§ selectionChanged

void QCPPolarAxisRadial::selectionChanged ( const QCPPolarAxisRadial::SelectableParts &  parts)
signal

This signal is emitted when the selection state of this axis has changed, either by user interaction or by a direct call to setSelectedParts.

§ selectableChanged

void QCPPolarAxisRadial::selectableChanged ( const QCPPolarAxisRadial::SelectableParts &  parts)
signal

This signal is emitted when the selectability changes, by calls to setSelectableParts

§ applyDefaultAntialiasingHint()

void QCPPolarAxisRadial::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing axis lines.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

For general information about this virtual method, see the base class implementation.

See also
setAntialiased

Implements QCPLayerable.

§ draw()

void QCPPolarAxisRadial::draw ( QCPPainter *  painter)
protectedvirtual

Draws the axis with the specified painter, using the internal QCPAxisPainterPrivate instance.

For general information about this virtual method, see the base class implementation.

Implements QCPLayerable.

§ selectionCategory()

QCP::Interaction QCPPolarAxisRadial::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ selectEvent()

void QCPPolarAxisRadial::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPPolarAxisRadial::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ mousePressEvent()

void QCPPolarAxisRadial::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis.

For the axis to accept this event and perform the single axis drag, the parent QCPAxisRect must be configured accordingly, i.e. it must allow range dragging in the orientation of this axis (QCPAxisRect::setRangeDrag) and this axis must be a draggable axis (QCPAxisRect::setRangeDragAxes)

For general information about this virtual method, see the base class implementation.

Note
The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::mousePressEvent.

Reimplemented from QCPLayerable.

§ mouseMoveEvent()

void QCPPolarAxisRadial::mouseMoveEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis.

For general information about this virtual method, see the base class implementation.

Note
The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::mousePressEvent.
See also
QCPAxis::mousePressEvent

Reimplemented from QCPLayerable.

§ mouseReleaseEvent()

void QCPPolarAxisRadial::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis.

For general information about this virtual method, see the base class implementation.

Note
The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::mousePressEvent.
See also
QCPAxis::mousePressEvent

Reimplemented from QCPLayerable.

§ wheelEvent()

void QCPPolarAxisRadial::wheelEvent ( QWheelEvent *  event)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user zoom individual axes exclusively, by performing the wheel event on top of the axis.

For the axis to accept this event and perform the single axis zoom, the parent QCPAxisRect must be configured accordingly, i.e. it must allow range zooming in the orientation of this axis (QCPAxisRect::setRangeZoom) and this axis must be a zoomable axis (QCPAxisRect::setRangeZoomAxes)

For general information about this virtual method, see the base class implementation.

Note
The zooming of possibly multiple axes at once by performing the wheel event anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::wheelEvent.

Reimplemented from QCPLayerable.

§ setupTickVectors()

void QCPPolarAxisRadial::setupTickVectors ( )
protected

Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling QCPAxisTicker::generate on the currently installed ticker.

If a change in the label text/count is detected, the cached axis margin is invalidated to make sure the next margin calculation recalculates the label sizes and returns an up-to-date value.

§ getBasePen()

QPen QCPPolarAxisRadial::getBasePen ( ) const
protected

Returns the pen that is used to draw the axis base line. Depending on the selection state, this is either mSelectedBasePen or mBasePen.

§ getTickPen()

QPen QCPPolarAxisRadial::getTickPen ( ) const
protected

Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this is either mSelectedTickPen or mTickPen.

§ getSubTickPen()

QPen QCPPolarAxisRadial::getSubTickPen ( ) const
protected

Returns the pen that is used to draw the subticks. Depending on the selection state, this is either mSelectedSubTickPen or mSubTickPen.

§ getTickLabelFont()

QFont QCPPolarAxisRadial::getTickLabelFont ( ) const
protected

Returns the font that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelFont or mTickLabelFont.

§ getLabelFont()

QFont QCPPolarAxisRadial::getLabelFont ( ) const
protected

Returns the font that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelFont or mLabelFont.

§ getTickLabelColor()

QColor QCPPolarAxisRadial::getTickLabelColor ( ) const
protected

Returns the color that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelColor or mTickLabelColor.

§ getLabelColor()

QColor QCPPolarAxisRadial::getLabelColor ( ) const
protected

Returns the color that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelColor or mLabelColor.

The documentation for this class was generated from the following files:
  • src/polar/radialaxis.h
  • src/polar/radialaxis.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_enum.html0000644000175000017500000001454214030601037024571 0ustar rusconirusconi Data Fields - Enumerations
 

- a -

- b -

- c -

- e -

- f -

- g -

- i -

- l -

- n -

- p -

- r -

- s -

- t -

- u -

- w -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPGraph.png0000644000175000017500000001057014030601040022751 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_ÀPLTEÿÿÿ“““ÇÇÇÖÖÖKKKRRR333<<<½½½+++###´´´zzzééé ™™™ˆˆˆsssDDDôô÷\\\jjj©©©ccc¶¶ÿ‡‡ÿhhÿHHÿYYÿÎü òPH¢ØØÿ''ý7.éòÇÓÿÒÒœzzhVàÆÆÿ*#ìÓ®Õä¼ÔD9ç ùèèÿ!ñïø|gÞ88þ™™ÿ`Oà±’Ø‚ÚÁžÖtÛxxÿ¨¨ÿVGãs_Þ÷3óbKGDˆH pHYsÃÃÇo¨dßIDATxÚí] W¢LNdEËjH‹ÍRJVk·òýÿÿê«Ug`ÆxNÇs–cwoóÌsgîÎΰPÃûZ>P5^Y/ÂS~šá´¬Wà • ¹·^Qx‚Ö+p†J…Ü[¯(…BKFàS(¡ÏZB>ël6̉R™~•:›‘Õ²ýdå«¥p;F8Œ¡gpHÛ{Ÿÿ€R(nÿ-!3ÒŠB&Ð’ÿ©hÐSkòYÒDªÂºÏ¡¢!!27…<ë„›@Úî"htäY¯¢aôû ÐÐG ÇTHAµ;Hh»+šº³£Ra9ž¢ã`=‡…åi÷ŽÌdêFçxSfc÷ùÓQl Í´7hÆYÍ4´<½ü¨S uš rD!UœFʃvC´!ò¬Ý ÿ’iî>yD­†óSÃûZ¾©GÌ”%ŠÃÐOßÏO†ÈCY ÿVËð?u­OóoÌ÷ƒÕì¸DÓìE) lûãah¡Ç¶¦i¹TXÒ-èåãÛ™Lå0R«ó¿‘“AŽÀ© ;JÇw½£„éZ( ŒÈÃp‘¶#›ÿ>‹j˜9#ÍçºEµˆ Ñ3Ði'ò5~(¤Š² ›;QrP¯üoE¿ÄNZ…r@LGë#OÃ0Fþäv4DAÓõ*⺟ªh6Ùó)ì!Ïùªñä|geR<Q42oÅ[ˆf'­B,lÇÁ‡*?*¬(4Å€<³˜ÂÑ ø!«@Jh µ€ÏaXeûƒJ…ñˆRŸC‚ V”¾ëª2@ ÐGŸÕ®Ï¿ƒè*€šŽ 8é>Cúhg{¤N—1ã<¥iœcF¬ûQt;†€öQÕçPͳTT”¾ë¨õA0Z™‘Ê:r†Nƒ,Òƶˆ%#½”ç@ŠÀ²vŸ;ôÐ3t²úyÌBÝ¡x.äà ©"Ð1Ž˜³H}# þ< ƒqPÅá@Úû$†>Sp†…BG þ`•æƺäìªd!æÜ賋®Ÿœõ¼¢…|?Š6##9?ÍpZÖ±9šŒƒÍHÞT¡¤v‡ŽÌI¬”£¹Âv&ƒ^-’³¯‰š&’pnÃ0c=ÝV¨g‘ºÞŠh>G M#[D)7ÃiY Ú‘IqQ[‚à«ÝbÿHŽÓd IœH—«¯™’&JrÛH/r𬓂g¤0@­ŽkÏ^FGëV¯!µ 0Ò{PRËü4rÑÖQã`0Ò„)ÔF}Eék‚Ù òK %©—~¡eœévläZÃék«íKOj´­ošš?·UGJ¿fgbÃ0c=Ý–º÷y¬ñš´ÝC¡6 ¤7ò¥þZý«¿˜]QiXØÖ‰‚gë¡Y—ï~GÕrHzIèè²2°¬ÿTzû“Ö«DÉ—žÞÄ=Å ¹ÇyÖ žuNù¢ÆÁ m´$0ªg5å\yd–}4—ÑS¾…B3”šÐ×òüªYë+ƒÓÙ@ERÁ¢Úí|ÆÎêípžÁB¨cÁzêŠ>³ˆØôó ý{Xĺ»Í†ásFÚiHÁÄòØ“˜¦ÕøÌ3Ží §ƒ¢TØ”¤ÎÑyƨÃü1¹ì†á1¶•.IÃõ!0F£œ3£¬¾óg:¢LºÜ zbËð§GƒžÞU“‹î]Yfñ0Q¡BK!p]ë =AÒºzo ÊR«%É⨧[›}ÐÌ^ÃðH‡ !è@·µºO˜‚ÚÕ‡>›JK‘úQ¯f uS– XX;ä‹m¾i½ß§²­2\1ßCGPkía£ï³©€NMJ} ×EXÚ*´j³Æt×EMïùsWCúÔæ°ík3¦?‰~~ÒÈn®ïåØŠ7G÷䧻.€ž ·/ž© V­=jô6å0›mèiTdÃðHë²XìÞtm i©â˜õ¦Uë}³)6†@Ò-A¤˜ŸPÍîPkQ­á¸^ïÚ½°©÷€$)F èj¨»ñ£Bzžš ‰bñ„ ëþtGh¶´ÜRÄa÷›q~(¤\E2,ж¶—YÝ¡¨´ä®râú´ºƒTÔ8éɪ¡»YW°KnIrÝ¢œ™±H¿*jœPS|nÍÒ¿·fuý̃Í{g¨@UFê+hôj–ÆâläÛ¡ÞïŸÂ¬±.û3V¥´]6ö·ü™m §ZÇt µ”“\KïUTP Š<ŸØm9=(òìÍz,` ʇ" ݆ûÇYNH…g ¤ÐKß:{%»o6ƒS >IÌVG×;hEí”(<FÒHø¯ Œ–"tAÙ¾çƒ̹ Ý]eÌ4Ô®Ð(¸ÜJ¨;ÔÁHZhÞtR*ÄACk m ãÒé@Su¥¯!+6 62eë}?•ÕCvµ¡ZRO0ª·zšÅ—WëµýyȬ̹-t:Í¢NNÏzn[Ûªþî™ Z­êö'F¬G¡‹¡‰æ×ùN1\ʯIR·`¿*l‘Þ:0À×[°ëÝž(á/¨ñÜ“ù±žnK1A0”¦/=%XÖΰaŸf8-ë(@[Èm‹¥¥–ó‹ñåÕI,i%ƒÔ‰a ²8ÔŽ#çú9¿†öõµmß”~äºüƒÚé_lmi+W/¢Ô;'Sx{çürœ{8Pú?N)Ö5ÐßU|3øðè|bþge»S6p^ˆ;”‡ù:}m[ú~m?ŽùQa¡÷ÎÁĽuö(tÜ'n|/È:ãxrœ0žÝŸ˜¦€;N—ßÔ}©Ð¹ó¦œøNÇ:o^À9J¡3‡\ø^˜u¦ñ;QÜç²+œ©pF÷Tè8˾Ӳ΅køKá#\3ï{Ö† ïx¼üàY)W*\xû´ýÚÿ‡}ɸïô¬óDá¾&Rø‡ôŒ† yÂêÙI… 'àH…ˆÃ*t^ ×JùQ!GN‘ÊZ˜B癬 ù¡ÌöŠü¥´dÁ<øQ!*BT…ÎÑR)?*ä†ÂóˆQ ‰®þòC!7ˆˆ0 ²2伨pÿ:)*$;)åG…¼P¸Z:©:K‚%~(äOðOjuœ7ø+¥œ¨ðÊv0TèØW úNÛ:'Â7, C}/Þ:‹»a4|/ÛÕâÁ‡ ݸuÂ:/.s¾S·Î…kx‡Iáü`Ì÷2¬3ˆé-fuœÛŸ—Þó ÂI|;N…Î_RK¿ü¨ /—6…ÄÒ{~(äqE"Þ`Ùî T˜”QÄ«ÐqÉä,¨°ìƒ¸ÄŒ_ß8¿~áÿl®Ë?Ä[è)_öñ›Q$ãž—ír±`?&f ”в! ”OIŠ.¦PH&¯à‡Bæ‘QÁõ À¼ “3Š$:¿IJùQ!ë^@'3…‰sNüPÈ:¼Mæ8ê8 ¯l·‹ã*œíÎegPá#}Pü¨q „I¦D¡” Ù†‰œ„ÁÅ*”²­Â±}€§*$P(åG…lSèÞç¤ðø üPÈ4ÖË£;Û€Á>˜V¡wpÃÅ!¿ƒ²Láäð‰Âƒ}Ú YÆÁ³õi y¾‚m0¬B3åÅAWð£B†)<˜Q¤Rè¸cvæ§ÒƒE:Èmìfìª05£HQá‘y?*d—BoáE¡s{Ôz?2‹ókx˜ÿËó™Uaú9Š4·Š²JaÚEA8•ÞóC!-ÌÖã÷#Z㎒ts§×äãý}ÍE$¦ÑÖ+B׶!„ÞU>' …©*t^snGœ\y¾ï¶ü+â÷ `:Φ>¼}æ¿æ/ôò´Á cëa:…Ž—§Ê¶v¡÷2ÿ´~÷öኼ¤k>„õ3ß@/óy¼;JÒ‘ã“n éës¾nX¾ºÃl}1¾¿¯;ŽpîÁÅ~*ðÕ“oáô)›¡Kƒ f¾ïùi wëóEŽnn™õ»ß¾ÿW²ôãrºº¼¥· þÞeNo?_I×Èóe¶8#!…ï{^Ãçy¬õùmî×ì_z¡ö^~¥ð·—›·Ýþîmó á4ûÖór÷Jº(^`9µÊF¦ûžW0¹,ûø/³ß-õîÏ ž7o»žýø¶Xú³<‚¯·y¿‰ëï¯ N³U/ µ´×“_]ï ×Ö,ñ$Lff¹Zïɳÿ²þÇv³µüz ÝElûnnÈQx–Ô¯·Ðc÷º™Ón†¹{vq'v˜9!…ø%š|¸K±þ=ìÉ©9vámâx@r,LþÛïîmÌéôÓ Þb4˜âyza&p/š]ô²º³WXýz¶‚ö á‘CàÄðÍ^ÿI=}½6–ñ1Ä:rí‘=i}}óŸÞC¼7;ß\ÛTk7Kx}ÎÊë˜'~oº?¸n÷ÛM!Pãkø’ÞÓ±_ƒ†ù7Æ¿l Á&!­¿»îÁ8îî]¸J€ M탘¾HŒlÿÙ0Ëþ†ôhõHüe„ïéËV·™Îç¡Ø+3Í!ˆ§;¬½x)Î7нÊf|ÓÖ–Ø+DØ=ÙKËQâ^Ë}Ⱥyå¢%œ/ÚpŠ5à_#}ò}^nBSýÇ—šÞÄŸ¸Ï‡ã2~.ŽÝ “ÃwÝ-ÝIfë~Bí½„‚ÓßÍÒïјޗR#Õ{ûaóÛÇýíÒÍ»ñäÚ8œS¹Pt|hÎÜÆÏXÑq—·÷Aƒlì`U¦œµ©LÝác¼ò\Þêjïc›ž<6=gØï’Áu/9Ó|t=3¯us}õÝ ãl•¦›0ŒOݤ”÷6Ë:{×'0é¼÷+œm\ËðƒË„Áé…Ú†¥YB:ó;Sí–M”³wæ"VoÙv~fb{Íbç´µLɶ2?‡Ëy”Ál «Ù\¿ˆrø¸t“ÓA~(, OS´0¾ |»ý-+Üg^‰fåmB¼€ÞÞ¬æÑÆ^ÈÈëú¹kï%r¯öaÑó£Â÷‘š»úëÛæ ÀQ®›SøðMï^ì´ÿ KEPuí庫bŽÆ¬ \.m·ð:&M”½›{vñ>¾Ê·Y'ŸëçWã÷ Œ˜Í ˦°²^¡B¥Bî­Wž õ œ¡R!÷Ö+ OÐzÎP©{ë…'h½g¨TȽõŠÂ´^3T*äÞzEá Z¯À*ž õ ¬à½l±9Ò=•ˆ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/namespacemembers_enum.html0000644000175000017500000000357414030601037026073 0ustar rusconirusconi Namespace Members
 
  • AntialiasedElement : QCP
  • ExportPen : QCP
  • Interaction : QCP
  • MarginSide : QCP
  • PlottingHint : QCP
  • ResolutionUnit : QCP
  • SelectionRectMode : QCP
  • SelectionType : QCP
  • SignDomain : QCP
qcustomplot-2.1.0+dfsg1/documentation/html/selectiontype-none.png0000644000175000017500000000342214030601041025167 0ustar rusconirusconi‰PNG  IHDR´n|F$HgAMA† 1è–_!PLTEÿÿÿZZ[˜˜˜dddèèè©©©¸¸¸www×××ÇÇLJ‡‡‚Å‚ôbKGDˆH pHYsÃÃÇo¨dIDAThÞí™ÍS[7ÀÅ{ÏŸ'/28ád‡Ò³…íprÂd˜ää’f¦éÉ·¥ÃÉšz2uz4%ôè4m2í_Ù]=°­‡ä·¦É;ðÓ“~Z­¤Ý•,Ä•\É•|®P¸à§ðé”JD_¼ïOˆþÿ}_†Ö—‰¾¸\¦Ö—9¬ËÐú2Ñ3ŠW+Ï õ½ïf@ïÁþ}Õc¡SR Ø䜈Œ,q*êlt Zbd™£uàö,ZË@Õ«‰è»µÙÐ"´ ]ƒõ™ "È¢¨M¢Aîbÿ÷hbØâ•?üÙÜÙt¢ï7éo'EþØèÔöÙèÌk%ëbÝ­q^.ˆN©‡øÐz²Ç ¯ñê,‰Âpiýä÷ n–.ZeÈ@WøͶÈv·œh|½‡½GèUО$) !nøhÃTùÈ…†ªJ\¤ýºÉhb q@=äÛ~Ó¥urYãkwJ–­ÉÄC»øÍ|Û…îƒL“-–Z8+´ºÅ05Í_°\ÁQ{CxëmGµàù.ú0Ú†àä¤ö‚zŸÆ—î Yw­ëýc(F;üºÔ Ê@‹°êY©¯dQ­ž]TP:Ö;\W`íts€D¬¿7P¶ìè «â9ê–Ö^Yû¥<È÷øå©ÛÅn/¿§Zßà w²]\Kmþì:-Ý¢µVêK|×Ô_5z›ƒ^õ<,ñÀÂ&-¯¦­–×ÚƒU1FopÐâïMr#'4ýÈ.õ,µ2o­=ö› t—ÕóÉà>8Üêu•LÎVý„¥&y€›–jsq•“Ñéaçbo½`©v4þªµN3VŸ×ÂùkŒ|ºf©¶C?‘‰^$x884`yeõò[&:«ýå4É…J-æ•œ„•žÛj¾7Ñ)u¶\rB ¢¹ýl²¬`]Wû&ÚC­—ªíF‡ cï ùVöQ/^3¶GÉ‘¡³*ºÑ`CçVßÖÌEÒ)mMÌi-*µùpjjƒÄÐ*œT[/ö¶‰Î>˜‚h×ãÅek¢@oÑ¢‰ÖÉŽ;¬S“g?Ä”Gß1ŒÐSÝùYÇ:"6¬ä;Ðò™‹¬Ý¨½7bZYÆN}ˉ>±îé:æHK²Ö‹iìA÷ȉÎ(Ùµ ñH㵌¢¾¸?˜¬ %÷xšÓW/ÒCãqÇx*Œu—X#µÌš£y®B$©²]u¡cyNý|-1 &$g}£[I¿;UZl:^ä[N4š`Ü*fù±ÖL÷íbŸ`ÝrKGÊ3ÚtÅܵcéL9GùãMâ)³ý Ž ÷˜Õqé–s'ãÀ^ƒU7zÉ¢^€¤äDûË#'V1¿;F“Onœ' bAb%ØÍk—˜Ÿ´Iz¸ ?q ²ºb–´e«*)‡¦á×d×\K~/y¬xŠœ>×Ñà 3gବ]E÷Š ¡#T§o-žóÒ-Ó£íýó?úá·Ä¥'ôétC¦7ZÞžbŒ´‚ r—…Ætdî,O>œzT8´ôµ* I‡FßLÿ;xh?ÑžCW97L‚“Näo¿ 4ö_^apQnE^êv¹’‡š—Kâ ‹œVûÂ_Qò¥&O¤ËNyÕ‡kšný6Dv[§øÎ8jJV±îÀé®Çç¿ 4ë7ÊéX5ɾî¼/Ž}ïë›K–Ö–~í”8Œ´Nö}‘­‹:r1¹Bÿ:‘¼Hé~b‘’xÞõð™¼axU’tôà]jÏ*}JÁCÞUüŒâÓÍ}_ÿŠñ±%$÷›}÷×Ç'§wÎ,p¢è禵P\×1»<0Ó¾+¹˜üg®ùwñ>1%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssStar.png0000644000175000017500000000042614030601041022623 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+HIDAT(Ïc` >p!¤à*— ‰}®Û…á>vÿÁ± .û¿1|Ã.m•B†6¸MpÁm ÜXÀ}¨7qøk8’T.¨¯$ÄÙ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPErrorBars__inherit__graph.png0000644000175000017500000000372414030601041030044 0ustar rusconirusconi‰PNG  IHDRP³-aYrgAMA† 1è–_0PLTEööùÿÿÿÒÒÓhhhPPR˜˜˜………ççê000ÒÒã,¢¢¶ V``‘ARL¡tRNS±ü€[|bKGDÿ-Þ pHYsHHFÉk>¾IDATxÚíÜOhÛVð˜Ñ{ŸcyuBl<“[s›„Ñ›I\’1Fë9®{2Ô°A.¹÷R§§™%£+a;t‚ö˜Co£‡m Æ´„ÞsÉe0f6z^({¿'9QmKÖûKZŸJ%Šž>}Oï÷Húµ¦PB¶©¨ ª ,ÐÒMæíF$Ð*;ÔˆÊ~¾‚*hü ù«ÇÚÆ-”Áu„ñ¶gh¦ñØ@Õµ÷þµk¨V!;ÐsŠ åÖK¤{Ûº†+šµŽôôâf  E46êö¨©U²å¥=]#ËÐ5]{þéÓŸWcuîÑ ÆD—ÂX×Q^_ Ò³8Ðó¡§7¤¶¶Œe“OŒo\hE½˜Lt×Bæ&ºùA™|ÒxâýRôÐóòPŒ³ØBZ•È4"‡šº;™Œ@ÑÌïú*åw~¼V&­î{~¼ ›‚*¨‚&Š™·h {+>Û'?ûY‹ê»Ýÿ}RAhï(jg8h滉€lûu" yÛ>MôÀ¶Mô̶íÙväÓ> tÖ&Ûa €¾N4ÐÓ@¯ô·@Oõjn­ÏŸFÌTPUPUPUPUPUPUPUPUPUPUÐ$@C¤ïkl‰ü§ì9ùqmOq¥ïÇ%ò±d¨á@åŒá³/©mUÐMó9EøÝÛX0ThgøêIß_3ú­hÞëhxÓé·qÐ,i Uq Îëgú5·É>Tó^E{ๆukêMßO×FCsm&hu׬dŒ/Ëô<7 }¯> õ¦ï÷¯t! L:c'|Ÿ^ÔÉ.ÚGúU¼¡aˆ%ò ÷5£“f=2ýWpÒg¨‰S‚l?Ù«` ­ÔÝC% (UG@=éûåéD®é2龟~ÞïÑiÈbC‡%òý ”¦ñòó½õ¤ìô¨‰š° Ù~Ô„h¥VtÝêÂú"JLBìÖ÷ sÂ÷Åþ=ªÎSh`"Ú¿Gï’ÏI;rÊÝY² ƒî ø"|É=´†èEú>ÉðÄÕ¶Ó¾/ºw×940‘?8ôî=éB!ÙO¡4Û¯Sh¾Å9´h‡ù ½'}Ÿ-£%Öá Nø†>E/C¿Nþ&ò&S CŸ"v-gèi¶ )h…BÉ!2ôä…>1™<é{R%L˜(m\™ÁNø>uºK'²tKL䔧>”L¦þ®"–t?àyVè‰pÚÆž'+ÏÍ C =¾·I0BsdäE [óEåYQsfo_Ée¿<æ|s+4Œr=žq¶9»ˆ~øqÐ4Aøß8rö'Á¾š”n÷ÿât~Ë_Ú¸ ižB(p7”·g¸G‚ŠÎN9NÊu'}Ÿ£˜ŠT þG}qÓ¡÷ÅðBÙ»§ ¶¢q?<¹˜öZ"N§¼1Ná—‚ïƒä‡²EX;#‚²SX;£‚²SµS4|1Y;%@ÃS‘µS4l1-ˆ¬2 !‹©ØÚ)nLÅÖN9Ð0³Dpí” Sw¶ZœâJ[LÅK¨è¸b:'^Bå@ÇSáµS4¸øäe=n˜o³;VŒ æ³ŽÕiR…6±i5ªx•¼Ô$ýl5 ×#‡®vª ¤GÉÐ×VÍ…Nm¹A^éÐ?„½úÊGñÂ=J>ðƒôî*ú6†½Å¥8 =٧ȫAoƒù'4W`oÇŠ¾GO&†Þ™Luº·p»9ô¼<”Ü£ “É)OV  q˜LÎF2 ~bV&UP}w Iù)4|xÿbKEø¦ ï.”cRD²ýšƒ]„£MæI%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/sync_on.png0000644000175000017500000000072014030601042023012 0ustar rusconirusconi‰PNG  IHDRY ËgAMA† 1è–_*PLTE$<„#;‚#;‚#;‚#;‚0IŒ#;‚”¦Ìsˆ¹Rj¥¶ÂÝÿÿÿÌÕççëõ}ÖhatRNS.äþ¾ò1bKGD ×ÄÀ pHYsHHFÉk>»IDATÓc`!e#E(PN#Û) L@l–4(rÜ`œD Ç ÆIf``R©ž3¬HK›¤ÄÒÒ¢v¦¥E/MKKbPKË< âìæÌݽ«½¼z÷  f黡  ȉ‚q'•uïÞ³jÕéÝÛÓ@œÌÛ@fƒ ³È9 2hi*ÐÒYa K¡Î ;Å¡¨^`„q@^†° ! b'9@ƒGÉØX Dôd7X‘%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/thelayoutsystem.html0000644000175000017500000004506714030601036025025 0ustar rusconirusconi The Layout System
The Layout System

The layout system is responsible for positioning and scaling layout elements such as axis rects, legends, or color scales in a QCustomPlot.

Classes and mechanisms

The layout system is based on the abstract base class QCPLayoutElement. All objects that take part in the layout system derive from this class, either directly or indirectly.

Since QCPLayoutElement itself derives from QCPLayerable, a layout element may draw its own content. However, it is perfectly possible for a layout element to only serve as a structuring and/or positioning element, not drawing anything on its own.

Rects of a layout element

A layout element is a rectangular object described by two rects: the inner rect (QCPLayoutElement::rect) and the outer rect (QCPLayoutElement::setOuterRect). The inner rect is calculated automatically by applying the margin (QCPLayoutElement::setMargins) inward from the outer rect. The inner rect is meant for main content while the margin area may either be left blank or serve for displaying peripheral graphics. For example, QCPAxisRect positions the four main axes at the sides of the inner rect, so graphs end up inside it and the axis labels and tick labels are in the margin area.

Margins

Each layout element may provide a mechanism to automatically determine its margins. Internally, this is realized with the QCPLayoutElement::calculateAutoMargin function which takes a QCP::MarginSide and returns an integer value which represents the ideal margin for the specified side. The automatic margin will be used on the sides specified in QCPLayoutElement::setAutoMargins. By default, it is set to QCP::msAll meaning automatic margin calculation is enabled for all four sides. In this case, a minimum margin may be set with QCPLayoutElement::setMinimumMargins, to prevent the automatic margin mechanism from setting margins smaller than desired for a specific situation. If automatic margin calculation is unset for a specific side, the margin of that side can be controlled directy via QCPLayoutElement::setMargins.

If multiple layout ements are arranged next to or beneath each other, it may be desirable to align their inner rects on certain sides. Since they all might have different automatic margins, this usually isn't the case. The class QCPMarginGroup and QCPLayoutElement::setMarginGroup fix this by allowing to synchronize multiple margins. See the documentation there for details.

Layouts

As mentioned, a QCPLayoutElement may have an arbitrary number of child layout elements and in princple can have the only purpose to manage/arrange those child elements. This is what the subclass QCPLayout specializes on. It is a QCPLayoutElement itself but has no visual representation. It defines an interface to add, remove and manage child layout elements. QCPLayout isn't a usable layout though, it's an abstract base class that concrete layouts derive from, like QCPLayoutGrid which arranges its child elements in a grid and QCPLayoutInset which allows placing child elements freely inside its rect.

Since a QCPLayout is a layout element itself, it may be placed inside other layouts. This way, complex hierarchies may be created, offering very flexible arrangements.

Below is a sketch of the default QCPLayoutGrid accessible via QCustomPlot::plotLayout. It shows how two child layout elements are placed inside the grid layout next to each other in cells (0, 0) and (0, 1).

LayoutsystemSketch.png

The top level plot layout

Every QCustomPlot has one top level layout of type QCPLayoutGrid. It is accessible via QCustomPlot::plotLayout and contains (directly or indirectly via other sub-layouts) all layout elements in the QCustomPlot. By default, this top level grid layout contains a single cell which holds the main axis rect.

Examples

Adding a plot title is a typical and simple case to demonstrate basic workings of the layout system.

layoutsystem-addingplottitle.png
// first we create and prepare a text layout element:
QCPTextElement *title = new QCPTextElement(customPlot);
title->setText("Plot Title Example");
title->setFont(QFont("sans", 12, QFont::Bold));
// then we add it to the main plot layout:
customPlot->plotLayout()->insertRow(0); // insert an empty row above the axis rect
customPlot->plotLayout()->addElement(0, 0, title); // place the title in the empty cell we've just created



Adding custom elements to the legend is quite simple, since the QCPLegend is itself just a subclass of QCPLayoutGrid. So we can manipulate it just like the main plot layout as before:

layoutsystem-addinglegendtitle.png
// prepare legend and some graphs:
customPlot->legend->setVisible(true);
customPlot->addGraph()->setName("Torque");
customPlot->addGraph()->setName("Power");
customPlot->addGraph()->setName("Efficiency");
// create and prepare a text layout element:
QCPTextElement *legendTitle = new QCPTextElement(customPlot);
legendTitle->setLayer(customPlot->legend->layer()); // place text element on same layer as legend, or it ends up below legend
legendTitle->setText("Engine Status");
legendTitle->setFont(QFont("sans", 7, QFont::Bold));
// then we add it to the QCPLegend (which is a subclass of QCPLayoutGrid):
if (customPlot->legend->hasElement(0, 0)) // if top cell isn't empty, insert an empty row at top
customPlot->legend->insertRow(0);
customPlot->legend->addElement(0, 0, legendTitle); // place the text element into the empty cell



Moving the legend outside the axis rect can be achieved as follows:

layoutsystem-movinglegend.png
// prepare some graphs:
customPlot->legend->setVisible(true);
customPlot->addGraph()->setName("Torque");
customPlot->addGraph()->setName("Power");
customPlot->addGraph()->setName("Efficiency");
// now we move the legend from the inset layout of the axis rect into the main grid layout.
// We create a sub layout so we can generate a small gap between the plot layout cell border
// and the legend border:
QCPLayoutGrid *subLayout = new QCPLayoutGrid;
customPlot->plotLayout()->addElement(1, 0, subLayout);
subLayout->setMargins(QMargins(5, 0, 5, 5));
subLayout->addElement(0, 0, customPlot->legend);
// change the fill order of the legend, so it's filled left to right in columns:
customPlot->legend->setFillOrder(QCPLegend::foColumnsFirst);
// set legend's row stretch factor very small so it ends up with minimum height:
customPlot->plotLayout()->setRowStretchFactor(1, 0.001);



Arranging multiple axis rects actually is the central purpose of the layout system. A QCPMarginGroup can be used to align the axes across multiple axis rects (not shown here).

layoutsystem-multipleaxisrects.png
customPlot->plotLayout()->clear(); // let's start from scratch and remove the default axis rect
// add the first axis rect in second row (row index 1):
QCPAxisRect *bottomAxisRect = new QCPAxisRect(customPlot);
customPlot->plotLayout()->addElement(1, 0, bottomAxisRect);
// create a sub layout that we'll place in first row:
QCPLayoutGrid *subLayout = new QCPLayoutGrid;
customPlot->plotLayout()->addElement(0, 0, subLayout);
// add two axis rects in the sub layout next to each other:
QCPAxisRect *leftAxisRect = new QCPAxisRect(customPlot);
QCPAxisRect *rightAxisRect = new QCPAxisRect(customPlot);
subLayout->addElement(0, 0, leftAxisRect);
subLayout->addElement(0, 1, rightAxisRect);
subLayout->setColumnStretchFactor(0, 3); // left axis rect shall have 60% of width
subLayout->setColumnStretchFactor(1, 2); // right one only 40% (3:2 = 60:40)
// since we've created the axis rects and axes from scratch, we need to place them on
// according layers, if we don't want the grid to be drawn above the axes etc.
// place the axis on "axes" layer and grids on the "grid" layer, which is below "axes":
QList<QCPAxis*> allAxes;
allAxes << bottomAxisRect->axes() << leftAxisRect->axes() << rightAxisRect->axes();
foreach (QCPAxis *axis, allAxes)
{
axis->setLayer("axes");
axis->grid()->setLayer("grid");
}







qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_12.png0000644000175000017500000000131314030601042024466 0ustar rusconirusconi‰PNG  IHDRu#ÚÝgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>ýIDAThÞíY=RÂ@}8l*+¸‚ö¹€¥ÌØÀpršXÙ„Š8:ÃØÛXÁôÑÊfSq›gÁ²ì.2†&ä¥Ù|ÿo¿Íf '‚³² ¨©ÖTkª™Ð\>Ð)»–BÐÁ£鮾`^vU`Ž7=nšŠ¤ìÊöŽ¶1>¡gµ¦ZEUï¨öàÁƒ‡ž––ÄS׳Ҏ´$ÈAÜÍ™{Z¨0 `:B F”Œ(jIHÉ)[$IARòFEˆ(Øå;%#¥Ï±v'R°»Óv3ZF¨ ›%e;±ÔÚÁZ„ ­Ú_ð’‚‚Suç[ºÕDÓñêrãíj¬F±;fW]í‚’)‹´¥OI_¯ ŸÒ˜N;§ëÉéA¨.®'KkÎüÒ>t:[Q¥AÃ¥êz¦ÅÛÕl xÝžk=X<ãrÕ4ŸÐÈiz¦ÅÛN5Ã<Ä#$a‚¡’Œq3ëàeÚøB¢wdç®õ] ú¸Ø9ÁcÜ¥zÎR¥9w`²«IwƒÄõ\-«ÈÑ/ü|Ý{[²»jç´=}µhméö®6–¿-˜àwë¤\á?©}ü/¼ó£ÕGL3»ÛgÁeR†E÷ôˆ¨5Õ*¢¦ZEX/›¢?ŽËÀê$¦©>”]SA¸Õ£FýO\QS­"šx-»„CáùÃÙÂâ™J%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssPlusSquare.png0000644000175000017500000000047014030601041024015 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+jIDAT(Ͻб ƒ@„á/r•“Z¯òÜ9kÆÊ"EÖÃÎ@B¦ùga†å[]ªËZpµ€ÕóÈîàV9¼#{` ·'š³ §ìôµ|g{l˜I’ëo7ÐÃqöÉ?è\”Ër˜˜%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssDisc.png0000644000175000017500000000046014030601041022572 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+bIDAT(Ïcd`dÀ ˜HU ƒ.À‡º Çþ0üaøÃpœA.Š$ýê¢+8Ž¦à8Dœî‹ß®aEv$†Ó`bD›ÀÀpMúº7 ú9öa „2># " S3%&¸·%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxis.html0000644000175000017500000056300614030601040024031 0ustar rusconirusconi QCPAxis Class Reference
Public Types | Public Functions | Signals | Static Public Functions | Protected Functions
QCPAxis Class Reference

Manages a single axis inside a QCustomPlot. More...

Inheritance diagram for QCPAxis:
Inheritance graph

Public Types

enum  AxisType
 
enum  LabelSide
 
enum  ScaleType
 
enum  SelectablePart
 

Public Functions

 QCPAxis (QCPAxisRect *parent, AxisType type)
 
AxisType axisType () const
 
QCPAxisRect * axisRect () const
 
ScaleType scaleType () const
 
const QCPRange range () const
 
bool rangeReversed () const
 
QSharedPointer< QCPAxisTicker > ticker () const
 
bool ticks () const
 
bool tickLabels () const
 
int tickLabelPadding () const
 
QFont tickLabelFont () const
 
QColor tickLabelColor () const
 
double tickLabelRotation () const
 
LabelSide tickLabelSide () const
 
QString numberFormat () const
 
int numberPrecision () const
 
QVector< double > tickVector () const
 
QVector< QString > tickVectorLabels () const
 
int tickLengthIn () const
 
int tickLengthOut () const
 
bool subTicks () const
 
int subTickLengthIn () const
 
int subTickLengthOut () const
 
QPen basePen () const
 
QPen tickPen () const
 
QPen subTickPen () const
 
QFont labelFont () const
 
QColor labelColor () const
 
QString label () const
 
int labelPadding () const
 
int padding () const
 
int offset () const
 
SelectableParts selectedParts () const
 
SelectableParts selectableParts () const
 
QFont selectedTickLabelFont () const
 
QFont selectedLabelFont () const
 
QColor selectedTickLabelColor () const
 
QColor selectedLabelColor () const
 
QPen selectedBasePen () const
 
QPen selectedTickPen () const
 
QPen selectedSubTickPen () const
 
QCPLineEnding lowerEnding () const
 
QCPLineEnding upperEnding () const
 
QCPGrid * grid () const
 
Q_SLOT void setScaleType (QCPAxis::ScaleType type)
 
Q_SLOT void setRange (const QCPRange &range)
 
void setRange (double lower, double upper)
 
void setRange (double position, double size, Qt::AlignmentFlag alignment)
 
void setRangeLower (double lower)
 
void setRangeUpper (double upper)
 
void setRangeReversed (bool reversed)
 
void setTicker (QSharedPointer< QCPAxisTicker > ticker)
 
void setTicks (bool show)
 
void setTickLabels (bool show)
 
void setTickLabelPadding (int padding)
 
void setTickLabelFont (const QFont &font)
 
void setTickLabelColor (const QColor &color)
 
void setTickLabelRotation (double degrees)
 
void setTickLabelSide (LabelSide side)
 
void setNumberFormat (const QString &formatCode)
 
void setNumberPrecision (int precision)
 
void setTickLength (int inside, int outside=0)
 
void setTickLengthIn (int inside)
 
void setTickLengthOut (int outside)
 
void setSubTicks (bool show)
 
void setSubTickLength (int inside, int outside=0)
 
void setSubTickLengthIn (int inside)
 
void setSubTickLengthOut (int outside)
 
void setBasePen (const QPen &pen)
 
void setTickPen (const QPen &pen)
 
void setSubTickPen (const QPen &pen)
 
void setLabelFont (const QFont &font)
 
void setLabelColor (const QColor &color)
 
void setLabel (const QString &str)
 
void setLabelPadding (int padding)
 
void setPadding (int padding)
 
void setOffset (int offset)
 
void setSelectedTickLabelFont (const QFont &font)
 
void setSelectedLabelFont (const QFont &font)
 
void setSelectedTickLabelColor (const QColor &color)
 
void setSelectedLabelColor (const QColor &color)
 
void setSelectedBasePen (const QPen &pen)
 
void setSelectedTickPen (const QPen &pen)
 
void setSelectedSubTickPen (const QPen &pen)
 
Q_SLOT void setSelectableParts (const QCPAxis::SelectableParts &selectableParts)
 
Q_SLOT void setSelectedParts (const QCPAxis::SelectableParts &selectedParts)
 
void setLowerEnding (const QCPLineEnding &ending)
 
void setUpperEnding (const QCPLineEnding &ending)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
Qt::Orientation orientation () const
 
int pixelOrientation () const
 
void moveRange (double diff)
 
void scaleRange (double factor)
 
void scaleRange (double factor, double center)
 
void setScaleRatio (const QCPAxis *otherAxis, double ratio=1.0)
 
void rescale (bool onlyVisiblePlottables=false)
 
double pixelToCoord (double value) const
 
double coordToPixel (double value) const
 
SelectablePart getPartAt (const QPointF &pos) const
 
QList< QCPAbstractPlottable * > plottables () const
 
QList< QCPGraph * > graphs () const
 
QList< QCPAbstractItem * > items () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void rangeChanged (const QCPRange &newRange)
 
void rangeChanged (const QCPRange &newRange, const QCPRange &oldRange)
 
void scaleTypeChanged (QCPAxis::ScaleType scaleType)
 
void selectionChanged (const QCPAxis::SelectableParts &parts)
 
void selectableChanged (const QCPAxis::SelectableParts &parts)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Static Public Functions

static AxisType marginSideToAxisType (QCP::MarginSide side)
 
static Qt::Orientation orientation (AxisType type)
 
static AxisType opposite (AxisType type)
 

Protected Functions

virtual int calculateMargin ()
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual QCP::Interaction selectionCategory () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void wheelEvent (QWheelEvent *event)
 
void setupTickVectors ()
 
QPen getBasePen () const
 
QPen getTickPen () const
 
QPen getSubTickPen () const
 
QFont getTickLabelFont () const
 
QFont getLabelFont () const
 
QColor getTickLabelColor () const
 
QColor getLabelColor () const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QRect clipRect () const
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

Manages a single axis inside a QCustomPlot.

Usually doesn't need to be instantiated externally. Access QCustomPlot's default four axes via QCustomPlot::xAxis (bottom), QCustomPlot::yAxis (left), QCustomPlot::xAxis2 (top) and QCustomPlot::yAxis2 (right).

Axes are always part of an axis rect, see QCPAxisRect.

AxisNamesOverview.png
Naming convention of axis parts


AxisRectSpacingOverview.png
Overview of the spacings and paddings that define the geometry of an axis. The dashed gray line on the left represents the QCustomPlot widget border.

Each axis holds an instance of QCPAxisTicker which is used to generate the tick coordinates and tick labels. You can access the currently installed ticker or set a new one (possibly one of the specialized subclasses, or your own subclass) via setTicker. For details, see the documentation of QCPAxisTicker.

Member Enumeration Documentation

§ AxisType

enum QCPAxis::AxisType

Defines at which side of the axis rect the axis will appear. This also affects how the tick marks are drawn, on which side the labels are placed etc.

Enumerator
atLeft 

0x01 Axis is vertical and on the left side of the axis rect

atRight 

0x02 Axis is vertical and on the right side of the axis rect

atTop 

0x04 Axis is horizontal and on the top side of the axis rect

atBottom 

0x08 Axis is horizontal and on the bottom side of the axis rect

§ LabelSide

enum QCPAxis::LabelSide

Defines on which side of the axis the tick labels (numbers) shall appear.

See also
setTickLabelSide
Enumerator
lsInside 

Tick labels will be displayed inside the axis rect and clipped to the inner axis rect.

lsOutside 

Tick labels will be displayed outside the axis rect.

§ ScaleType

enum QCPAxis::ScaleType

Defines the scale of an axis.

See also
setScaleType
Enumerator
stLinear 

Linear scaling.

stLogarithmic 

Logarithmic scaling with correspondingly transformed axis coordinates (possibly also setTicker to a QCPAxisTickerLog instance).

§ SelectablePart

enum QCPAxis::SelectablePart

Defines the selectable parts of an axis.

See also
setSelectableParts, setSelectedParts
Enumerator
spNone 

None of the selectable parts.

spAxis 

The axis backbone and tick marks.

spTickLabels 

Tick labels (numbers) of this axis (as a whole, not individually)

spAxisLabel 

The axis label.

Constructor & Destructor Documentation

§ QCPAxis()

QCPAxis::QCPAxis ( QCPAxisRect *  parent,
AxisType  type 
)
explicit

Constructs an Axis instance of Type type for the axis rect parent.

Usually it isn't necessary to instantiate axes directly, because you can let QCustomPlot create them for you with QCPAxisRect::addAxis. If you want to use own QCPAxis-subclasses however, create them manually and then inject them also via QCPAxisRect::addAxis.

Member Function Documentation

§ ticker()

QSharedPointer< QCPAxisTicker > QCPAxis::ticker ( ) const
inline

Returns a modifiable shared pointer to the currently installed axis ticker. The axis ticker is responsible for generating the tick positions and tick labels of this axis. You can access the QCPAxisTicker with this method and modify basic properties such as the approximate tick count (QCPAxisTicker::setTickCount).

You can gain more control over the axis ticks by setting a different QCPAxisTicker subclass, see the documentation there. A new axis ticker can be set with setTicker.

Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes.

See also
setTicker

§ grid()

QCPGrid * QCPAxis::grid ( ) const
inline

Returns the QCPGrid instance belonging to this axis. Access it to set details about the way the grid is displayed.

§ setScaleType()

void QCPAxis::setScaleType ( QCPAxis::ScaleType  type)

Sets whether the axis uses a linear scale or a logarithmic scale.

Note that this method controls the coordinate transformation. For logarithmic scales, you will likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting the axis ticker to an instance of QCPAxisTickerLog :

customPlot->xAxis->setScaleType(QCPAxis::stLogarithmic);
customPlot->xAxis->setTicker(QSharedPointer<QCPAxisTickerLog>(new QCPAxisTickerLog));

See the documentation of QCPAxisTickerLog about the details of logarithmic axis tick creation.

setNumberPrecision

§ setRange() [1/3]

void QCPAxis::setRange ( const QCPRange &  range)

Sets the range of the axis.

This slot may be connected with the rangeChanged signal of another axis so this axis is always synchronized with the other axis range, when it changes.

To invert the direction of an axis, use setRangeReversed.

§ setRange() [2/3]

void QCPAxis::setRange ( double  lower,
double  upper 
)

This is an overloaded function.

Sets the lower and upper bound of the axis range.

To invert the direction of an axis, use setRangeReversed.

There is also a slot to set a range, see setRange(const QCPRange &range).

§ setRange() [3/3]

void QCPAxis::setRange ( double  position,
double  size,
Qt::AlignmentFlag  alignment 
)

This is an overloaded function.

Sets the range of the axis.

The position coordinate indicates together with the alignment parameter, where the new range will be positioned. size defines the size of the new axis range. alignment may be Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, or center of the range to be aligned with position. Any other values of alignment will default to Qt::AlignCenter.

§ setRangeLower()

void QCPAxis::setRangeLower ( double  lower)

Sets the lower bound of the axis range. The upper bound is not changed.

See also
setRange

§ setRangeUpper()

void QCPAxis::setRangeUpper ( double  upper)

Sets the upper bound of the axis range. The lower bound is not changed.

See also
setRange

§ setRangeReversed()

void QCPAxis::setRangeReversed ( bool  reversed)

Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When reversed is set to true, the direction of increasing values is inverted.

Note that the range and data interface stays the same for reversed axes, e.g. the lower part of the setRange interface will still reference the mathematically smaller number than the upper part.

§ setTicker()

void QCPAxis::setTicker ( QSharedPointer< QCPAxisTicker >  ticker)

The axis ticker is responsible for generating the tick positions and tick labels. See the documentation of QCPAxisTicker for details on how to work with axis tickers.

You can change the tick positioning/labeling behaviour of this axis by setting a different QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis ticker, access it via ticker.

Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes.

See also
ticker

§ setTicks()

void QCPAxis::setTicks ( bool  show)

Sets whether tick marks are displayed.

Note that setting show to false does not imply that tick labels are invisible, too. To achieve that, see setTickLabels.

See also
setSubTicks

§ setTickLabels()

void QCPAxis::setTickLabels ( bool  show)

Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks.

§ setTickLabelPadding()

void QCPAxis::setTickLabelPadding ( int  padding)

Sets the distance between the axis base line (including any outward ticks) and the tick labels.

See also
setLabelPadding, setPadding

§ setTickLabelFont()

void QCPAxis::setTickLabelFont ( const QFont &  font)

Sets the font of the tick labels.

See also
setTickLabels, setTickLabelColor

§ setTickLabelColor()

void QCPAxis::setTickLabelColor ( const QColor &  color)

Sets the color of the tick labels.

See also
setTickLabels, setTickLabelFont

§ setTickLabelRotation()

void QCPAxis::setTickLabelRotation ( double  degrees)

Sets the rotation of the tick labels. If degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by degrees clockwise. The specified angle is bound to values from -90 to 90 degrees.

If degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For other angles, the label is drawn with an offset such that it seems to point toward or away from the tick mark.

§ setTickLabelSide()

void QCPAxis::setTickLabelSide ( LabelSide  side)

Sets whether the tick labels (numbers) shall appear inside or outside the axis rect.

The usual and default setting is lsOutside. Very compact plots sometimes require tick labels to be inside the axis rect, to save space. If side is set to lsInside, the tick labels appear on the inside are additionally clipped to the axis rect.

§ setNumberFormat()

void QCPAxis::setNumberFormat ( const QString &  formatCode)

Sets the number format for the numbers in tick labels. This formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class.

formatCode is a string of one, two or three characters.

The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter. For the 'e', 'E', and 'f' formats, the precision set by setNumberPrecision represents the number of digits after the decimal point. For the 'g' and 'G' formats, the precision represents the maximum number of significant digits, trailing zeroes are omitted.

The second and third characters are optional and specific to QCustomPlot:
If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which is ugly in a plot. So when the second char of formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot.

Examples for formatCode:

  • g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used
  • gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign
  • ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign
  • fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'.
  • hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed.

§ setNumberPrecision()

void QCPAxis::setNumberPrecision ( int  precision)

Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Formats starting with 'e', see setNumberFormat

§ setTickLength()

void QCPAxis::setTickLength ( int  inside,
int  outside = 0 
)

Sets the length of the ticks in pixels. inside is the length the ticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setSubTickLength, setTickLengthIn, setTickLengthOut

§ setTickLengthIn()

void QCPAxis::setTickLengthIn ( int  inside)

Sets the length of the inward ticks in pixels. inside is the length the ticks will reach inside the plot.

See also
setTickLengthOut, setTickLength, setSubTickLength

§ setTickLengthOut()

void QCPAxis::setTickLengthOut ( int  outside)

Sets the length of the outward ticks in pixels. outside is the length the ticks will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setTickLengthIn, setTickLength, setSubTickLength

§ setSubTicks()

void QCPAxis::setSubTicks ( bool  show)

Sets whether sub tick marks are displayed.

Sub ticks are only potentially visible if (major) ticks are also visible (see setTicks)

See also
setTicks

§ setSubTickLength()

void QCPAxis::setSubTickLength ( int  inside,
int  outside = 0 
)

Sets the length of the subticks in pixels. inside is the length the subticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setTickLength, setSubTickLengthIn, setSubTickLengthOut

§ setSubTickLengthIn()

void QCPAxis::setSubTickLengthIn ( int  inside)

Sets the length of the inward subticks in pixels. inside is the length the subticks will reach inside the plot.

See also
setSubTickLengthOut, setSubTickLength, setTickLength

§ setSubTickLengthOut()

void QCPAxis::setSubTickLengthOut ( int  outside)

Sets the length of the outward subticks in pixels. outside is the length the subticks will reach outside the plot. If outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setSubTickLengthIn, setSubTickLength, setTickLength

§ setBasePen()

void QCPAxis::setBasePen ( const QPen &  pen)

Sets the pen, the axis base line is drawn with.

See also
setTickPen, setSubTickPen

§ setTickPen()

void QCPAxis::setTickPen ( const QPen &  pen)

Sets the pen, tick marks will be drawn with.

See also
setTickLength, setBasePen

§ setSubTickPen()

void QCPAxis::setSubTickPen ( const QPen &  pen)

Sets the pen, subtick marks will be drawn with.

See also
setSubTickCount, setSubTickLength, setBasePen

§ setLabelFont()

void QCPAxis::setLabelFont ( const QFont &  font)

Sets the font of the axis label.

See also
setLabelColor

§ setLabelColor()

void QCPAxis::setLabelColor ( const QColor &  color)

Sets the color of the axis label.

See also
setLabelFont

§ setLabel()

void QCPAxis::setLabel ( const QString &  str)

Sets the text of the axis label that will be shown below/above or next to the axis, depending on its orientation. To disable axis labels, pass an empty string as str.

§ setLabelPadding()

void QCPAxis::setLabelPadding ( int  padding)

Sets the distance between the tick labels and the axis label.

See also
setTickLabelPadding, setPadding

§ setPadding()

void QCPAxis::setPadding ( int  padding)

Sets the padding of the axis.

When QCPAxisRect::setAutoMargins is enabled, the padding is the additional outer most space, that is left blank.

The axis padding has no meaning if QCPAxisRect::setAutoMargins is disabled.

See also
setLabelPadding, setTickLabelPadding

§ setOffset()

void QCPAxis::setOffset ( int  offset)

Sets the offset the axis has to its axis rect side.

If an axis rect side has multiple axes and automatic margin calculation is enabled for that side, only the offset of the inner most axis has meaning (even if it is set to be invisible). The offset of the other, outer axes is controlled automatically, to place them at appropriate positions.

§ setSelectedTickLabelFont()

void QCPAxis::setSelectedTickLabelFont ( const QFont &  font)

Sets the font that is used for tick labels when they are selected.

See also
setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedLabelFont()

void QCPAxis::setSelectedLabelFont ( const QFont &  font)

Sets the font that is used for the axis label when it is selected.

See also
setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedTickLabelColor()

void QCPAxis::setSelectedTickLabelColor ( const QColor &  color)

Sets the color that is used for tick labels when they are selected.

See also
setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedLabelColor()

void QCPAxis::setSelectedLabelColor ( const QColor &  color)

Sets the color that is used for the axis label when it is selected.

See also
setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedBasePen()

void QCPAxis::setSelectedBasePen ( const QPen &  pen)

Sets the pen that is used to draw the axis base line when selected.

See also
setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedTickPen()

void QCPAxis::setSelectedTickPen ( const QPen &  pen)

Sets the pen that is used to draw the (major) ticks when selected.

See also
setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedSubTickPen()

void QCPAxis::setSelectedSubTickPen ( const QPen &  pen)

Sets the pen that is used to draw the subticks when selected.

See also
setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectableParts()

void QCPAxis::setSelectableParts ( const QCPAxis::SelectableParts &  selectableParts)

Sets whether the user can (de-)select the parts in selectable by clicking on the QCustomPlot surface. (When QCustomPlot::setInteractions contains iSelectAxes.)

However, even when selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling setSelectedParts directly.

See also
SelectablePart, setSelectedParts

§ setSelectedParts()

void QCPAxis::setSelectedParts ( const QCPAxis::SelectableParts &  selectedParts)

Sets the selected state of the respective axis parts described by SelectablePart. When a part is selected, it uses a different pen/font.

The entire selection mechanism for axes is handled automatically when QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you wish to change the selection state manually.

This function can change the selection state of a part, independent of the setSelectableParts setting.

emits the selectionChanged signal when selected is different from the previous selection state.

See also
SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor

§ setLowerEnding()

void QCPAxis::setLowerEnding ( const QCPLineEnding &  ending)

Sets the style for the lower axis ending. See the documentation of QCPLineEnding for available styles.

For horizontal axes, this method refers to the left ending, for vertical axes the bottom ending. Note that this meaning does not change when the axis range is reversed with setRangeReversed.

See also
setUpperEnding

§ setUpperEnding()

void QCPAxis::setUpperEnding ( const QCPLineEnding &  ending)

Sets the style for the upper axis ending. See the documentation of QCPLineEnding for available styles.

For horizontal axes, this method refers to the right ending, for vertical axes the top ending. Note that this meaning does not change when the axis range is reversed with setRangeReversed.

See also
setLowerEnding

§ selectTest()

double QCPAxis::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Reimplemented from QCPLayerable.

§ orientation() [1/2]

Qt::Orientation QCPAxis::orientation ( ) const
inline

Returns the orientation of this axis. The axis orientation (horizontal or vertical) is deduced from the axis type (left, top, right or bottom).

See also
orientation(AxisType type), pixelOrientation

§ pixelOrientation()

int QCPAxis::pixelOrientation ( ) const
inline

Returns which direction points towards higher coordinate values/keys, in pixel space.

This method returns either 1 or -1. If it returns 1, then going in the positive direction along the orientation of the axis in pixels corresponds to going from lower to higher axis coordinates. On the other hand, if this method returns -1, going to smaller pixel values corresponds to going from lower to higher axis coordinates.

For example, this is useful to easily shift axis coordinates by a certain amount given in pixels, without having to care about reversed or vertically aligned axes:

double newKey = keyAxis->pixelToCoord(keyAxis->coordToPixel(oldKey)+10*keyAxis->pixelOrientation());

newKey will then contain a key that is ten pixels towards higher keys, starting from oldKey.

§ moveRange()

void QCPAxis::moveRange ( double  diff)

If the scale type (setScaleType) is stLinear, diff is added to the lower and upper bounds of the range. The range is simply moved by diff.

If the scale type is stLogarithmic, the range bounds are multiplied by diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff).

§ scaleRange() [1/2]

void QCPAxis::scaleRange ( double  factor)

Scales the range of this axis by factor around the center of the current axis range. For example, if factor is 2.0, then the axis range will double its size, and the point at the axis range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around the center will have moved symmetrically closer).

If you wish to scale around a different coordinate than the current axis range center, use the overload scaleRange(double factor, double center).

§ scaleRange() [2/2]

void QCPAxis::scaleRange ( double  factor,
double  center 
)

This is an overloaded function.

Scales the range of this axis by factor around the coordinate center. For example, if factor is 2.0, center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0).

See also
scaleRange(double factor)

§ setScaleRatio()

void QCPAxis::setScaleRatio ( const QCPAxis *  otherAxis,
double  ratio = 1.0 
)

Scales the range of this axis to have a certain scale ratio to otherAxis. The scaling will be done around the center of the current axis range.

For example, if ratio is 1, this axis is the yAxis and otherAxis is xAxis, graphs plotted with those axes will appear in a 1:1 aspect ratio, independent of the aspect ratio the axis rect has.

This is an operation that changes the range of this axis once, it doesn't fix the scale ratio indefinitely. Note that calling this function in the constructor of the QCustomPlot's parent won't have the desired effect, since the widget dimensions aren't defined yet, and a resizeEvent will follow.

§ rescale()

void QCPAxis::rescale ( bool  onlyVisiblePlottables = false)

Changes the axis range such that all plottables associated with this axis are fully visible in that dimension.

See also
QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes

§ pixelToCoord()

double QCPAxis::pixelToCoord ( double  value) const

Transforms value, in pixel coordinates of the QCustomPlot widget, to axis coordinates.

§ coordToPixel()

double QCPAxis::coordToPixel ( double  value) const

Transforms value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget.

§ getPartAt()

QCPAxis::SelectablePart QCPAxis::getPartAt ( const QPointF &  pos) const

Returns the part of the axis that is hit by pos (in pixels). The return value of this function is independent of the user-selectable parts defined with setSelectableParts. Further, this function does not change the current selection state of the axis.

If the axis is not visible (setVisible), this function always returns spNone.

See also
setSelectedParts, setSelectableParts, QCustomPlot::setInteractions

§ plottables()

QList< QCPAbstractPlottable * > QCPAxis::plottables ( ) const

Returns a list of all the plottables that have this axis as key or value axis.

If you are only interested in plottables of type QCPGraph, see graphs.

See also
graphs, items

§ graphs()

QList< QCPGraph * > QCPAxis::graphs ( ) const

Returns a list of all the graphs that have this axis as key or value axis.

See also
plottables, items

§ items()

QList< QCPAbstractItem * > QCPAxis::items ( ) const

Returns a list of all the items that are associated with this axis. An item is considered associated with an axis if at least one of its positions uses the axis as key or value axis.

See also
plottables, graphs

§ marginSideToAxisType()

QCPAxis::AxisType QCPAxis::marginSideToAxisType ( QCP::MarginSide  side)
static

Transforms a margin side to the logically corresponding axis type. (QCP::msLeft to QCPAxis::atLeft, QCP::msRight to QCPAxis::atRight, etc.)

§ orientation() [2/2]

static Qt::Orientation QCPAxis::orientation ( AxisType  type)
inlinestatic

Returns the orientation of the specified axis type

See also
orientation(), pixelOrientation

§ opposite()

QCPAxis::AxisType QCPAxis::opposite ( QCPAxis::AxisType  type)
static

Returns the axis type that describes the opposite axis of an axis with the specified type.

§ rangeChanged [1/2]

void QCPAxis::rangeChanged ( const QCPRange &  newRange)
signal

This signal is emitted when the range of this axis has changed. You can connect it to the setRange slot of another axis to communicate the new range to the other axis, in order for it to be synchronized.

You may also manipulate/correct the range with setRange in a slot connected to this signal. This is useful if for example a maximum range span shall not be exceeded, or if the lower/upper range shouldn't go beyond certain values (see QCPRange::bounded). For example, the following slot would limit the x axis to ranges between 0 and 10:

customPlot->xAxis->setRange(newRange.bounded(0, 10))

§ rangeChanged [2/2]

void QCPAxis::rangeChanged ( const QCPRange &  newRange,
const QCPRange &  oldRange 
)
signal

This is an overloaded function.

Additionally to the new range, this signal also provides the previous range held by the axis as oldRange.

§ scaleTypeChanged

void QCPAxis::scaleTypeChanged ( QCPAxis::ScaleType  scaleType)
signal

This signal is emitted when the scale type changes, by calls to setScaleType

§ selectionChanged

void QCPAxis::selectionChanged ( const QCPAxis::SelectableParts &  parts)
signal

This signal is emitted when the selection state of this axis has changed, either by user interaction or by a direct call to setSelectedParts.

§ selectableChanged

void QCPAxis::selectableChanged ( const QCPAxis::SelectableParts &  parts)
signal

This signal is emitted when the selectability changes, by calls to setSelectableParts

§ calculateMargin()

int QCPAxis::calculateMargin ( )
protectedvirtual

Returns the appropriate outward margin for this axis. It is needed if QCPAxisRect::setAutoMargins is set to true on the parent axis rect. An axis with axis type atLeft will return an appropriate left margin, atBottom will return an appropriate bottom margin and so forth. For the calculation, this function goes through similar steps as draw, so changing one function likely requires the modification of the other one as well.

The margin consists of the outward tick length, tick label padding, tick label size, label padding, label size, and padding.

The margin is cached internally, so repeated calls while leaving the axis range, fonts, etc. unchanged are very fast.

§ applyDefaultAntialiasingHint()

void QCPAxis::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing axis lines.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

For general information about this virtual method, see the base class implementation.

See also
setAntialiased

Implements QCPLayerable.

§ draw()

void QCPAxis::draw ( QCPPainter *  painter)
protectedvirtual

Draws the axis with the specified painter, using the internal QCPAxisPainterPrivate instance.

For general information about this virtual method, see the base class implementation.

Implements QCPLayerable.

§ selectionCategory()

QCP::Interaction QCPAxis::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ selectEvent()

void QCPAxis::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPAxis::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ mousePressEvent()

void QCPAxis::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis.

For the axis to accept this event and perform the single axis drag, the parent QCPAxisRect must be configured accordingly, i.e. it must allow range dragging in the orientation of this axis (QCPAxisRect::setRangeDrag) and this axis must be a draggable axis (QCPAxisRect::setRangeDragAxes)

For general information about this virtual method, see the base class implementation.

Note
The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::mousePressEvent.

Reimplemented from QCPLayerable.

§ mouseMoveEvent()

void QCPAxis::mouseMoveEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis.

For general information about this virtual method, see the base class implementation.

Note
The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::mousePressEvent.
See also
QCPAxis::mousePressEvent

Reimplemented from QCPLayerable.

§ mouseReleaseEvent()

void QCPAxis::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user drag individual axes exclusively, by startig the drag on top of the axis.

For general information about this virtual method, see the base class implementation.

Note
The dragging of possibly multiple axes at once by starting the drag anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::mousePressEvent.
See also
QCPAxis::mousePressEvent

Reimplemented from QCPLayerable.

§ wheelEvent()

void QCPAxis::wheelEvent ( QWheelEvent *  event)
protectedvirtual

This mouse event reimplementation provides the functionality to let the user zoom individual axes exclusively, by performing the wheel event on top of the axis.

For the axis to accept this event and perform the single axis zoom, the parent QCPAxisRect must be configured accordingly, i.e. it must allow range zooming in the orientation of this axis (QCPAxisRect::setRangeZoom) and this axis must be a zoomable axis (QCPAxisRect::setRangeZoomAxes)

For general information about this virtual method, see the base class implementation.

Note
The zooming of possibly multiple axes at once by performing the wheel event anywhere in the axis rect is handled by the axis rect's mouse event, e.g. QCPAxisRect::wheelEvent.

Reimplemented from QCPLayerable.

§ setupTickVectors()

void QCPAxis::setupTickVectors ( )
protected

Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling QCPAxisTicker::generate on the currently installed ticker.

If a change in the label text/count is detected, the cached axis margin is invalidated to make sure the next margin calculation recalculates the label sizes and returns an up-to-date value.

§ getBasePen()

QPen QCPAxis::getBasePen ( ) const
protected

Returns the pen that is used to draw the axis base line. Depending on the selection state, this is either mSelectedBasePen or mBasePen.

§ getTickPen()

QPen QCPAxis::getTickPen ( ) const
protected

Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this is either mSelectedTickPen or mTickPen.

§ getSubTickPen()

QPen QCPAxis::getSubTickPen ( ) const
protected

Returns the pen that is used to draw the subticks. Depending on the selection state, this is either mSelectedSubTickPen or mSubTickPen.

§ getTickLabelFont()

QFont QCPAxis::getTickLabelFont ( ) const
protected

Returns the font that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelFont or mTickLabelFont.

§ getLabelFont()

QFont QCPAxis::getLabelFont ( ) const
protected

Returns the font that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelFont or mLabelFont.

§ getTickLabelColor()

QColor QCPAxis::getTickLabelColor ( ) const
protected

Returns the color that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelColor or mTickLabelColor.

§ getLabelColor()

QColor QCPAxis::getLabelColor ( ) const
protected

Returns the color that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelColor or mLabelColor.

The documentation for this class was generated from the following files:
  • src/axis/axis.h
  • src/axis/axis.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPBarsGroup.html0000644000175000017500000011075514030601036025035 0ustar rusconirusconi QCPBarsGroup Class Reference
Public Types | Public Functions | Protected Functions
QCPBarsGroup Class Reference

Groups multiple QCPBars together so they appear side by side. More...

Inherits QObject.

Public Types

enum  SpacingType
 

Public Functions

 QCPBarsGroup (QCustomPlot *parentPlot)
 
SpacingType spacingType () const
 
double spacing () const
 
void setSpacingType (SpacingType spacingType)
 
void setSpacing (double spacing)
 
QList< QCPBars * > bars () const
 
QCPBars * bars (int index) const
 
int size () const
 
bool isEmpty () const
 
void clear ()
 
bool contains (QCPBars *bars) const
 
void append (QCPBars *bars)
 
void insert (int i, QCPBars *bars)
 
void remove (QCPBars *bars)
 

Protected Functions

void registerBars (QCPBars *bars)
 
void unregisterBars (QCPBars *bars)
 
double keyPixelOffset (const QCPBars *bars, double keyCoord)
 
double getPixelSpacing (const QCPBars *bars, double keyCoord)
 

Detailed Description

Groups multiple QCPBars together so they appear side by side.

QCPBarsGroup.png

When showing multiple QCPBars in one plot which have bars at identical keys, it may be desirable to have them appearing next to each other at each key. This is what adding the respective QCPBars plottables to a QCPBarsGroup achieves. (An alternative approach is to stack them on top of each other, see QCPBars::moveAbove.)

Usage

To add a QCPBars plottable to the group, create a new group and then add the respective bars intances:

QCPBarsGroup *group = new QCPBarsGroup(customPlot);
group->append(bars1);
group->append(bars2);

Alternatively to appending to the group like shown above, you can also set the group on the QCPBars plottable via QCPBars::setBarsGroup.

The spacing between the bars can be configured via setSpacingType and setSpacing. The bars in this group appear in the plot in the order they were appended. To insert a bars plottable at a certain index position, or to reposition a bars plottable which is already in the group, use insert.

To remove specific bars from the group, use either remove or call QCPBars::setBarsGroup(0) on the respective bars plottable.

To clear the entire group, call clear, or simply delete the group.

Example

The image above is generated with the following code:

QVector<double> datax = QVector<double>() << 1 << 2 << 3 << 4;
QVector<double> datay1 = QVector<double>() << 0.6 << 0.5 << 0.3 << 0.15;
QVector<double> datay2 = QVector<double>() << 0.3 << 0.28 << 0.2 << 0.1;
QVector<double> datay3 = QVector<double>() << 0.33 << 0.31 << 0.27 << 0.13;
QCPBarsGroup *group1 = new QCPBarsGroup(customPlot);
QCPBars *bars = new QCPBars(customPlot->xAxis, customPlot->yAxis);
bars->setData(datax, datay1);
bars->setBrush(QColor(0, 0, 255, 50));
bars->setPen(QColor(0, 0, 255));
bars->setWidth(0.15);
bars->setBarsGroup(group1);
bars = new QCPBars(customPlot->xAxis, customPlot->yAxis);
bars->setData(datax, datay2);
bars->setBrush(QColor(180, 00, 120, 50));
bars->setPen(QColor(180, 00, 120));
bars->setWidth(0.15);
bars->setBarsGroup(group1);
bars = new QCPBars(customPlot->xAxis, customPlot->yAxis);
bars->setData(datax, datay3);
bars->setBrush(QColor(255, 154, 0, 50));
bars->setPen(QColor(255, 154, 0));
bars->setWidth(0.15);
bars->setBarsGroup(group1);
customPlot->xAxis->setRange(0.1, 4.9);
customPlot->yAxis->setRange(0, 0.7);

Member Enumeration Documentation

§ SpacingType

enum QCPBarsGroup::SpacingType

Defines the ways the spacing between bars in the group can be specified. Thus it defines what the number passed to setSpacing actually means.

See also
setSpacingType, setSpacing
Enumerator
stAbsolute 

Bar spacing is in absolute pixels.

stAxisRectRatio 

Bar spacing is given by a fraction of the axis rect size.

stPlotCoords 

Bar spacing is in key coordinates and thus scales with the key axis range.

Constructor & Destructor Documentation

§ QCPBarsGroup()

QCPBarsGroup::QCPBarsGroup ( QCustomPlot *  parentPlot)
explicit

Constructs a new bars group for the specified QCustomPlot instance.

Member Function Documentation

§ setSpacingType()

void QCPBarsGroup::setSpacingType ( SpacingType  spacingType)

Sets how the spacing between adjacent bars is interpreted. See SpacingType.

The actual spacing can then be specified with setSpacing.

See also
setSpacing

§ setSpacing()

void QCPBarsGroup::setSpacing ( double  spacing)

Sets the spacing between adjacent bars. What the number passed as spacing actually means, is defined by the current SpacingType, which can be set with setSpacingType.

See also
setSpacingType

§ bars() [1/2]

QList< QCPBars * > QCPBarsGroup::bars ( ) const
inline

Returns all bars currently in this group.

See also
bars(int index)

§ bars() [2/2]

QCPBars * QCPBarsGroup::bars ( int  index) const

Returns the QCPBars instance with the specified index in this group. If no such QCPBars exists, returns nullptr.

See also
bars(), size

§ size()

int QCPBarsGroup::size ( ) const
inline

Returns the number of QCPBars plottables that are part of this group.

§ isEmpty()

bool QCPBarsGroup::isEmpty ( ) const
inline

Returns whether this bars group is empty.

See also
size

§ clear()

void QCPBarsGroup::clear ( )

Removes all QCPBars plottables from this group.

See also
isEmpty

§ contains()

bool QCPBarsGroup::contains ( QCPBars *  bars) const
inline

Returns whether the specified bars plottable is part of this group.

§ append()

void QCPBarsGroup::append ( QCPBars *  bars)

Adds the specified bars plottable to this group. Alternatively, you can also use QCPBars::setBarsGroup on the bars instance.

See also
insert, remove

§ insert()

void QCPBarsGroup::insert ( int  i,
QCPBars *  bars 
)

Inserts the specified bars plottable into this group at the specified index position i. This gives you full control over the ordering of the bars.

bars may already be part of this group. In that case, bars is just moved to the new index position.

See also
append, remove

§ remove()

void QCPBarsGroup::remove ( QCPBars *  bars)

Removes the specified bars plottable from this group.

See also
contains, clear

§ registerBars()

void QCPBarsGroup::registerBars ( QCPBars *  bars)
protected

Adds the specified bars to the internal mBars list of bars. This method does not change the barsGroup property on bars.

See also
unregisterBars

§ unregisterBars()

void QCPBarsGroup::unregisterBars ( QCPBars *  bars)
protected

Removes the specified bars from the internal mBars list of bars. This method does not change the barsGroup property on bars.

See also
registerBars

§ keyPixelOffset()

double QCPBarsGroup::keyPixelOffset ( const QCPBars *  bars,
double  keyCoord 
)
protected

Returns the pixel offset in the key dimension the specified bars plottable should have at the given key coordinate keyCoord. The offset is relative to the pixel position of the key coordinate keyCoord.

§ getPixelSpacing()

double QCPBarsGroup::getPixelSpacing ( const QCPBars *  bars,
double  keyCoord 
)
protected

Returns the spacing in pixels which is between this bars and the following one, both at the key coordinate keyCoord.

Note
Typically the returned value doesn't depend on bars or keyCoord. bars is only needed to get access to the key axis transformation and axis rect for the modes stAxisRectRatio and stPlotCoords. The keyCoord is only relevant for spacings given in stPlotCoords on a logarithmic axis.
The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/ssPlus.png0000644000175000017500000000036714030601041022641 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+)IDAT(Ïc` >p!¤à?*—‰zê)°aø… p–Í`q$& ’Tfó ß÷0Ö%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPDataRange.html0000644000175000017500000007176214030601036024763 0ustar rusconirusconi QCPDataRange Class Reference
Public Functions | Related Non-Members
QCPDataRange Class Reference

Describes a data range given by begin and end index. More...

Public Functions

 QCPDataRange ()
 
 QCPDataRange (int begin, int end)
 
bool operator== (const QCPDataRange &other) const
 
bool operator!= (const QCPDataRange &other) const
 
int begin () const
 
int end () const
 
int size () const
 
int length () const
 
void setBegin (int begin)
 
void setEnd (int end)
 
bool isValid () const
 
bool isEmpty () const
 
QCPDataRange bounded (const QCPDataRange &other) const
 
QCPDataRange expanded (const QCPDataRange &other) const
 
QCPDataRange intersection (const QCPDataRange &other) const
 
QCPDataRange adjusted (int changeBegin, int changeEnd) const
 
bool intersects (const QCPDataRange &other) const
 
bool contains (const QCPDataRange &other) const
 

Related Non-Members

(Note that these are not member functions.)

QDebug operator<< (QDebug d, const QCPDataRange &dataRange)
 

Detailed Description

Describes a data range given by begin and end index.

QCPDataRange holds two integers describing the begin (setBegin) and end (setEnd) index of a contiguous set of data points. The end index corresponds to the data point just after the last data point of the data range, like in standard iterators.

Data Ranges are not bound to a certain plottable, thus they can be freely exchanged, created and modified. If a non-contiguous data set shall be described, the class QCPDataSelection is used, which holds and manages multiple instances of QCPDataRange. In most situations, QCPDataSelection is thus used.

Both QCPDataRange and QCPDataSelection offer convenience methods to work with them, e.g. bounded, expanded, intersects, intersection, adjusted, contains. Further, addition and subtraction operators (defined in QCPDataSelection) can be used to join/subtract data ranges and data selections (or mixtures), to retrieve a corresponding QCPDataSelection.

QCustomPlot's data selection mechanism is based on QCPDataSelection and QCPDataRange.

Note
Do not confuse QCPDataRange with QCPRange. A QCPRange describes an interval in floating point plot coordinates, e.g. the current axis range.

Constructor & Destructor Documentation

§ QCPDataRange() [1/2]

QCPDataRange::QCPDataRange ( )

Creates an empty QCPDataRange, with begin and end set to 0.

§ QCPDataRange() [2/2]

QCPDataRange::QCPDataRange ( int  begin,
int  end 
)

Creates a QCPDataRange, initialized with the specified begin and end.

No checks or corrections are made to ensure the resulting range is valid (isValid).

Member Function Documentation

§ size()

int QCPDataRange::size ( ) const
inline

Returns the number of data points described by this data range. This is equal to the end index minus the begin index.

See also
length

§ length()

int QCPDataRange::length ( ) const
inline

Returns the number of data points described by this data range. Equivalent to size.

§ setBegin()

void QCPDataRange::setBegin ( int  begin)
inline

Sets the begin of this data range. The begin index points to the first data point that is part of the data range.

No checks or corrections are made to ensure the resulting range is valid (isValid).

See also
setEnd

§ setEnd()

void QCPDataRange::setEnd ( int  end)
inline

Sets the end of this data range. The end index points to the data point just after the last data point that is part of the data range.

No checks or corrections are made to ensure the resulting range is valid (isValid).

See also
setBegin

§ isValid()

bool QCPDataRange::isValid ( ) const
inline

Returns whether this range is valid. A valid range has a begin index greater or equal to 0, and an end index greater or equal to the begin index.

Note
Invalid ranges should be avoided and are never the result of any of QCustomPlot's methods (unless they are themselves fed with invalid ranges). Do not pass invalid ranges to QCustomPlot's methods. The invalid range is not inherently prevented in QCPDataRange, to allow temporary invalid begin/end values while manipulating the range. An invalid range is not necessarily empty (isEmpty), since its length can be negative and thus non-zero.

§ isEmpty()

bool QCPDataRange::isEmpty ( ) const
inline

Returns whether this range is empty, i.e. whether its begin index equals its end index.

See also
size, length

§ bounded()

QCPDataRange QCPDataRange::bounded ( const QCPDataRange &  other) const

Returns a data range that matches this data range, except that parts exceeding other are excluded.

This method is very similar to intersection, with one distinction: If this range and the other range share no intersection, the returned data range will be empty with begin and end set to the respective boundary side of other, at which this range is residing. (intersection would just return a range with begin and end set to 0.)

§ expanded()

QCPDataRange QCPDataRange::expanded ( const QCPDataRange &  other) const

Returns a data range that contains both this data range as well as other.

§ intersection()

QCPDataRange QCPDataRange::intersection ( const QCPDataRange &  other) const

Returns the data range which is contained in both this data range and other.

This method is very similar to bounded, with one distinction: If this range and the other range share no intersection, the returned data range will be empty with begin and end set to 0. (bounded would return a range with begin and end set to one of the boundaries of other, depending on which side this range is on.)

See also
QCPDataSelection::intersection

§ adjusted()

QCPDataRange QCPDataRange::adjusted ( int  changeBegin,
int  changeEnd 
) const
inline

Returns a data range where changeBegin and changeEnd were added to the begin and end indices, respectively.

§ intersects()

bool QCPDataRange::intersects ( const QCPDataRange &  other) const

Returns whether this data range and other share common data points.

See also
intersection, contains

§ contains()

bool QCPDataRange::contains ( const QCPDataRange &  other) const

Returns whether all data points of other are also contained inside this data range.

See also
intersects

Friends And Related Function Documentation

§ operator<<()

QDebug operator<< ( QDebug  d,
const QCPDataRange &  dataRange 
)
related

Prints dataRange in a human readable format to the qDebug output.

The documentation for this class was generated from the following files:
  • src/selection.h
  • src/selection.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_i.html0000644000175000017500000001407114030601037024052 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- i -

qcustomplot-2.1.0+dfsg1/documentation/html/ssSquare.png0000644000175000017500000000043614030601041023153 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+PIDAT(Ïc` 0ÂYV \(2ߎ!+0cØÉpE ƒ;Ã)(—á ƒ+Š‚à l L„Ü0$À¼ù‹A‡a7ŠŒÃ/¢B’Áç OS™%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemTracer.html0000644000175000017500000017746314030601040025174 0ustar rusconirusconi QCPItemTracer Class Reference
Public Types | Public Functions | Public Members | Protected Functions
QCPItemTracer Class Reference

Item that sticks to QCPGraph data points. More...

Inheritance diagram for QCPItemTracer:
Inheritance graph

Public Types

enum  TracerStyle
 

Public Functions

 QCPItemTracer (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
QBrush brush () const
 
QBrush selectedBrush () const
 
double size () const
 
TracerStyle style () const
 
QCPGraph * graph () const
 
double graphKey () const
 
bool interpolating () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setSelectedBrush (const QBrush &brush)
 
void setSize (double size)
 
void setStyle (TracerStyle style)
 
void setGraph (QCPGraph *graph)
 
void setGraphKey (double key)
 
void setInterpolating (bool enabled)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
void updatePosition ()
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const position
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
QPen mainPen () const
 
QBrush mainBrush () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

Item that sticks to QCPGraph data points.

QCPItemTracer.png
Tracer example. Blue dotted circles are anchors, solid blue discs are positions.

The tracer can be connected with a QCPGraph via setGraph. Then it will automatically adopt the coordinate axes of the graph and update its position to be on the graph's data. This means the key stays controllable via setGraphKey, but the value will follow the graph data. If a QCPGraph is connected, note that setting the coordinates of the tracer item directly via position will have no effect because they will be overriden in the next redraw (this is when the coordinate update happens).

If the specified key in setGraphKey is outside the key bounds of the graph, the tracer will stay at the corresponding end of the graph.

With setInterpolating you may specify whether the tracer may only stay exactly on data points or whether it interpolates data points linearly, if given a key that lies between two data points of the graph.

The tracer has different visual styles, see setStyle. It is also possible to make the tracer have no own visual appearance (set the style to tsNone), and just connect other item positions to the tracer position (used as an anchor) via QCPItemPosition::setParentAnchor.

Note
The tracer position is only automatically updated upon redraws. So when the data of the graph changes and immediately afterwards (without a redraw) the position coordinates of the tracer are retrieved, they will not reflect the updated data of the graph. In this case updatePosition must be called manually, prior to reading the tracer coordinates.

Member Enumeration Documentation

§ TracerStyle

enum QCPItemTracer::TracerStyle

The different visual appearances a tracer item can have. Some styles size may be controlled with setSize.

See also
setStyle
Enumerator
tsNone 

The tracer is not visible.

tsPlus 

A plus shaped crosshair with limited size.

tsCrosshair 

A plus shaped crosshair which spans the complete axis rect.

tsCircle 

A circle.

tsSquare 

A square.

Constructor & Destructor Documentation

§ QCPItemTracer()

QCPItemTracer::QCPItemTracer ( QCustomPlot *  parentPlot)
explicit

Creates a tracer item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemTracer::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the line of the tracer

See also
setSelectedPen, setBrush

§ setSelectedPen()

void QCPItemTracer::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the line of the tracer when selected

See also
setPen, setSelected

§ setBrush()

void QCPItemTracer::setBrush ( const QBrush &  brush)

Sets the brush that will be used to draw any fills of the tracer

See also
setSelectedBrush, setPen

§ setSelectedBrush()

void QCPItemTracer::setSelectedBrush ( const QBrush &  brush)

Sets the brush that will be used to draw any fills of the tracer, when selected.

See also
setBrush, setSelected

§ setSize()

void QCPItemTracer::setSize ( double  size)

Sets the size of the tracer in pixels, if the style supports setting a size (e.g. tsSquare does, tsCrosshair does not).

§ setStyle()

void QCPItemTracer::setStyle ( QCPItemTracer::TracerStyle  style)

Sets the style/visual appearance of the tracer.

If you only want to use the tracer position as an anchor for other items, set style to tsNone.

§ setGraph()

void QCPItemTracer::setGraph ( QCPGraph *  graph)

Sets the QCPGraph this tracer sticks to. The tracer position will be set to type QCPItemPosition::ptPlotCoords and the axes will be set to the axes of graph.

To free the tracer from any graph, set graph to nullptr. The tracer position can then be placed freely like any other item position. This is the state the tracer will assume when its graph gets deleted while still attached to it.

See also
setGraphKey

§ setGraphKey()

void QCPItemTracer::setGraphKey ( double  key)

Sets the key of the graph's data point the tracer will be positioned at. This is the only free coordinate of a tracer when attached to a graph.

Depending on setInterpolating, the tracer will be either positioned on the data point closest to key, or will stay exactly at key and interpolate the value linearly.

See also
setGraph, setInterpolating

§ setInterpolating()

void QCPItemTracer::setInterpolating ( bool  enabled)

Sets whether the value of the graph's data points shall be interpolated, when positioning the tracer.

If enabled is set to false and a key is given with setGraphKey, the tracer is placed on the data point of the graph which is closest to the key, but which is not necessarily exactly there. If enabled is true, the tracer will be positioned exactly at the specified key, and the appropriate value will be interpolated from the graph's data points linearly.

See also
setGraph, setGraphKey

§ selectTest()

double QCPItemTracer::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ updatePosition()

void QCPItemTracer::updatePosition ( )

If the tracer is connected with a graph (setGraph), this function updates the tracer's position to reside on the graph data, depending on the configured key (setGraphKey).

It is called automatically on every redraw and normally doesn't need to be called manually. One exception is when you want to read the tracer coordinates via position and are not sure that the graph's data (or the tracer key with setGraphKey) hasn't changed since the last redraw. In that situation, call this function before accessing position, to make sure you don't get out-of-date coordinates.

If there is no graph set on this tracer, this function does nothing.

§ draw()

void QCPItemTracer::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ mainPen()

QPen QCPItemTracer::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

§ mainBrush()

QBrush QCPItemTracer::mainBrush ( ) const
protected

Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is.

The documentation for this class was generated from the following files:
  • src/items/item-tracer.h
  • src/items/item-tracer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemText__inherit__graph.png0000644000175000017500000000211414030601041027676 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii222PPR™™™………ççè±±µÓÓÕ*P4nnxXëAtRNSªvå’bKGDˆH pHYsHHFÉk>6IDAThÞíÚÁOÓPpþ]˜ ÁÕÌ›u1ñ&6Ù‘×ö·9!™Ñ#‚%åƒLˆ‰O„p1^= †;ƒ‰wþÞÞ6 ¬okk"èû5!ÍÞû´¯¿¾,á›MAªº3¥ôÀÙ54XØaã½x~™K" dø_D6Áú{k½eZÉàd =Ø~e’þ ïî²\Ï>ùÀý–)Ö_ýlŒtNël; l(Ô-ò94ý+Jö¹}ù•åFm¦Éö®¦óÑ¥üŸô¿Âþn)¢îGTÂ>²fOäããüû`=•?NSù³à[Ÿ‚iü\§ñ³Al§ð_ÈÿJáÏÉŸ¦ðgä¿'÷âò ÷sÜŸ$÷¹Ÿ¼RÚ‰ègàz'#|(ûYƒì*­?»ïÁó~ôCë§Sm_„A£|(ûqa†QÿrÔ7“‰èçùé4Š0h”¿žý¤ÚÊߟ ûf@ä#³yþ#2 •ÿH‡Uþ£ò•ÿ(¯¼òÊ+¯¼ò7ÓG¥@ùOíªû_È5ïúqÊT~¤ß@‡±áaÓw½‹ùÔq1Á“ûö‹vc³YzìuÌK~àÆyÇßp½Ÿ¦û.b‡–aã"6øøªæ/"J½åw\¯B^Ü¿ûÔôí²]vÉ×Ê®þÒsÿ¡ÏïÑí,:¸§t°2ñúýž§K¹½Ã£«ø›c½IýÛàýëùJ÷ÑüÐWKõg¿â$ïû.vêÎÐÏc£æW»òþù~½r›÷¯òI}Êï_i õëŸóûÕ¿èãõíjÝû ÑãCe’–=%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/sync_off.png0000644000175000017500000000073214030601042023153 0ustar rusconirusconi‰PNG  IHDRY ËgAMA† 1è–_-PLTE$<„#;‚#;‚#;‚#;‚#;‚•¦Ì#;‚1Jsˆ¹Rj¥¶ÂÝÿÿÿÌÕççëõO黤tRNS.×îü]UÙbKGD ³Qc pHYsHHFÉk>ÁIDATÓU?Á`Å׿ÞPhƒ"½ŒQs3 7Ha¼à p„T´˜‰–"ëœÀ8„Ý|_ÆxÅîû5»o—HTkwšdÕ†h`ü™ºê+°ª Œs˜ ôrX¥m 9T–{`Sj Jb J·ÉÅø­°þðŇϼŸSoÂÌ)¤Üé÷¥wÅüžIDATXÃí•ëqà €óG3h6`¯ Ø"{0§`mA%ÞnÒ$õµg_‹.G„"ć$È%ž\.GLÀ (ʧ”µ8šå‘€.ä#™€ðG6ù À+\³9)<Â-Füm7{Âa;k6Y.ë¶öºÇ“s|hÁ‘“ˆ,y”Õ´ÈF:Ã;Àç»@ú¹';~ 0ÙÅR-;ÈÔ·³§Ñfj¦ëlE€XsFR lïÁ¼¬{H—l—¨Aò؇@EÝWâ*¡RY¢=g÷`÷3uÀH¯Ô²ºë’$AGA—^dUUΠÏuòC‰«GÏ —X#£Z$mãÒ 1ÊêkÀþÌ*8r Í…à_„Uçk!~¦ÍÖT©âQ{ðV/ .ÜÍØž™!PQߌÒU—ùW7– ø¿O)Ì)…à™eþ}@wrùôAΠ«t%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractPaintBuffer.html0000644000175000017500000005652014030601040027014 0ustar rusconirusconi QCPAbstractPaintBuffer Class Reference
Public Functions | Protected Functions
QCPAbstractPaintBuffer Class Referenceabstract

The abstract base class for paint buffers, which define the rendering backend. More...

Inheritance diagram for QCPAbstractPaintBuffer:
Inheritance graph

Public Functions

 QCPAbstractPaintBuffer (const QSize &size, double devicePixelRatio)
 
QSize size () const
 
bool invalidated () const
 
double devicePixelRatio () const
 
void setSize (const QSize &size)
 
void setInvalidated (bool invalidated=true)
 
void setDevicePixelRatio (double ratio)
 
virtual QCPPainter * startPainting ()=0
 
virtual void donePainting ()
 
virtual void draw (QCPPainter *painter) const =0
 
virtual void clear (const QColor &color)=0
 

Protected Functions

virtual void reallocateBuffer ()=0
 

Detailed Description

The abstract base class for paint buffers, which define the rendering backend.

This abstract base class defines the basic interface that a paint buffer needs to provide in order to be usable by QCustomPlot.

A paint buffer manages both a surface to draw onto, and the matching paint device. The size of the surface can be changed via setSize. External classes (QCustomPlot and QCPLayer) request a painter via startPainting and then perform the draw calls. Once the painting is complete, donePainting is called, so the paint buffer implementation can do clean up if necessary. Before rendering a frame, each paint buffer is usually filled with a color using clear (usually the color is Qt::transparent), to remove the contents of the previous frame.

The simplest paint buffer implementation is QCPPaintBufferPixmap which allows regular software rendering via the raster engine. Hardware accelerated rendering via pixel buffers and frame buffer objects is provided by QCPPaintBufferGlPbuffer and QCPPaintBufferGlFbo. They are used automatically if QCustomPlot::setOpenGl is enabled.

Constructor & Destructor Documentation

§ QCPAbstractPaintBuffer()

QCPAbstractPaintBuffer::QCPAbstractPaintBuffer ( const QSize &  size,
double  devicePixelRatio 
)
explicit

Creates a paint buffer and initializes it with the provided size and devicePixelRatio.

Subclasses must call their reallocateBuffer implementation in their respective constructors.

Member Function Documentation

§ setSize()

void QCPAbstractPaintBuffer::setSize ( const QSize &  size)

Sets the paint buffer size.

The buffer is reallocated (by calling reallocateBuffer), so any painters that were obtained by startPainting are invalidated and must not be used after calling this method.

If size is already the current buffer size, this method does nothing.

§ setInvalidated()

void QCPAbstractPaintBuffer::setInvalidated ( bool  invalidated = true)

Sets the invalidated flag to invalidated.

This mechanism is used internally in conjunction with isolated replotting of QCPLayer instances (in QCPLayer::lmBuffered mode). If QCPLayer::replot is called on a buffered layer, i.e. an isolated repaint of only that layer (and its dedicated paint buffer) is requested, QCustomPlot will decide depending on the invalidated flags of other paint buffers whether it also replots them, instead of only the layer on which the replot was called.

The invalidated flag is set to true when QCPLayer association has changed, i.e. if layers were added or removed from this buffer, or if they were reordered. It is set to false as soon as all associated QCPLayer instances are drawn onto the buffer.

Under normal circumstances, it is not necessary to manually call this method.

§ setDevicePixelRatio()

void QCPAbstractPaintBuffer::setDevicePixelRatio ( double  ratio)

Sets the device pixel ratio to ratio. This is useful to render on high-DPI output devices. The ratio is automatically set to the device pixel ratio used by the parent QCustomPlot instance.

The buffer is reallocated (by calling reallocateBuffer), so any painters that were obtained by startPainting are invalidated and must not be used after calling this method.

Note
This method is only available for Qt versions 5.4 and higher.

§ startPainting()

QCPPainter * QCPAbstractPaintBuffer::startPainting ( )
pure virtual

Returns a QCPPainter which is ready to draw to this buffer. The ownership and thus the responsibility to delete the painter after the painting operations are complete is given to the caller of this method.

Once you are done using the painter, delete the painter and call donePainting.

While a painter generated with this method is active, you must not call setSize, setDevicePixelRatio or clear.

This method may return 0, if a painter couldn't be activated on the buffer. This usually indicates a problem with the respective painting backend.

Implemented in QCPPaintBufferGlFbo, QCPPaintBufferGlPbuffer, and QCPPaintBufferPixmap.

§ donePainting()

void QCPAbstractPaintBuffer::donePainting ( )
inlinevirtual

If you have acquired a QCPPainter to paint onto this paint buffer via startPainting, call this method as soon as you are done with the painting operations and have deleted the painter.

paint buffer subclasses may use this method to perform any type of cleanup that is necessary. The default implementation does nothing.

Reimplemented in QCPPaintBufferGlFbo.

§ draw()

void QCPAbstractPaintBuffer::draw ( QCPPainter *  painter) const
pure virtual

Draws the contents of this buffer with the provided painter. This is the method that is used to finally join all paint buffers and draw them onto the screen.

Implemented in QCPPaintBufferGlFbo, QCPPaintBufferGlPbuffer, and QCPPaintBufferPixmap.

§ clear()

void QCPAbstractPaintBuffer::clear ( const QColor &  color)
pure virtual

Fills the entire buffer with the provided color. To have an empty transparent buffer, use the named color Qt::transparent.

This method must not be called if there is currently a painter (acquired with startPainting) active.

Implemented in QCPPaintBufferGlFbo, QCPPaintBufferGlPbuffer, and QCPPaintBufferPixmap.

§ reallocateBuffer()

void QCPAbstractPaintBuffer::reallocateBuffer ( )
protectedpure virtual

Reallocates the internal buffer with the currently configured size (setSize) and device pixel ratio, if applicable (setDevicePixelRatio). It is called as soon as any of those properties are changed on this paint buffer.

Note
Subclasses of QCPAbstractPaintBuffer must call their reimplementation of this method in their constructor, to perform the first allocation (this can not be done by the base class because calling pure virtual methods in base class constructors is not possible).

Implemented in QCPPaintBufferGlFbo, QCPPaintBufferGlPbuffer, and QCPPaintBufferPixmap.

The documentation for this class was generated from the following files:
  • src/paintbuffer.h
  • src/paintbuffer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPErrorBarsData.html0000644000175000017500000001650214030601036025617 0ustar rusconirusconi QCPErrorBarsData Class Reference
Public Functions | Public Members
QCPErrorBarsData Class Reference

Holds the data of one single error bar for QCPErrorBars. More...

Public Functions

 QCPErrorBarsData ()
 
 QCPErrorBarsData (double error)
 
 QCPErrorBarsData (double errorMinus, double errorPlus)
 

Public Members

double errorMinus
 
double errorPlus
 

Detailed Description

Holds the data of one single error bar for QCPErrorBars.

The stored data is:

  • errorMinus: how much the error bar extends towards negative coordinates from the data point position
  • errorPlus: how much the error bar extends towards positive coordinates from the data point position

The container for storing the error bar information is QCPErrorBarsDataContainer. It is a typedef for QVector<QCPErrorBarsData>.

See also
QCPErrorBarsDataContainer

Constructor & Destructor Documentation

§ QCPErrorBarsData() [1/3]

QCPErrorBarsData::QCPErrorBarsData ( )

Constructs an error bar with errors set to zero.

§ QCPErrorBarsData() [2/3]

QCPErrorBarsData::QCPErrorBarsData ( double  error)
explicit

Constructs an error bar with equal error in both negative and positive direction.

§ QCPErrorBarsData() [3/3]

QCPErrorBarsData::QCPErrorBarsData ( double  errorMinus,
double  errorPlus 
)

Constructs an error bar with negative and positive errors set to errorMinus and errorPlus, respectively.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/adaptive-sampling-scatter.png0000644000175000017500000003711314030601037026424 0ustar rusconirusconi‰PNG  IHDRvðºüÙ'ÀPLTE ÿ ÿ !# '(& ÿ./-675&.ÿ>@=DECIJH4AÿNOMTVSY[XZ\YQTÿ`b_fhe_aÿlmksurloÿ|~{‚„‡‰†„€ÿŠŒ‰‘Ž–˜•‘‘ÿ››× ¢Ÿ¡¡ÿ§¬¯ª¬©¯±®«±ÿ¶¸µ½¿¼ÁÀÿÈÊÇÎÑÍÎÍÿÔÖÒÖÑþÓÖÿÝßÜâäáæèåççþìîëñóðöøõú÷üùûøþÿüù6á3bKGDˆH pHYsÄÄ•+ IDATxÚí} cÛ¶Ò­¢ÀÓÆH`¯2nÑ¢½pË|°Ë–º,™ŠIXüÿõfÀEÔjʦ6WhìZeIdza–‘¿¬Ë:ø] ¸¬ í.ëB»Ëº¬ í.ëB»Ëº¬ í.ëB»Ëº¬ í.ëB»Ëº¬ í.ëB»ËºÐî².ëB»Ëú—ÑntY¸^ñe­àׇvbÙ¹a gÀ€ó Ÿ\°Ìè,+–~Óoì…Fi…%ü|‹_ðËÎó~}hÇ!Mƒ¡‹ (..Fe1 „.—^¥(.´[ŸwQ–›oükñë§dU7b0Æ‚dB©¬d´mó¢¥çX3 e9òƒ^·ûe/U²]üJc<ÏEŠ7æøñâß…_ÚY@®Yë£ÈÄ#qîyÆM!J«’yBè•ÓîeÒÎAÌ—ðËU²€ß+§Ý6iwC–ßûêç1þxÛ\L0‚ÍZíF¨XæJ‰Š£Ì/Y)u~•ío*²Qmðý›h·ŒßMóTÁ$Ÿã‡´Ë]éâ—í*üÜ~)◦ſ‚v´nïkئK²€¥ÐÒ(F ŒêþSÀÃ} ™V?à Á¹Ñ¿/Ðt³?´ì`Ž*UÆwsü4J9ÿkð[¼9ÍjØf]Úq`K+°LeT¶à5ƒHű”žvlߌé¥$¦ýÞsÏËþuÓÝi·?¡ ò®‹¡0œü„,~¼P±ûá·xó¾Q ãwïîf ´®¤–K¤ûq¿"„JƱP1¨¸(…ÑÉ¿-¾¹„ߤÅO¸Â‚–„Ÿ™EÆE5Œšxø¬ ´ëà—¾füo^?Ö?ô À˜8SáAùû¯Fák÷÷Qá‡ä#ü&-~Æ–*Ð袗°2#HÉY­?Z6ÆÈO"ž5~éöÌ~ß8ß5A”éûñøvÚXÿÒ 4› :)-ôîJâúzÛ'müä¸UÞÜüþÔÇßÚïïß¼§';­¾vV²~“ ¿›?¥çšh‡¨p“(õ*SX &xÂujÐ<¡0 zè\ˆT¤M¼ø9øˆ;¹Õû]~ÛiXf4B©¬|¶ `^_OŸBlíºýiöõÏïž¹Qÿ÷ö÷/¿¿ý_uÉè|?@ÚiÃ"•§9ŽGV3nˆ‰ ´GS.‘^P¸Àp¤]RXSZÿ<üNÄÝi·òŒÑh7ÚÕ ‡„Ç1à׎zö‡ÿþ÷üß??Ž¯îñýýõýxüýg|ÿ};þñ_¹E£ÿÑòîþ—oÇÿùR=ñMýÿö¿Œ¯~ÿïø›?Û'×uôÛ·o>üåý×ÆWÿ­!øþ7üöë÷~]¦ÎKÏdéM´ëb°¹…‹\…X ¿Z»*ƒ—I™(T¬I\üŒŒãçèÙã‚Ø>¸¿>´c».àÓ`<¦jEáöÄõU_ßþý÷Û¯Þÿ|û÷ß7øþÞÿùõËáoßþÜꇈÃüýí§Ïw?Õg?~ ÿoŸñã—ßÞàׇ…'Ó¿ÿ÷éË/7øßÍf·5ßþßþ~7—vÓgJ»øq:›EÚY¤J:˸@: £L"mâtQ[3ÜÄøÚ…aŽ+%x…_êvR²G±~ðÒŽíÎ;¨½_›0ð:ñRG½•Åã-Jzô¢ßáfù«~_¾Á÷A·ßµˆÑžÂÍu÷ξ­Í’¾7QÚðŒÏþ+}½Yx2ý˾¼Y|‰7_é¯õæåJÖ¯*ÙÈ É’Å §vÌ8‹²Í ŽÚUÊØKä%R‘«(/FÁ6µÚët'üNÄúÁƒÒni™Rðþ°}÷ÞÿßwÕGøŠïoz;®TÂ×9-ðÛçñçÙø³³¨g?ÝtžáۯΓGsƒºy‰µÒn@Ú•\ B4ÞPþG< ÑNPH¶ ;Ë]å¹€ï;Uš: º”ÉNø ˆ ©O§dÆ¢.áƸ>JbV™V³v½û¿Ïÿ|­lTôï'hÀZ|zØÍ3:ˆ-nÔúWt7êÜ,ZÉ’ãÚ„Óx'ÎYJig¸C÷VPðNJFçdu¨3¤‰"H,B{âw: —víù·í>¾ÿ}ÿϯÁ,!›áê÷¯Ÿ¾Í-‹·Uïûëk´L~½ýëŸÿ}_oñ?¿~¦Ú>£ƒØ¢YRt2K¾ ìÉ®<Õ& —Œ9è‡\Rõa6+(},&ï õ¬÷œÅ¶f¨’{:æžøˆ/¤ÝèeÄ£Ó\Fa©¸ú}YÈvcVÏû?éûŸïÉCz{yóí¯£Êúúý¸þÌßkä×ë6RôûÍ›·ßê<£ƒXýäEÄè%~i,߯ß\ÿî×ÒlƒŽVŽu(—±ö7œãÍé#\äŒÍxˆ_8¶è‡ßé€8Gñ0žì÷Öàn-­·ÿo­WångŠ/Šµo 5½ìLvÓKË Þx}ÚòÕ S{Z!Ú *·lNP’„Ý ð; ˆÇW² Ð6)Á[Ø 8>b?Í>Ýþ´ç§4O\­Q·îd»{V ZíÓ"Dû˜¡|RÑîùøÄãÑŽ6o1Á«}’¤ŽØ¯ß¼ýá˾i÷ œj¹ˆÿT°Zyh/Áï¨ ‘v*³ÖåÁq¡Ç&eÙï §ïÐþ.vòxš´íŠ"—†¿ü˜-^ ~•vR„S€Ë2¥cˆ»e+'¾^J;Ẋ]Σï’$˜Bß«ˆŒÔÌ©*9C†®˜LJ¢á—çgŽß<Ùy%r™}¡mr$Ððdùvo¿ rJ.JÝõ%”%Ò1Š,—îuàwPiÇdÄÀa+K‚íµ•ðlÃØf‡bai+åGÃ4!æ¢lRe¯¿CÒa˸¥Q¸’³ÑƒÐN1±]Úµ¼DßUÔ¹)T舴3^¤¬t P¯¿Ãz²!|µè€•vŸŸ¶'C»Þ‹ ‰•‘ .¸º$Úá=Tæ^~‡¤Ý<¹,9¬3ا’Èøéy²ì)#$ )çB°¯vFº _À/ß+~ùžð;í¸Œâv‰ö¹[×Ò݊¡'`^…׬¤ä…HbaÉÍÕà’.~é^ñËùñ¤ÝhXâ)P(¿›YnÀÚ=鉢Š± '9“ÝmovxiR@%›¥˜¹—Žð“ÞæçŠß1¤zi\•n\t28åÙîGI”E‘ñ¢(ÏIÉ.:þUµêÚRȤŽðA^ŠñCA´üÒ=á·Î[äçxO´kŽ¶¹ôÈb³'%q,%;¿&˜Ò¦ ~Ü‹(áÑ^ñ;°’m:?í‰vm%2Ïd›<·<êti7~ šÈ Äõ+’§(èPK4~††x¯ø½.Ú5û—kPöi؞åq<ÙÞ´ƒ'cNMƒ£àÄòœ‹ï"ŒåÚÛë*á$q1ˆ=Æ¥)A&ž~G¦]'&"­O5evXÚõ—w¼{qó“É9µ–IÞ_4ø¥çßiÐŽ ¬[#ƒýÐnõ€z'Å+TÓA@-$º¸’³Âï4hÇ5$R—`L¹îð•)Yx’†›òca¹Ô–j-¨s™ƒô¬ð;i‰“žl¿JiÃl϶Ÿ‰Hks–Zç)Å §Î¿#{²óþ(œƒ—a á+÷d‡p&*ö©HJçËÒ²‚{´;üNƶ«ÂI›³¯MÉÊEÏ@Àó<Œ…Fœ)A´+X^7“Òå™àwJ´³À¥â TNj}yºJâ¥J6u¥Ø)ÖÒ¼J8æ¥S8Ô¶âð;%Ú‘¹+ˆãLØDòzhÇž¤ÝóÜÿD GAd´Qvy#éâ¼¢H/´ë¿4§V–ÜÎiwþJ ¿×ЛD7ÁPÄAΊœªy—V ~Pá—^”lo õñUEV”")Ë×"íž …›MJŽŒNzòxèȨ˜/S£ …ÄŠ¨(¬.ò“ÆïD<Ùðµaê¿ÓièÙ—{²Õ°lÅ›‰'°")ƒ32,®ïýŒ¾J[†ü²m½Ij­<:~K7ïîjØf§ d¹´,gË"íPÙa“hKFÉN&kð ´#庲_ÉÞ‹œÃ}TWT(e $ùTM;.úRd1+›ŒœS·ŠrY槀ßÒÍ÷µ–¿{w7ëC;اÀ*AƒeA²o%1í:øMf J¶=šÁRa"KÎ&%‹HžRIнE†JÍ­S^ ¨`Ê„ÊDó´Âµ~~¦&ŽT+„N¿Ñ’yRÿð8Þ½›{¿¸øVõºî‚Iôñ£\l^E°­kj5í×ûjå²²|„rZn¸l‡Fc-~Óéd?!t¥l‘bS!uDÝ‚ói…—FÑP¼EªV¯èûE¾ˆ§ÓŽE€áñôe_á§Zô‡ÀïaGünÞ_wtCkŸ¬íá²=J„gù]}hg$Ÿ€k¹¤g‡Ö!ôÀ_,íúâG‘5•ˆbΈœÊ]u(zÕZð‰ÒT1—4çÎöÐ)\55³U„ñ2"Y‹8Wq²„_ztüº7ïßuQó{1¢hBˆ½iŽráUˆ8«)ˆ²ßóÙA”ì2~ÍSц7 ”$ g 9ÎëáØB£<'â1W%µGˆ˜ÚV*2šê õ˜ÞŒU“çRc(œbJ¤JQ{røu=Ù«iãVL§³ÙÝլݭtÒBÝèÑfM|+ïå.ùˆ/ +ݧ êùžØ:ØvödküЭ ü&-~Þ ML⺳‰—Í,Oe„BFX:­-cmˆlÔ›šuê*ô ª}€ŠžÞ­z!¿ É.O ¿ÎÍw£*Xw{ï§ïÇãÛyï] îà\¡¸‹d–ÔŸE†vkp™G}Ä~ódKþrið» í ¿yïbo•s„_Žøå ~ "#Ò´®Q‘áœ"4De"• £“ Å{]pž–aèvTM—<•þ¤ð[çõê)ÇÊŸ_KNšOµA€… ûà ŠhÇÇu‡SŠëµO…¼t•üÒ ääSðº ;—6*KçX,f…umS&Â$ÜèÜA`DYØF•Ð郸úÝ gÊHHÈ¡@·€«žº˜D‡„NU]¹}Zøõ¢]3igŠ,S&‹ƒ î¸Åh#FH¨¨<ÏöáWô¼ÀÉàüÄhW-Ä/M•I+ü¼¨ñˉvª®Ut"§§”ª‚ á1K7ù.aRÑoðTl5!à˜øõ¡];“¾Arš¨=§2èߣ¨ÒNJ%ŸÙb¡×Ÿ¶7Ö®ÄzQ ¿†uØ¡ÝFü´B+#y;¨¼= C ÈäÐj[¶¡+ÁûÖ0•u_zøv‚­Ú-lÁRAe9'BCœÚˆ;.ö£gËñ¡“U²ÛðËSÒ¹Ô‡ò/įŠž„èT´3\[»S°”KYD “²•’'„ßsh×î„62ó ’Ï:½"ËehÇ6œÄƒ¤Š•{…-‹@»µøUí#tÀ 9a…MR "(ŠóHA_L5JL:‘š•¿<Žv•RT:¿5L¥W*2l2ÉÈ-ãÐK ±Êq=”CÁ@©,‘ ‹“äi±^<×뎳Ö“} ¿@;*7DüRx±2ªÎç¸ßtíÛ2µ“é.B7ب»S¦Í+üÒÀ¯íxÈî-³,áY67ôÈçã:ó7C'ÝšI¤%:^"˜Ä -g=SûœU¤ŸÃ•ÖÃ6˜´«Rêʦ3f8Ú…¿_…m˜æ©{Q²›ñë˜Y¶¶õü<þ •UT•“$‰­ƒnœx}›´åÚœ~ým»§œŸn4—°‹#*‘š"òšŽ„jpw6´ã}µ .f…Ÿ¤¦ØV˜²Œåüˆ¡´[ÅtáI§iæÃßA¶F­«%œ~ý=Ù'¼˜Ú…ËÍ|"œšBY¥ À´sÅS—XkzZ]äJç,s–« êÉb0šeZq² }W%Ä!̯÷Øÿ%´ë‡Ÿ]Á/Â/¹ óp¬›‹:‘e½´Û„š:’£©h5mô±ñ ‚8Áf–`ÓZ~Uðªe¨@J%7µ×:ˆ0˜’Øï)ÅóðKÃJFð6Jé¡)}aÈóà«UUã CF æJ+8tõ´U<2àÒ¢¡ÝÁñÛ•v;( OSa4ÊUDL xLK™ö÷PÏ$I•Ÿ'ÛŒbü NvÚ™*£Ý[PâcÈGæ½ÆúTdåÐÖ߶øÉÃã7j£Ø¢uRB©Ö¦#ÓV²—F9_âþgèëÅñK»>øU½ƒpCë,RV¨FÎmÕ#Ep~C;mt1D¨W£P´øŇÇo0Ú ±Ø±D«5V´i‹èé’»ç([4·KIV[³3 ÝüÜ2~Àz‡&ZìÃ$ßV~G©¸xÍÂ@ÎA8âçµ{2? ? ízybaÉ•nÃv¼Î_rÀÈqpÊ m\ Æ[Þ\É^ª$àÉnÀÏÍñÃ]¦$W¢nST¾&h²Ò·@Ço+¤Ûúæö€ßh¸õ1ÅrD¢äEQÔ‚/ô„S–mv%;i·¿¼ÆË¿¨mýGÊ(¤\2‹šÖô ¯’ ¸‚Ç=dÑá|rpü6`2»_Ý–7ñøug>ÜPñŠÞKÖ{[¶îÔ,cY––v³Éðø•6à§ä¼fQ3-ûL˜»a‘Qv<œÏ»d4øå«øåyÎðë ´»»™MÛªöþVnlé°AT–Zbh 4‹¢(¼j²R0P®æhÀ“ì?Ô†eŽN€©©$$EûÌ.ªxâ,Õì*pêá ìÁñÛ'AÖtÚñͽÕÑæç‘·‘®'?É:®*§°ayJ–ðkº? …2.àÇ«Ù*ÀyƒOò²äŒ?uö"öH´(±eŽ :/Tu4åø­Çd6šyÿagØ6ÇãË¢P®@"ÕÐZ¤aBgIÈ áÆDåÑiwüÂ(ŠLÂYÿ¶ÇŠ8Ø…Æ6mE”a ¥æ‡Ão=&SºûñºuCpM_¶tu¢£>¢3ÜyE…£ -àÔ4³V£o&íò‹ó½õ:>-à÷°Oü¨"ЯýÑtú‘M¥ê2¦66QÓ¬1xx$ùù‘ ʇ߰Ònër‘@K†+³°ÔIð*÷•×ÑÑÃÅûÇ×£P?FQŽ²×yìO‘/Ì\A»Ð“§1ð(W1`V¯q(ü†µí¶® $Š¢D3=ªá‹i…Jd$3®lV”Ç¥Ýsm»þøy•C(`Ò˜Ô÷K+kË!‘«ø»Âñ[™KKUBR)ë¿ñË÷Žß&OööYžØÖËLJõÊ(+!Š3?pÔ Q“Š¶&ñ,<Ù~ø¥ˆ_Rx!"Öi,ǨÿâæÚª¥c+ó¸"ÚytaT•LÅNL†ß€q»‹`Cy^¯b¯L4”¦•Œ9qÃ5t”Da&íž·Û?mbîPé*ú3úúkz^6‹X¤DÝ”z<úÃà7ñ­ñcQtš• Ø4¥Q3Ô¹° ‹£Ñî0øåÒ¤*ÎEB½fñ£§qwætLF‹¸ÖuoN»T•výÏŸ¼¬Œc±5Nç2;d&ÁŽf‹†'i·ãg€â`g²»á—[)X˜Jitm㉾6IY™×shÁ•HÆ¡¿ûVÚ €ßa¥/”¢<1®¹Ô24ÊŠxbnT+r) ­QëèôDè‰ßqi'w 6íRIrxD•©[zɹ§”l²”¬\/-£“¥]"K&eÝte“”‚Õ'>PÏ¿ Ä½ ‰àÀIDAT]bLȇ¢~q5~˜¢¬{ñ¹§”lº?c¢£{² —…˜²¡™‡Š£M6Ê.*Ùr“mW–Á Yú ôéx²KøÅ2à—ú’i”î yÍJì–ø](ž§8–CÏjÍC·¿¼¾D…ZÊ~y™oÄÏ­ÁÏh}RÒ.©J¢x žlàáöôY]qåaó2ÉÔú7äÊÊ6‰æÉ?ŽF~ñÓ”vI=dñCÚ‹.•Ü©œâ#QŸF ¡‚¬ÞœÔ 8Ã-Y&„_Zá'WñËwÃóS³í„ ñ Ò+à <0èäEÀ,õÂ,LÒhë¶äŽó¬ª¢ª‚!Ï6Fû +Ù ?o„·FÓÈw4k ñk†¯Âºd÷*”[_ð¸lÛ…R}‘sVuæë‹_ž.ã—hrOÍ“MÐObøó¡Í»8üjPVeµ-Z¤kÃE”$åÚU“­¥X}hqéNדmðKª,PU"‘ ‚icgWÁTiØ[³eéP6¤wèIÐ0‘朗s[nŽ_šnÀ/_ÁÏ).OÏ“EŒØ$)´UC6vϤ %y4¦/îÒ.Œl©X| sòã"A³IŠˆW•¡AF¾‚_êsÂ/_Á/*;ø¥ÔòŽk-OvEÝ[Øžf!3‘)É鶉,*3¨^ Qmë‘ÑHm )²Œªï¥)š'K»ü(‡„‰:^)x5tXÃèžÐû7’ª¹u!ÒBoÁ¯õnE^ágŠ"§b  ?>0 W|Zžl\\–…½vv£¡3nî “—ÇE€M(¯ZÛ˜¢õ•,þ+}4¯u' b[=Á i‡¶oÈÝÀ šØd]*Ö {²ür¤·‰&S¬J;4”ôÎ@î‚2Œ°J’VUØŽz¯D ðK’" ¥FÐuµq‰£©Rò´,)²RpB6šÒ—žž'ÛݵÔ'§݇À#9*æ¨ëTnÄPx°f”ÈxÓ©Ò)K»¿HDÜ–eé4šõŒ*DÞo`ÔB‡j!ªäR³*ç&;Di…ÆŸ -£h ¸4ÒC„XWÐ,ƒXTj‹ò-g2&sÏn¦Ýôv<¾›U?ß"?LJ†ÍëÅü½®JÔÛPFT·d’™MC {€0½'5~“£àg«dTyÂXž+»$ïA;¨Ç¨62K‘ÑÖšI÷ÒÃA:p|PÖøq•æekI‚+P¹ F¬ô>ÝL»ÇÇÙôC]’}{@Ol!Þ¨½LÌ>IW-‚´—²ãëmãzî<< ~uIöäXø…ãD·ýeÛmÐ*OÀ È&ðŽ†[TF#$©eZ;EŽ†ÊUB´-\ )+—š *e#­ôOåÛ5}O6Òno«Î6BÚřιH©â›½¾ž 4}O&‡Ç/mhGZVòPÉ ´ÁJÆùÎÛ’™È ÁK:Ay& >næµ8«ZTÍ2ÇeÉ£Xظž6‡6KT”Ìq™¦y±vMŠÛ««›éAa«gûj‹ÎÀÁg: }Û«ö¡i@19~¶Á¿l$¤‚$4­Ø)"Jþ©€jH++¤²Övlbð!GlŽmbA‘óA'ŠKüYqBaèR‹4°U ÜÜJ»Ç¦Âãtz?š¶žu, "}:õõÛÿí~™ŽÚŸ )öÎ;€Þˆ:>=4ø=¿V>œ¦N)¢ãD·§´ ÑÎyÙ…lF(Gó¨A‚‡T|”m°5 r5–;?…â#%+‘ÐAïæŽO³êþ¶mÇ‚¢=Ànq;IkëĆ21ûw)Úp^¿µ„µøMŽ_ÚÁ¯«ù|“ñ­}l½yD“Œ° bü]¢( V‚*Ѷóy%ËbGñ¸*‚Ð]êžiórõ|GQl“v‹¨ù»ÃÁ– l(ÊÛê†XqËNjõa ¿ÉÁñKð«gDU™ÇARI€>½ŽUh'¸#‚|üHØœI¯ ó­&2öÜÇ(ødóZ€ê8ŠÀF¤¯t ¬ß@?V ö ¿f³ÇÑÀ‹¶_fºªe‡2ï`8ÚMÇ•‚Eüf³‡câ—Ì£!á€,Tõ Ø¿ÐB65(útÊPžR©vŽ¿âv¡ßOE3¾€.2Π÷A?.4l[hw7ª‚M÷èVÜŒGïa7!÷¬ .øž‘´›4øM*üŽ‰_Jø)m;±º`‡Á†t×x„\ }SrÒߨÔi=«$€NÃ8·%ôP÷ŠïU@O Çž>¥¸›#Êž¬Ô¢ó/cÉÏGÉ6ô;~é*~ZÅÒ&èèÊè‡]ó VtB;:xÔ눓JmÆ^¤Tº› ÃA©âÈî¸}þɞɮ,;'Bº38“]‹_¬üsÌŠªA-_~ ?C‡¼†çÆzr4ŠHºX …ˆ- ÃÚÁà !ÿ“>“]òÎåõruvÒî´ð 9P¡4,Ú)j!–Кj‚5£Ë “x–Ë:#Ù‹TR•° g.’–R}¢(ªòXØÙЮ̲HfF0¸ÐîYøåy„öW¤bØÂô ¢Ô´ÛNrƒ@s…‰EÏØÈ0O‡—àw‚q;»nòKÝûž_¤Ý‹ðKMß5ØÀ½’õË$åÈ”3¢]žnÃÃ,áaaM›-ØùÎéLv~Y–Ä4SKÈs§Ý‘ðËkü“q 1Ï•à%gTÀýìà‰îÏijÉ@YXN†¾Ç‹Ÿ_Ê:ü¤Vø…ô ¹è–kê U1d fgO;2Y ãJ;õÎœv~Â9Æ —W!<‘h£4%[XwPüN8»xé2kKSx Ç8£=ËìâµøÅhÖÅó‚tN'ù\q¡õàöÜyf¯è ç‹$i÷"ü,uŽhPÞ™DsåNAÚÝ×…ì'›§öÐŽ8Þ„“ů:¢ MÀØ¢Ô!GˆÈZ¶×<îž´»;-O¬(®¹© á”i79mürN µ­÷Ú¡ÑÇ©ó0?iwwrJ¢>sT‰Ì^`:*íN¿¼’vèGx[ÑŽs Ux6íÆWîO¶2ó‰E¦ÀR»C2oWÚ&~yÀ/U4I61:vPä‰%ï6Œ»«Îª4&ñÌóˆµõA=;µO§³Çñ}뉠cQŸË¿[ˆSSÄC‘n‡ŽO]üN¿‡EüÈL¦ÑV¡êFÛ0:–ßÀwsǧ%kø¦úáæäv+Tÿ7QzA²ùb¿gŸ ót¨»:+ f¢ÐðU†!È/?ƒ}~ÜîþÃIÁVfYÕÌk•…Ïø Ûv§ˆ_š&PͼøåÕ Ò2'™2èÑšy¿:¶ñ°Vîv³Ùôêþ¤<±R*z¢Ì~quewäÎÃ&üŽ²žÄOrp±0º,½„§h·GOöîjôîMbX¼mà`zvG&ç‚_›ÞÔX4g³0dÓ#8ß3Ùµ°©˜‹SU²»à7:~.,Udäb§D•Ï¹ØåEž?ß3Y‚M.÷ˆ" •(ûöj‡;“¥xßýµv#ßu€GC0r~œJßQ³æE'‰ÁÉ2ÉìŒÏd7làÐåtÿ-¶‡’vxãóÏúÐî0È—\ª@;2ù8RZ XI…ƒØvgC;qyˆì€i翼ñþ—oÇÿù‚7ÿûvüã?áî¯?^]ýøÕwc\£úÛè—ñÕïÿó§oŸ8Ø’IÚý£ÃQÒXN‘›¨PÔ³\ÁÂ@‹ùÖ–ýôj·ãL³‹7¬ú³%ñÞËh–v÷·Ÿ>ßý„7oÿþûöçp÷ÏøãÍÏ«ÒŽh÷×ßÞüøå7”’ÍŸ¥d7Ñ.OæDC ¶M-¼Lkû¨äó¼ ê#úº¤ SÙ!+ÌÙÐ×Õ'æÝì[¼‰ÿÿë]¸æÝüÇÚ}ö_é ¥dóÄáðãœz¿2šø†K¸:¥‘Bz0£5pÉ«ö‰½×<›EYÎŒ|]´+ Í\Q”eÁö|B; ´ûtóèßÔF£¯>° |3ÿq…v¾ýz󌓺­øñ¸Â]Ú¢ùdß5óhi0§Ô°q J'ÌB¬Æ÷´G¯Oœµ'»fFðÉžÓ ôdñëÓÕ—ëOõÍ~ÒnN»æ‰C)YéqE m‡0‘S8(ǽAOkJÈÛÕ£àm× a5Ø×åÉ:ê¬ ¯ˆÕù¸þûß~½ýëŸÿ}¿Ö¶{û×6Ú5O?gÃ;”i\…iQ¸³°(’ÚÙÅmÝi2ïÛÉV_ü–c5ǯ‰vY+Çþ¤$œíþxï½~óþ÷Ê“ýákדõ÷ãÑÚ5Odå~èH¤süæszšy§UÓÎÅIÇÍ°îø¬þ ø´¼ôÞJŸˆWåÉv¦€$¼žttV§‡ÙÒ=ñ“hü³$Ò4'O2%ó$å,áÒDšf݉j*<á¶.¸¼`i:Š–ðÊâv-l†9³~´ënÜÈP+ž„i¡mGÝë"_¤2æE˜3.8[„ M$¯mÚT¡§¾L»WG»ºsEYÍW¦÷u`ñZi—çsü„d–u2Ÿ¨(·içs‘°èü–¤ÞÒß³Û[ŸÇ1sðWæÉ6*¢%FðáO-†ód²zàWÏ+~È?Çšg^’AîdÌJ—§²kCÏ-d×i\eå©R ™øêÎdÛ”!§ŒÙLß¿WÂiK»Z±4Ê”ðã¼Ò'΋´‘-ËÐíaºôüGEÓO*³:(`—í"n#kða¯”v÷èñ×öÚª…è h7êõðhïøù~†QFJÅRXe­DÚÙ$ñKñ‚zF7o5+@*\š¶~¯DiÀ,:)¯Ì“íè ų„:ÌU•MËAœš´[—øô\Ú}ún<þŽÂÇ?Ç?yÿç7”+ðÇ»ž‰ŸöÓ¿ÄhHŠÈˆ4áH;£i؉PÖóî˜Ú®gxF]}¼°Žƒ4µ­‰V¡*%ƒW+í|aYF½„ª'ëR®¢¤je·¾$n·’øô\Ú}øùsø]¿½ÿôéýoþú÷ßßû®_Ôkñ*##ËŒÓO¸v>w‚Œ% µ0 û GºP4 Œ/ ¹¯ÊÇ= Ð ´Ð _/íè<;´Ô¢%?ápq'ñéŸÆW÷£y`øŸŸ¿ uŽK‡GCŽÔç·Ÿñî·3ºçÍ—êw}ø…ÜóÏ×7þ×Û—ž\Tø¡™"*•ÒÏF¨dAC„šX²0뉌ç0Ì/æ%3eLçIÝM”¤ªË ô¾NO68¥$–DݨªNÊ“]J| 'bÚýróéó~åáðhuŽöã/ȱïÂ=ßÿüåóÏß{?F&ÎÆþú?Þ~û׳a¶]×âWÔ– ú®ÎF±98ICUtYÈ…& jóñªðB8:y M’%€´¯Ö“E_¿úÈU/Ž ³¨,Œ9=Û®›øÎÿ;´{W±fùáðh•*ðé›üáž¿¿¾E¹7Bkÿm»ü#XxÏY¼èȼÈ¥ üB;K)n!r­ÑyYÙsÂkY+d“³’ ‘jŠ¢>¶@méîÍ´ ]ŠFA|ûÛjìý9Ñ.A¯Õ8×`gK‹ÛÝwšsôŒ@ ·µÝ }i×Åo² ¿¥Ä§íÔ¡Ýö~åáðhõýÿùëêª[²ín[i‡ë¯·Ÿƒ…÷bÚ~>OÐ¥@ýŒ&ó„ªO[7h7ƒæQIó‘ÑeV£K¥är6w4_ª)l—vM%ûíý™y²ÖÐL- W¢òì´ãpøÝ6ë¹÷ü&÷[l»NâS#ÎÈL›u¤ÝÒÃi秦ÿ©îY²íèÏökeá=?mŠÅ{M^ÒþJoGþP槦h‰-Š’\8¢v¡ö ŠG :ÆõÇ°{óí´»~|‚v§º\Sv ÓTØ/ra¹CS™õáú¡í:‰Od¼Ýâ}7¿|ùôÿæ¶ÝòÃÛ¯½ù³ãÉÞ´ž¬÷¿_ÿ,¼çâEå*»ø٦űðe5jÂ!/+AXÍÕU225 u(Áo¥Ýt<«iwuu3=3O–Iw³Òhç ö#µ8 š¯£µt§ä‰à”ŽF›<ƒž ´øM6á·”øôõ‡ñ[rUÿúðæÛßjOöWï—n‚w@sŸó#ed û½/wn~W¡ãÓùá—çVåù~é~y4Î>·V·ÕH¢Ñ6ç.2ö üF ª"ÄÔ·øf·Ñ‰N^ØF7»†öÃÝÍlÚ…÷õPÕ•ü&/»AüžÀïaŽßâ7ÙŠßîø=lW²Hô ¿í.í‡Ézüv “ð%¿]ìñÝæAJ–.{G™·›‚ cêÖ0½ z»KÑ\¼y5¯Tk‡ºìCý¯7»êÖMxÙ,üx?Pà.à7©>Ðdó'&%K—…OuÓ ¿›ð»éߤ~“Íøí|Jq7ò²û¡þ¢,=âõ —í3žyÙÀøM…ßåp첎°.´»¬ í.ëB»Ëº¬ í.ëB»Ëº¬ í.ëB»Ëº¬'Öÿ‚q‰îÕYÇIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPlottableLegendItem.html0000644000175000017500000015332414030601040027007 0ustar rusconirusconi QCPPlottableLegendItem Class Reference
Public Functions | Protected Functions
QCPPlottableLegendItem Class Reference

A legend item representing a plottable with an icon and the plottable name. More...

Inheritance diagram for QCPPlottableLegendItem:
Inheritance graph

Public Functions

 QCPPlottableLegendItem (QCPLegend *parent, QCPAbstractPlottable *plottable)
 
QCPAbstractPlottable * plottable ()
 
- Public Functions inherited from QCPAbstractLegendItem
 QCPAbstractLegendItem (QCPLegend *parent)
 
QCPLegend * parentLegend () const
 
QFont font () const
 
QColor textColor () const
 
QFont selectedFont () const
 
QColor selectedTextColor () const
 
bool selectable () const
 
bool selected () const
 
void setFont (const QFont &font)
 
void setTextColor (const QColor &color)
 
void setSelectedFont (const QFont &font)
 
void setSelectedTextColor (const QColor &color)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual void update (UpdatePhase phase)
 
virtual QSize maximumOuterSizeHint () const
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QSize minimumOuterSizeHint () const
 
QPen getIconBorderPen () const
 
QColor getTextColor () const
 
QFont getFont () const
 
- Protected Functions inherited from QCPAbstractLegendItem
virtual QCP::Interaction selectionCategory () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 
- Signals inherited from QCPAbstractLegendItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A legend item representing a plottable with an icon and the plottable name.

This is the standard legend item for plottables. It displays an icon of the plottable next to the plottable name. The icon is drawn by the respective plottable itself (QCPAbstractPlottable::drawLegendIcon), and tries to give an intuitive symbol for the plottable. For example, the QCPGraph draws a centered horizontal line and/or a single scatter point in the middle.

Legend items of this type are always associated with one plottable (retrievable via the plottable() function and settable with the constructor). You may change the font of the plottable name with setFont. Icon padding and border pen is taken from the parent QCPLegend, see QCPLegend::setIconBorderPen and QCPLegend::setIconTextPadding.

The function QCPAbstractPlottable::addToLegend/QCPAbstractPlottable::removeFromLegend creates/removes legend items of this type.

Since QCPLegend is based on QCPLayoutGrid, a legend item itself is just a subclass of QCPLayoutElement. While it could be added to a legend (or any other layout) via the normal layout interface, QCPLegend has specialized functions for handling legend items conveniently, see the documentation of QCPLegend.

Constructor & Destructor Documentation

§ QCPPlottableLegendItem()

QCPPlottableLegendItem::QCPPlottableLegendItem ( QCPLegend *  parent,
QCPAbstractPlottable *  plottable 
)

Creates a new legend item associated with plottable.

Once it's created, it can be added to the legend via QCPLegend::addItem.

A more convenient way of adding/removing a plottable to/from the legend is via the functions QCPAbstractPlottable::addToLegend and QCPAbstractPlottable::removeFromLegend.

Member Function Documentation

§ draw()

void QCPPlottableLegendItem::draw ( QCPPainter *  painter)
protectedvirtual

Draws the item with painter. The size and position of the drawn legend item is defined by the parent layout (typically a QCPLegend) and the minimumOuterSizeHint and maximumOuterSizeHint of this legend item.

Implements QCPAbstractLegendItem.

§ minimumOuterSizeHint()

QSize QCPPlottableLegendItem::minimumOuterSizeHint ( ) const
protectedvirtual

Calculates and returns the size of this item. This includes the icon, the text and the padding in between.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayoutElement.

§ getIconBorderPen()

QPen QCPPlottableLegendItem::getIconBorderPen ( ) const
protected

Returns the pen that shall be used to draw the icon border, taking into account the selection state of this item.

§ getTextColor()

QColor QCPPlottableLegendItem::getTextColor ( ) const
protected

Returns the text color that shall be used to draw text, taking into account the selection state of this item.

§ getFont()

QFont QCPPlottableLegendItem::getFont ( ) const
protected

Returns the font that shall be used to draw text, taking into account the selection state of this item.

The documentation for this class was generated from the following files:
  • src/layoutelements/layoutelement-legend.h
  • src/layoutelements/layoutelement-legend.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayerable.html0000644000175000017500000026104414030601040025022 0ustar rusconirusconi QCPLayerable Class Reference
Public Functions | Signals | Protected Functions
QCPLayerable Class Referenceabstract

Base class for all drawable objects. More...

Inheritance diagram for QCPLayerable:
Inheritance graph

Public Functions

 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
bool realVisibility () const
 

Signals

void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const =0
 
virtual void draw (QCPPainter *painter)=0
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

Base class for all drawable objects.

This is the abstract base class most visible objects derive from, e.g. plottables, axes, grid etc.

Every layerable is on a layer (QCPLayer) which allows controlling the rendering order by stacking the layers accordingly.

For details about the layering mechanism, see the QCPLayer documentation.

Constructor & Destructor Documentation

§ QCPLayerable()

QCPLayerable::QCPLayerable ( QCustomPlot *  plot,
QString  targetLayer = QString(),
QCPLayerable *  parentLayerable = nullptr 
)

Creates a new QCPLayerable instance.

Since QCPLayerable is an abstract base class, it can't be instantiated directly. Use one of the derived classes.

If plot is provided, it automatically places itself on the layer named targetLayer. If targetLayer is an empty string, it places itself on the current layer of the plot (see QCustomPlot::setCurrentLayer).

It is possible to provide nullptr as plot. In that case, you should assign a parent plot at a later time with initializeParentPlot.

The layerable's parent layerable is set to parentLayerable, if provided. Direct layerable parents are mainly used to control visibility in a hierarchy of layerables. This means a layerable is only drawn, if all its ancestor layerables are also visible. Note that parentLayerable does not become the QObject-parent (for memory management) of this layerable, plot does. It is not uncommon to set the QObject-parent to something else in the constructors of QCPLayerable subclasses, to guarantee a working destruction hierarchy.

Member Function Documentation

§ parentLayerable()

QCPLayerable * QCPLayerable::parentLayerable ( ) const
inline

Returns the parent layerable of this layerable. The parent layerable is used to provide visibility hierarchies in conjunction with the method realVisibility. This way, layerables only get drawn if their parent layerables are visible, too.

Note that a parent layerable is not necessarily also the QObject parent for memory management. Further, a layerable doesn't always have a parent layerable, so this function may return nullptr.

A parent layerable is set implicitly when placed inside layout elements and doesn't need to be set manually by the user.

§ setVisible()

void QCPLayerable::setVisible ( bool  on)

Sets the visibility of this layerable object. If an object is not visible, it will not be drawn on the QCustomPlot surface, and user interaction with it (e.g. click and selection) is not possible.

§ setLayer() [1/2]

bool QCPLayerable::setLayer ( QCPLayer *  layer)

Sets the layer of this layerable object. The object will be placed on top of the other objects already on layer.

If layer is 0, this layerable will not be on any layer and thus not appear in the plot (or interact/receive events).

Returns true if the layer of this layerable was successfully changed to layer.

§ setLayer() [2/2]

bool QCPLayerable::setLayer ( const QString &  layerName)

This is an overloaded function. Sets the layer of this layerable object by name

Returns true on success, i.e. if layerName is a valid layer name.

§ setAntialiased()

void QCPLayerable::setAntialiased ( bool  enabled)

Sets whether this object will be drawn antialiased or not.

Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

§ selectTest()

double QCPLayerable::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Reimplemented in QCPLayoutInset, QCPAxis, QCPLegend, QCPBars, QCPPolarAxisRadial, QCPAbstractItem, QCPPolarAxisAngular, QCPPolarGraph, QCPLayoutElement, QCPFinancial, QCPAbstractPlottable, QCPColorMap, QCPErrorBars, QCPGraph, QCPStatisticalBox, QCPCurve, QCPItemTracer, QCPItemText, QCPTextElement, QCPItemBracket, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, QCPAbstractPlottable1D< QCPCurveData >, QCPAbstractLegendItem, QCPItemPixmap, QCPItemCurve, QCPItemLine, QCPItemEllipse, QCPItemRect, and QCPItemStraightLine.

§ realVisibility()

bool QCPLayerable::realVisibility ( ) const

Returns whether this layerable is visible, taking the visibility of the layerable parent and the visibility of this layerable's layer into account. This is the method that is consulted to decide whether a layerable shall be drawn or not.

If this layerable has a direct layerable parent (usually set via hierarchies implemented in subclasses, like in the case of QCPLayoutElement), this function returns true only if this layerable has its visibility set to true and the parent layerable's realVisibility returns true.

§ layerChanged

void QCPLayerable::layerChanged ( QCPLayer *  newLayer)
signal

This signal is emitted when the layer of this layerable changes, i.e. this layerable is moved to a different layer.

See also
setLayer

§ parentPlotInitialized()

void QCPLayerable::parentPlotInitialized ( QCustomPlot *  parentPlot)
protectedvirtual

This function is called by initializeParentPlot, to allow subclasses to react on the setting of a parent plot. This is the case when nullptr was passed as parent plot in the constructor, and the parent plot is set at a later time.

For example, QCPLayoutElement/QCPLayout hierarchies may be created independently of any QCustomPlot at first. When they are then added to a layout inside the QCustomPlot, the top level element of the hierarchy gets its parent plot initialized with initializeParentPlot. To propagate the parent plot to all the children of the hierarchy, the top level element then uses this function to pass the parent plot on to its child elements.

The default implementation does nothing.

See also
initializeParentPlot

Reimplemented in QCPLegend, and QCPLayoutElement.

§ selectionCategory()

QCP::Interaction QCPLayerable::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPLegend, QCPAbstractItem, QCPAbstractPlottable, QCPPolarGraph, and QCPAbstractLegendItem.

§ clipRect()

QRect QCPLayerable::clipRect ( ) const
protectedvirtual

Returns the clipping rectangle of this layerable object. By default, this is the viewport of the parent QCustomPlot. Specific subclasses may reimplement this function to provide different clipping rects.

The returned clipping rect is set on the painter before the draw function of the respective object is called.

Reimplemented in QCPAbstractItem, QCPAbstractPlottable, QCPPolarGraph, and QCPAbstractLegendItem.

§ applyDefaultAntialiasingHint()

void QCPLayerable::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedpure virtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Implemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPLegend, QCPAbstractItem, QCPAbstractPlottable, QCPPolarGraph, QCPLayoutElement, QCPAxisRect, QCPColorScale, QCPTextElement, QCPPolarGrid, QCPGrid, QCPAbstractLegendItem, and QCPSelectionRect.

§ draw()

void QCPLayerable::draw ( QCPPainter *  painter)
protectedpure virtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPLegend, QCPBars, QCPAbstractItem, QCPAbstractPlottable, QCPPolarGraph, QCPColorMap, QCPLayoutElement, QCPFinancial, QCPAxisRect, QCPErrorBars, QCPGraph, QCPStatisticalBox, QCPCurve, QCPPlottableLegendItem, QCPItemText, QCPItemTracer, QCPTextElement, QCPPolarGrid, QCPGrid, QCPAbstractLegendItem, QCPItemPixmap, QCPItemBracket, QCPItemEllipse, QCPItemRect, QCPSelectionRect, QCPItemCurve, QCPItemLine, QCPItemStraightLine, and QCPPolarLegendItem.

§ selectEvent()

void QCPLayerable::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented in QCPAxis, QCPPolarAxisRadial, QCPLegend, QCPAbstractItem, QCPAbstractPlottable, QCPPolarGraph, QCPTextElement, and QCPAbstractLegendItem.

§ deselectEvent()

void QCPLayerable::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented in QCPAxis, QCPPolarAxisRadial, QCPLegend, QCPAbstractItem, QCPAbstractPlottable, QCPPolarGraph, QCPTextElement, and QCPAbstractLegendItem.

§ mousePressEvent()

void QCPLayerable::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

This event gets called when the user presses a mouse button while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to selectTest.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter details contains layerable-specific details about the hit, which were generated in the previous call to selectTest. For example, One-dimensional plottables like QCPGraph or QCPBars convey the clicked data point in the details parameter, as QCPDataSelection packed as QVariant. Multi-part objects convey the specific SelectablePart that was hit (e.g. QCPAxis::SelectablePart in the case of axes).

QCustomPlot uses an event propagation system that works the same as Qt's system. If your layerable doesn't reimplement the mousePressEvent or explicitly calls event->ignore() in its reimplementation, the event will be propagated to the next layerable in the stacking order.

Once a layerable has accepted the mousePressEvent, it is considered the mouse grabber and will receive all following calls to mouseMoveEvent or mouseReleaseEvent for this mouse interaction (a "mouse interaction" in this context ends with the release).

The default implementation does nothing except explicitly ignoring the event with event->ignore().

See also
mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPAxisRect, QCPColorScale, and QCPTextElement.

§ mouseMoveEvent()

void QCPLayerable::mouseMoveEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This event gets called when the user moves the mouse while holding a mouse button, after this layerable has become the mouse grabber by accepting the preceding mousePressEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter startPos indicates the position where the initial mousePressEvent occurred, that started the mouse interaction.

The default implementation does nothing.

See also
mousePressEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPAxisRect, and QCPColorScale.

§ mouseReleaseEvent()

void QCPLayerable::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This event gets called when the user releases the mouse button, after this layerable has become the mouse grabber by accepting the preceding mousePressEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter startPos indicates the position where the initial mousePressEvent occurred, that started the mouse interaction.

The default implementation does nothing.

See also
mousePressEvent, mouseMoveEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPAxisRect, QCPColorScale, and QCPTextElement.

§ mouseDoubleClickEvent()

void QCPLayerable::mouseDoubleClickEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

This event gets called when the user presses the mouse button a second time in a double-click, while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to selectTest.

The mouseDoubleClickEvent is called instead of the second mousePressEvent. So in the case of a double-click, the event succession is pressEvent – releaseEvent – doubleClickEvent – releaseEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter details contains layerable-specific details about the hit, which were generated in the previous call to selectTest. For example, One-dimensional plottables like QCPGraph or QCPBars convey the clicked data point in the details parameter, as QCPDataSelection packed as QVariant. Multi-part objects convey the specific SelectablePart that was hit (e.g. QCPAxis::SelectablePart in the case of axes).

Similarly to mousePressEvent, once a layerable has accepted the mouseDoubleClickEvent, it is considered the mouse grabber and will receive all following calls to mouseMoveEvent and mouseReleaseEvent for this mouse interaction (a "mouse interaction" in this context ends with the release).

The default implementation does nothing except explicitly ignoring the event with event->ignore().

See also
mousePressEvent, mouseMoveEvent, mouseReleaseEvent, wheelEvent

Reimplemented in QCPTextElement.

§ wheelEvent()

void QCPLayerable::wheelEvent ( QWheelEvent *  event)
protectedvirtual

This event gets called when the user turns the mouse scroll wheel while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to selectTest.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos().

The event->angleDelta() indicates how far the mouse wheel was turned, which is usually +/- 120 for single rotation steps. However, if the mouse wheel is turned rapidly, multiple steps may accumulate to one event, making the delta larger. On the other hand, if the wheel has very smooth steps or none at all, the delta may be smaller.

The default implementation does nothing.

See also
mousePressEvent, mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent

Reimplemented in QCPAxis, QCPPolarAxisAngular, QCPPolarAxisRadial, QCPAxisRect, and QCPColorScale.

§ initializeParentPlot()

void QCPLayerable::initializeParentPlot ( QCustomPlot *  parentPlot)
protected

Sets the parent plot of this layerable. Use this function once to set the parent plot if you have passed nullptr in the constructor. It can not be used to move a layerable from one QCustomPlot to another one.

Note that, unlike when passing a non nullptr parent plot in the constructor, this function does not make parentPlot the QObject-parent of this layerable. If you want this, call QObject::setParent(parentPlot) in addition to this function.

Further, you will probably want to set a layer (setLayer) after calling this function, to make the layerable appear on the QCustomPlot.

The parent plot change will be propagated to subclasses via a call to parentPlotInitialized so they can react accordingly (e.g. also initialize the parent plot of child layerables, like QCPLayout does).

§ setParentLayerable()

void QCPLayerable::setParentLayerable ( QCPLayerable *  parentLayerable)
protected

Sets the parent layerable of this layerable to parentLayerable. Note that parentLayerable does not become the QObject-parent (for memory management) of this layerable.

The parent layerable has influence on the return value of the realVisibility method. Only layerables with a fully visible parent tree will return true for realVisibility, and thus be drawn.

See also
realVisibility

§ moveToLayer()

bool QCPLayerable::moveToLayer ( QCPLayer *  layer,
bool  prepend 
)
protected

Moves this layerable object to layer. If prepend is true, this object will be prepended to the new layer's list, i.e. it will be drawn below the objects already on the layer. If it is false, the object will be appended.

Returns true on success, i.e. if layer is a valid layer.

§ applyAntialiasingHint()

void QCPLayerable::applyAntialiasingHint ( QCPPainter *  painter,
bool  localAntialiased,
QCP::AntialiasedElement  overrideElement 
) const
protected

Sets the QCPainter::setAntialiasing state on the provided painter, depending on the localAntialiased value as well as the overrides QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements. Which override enum this function takes into account is controlled via overrideElement.

The documentation for this class was generated from the following files:
  • src/layer.h
  • src/layer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemLine.png0000644000175000017500000000242314030601041023415 0ustar rusconirusconi‰PNG  IHDRæ /µàøgAMA† 1è–_ÀPLTEÿÿÿêêÿ01ÿPPÿÿooÿÓÑÿ³³ÿ‘‘ÿÿõõùÿqq¤ÒèèèOOO ppp888²²²(((ÐÐÐ’’’ ^ÿ´óÿÈYÿ$ÿÝþÿ©7ÿ Lÿèþÿ·Qÿþçÿ‚Úÿ) ÿTÃÿõ¹ÿuÖÿ<­ÿùÔÿ"`ÿq'ÿ 5ÿÇ÷ÿ]ÿé’ÿÿá{ÿï®ÿM¤ÿèÿ‹ÿÏhÿ,ÿš!؈ˆª‘-ÿÒºÿ’íbKGDˆH pHYsÃÃÇo¨dzIDATxÚíÜ‹Râ0àÐZBµ ˆW(·Š¨ÜdQÁ½¾ÿ[mÒÖ\·d“üß0:e OU—³gõðä\uû CzdrHŸ•EH«ÕUìùé™ê"öáì!5‹U!­kÒ‹Æ–«fÔjuº½¨õü•cR}· qp¹y÷¯ü:î߈×Ë+uRÕõ~ÜmŸh8">îŽ8E“Ÿ—WŒÝñIsÖeíŽ|­(WEHu{õ¢.+ÜòKù›.yÿhØM®k»â%–n÷묵þ&ýB:¢{&‹GA@7þÀ²6;,kóŽ7^¿M„T¯}}| ecÍÙD„p½Í…\´c¹|7ߧ׾þVܯY_³vÔ§w3W,YÎÉ#h™t»…©6‡ï¿g#{ÍÒ»)¯D_s±T{Dã ßz·<|ëÒMÓeúù6½»Ûéø¸éZ],ßý6½Bú Ø×ç\ûî‡oÓXRí· ;9¶*¤ª‹Ø„Ô8Ú¾ÿ–Ü×ÛRߟcÂá{'V…Ôž-ƒ-!µfË`IH­Ú×ÛR«öõvüy ߦ±*¤Ø×åLÏ?Où8‹ß©apø6ŽM[†Õš{s×BzRQ]N~VBÖ îóe_†5s×­”¾kÆ÷™¾E›¢Ï"+8žêròS©‡Ò/xN º˜üœ‡©o®ã›»t«Y—áù®¡ÓÐY—ߟ¾Ë¡oÇ5xÙŠ|þ8ü)Û,:ŽêRòæeßàgm"(|ÏÐd®(ò²œo·ÿûà_ÉÆe›Q+žRƒ­Ì|%m3î_ÅÓˆ7ØÚÌ·Æzœ¢Æ€÷¾dìOÚ”C³¿åÔå«™o]Íù›tó֜®Ù(i³ý<\Ê6f¾µ´ Ω#g³¡ý´­ÇËÚÜ2ó­¡tÖùÝ6'Ÿû ÿ…9]±x’µ9§Kö˜´)ÿ…AÚæ3ߺ ºÏÚ î$m&&Þžù6ÁN3ßúÛqæÔø4T„È–!%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_y.html0000644000175000017500000000250514030601037024071 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- y -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_p.html0000644000175000017500000001457414030601037024071 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- p -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_w.html0000644000175000017500000000602214030601037024065 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- w -

qcustomplot-2.1.0+dfsg1/documentation/html/index.html0000644000175000017500000004423014030601036022640 0ustar rusconirusconi QCustomPlot 2.1.0 Documentation
QCustomPlot 2.1.0 Documentation
qcp-doc-logo.png

If you are new to QCustomPlot and just want to start using it, it's recommended to look at the tutorials and examples at

http://www.qcustomplot.com/

This documentation is especially helpful as a reference, when you're familiar with the basics of data visualization with QCustomPlot and you wish to learn more about specific functionality or more advanced concepts. See the class overview for diagrams explaining the relationships between the most important classes of the QCustomPlot library.

Plottables

Plottables are classes that display any kind of data in QCustomPlot. They all derive from QCPAbstractPlottable. For example, QCPGraph is a plottable that displays a graph with different line styles, scatter styles, filling etc.

Since plotting graphs is such a dominant use case, QCustomPlot has a special interface for working with QCPGraph plottables, that makes it very easy to handle them:
A new graph can be created with QCustomPlot::addGraph and accessed with QCustomPlot::graph.

For all other plottables, the normal plottable interface is used: First, an instance of the respective plottable is created and added to the QCustomPlot, e.g.

QCPCurve *newCurve = new QCPCurve(customPlot->xAxis, customPlot->yAxis);

The properties of the newly created plottable can then be accessed via the newCurve pointer.

Plottables (including graphs) can be retrieved via QCustomPlot::plottable. Since the return type of that function is the abstract base class of all plottables, QCPAbstractPlottable, you will probably want to qobject_cast the returned pointer to the respective plottable subclass. As usual, the cast returns nullptr if the plottable wasn't of that specific subclass.

All further interfacing with plottables (e.g how to set data) is specific to the plottable type. See the documentations of the subclasses: QCPGraph, QCPCurve, QCPBars, QCPStatisticalBox, QCPColorMap, QCPFinancial.

Controlling the Axes

QCustomPlot has four default axes: xAxis (bottom), yAxis (left), xAxis2 (top), yAxis2 (right).

Their range is handled by the simple QCPRange class which basically holds the lower and upper axis coordinate. You can set the range with the QCPAxis::setRange function. To change the axis scale type from a linear scale to a logarithmic scale, set QCPAxis::setScaleType to QCPAxis::stLogarithmic. In that case you will also want logarithmically spaced ticks and tick labels, so set the axis ticker with QCPAxis::setTicker to a QCPAxisTickerLog instance.

Each axis can be given an axis label (e.g. "Voltage (mV)") with QCPAxis::setLabel.

By default, an axis automatically creates and labels ticks in a sensible manner. See the various methods of the QCPAxis documentation for fine-tuning. Ticks can be disabled for an axis via QCPAxis::setTicks. If you only wish to hide tick labels (the numbers), use QCPAxis::setTickLabels. Note that the default right and top axes start out with hidden tick labels.

The distance of an axis backbone to the respective viewport/widget border is called its margin. Normally, the margins are calculated automatically to fit the axis and tick labels. To change this, set QCPAxisRect::setAutoMargins to exclude the respective margin sides, and set the margins manually with QCPAxisRect::setMargins. The main axis rect can be accessed with QCustomPlot::axisRect(). A detailed explanation of the different margins/paddings/offset options is given in the QCPAxisRect and QCPAxis documentation.

Plot Legend

Every QCustomPlot has one QCPLegend (as QCustomPlot::legend) by default. A legend is a small layout element inside the plot which lists the plottables with an icon of the plottable line/symbol and a name (QCPAbstractPlottable::setName). Plottables can be added and removed from the legend via QCPAbstractPlottable::addToLegend and QCPAbstractPlottable::removeFromLegend. By default, adding a plottable to QCustomPlot automatically adds it to the legend, too. This behaviour can be changed with the QCustomPlot::setAutoAddPlottableToLegend property.

QCPLegend provides an interface to access, add and remove legend items directly, too. See QCPLegend::item, QCPLegend::itemWithPlottable, QCPLegend::addItem, QCPLegend::removeItem for example.

Multiple legends are supported via the layout system (since a QCPLegend is a normal layout element).

User Interaction

QCustomPlot supports dragging axis ranges with the mouse (QCPAxisRect::setRangeDrag), zooming axis ranges with the mouse wheel (QCPAxisRect::setRangeZoom) and a complete selection mechanism with configurable granularity down to data points and data ranges.

The availability of these interactions is controlled with QCustomPlot::setInteractions. For details about the interaction system, see the documentation there. The data selection is discussed in detail on the dedicated Data Selection Mechanism page.

Further, QCustomPlot always emits corresponding signals, when objects are clicked or doubleClicked. See QCustomPlot::plottableClick, QCustomPlot::plottableDoubleClick and QCustomPlot::axisClick for example.

Finally on the lowest level you can work with the QCPLayerable mouse event virtual methods in own subclasses, that the QCustomPlot instance calls on the affected layerable.

Decorations and Auxiliary Items

Apart from plottables there is another category of plot objects that are important: Items. The base class of all items is QCPAbstractItem. An item sets itself apart from plottables in that it's not necessarily bound to any axes. This means it may also be positioned in absolute pixel coordinates or placed at a relative position on an axis rect. Further, it usually doesn't represent data directly, but acts as decoration, emphasis, description etc.

Multiple items can be arranged in a parent-child-hierarchy allowing for dynamical behaviour. For example, you could place the head of an arrow at a fixed plot coordinate, so it always points to some important area in the plot. The tail of the arrow can be anchored to a text item which always resides in the top center of the axis rect, independent of where the user drags the axis ranges. This way the arrow stretches and turns so it always points from the label to the specified plot coordinate, without any further code necessary.

For a more detailed introduction, see the QCPAbstractItem documentation, and from there the documentations of the individual standard items, to find out how to use them.

Layout Elements and Layouts

QCustomPlot uses an internal layout system to provide dynamic sizing and positioning of objects like the axis rect(s), legends, color scales, and other layout elements. They are all based on QCPLayoutElement and are arranged by placing them inside a QCPLayout subclass, like QCPLayoutGrid.

See the page about the layout system for details.

OpenGL Accelerated Plotting and Performance Improvement

QCustomPlot has multiple OpenGL backends to provide OpenGL hardware accelerated plotting across all supported Qt versions. If the computer supports OpenGL, you can enable it by compiling with QCUSTOMPLOT_USE_OPENGL and simply calling setOpenGl(true) on the respective QCustomPlot instance. More details are given in the documentation of that method.

Information on maximizing plot performance for demanding visualization tasks can be found on the dedicated page about Plot Performance Improvement.

Preprocessor Define Flags

QCustomPlot understands some preprocessor defines that are useful for debugging and compilation. The flags must be defined before including the QCustomPlot header. Usually it's best to add them to your qmake project file, using e.g. DEFINES += QCUSTOMPLOT_USE_OPENGL

QCUSTOMPLOT_USE_OPENGL
If this flag is defined, QCustomPlot can use OpenGL to improve plot performance for graphically demanding plots, see QCustomPlot::setOpenGl.
QCUSTOMPLOT_COMPILE_LIBRARY
Define this flag when compiling QCustomPlot as a shared library (.so/.dll)
QCUSTOMPLOT_USE_LIBRARY
Define this flag before including the header, when using QCustomPlot as a shared library
QCUSTOMPLOT_CHECK_DATA
If this flag is defined, the QCustomPlot plottables will perform data validity checks on every redraw. They will give qDebug output when encountering inf or nan values (also if silent NaNs are used intentionally to create gaps in graphs).

Using QCustomPlot with special Qt flags

See the page Special Qt Flags if your project uses QT_NO_CAST_FROM_ASCII, QT_NO_CAST_TO_ASCII or QT_NO_KEYWORDS.







qcustomplot-2.1.0+dfsg1/documentation/html/classQCPGrid.html0000644000175000017500000010640614030601040024007 0ustar rusconirusconi QCPGrid Class Reference
Public Functions | Protected Functions
QCPGrid Class Reference

Responsible for drawing the grid of a QCPAxis. More...

Inheritance diagram for QCPGrid:
Inheritance graph

Public Functions

 QCPGrid (QCPAxis *parentAxis)
 
bool subGridVisible () const
 
bool antialiasedSubGrid () const
 
bool antialiasedZeroLine () const
 
QPen pen () const
 
QPen subGridPen () const
 
QPen zeroLinePen () const
 
void setSubGridVisible (bool visible)
 
void setAntialiasedSubGrid (bool enabled)
 
void setAntialiasedZeroLine (bool enabled)
 
void setPen (const QPen &pen)
 
void setSubGridPen (const QPen &pen)
 
void setZeroLinePen (const QPen &pen)
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
bool realVisibility () const
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
void drawGridLines (QCPPainter *painter) const
 
void drawSubGridLines (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

Responsible for drawing the grid of a QCPAxis.

This class is tightly bound to QCPAxis. Every axis owns a grid instance and uses it to draw the grid lines, sub grid lines and zero-line. You can interact with the grid of an axis via QCPAxis::grid. Normally, you don't need to create an instance of QCPGrid yourself.

The axis and grid drawing was split into two classes to allow them to be placed on different layers (both QCPAxis and QCPGrid inherit from QCPLayerable). Thus it is possible to have the grid in the background and the axes in the foreground, and any plottables/items in between. This described situation is the default setup, see the QCPLayer documentation.

Constructor & Destructor Documentation

§ QCPGrid()

QCPGrid::QCPGrid ( QCPAxis *  parentAxis)
explicit

Creates a QCPGrid instance and sets default values.

You shouldn't instantiate grids on their own, since every QCPAxis brings its own QCPGrid.

Member Function Documentation

§ setSubGridVisible()

void QCPGrid::setSubGridVisible ( bool  visible)

Sets whether grid lines at sub tick marks are drawn.

See also
setSubGridPen

§ setAntialiasedSubGrid()

void QCPGrid::setAntialiasedSubGrid ( bool  enabled)

Sets whether sub grid lines are drawn antialiased.

§ setAntialiasedZeroLine()

void QCPGrid::setAntialiasedZeroLine ( bool  enabled)

Sets whether zero lines are drawn antialiased.

§ setPen()

void QCPGrid::setPen ( const QPen &  pen)

Sets the pen with which (major) grid lines are drawn.

§ setSubGridPen()

void QCPGrid::setSubGridPen ( const QPen &  pen)

Sets the pen with which sub grid lines are drawn.

§ setZeroLinePen()

void QCPGrid::setZeroLinePen ( const QPen &  pen)

Sets the pen with which zero lines are drawn.

Zero lines are lines at value coordinate 0 which may be drawn with a different pen than other grid lines. To disable zero lines and just draw normal grid lines at zero, set pen to Qt::NoPen.

§ applyDefaultAntialiasingHint()

void QCPGrid::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing the major grid lines.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

See also
setAntialiased

Implements QCPLayerable.

§ draw()

void QCPGrid::draw ( QCPPainter *  painter)
protectedvirtual

Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning over the complete axis rect. Also draws the zero line, if appropriate (setZeroLinePen).

Implements QCPLayerable.

§ drawGridLines()

void QCPGrid::drawGridLines ( QCPPainter *  painter) const
protected

Draws the main grid lines and possibly a zero line with the specified painter.

This is a helper function called by draw.

§ drawSubGridLines()

void QCPGrid::drawSubGridLines ( QCPPainter *  painter) const
protected

Draws the sub grid lines with the specified painter.

This is a helper function called by draw.

The documentation for this class was generated from the following files:
  • src/axis/axis.h
  • src/axis/axis.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractItem.html0000644000175000017500000024244014030601040025503 0ustar rusconirusconi QCPAbstractItem Class Reference
Public Functions | Signals | Protected Functions
QCPAbstractItem Class Referenceabstract

The abstract base class for all items in a plot. More...

Inheritance diagram for QCPAbstractItem:
Inheritance graph

Public Functions

 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const =0
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)=0
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

The abstract base class for all items in a plot.

In QCustomPlot, items are supplemental graphical elements that are neither plottables (QCPAbstractPlottable) nor axes (QCPAxis). While plottables are always tied to two axes and thus plot coordinates, items can also be placed in absolute coordinates independent of any axes. Each specific item has at least one QCPItemPosition member which controls the positioning. Some items are defined by more than one coordinate and thus have two or more QCPItemPosition members (For example, QCPItemRect has topLeft and bottomRight).

This abstract base class defines a very basic interface like visibility and clipping. Since this class is abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to create new items.

The built-in items are:

QCPItemLineA line defined by a start and an end point. May have different ending styles on each side (e.g. arrows).
QCPItemStraightLineA straight line defined by a start and a direction point. Unlike QCPItemLine, the straight line is infinitely long and has no endings.
QCPItemCurveA curve defined by start, end and two intermediate control points. May have different ending styles on each side (e.g. arrows).
QCPItemRectA rectangle
QCPItemEllipseAn ellipse
QCPItemPixmapAn arbitrary pixmap
QCPItemTextA text label
QCPItemBracketA bracket which may be used to reference/highlight certain parts in the plot.
QCPItemTracerAn item that can be attached to a QCPGraph and sticks to its data points, given a key coordinate.

Clipping

Items are by default clipped to the main axis rect (they are only visible inside the axis rect). To make an item visible outside that axis rect, disable clipping via setClipToAxisRect(false).

On the other hand if you want the item to be clipped to a different axis rect, specify it via setClipAxisRect. This clipAxisRect property of an item is only used for clipping behaviour, and in principle is independent of the coordinate axes the item might be tied to via its position members (QCPItemPosition::setAxes). However, it is common that the axis rect for clipping also contains the axes used for the item positions.

Using items

First you instantiate the item you want to use and add it to the plot:

QCPItemLine *line = new QCPItemLine(customPlot);

by default, the positions of the item are bound to the x- and y-Axis of the plot. So we can just set the plot coordinates where the line should start/end:

line->start->setCoords(-0.1, 0.8);
line->end->setCoords(1.1, 0.2);

If we don't want the line to be positioned in plot coordinates but a different coordinate system, e.g. absolute pixel positions on the QCustomPlot surface, we need to change the position type like this:

line->start->setType(QCPItemPosition::ptAbsolute);
line->end->setType(QCPItemPosition::ptAbsolute);

Then we can set the coordinates, this time in pixels:

line->start->setCoords(100, 200);
line->end->setCoords(450, 320);

and make the line visible on the entire QCustomPlot, by disabling clipping to the axis rect:

line->setClipToAxisRect(false);

For more advanced plots, it is even possible to set different types and parent anchors per X/Y coordinate of an item position, using for example QCPItemPosition::setTypeX or QCPItemPosition::setParentAnchorX. For details, see the documentation of QCPItemPosition.

Creating own items

To create an own item, you implement a subclass of QCPAbstractItem. These are the pure virtual functions, you must implement:

See the documentation of those functions for what they need to do.

Allowing the item to be positioned

As mentioned, item positions are represented by QCPItemPosition members. Let's assume the new item shall have only one point as its position (as opposed to two like a rect or multiple like a polygon). You then add a public member of type QCPItemPosition like so:

QCPItemPosition * const myPosition;

the const makes sure the pointer itself can't be modified from the user of your new item (the QCPItemPosition instance it points to, can be modified, of course). The initialization of this pointer is made easy with the createPosition function. Just assign the return value of this function to each QCPItemPosition in the constructor of your item. createPosition takes a string which is the name of the position, typically this is identical to the variable name. For example, the constructor of QCPItemExample could look like this:

QCPItemExample::QCPItemExample(QCustomPlot *parentPlot) :
QCPAbstractItem(parentPlot),
myPosition(createPosition("myPosition"))
{
// other constructor code
}

The draw function

To give your item a visual representation, reimplement the draw function and use the passed QCPPainter to draw the item. You can retrieve the item position in pixel coordinates from the position member(s) via QCPItemPosition::pixelPosition.

To optimize performance you should calculate a bounding rect first (don't forget to take the pen width into account), check whether it intersects the clipRect, and only draw the item at all if this is the case.

The selectTest function

Your implementation of the selectTest function may use the helpers QCPVector2D::distanceSquaredToLine and rectDistance. With these, the implementation of the selection test becomes significantly simpler for most items. See the documentation of selectTest for what the function parameters mean and what the function should return.

Providing anchors

Providing anchors (QCPItemAnchor) starts off like adding a position. First you create a public member, e.g.

QCPItemAnchor * const bottom;

and create it in the constructor with the createAnchor function, assigning it a name and an anchor id (an integer enumerating all anchors on the item, you may create an own enum for this). Since anchors can be placed anywhere, relative to the item's position(s), your item needs to provide the position of every anchor with the reimplementation of the anchorPixelPosition(int anchorId) function.

In essence the QCPItemAnchor is merely an intermediary that itself asks your item for the pixel position when anything attached to the anchor needs to know the coordinates.

Constructor & Destructor Documentation

§ QCPAbstractItem()

QCPAbstractItem::QCPAbstractItem ( QCustomPlot *  parentPlot)
explicit

Base class constructor which initializes base class members.

Member Function Documentation

§ setClipToAxisRect()

void QCPAbstractItem::setClipToAxisRect ( bool  clip)

Sets whether the item shall be clipped to an axis rect or whether it shall be visible on the entire QCustomPlot. The axis rect can be set with setClipAxisRect.

See also
setClipAxisRect

§ setClipAxisRect()

void QCPAbstractItem::setClipAxisRect ( QCPAxisRect *  rect)

Sets the clip axis rect. It defines the rect that will be used to clip the item when setClipToAxisRect is set to true.

See also
setClipToAxisRect

§ setSelectable()

void QCPAbstractItem::setSelectable ( bool  selectable)

Sets whether the user can (de-)select this item by clicking on the QCustomPlot surface. (When QCustomPlot::setInteractions contains QCustomPlot::iSelectItems.)

However, even when selectable was set to false, it is possible to set the selection manually, by calling setSelected.

See also
QCustomPlot::setInteractions, setSelected

§ setSelected()

void QCPAbstractItem::setSelected ( bool  selected)

Sets whether this item is selected or not. When selected, it might use a different visual appearance (e.g. pen and brush), this depends on the specific item though.

The entire selection mechanism for items is handled automatically when QCustomPlot::setInteractions contains QCustomPlot::iSelectItems. You only need to call this function when you wish to change the selection state manually.

This function can change the selection state even when setSelectable was set to false.

emits the selectionChanged signal when selected is different from the previous selection state.

See also
setSelectable, selectTest

§ selectTest()

virtual double QCPAbstractItem::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
pure virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Reimplemented from QCPLayerable.

Implemented in QCPItemTracer, QCPItemText, QCPItemBracket, QCPItemPixmap, QCPItemCurve, QCPItemLine, QCPItemEllipse, QCPItemRect, and QCPItemStraightLine.

§ positions()

QList< QCPItemPosition * > QCPAbstractItem::positions ( ) const
inline

Returns all positions of the item in a list.

See also
anchors, position

§ anchors()

QList< QCPItemAnchor * > QCPAbstractItem::anchors ( ) const
inline

Returns all anchors of the item in a list. Note that since a position (QCPItemPosition) is always also an anchor, the list will also contain the positions of this item.

See also
positions, anchor

§ position()

QCPItemPosition * QCPAbstractItem::position ( const QString &  name) const

Returns the QCPItemPosition with the specified name. If this item doesn't have a position by that name, returns nullptr.

This function provides an alternative way to access item positions. Normally, you access positions direcly by their member pointers (which typically have the same variable name as name).

See also
positions, anchor

§ anchor()

QCPItemAnchor * QCPAbstractItem::anchor ( const QString &  name) const

Returns the QCPItemAnchor with the specified name. If this item doesn't have an anchor by that name, returns nullptr.

This function provides an alternative way to access item anchors. Normally, you access anchors direcly by their member pointers (which typically have the same variable name as name).

See also
anchors, position

§ hasAnchor()

bool QCPAbstractItem::hasAnchor ( const QString &  name) const

Returns whether this item has an anchor with the specified name.

Note that you can check for positions with this function, too. This is because every position is also an anchor (QCPItemPosition inherits from QCPItemAnchor).

See also
anchor, position

§ selectionChanged

void QCPAbstractItem::selectionChanged ( bool  selected)
signal

This signal is emitted when the selection state of this item has changed, either by user interaction or by a direct call to setSelected.

§ selectionCategory()

QCP::Interaction QCPAbstractItem::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ clipRect()

QRect QCPAbstractItem::clipRect ( ) const
protectedvirtual

Returns the rect the visual representation of this item is clipped to. This depends on the current setting of setClipToAxisRect as well as the axis rect set with setClipAxisRect.

If the item is not clipped to an axis rect, QCustomPlot's viewport rect is returned.

See also
draw

Reimplemented from QCPLayerable.

§ applyDefaultAntialiasingHint()

void QCPAbstractItem::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing item lines.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

See also
setAntialiased

Implements QCPLayerable.

§ draw()

void QCPAbstractItem::draw ( QCPPainter *  painter)
protectedpure virtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPLayerable.

Implemented in QCPItemText, QCPItemTracer, QCPItemPixmap, QCPItemBracket, QCPItemEllipse, QCPItemRect, QCPItemCurve, QCPItemLine, and QCPItemStraightLine.

§ selectEvent()

void QCPAbstractItem::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPAbstractItem::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ anchorPixelPosition()

QPointF QCPAbstractItem::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Returns the pixel position of the anchor with Id anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor).

For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor.

See also
createAnchor

Reimplemented in QCPItemText, QCPItemPixmap, QCPItemBracket, QCPItemEllipse, and QCPItemRect.

§ rectDistance()

double QCPAbstractItem::rectDistance ( const QRectF &  rect,
const QPointF &  pos,
bool  filledRect 
) const
protected

A convenience function which returns the selectTest value for a specified rect and a specified click position pos. filledRect defines whether a click inside the rect should also be considered a hit or whether only the rect border is sensitive to hits.

This function may be used to help with the implementation of the selectTest function for specific items.

For example, if your item consists of four rects, call this function four times, once for each rect, in your selectTest reimplementation. Finally, return the minimum (non -1) of all four returned values.

§ createPosition()

QCPItemPosition * QCPAbstractItem::createPosition ( const QString &  name)
protected

Creates a QCPItemPosition, registers it with this item and returns a pointer to it. The specified name must be a unique string that is usually identical to the variable name of the position member (This is needed to provide the name-based position access to positions).

Don't delete positions created by this function manually, as the item will take care of it.

Use this function in the constructor (initialization list) of the specific item subclass to create each position member. Don't create QCPItemPositions with new yourself, because they won't be registered with the item properly.

See also
createAnchor

§ createAnchor()

QCPItemAnchor * QCPAbstractItem::createAnchor ( const QString &  name,
int  anchorId 
)
protected

Creates a QCPItemAnchor, registers it with this item and returns a pointer to it. The specified name must be a unique string that is usually identical to the variable name of the anchor member (This is needed to provide the name based anchor access to anchors).

The anchorId must be a number identifying the created anchor. It is recommended to create an enum (e.g. "AnchorIndex") for this on each item that uses anchors. This id is used by the anchor to identify itself when it calls QCPAbstractItem::anchorPixelPosition. That function then returns the correct pixel coordinates for the passed anchor id.

Don't delete anchors created by this function manually, as the item will take care of it.

Use this function in the constructor (initialization list) of the specific item subclass to create each anchor member. Don't create QCPItemAnchors with new yourself, because then they won't be registered with the item properly.

See also
createPosition
The documentation for this class was generated from the following files:
  • src/item.h
  • src/item.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerDateTime.html0000644000175000017500000012642614030601040026611 0ustar rusconirusconi QCPAxisTickerDateTime Class Reference
Public Functions | Static Public Functions | Protected Types | Protected Functions
QCPAxisTickerDateTime Class Reference

Specialized axis ticker for calendar dates and times as axis ticks. More...

Inheritance diagram for QCPAxisTickerDateTime:
Inheritance graph

Public Functions

 QCPAxisTickerDateTime ()
 
QString dateTimeFormat () const
 
Qt::TimeSpec dateTimeSpec () const
 
QTimeZone timeZone () const
 
void setDateTimeFormat (const QString &format)
 
void setDateTimeSpec (Qt::TimeSpec spec)
 
void setTimeZone (const QTimeZone &zone)
 
void setTickOrigin (double origin)
 
void setTickOrigin (const QDateTime &origin)
 
- Public Functions inherited from QCPAxisTicker
 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Static Public Functions

static QDateTime keyToDateTime (double key)
 
static double dateTimeToKey (const QDateTime &dateTime)
 
static double dateTimeToKey (const QDate &date, Qt::TimeSpec timeSpec=Qt::LocalTime)
 

Protected Types

enum  DateStrategy
 

Protected Functions

virtual double getTickStep (const QCPRange &range)
 
virtual int getSubTickCount (double tickStep)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
- Protected Functions inherited from QCPAxisTicker
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Additional Inherited Members

- Public Types inherited from QCPAxisTicker
enum  TickStepStrategy
 

Detailed Description

Specialized axis ticker for calendar dates and times as axis ticks.

axisticker-datetime.png

This QCPAxisTicker subclass generates ticks that correspond to real calendar dates and times. The plot axis coordinate is interpreted as Unix Time, so seconds since Epoch (January 1, 1970, 00:00 UTC). This is also used for example by QDateTime in the toTime_t()/setTime_t() methods with a precision of one second. Since Qt 4.7, millisecond accuracy can be obtained from QDateTime by using QDateTime::fromMSecsSinceEpoch()/1000.0. The static methods dateTimeToKey and keyToDateTime conveniently perform this conversion achieving a precision of one millisecond on all Qt versions.

The format of the date/time display in the tick labels is controlled with setDateTimeFormat. If a different time spec or time zone shall be used for the tick label appearance, see setDateTimeSpec or setTimeZone, respectively.

This ticker produces unequal tick spacing in order to provide intuitive date and time-of-day ticks. For example, if the axis range spans a few years such that there is one tick per year, ticks will be positioned on 1. January of every year. This is intuitive but, due to leap years, will result in slightly unequal tick intervals (visually unnoticeable). The same can be seen in the image above: even though the number of days varies month by month, this ticker generates ticks on the same day of each month.

If you would like to change the date/time that is used as a (mathematical) starting date for the ticks, use the setTickOrigin(const QDateTime &origin) method overload, which takes a QDateTime. If you pass 15. July, 9:45 to this method, the yearly ticks will end up on 15. July at 9:45 of every year.

The ticker can be created and assigned to an axis like this:

QSharedPointer<QCPAxisTickerDateTime> dateTimeTicker(new QCPAxisTickerDateTime);
customPlot->xAxis->setTicker(dateTimeTicker);
customPlot->xAxis->setRange(QCPAxisTickerDateTime::dateTimeToKey(QDate(2013, 11, 16)), QCPAxisTickerDateTime::dateTimeToKey(QDate(2015, 5, 2)));
dateTimeTicker->setDateTimeFormat("d. MMM\nyyyy");
Note
If you rather wish to display relative times in terms of days, hours, minutes, seconds and milliseconds, and are not interested in the intricacies of real calendar dates with months and (leap) years, have a look at QCPAxisTickerTime instead.

Constructor & Destructor Documentation

§ QCPAxisTickerDateTime()

QCPAxisTickerDateTime::QCPAxisTickerDateTime ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ setDateTimeFormat()

void QCPAxisTickerDateTime::setDateTimeFormat ( const QString &  format)

Sets the format in which dates and times are displayed as tick labels. For details about the format string, see the documentation of QDateTime::toString().

Typical expressions are

d The day as a number without a leading zero (1 to 31)
dd The day as a number with a leading zero (01 to 31)
ddd The abbreviated localized day name (e.g. 'Mon' to 'Sun'). Uses the system locale to localize the name, i.e. QLocale::system().
dddd The long localized day name (e.g. 'Monday' to 'Sunday'). Uses the system locale to localize the name, i.e. QLocale::system().
M The month as a number without a leading zero (1 to 12)
MM The month as a number with a leading zero (01 to 12)
MMM The abbreviated localized month name (e.g. 'Jan' to 'Dec'). Uses the system locale to localize the name, i.e. QLocale::system().
MMMM The long localized month name (e.g. 'January' to 'December'). Uses the system locale to localize the name, i.e. QLocale::system().
yy The year as a two digit number (00 to 99)
yyyy The year as a four digit number. If the year is negative, a minus sign is prepended, making five characters.
h The hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
hh The hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
H The hour without a leading zero (0 to 23, even with AM/PM display)
HH The hour with a leading zero (00 to 23, even with AM/PM display)
m The minute without a leading zero (0 to 59)
mm The minute with a leading zero (00 to 59)
s The whole second, without any leading zero (0 to 59)
ss The whole second, with a leading zero where applicable (00 to 59)
z The fractional part of the second, to go after a decimal point, without trailing zeroes (0 to 999). Thus "s.z" reports the seconds to full available (millisecond) precision without trailing zeroes.
zzz The fractional part of the second, to millisecond precision, including trailing zeroes where applicable (000 to 999).
AP or A Use AM/PM display. A/AP will be replaced by an upper-case version of either QLocale::amText() or QLocale::pmText().
ap or a Use am/pm display. a/ap will be replaced by a lower-case version of either QLocale::amText() or QLocale::pmText().
t The timezone (for example "CEST")

Newlines can be inserted with "\n", literal strings (even when containing above expressions) by encapsulating them using single-quotes. A literal single quote can be generated by using two consecutive single quotes in the format.

See also
setDateTimeSpec, setTimeZone

§ setDateTimeSpec()

void QCPAxisTickerDateTime::setDateTimeSpec ( Qt::TimeSpec  spec)

Sets the time spec that is used for creating the tick labels from corresponding dates/times.

The default value of QDateTime objects (and also QCPAxisTickerDateTime) is Qt::LocalTime. However, if the displayed tick labels shall be given in UTC, set spec to Qt::UTC.

Tick labels corresponding to other time zones can be achieved with setTimeZone (which sets spec to Qt::TimeZone internally). Note that if spec is afterwards set to not be Qt::TimeZone again, the setTimeZone setting will be ignored accordingly.

See also
setDateTimeFormat, setTimeZone

§ setTimeZone()

void QCPAxisTickerDateTime::setTimeZone ( const QTimeZone &  zone)

Sets the time zone that is used for creating the tick labels from corresponding dates/times. The time spec (setDateTimeSpec) is set to Qt::TimeZone.

See also
setDateTimeFormat, setTimeZone

§ setTickOrigin() [1/2]

void QCPAxisTickerDateTime::setTickOrigin ( double  origin)

Sets the tick origin (see QCPAxisTicker::setTickOrigin) in seconds since Epoch (1. Jan 1970, 00:00 UTC). For the date time ticker it might be more intuitive to use the overload which directly takes a QDateTime, see setTickOrigin(const QDateTime &origin).

This is useful to define the month/day/time recurring at greater tick interval steps. For example, If you pass 15. July, 9:45 to this method and the tick interval happens to be one tick per year, the ticks will end up on 15. July at 9:45 of every year.

§ setTickOrigin() [2/2]

void QCPAxisTickerDateTime::setTickOrigin ( const QDateTime &  origin)

Sets the tick origin (see QCPAxisTicker::setTickOrigin) as a QDateTime origin.

This is useful to define the month/day/time recurring at greater tick interval steps. For example, If you pass 15. July, 9:45 to this method and the tick interval happens to be one tick per year, the ticks will end up on 15. July at 9:45 of every year.

§ keyToDateTime()

QDateTime QCPAxisTickerDateTime::keyToDateTime ( double  key)
static

A convenience method which turns key (in seconds since Epoch 1. Jan 1970, 00:00 UTC) into a QDateTime object. This can be used to turn axis coordinates to actual QDateTimes.

The accuracy achieved by this method is one millisecond, irrespective of the used Qt version (it works around the lack of a QDateTime::fromMSecsSinceEpoch in Qt 4.6)

See also
dateTimeToKey

§ dateTimeToKey() [1/2]

double QCPAxisTickerDateTime::dateTimeToKey ( const QDateTime &  dateTime)
static

This is an overloaded function.

A convenience method which turns a QDateTime object into a double value that corresponds to seconds since Epoch (1. Jan 1970, 00:00 UTC). This is the format used as axis coordinates by QCPAxisTickerDateTime.

The accuracy achieved by this method is one millisecond, irrespective of the used Qt version (it works around the lack of a QDateTime::toMSecsSinceEpoch in Qt 4.6)

See also
keyToDateTime

§ dateTimeToKey() [2/2]

double QCPAxisTickerDateTime::dateTimeToKey ( const QDate &  date,
Qt::TimeSpec  timeSpec = Qt::LocalTime 
)
static

This is an overloaded function.

A convenience method which turns a QDate object into a double value that corresponds to seconds since Epoch (1. Jan 1970, 00:00 UTC). This is the format used as axis coordinates by QCPAxisTickerDateTime.

The returned value will be the start of the passed day of date, interpreted in the given timeSpec.

See also
keyToDateTime

§ getTickStep()

double QCPAxisTickerDateTime::getTickStep ( const QCPRange &  range)
protectedvirtual

Returns a sensible tick step with intervals appropriate for a date-time-display, such as weekly, monthly, bi-monthly, etc.

Note that this tick step isn't used exactly when generating the tick vector in createTickVector, but only as a guiding value requiring some correction for each individual tick interval. Otherwise this would lead to unintuitive date displays, e.g. jumping between first day in the month to the last day in the previous month from tick to tick, due to the non-uniform length of months. The same problem arises with leap years.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getSubTickCount()

int QCPAxisTickerDateTime::getSubTickCount ( double  tickStep)
protectedvirtual

Returns a sensible sub tick count with intervals appropriate for a date-time-display, such as weekly, monthly, bi-monthly, etc.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getTickLabel()

QString QCPAxisTickerDateTime::getTickLabel ( double  tick,
const QLocale &  locale,
QChar  formatChar,
int  precision 
)
protectedvirtual

Generates a date/time tick label for tick coordinate tick, based on the currently set format (setDateTimeFormat), time spec (setDateTimeSpec), and possibly time zone (setTimeZone).

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ createTickVector()

QVector< double > QCPAxisTickerDateTime::createTickVector ( double  tickStep,
const QCPRange &  range 
)
protectedvirtual

Uses the passed tickStep as a guiding value and applies corrections in order to obtain non-uniform tick intervals but intuitive tick labels, e.g. falling on the same day of each month.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

The documentation for this class was generated from the following files:
  • src/axis/axistickerdatetime.h
  • src/axis/axistickerdatetime.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/dir_7ecf847125af2ab645f5f2d2c82f57e2.html0000644000175000017500000000246114030601036027040 0ustar rusconirusconi src/polar Directory Reference
polar Directory Reference
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_e.html0000644000175000017500000000637714030601037025073 0ustar rusconirusconi Data Fields - Functions
 

- e -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarGrid.html0000644000175000017500000010555414030601040025010 0ustar rusconirusconi QCPPolarGrid Class Reference
Public Types | Public Functions | Protected Functions
QCPPolarGrid Class Reference

The grid in both angular and radial dimensions for polar plots. More...

Inheritance diagram for QCPPolarGrid:
Inheritance graph

Public Types

enum  GridType
 

Public Functions

 QCPPolarGrid (QCPPolarAxisAngular *parentAxis)
 
QCPPolarAxisRadial * radialAxis () const
 
GridTypes type () const
 
GridTypes subGridType () const
 
bool antialiasedSubGrid () const
 
bool antialiasedZeroLine () const
 
QPen angularPen () const
 
QPen angularSubGridPen () const
 
QPen radialPen () const
 
QPen radialSubGridPen () const
 
QPen radialZeroLinePen () const
 
void setRadialAxis (QCPPolarAxisRadial *axis)
 
void setType (GridTypes type)
 
void setSubGridType (GridTypes type)
 
void setAntialiasedSubGrid (bool enabled)
 
void setAntialiasedZeroLine (bool enabled)
 
void setAngularPen (const QPen &pen)
 
void setAngularSubGridPen (const QPen &pen)
 
void setRadialPen (const QPen &pen)
 
void setRadialSubGridPen (const QPen &pen)
 
void setRadialZeroLinePen (const QPen &pen)
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
bool realVisibility () const
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
void drawRadialGrid (QCPPainter *painter, const QPointF &center, const QVector< double > &coords, const QPen &pen, const QPen &zeroPen=Qt::NoPen)
 
void drawAngularGrid (QCPPainter *painter, const QPointF &center, double radius, const QVector< QPointF > &ticksCosSin, const QPen &pen)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

The grid in both angular and radial dimensions for polar plots.

Warning
In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future.

Member Enumeration Documentation

§ GridType

enum QCPPolarGrid::GridType

TODO

Constructor & Destructor Documentation

§ QCPPolarGrid()

QCPPolarGrid::QCPPolarGrid ( QCPPolarAxisAngular *  parentAxis)
explicit

Creates a QCPPolarGrid instance and sets default values.

You shouldn't instantiate grids on their own, since every axis brings its own grid.

Member Function Documentation

§ setAntialiasedSubGrid()

void QCPPolarGrid::setAntialiasedSubGrid ( bool  enabled)

Sets whether sub grid lines are drawn antialiased.

§ setAntialiasedZeroLine()

void QCPPolarGrid::setAntialiasedZeroLine ( bool  enabled)

Sets whether zero lines are drawn antialiased.

§ setAngularPen()

void QCPPolarGrid::setAngularPen ( const QPen &  pen)

Sets the pen with which (major) grid lines are drawn.

§ setAngularSubGridPen()

void QCPPolarGrid::setAngularSubGridPen ( const QPen &  pen)

Sets the pen with which sub grid lines are drawn.

§ applyDefaultAntialiasingHint()

void QCPPolarGrid::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing the major grid lines.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

See also
setAntialiased

Implements QCPLayerable.

§ draw()

void QCPPolarGrid::draw ( QCPPainter *  painter)
protectedvirtual

Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning over the complete axis rect. Also draws the zero line, if appropriate (setZeroLinePen).

Implements QCPLayerable.

The documentation for this class was generated from the following files:
  • src/polar/polargrid.h
  • src/polar/polargrid.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPSelectionDecorator__inherit__graph.png0000644000175000017500000000221114030601041031721 0ustar rusconirusconi‰PNG  IHDRÐkô‡ñgAMA† 1è–_0PLTEþþþÿÿÿ333………MMMiii+———!!Yèèéff—ÒÒâÑÑÑ´´¸<Ú'õtRNS«â¢bKGDÿ-Þ pHYsHHFÉk>sIDAThÞíšÏKQÇõÖë˜×ŒFŠ =u‹7áíÎf)’ v×z"zJ»i ^zëö×Á[¯Þ¼*¨…ž¼õšâ? íUÚséÌÛ?ˆI³k²Xys˜¼|çÍ|Øyó‚°AJ6¤Aÿhr¶6Ó„}µ. Óë£4(U;ÐÒg‹.–<Í‹ ÷‰Xl«mÇUת«Ë¥Æ#·Rð¬Fõ2è¼è+óº Ó[²Ý"Wõ=‡¾û¸ê²« È«ºk˜T´‰t< =,¹h« Ý#Èñ*¶['=QÁZõ̶«Üœjõ’Vù-qÎð,Ú_%M{}¢3QeÒ¢Ó »º9u(ëüäˈ¤9ajÜÖ±©ö¹Êƒh< k¦cÐA  Qm¦úÉ O)€î0èM jÞf‚$ Ò Ò Ò Ò Ò Ò Jt÷«aÅ͘W ¿Ÿoy¯6'%hDLÓ dòÒ¢3ÈÇd±ˆ­/€äÙJІN5†YEÙÊÚ»øë¿@îIñpwú2è,?ç¯tÁ¾ì$j´p8–“â o<ÉîJ9OÀÄš€l$Âo<U)°†ÈÁ2(Tò†y‡öQf;¨ ‡PfО¼g!óÜÉnf›[—™š“ ÁxKœÙ™tãï’ÆAëˆZ·*™)'5U:ƒh;ü(ܧ4ìÊêŒDó@"±L«&,i,S·öZJ„ªB·Öñ·¼G´dwâj]$2ˆJ|@’@¹–B ÿTUè6 ™gßefþ”£.-†­cPÎ]‰Dn€½C'Õ)…[—]ä}‹WŒw5oeÑ΃'…pD"‘‡²L9‚aZ5*yî§ÿ‡öÚ‡`d!ùýü‡Ý˜Ÿ Ò úûöõ* Aû=½U½–­ßþM¼ ÁOBh{½ö„DÞI²%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/bc_s.png0000644000175000017500000000057414030601042022257 0ustar rusconirusconi‰PNG  IHDRã®B>gAMA† 1è–_0PLTE>U•7P’\s«2JD]œ.F‰7O3{h}³\t¬Ul§0I:R’.F‹ 7~ÿÿÿƒ¥ÈtRNSìâŸÖ\Óº¢s=2ÌçêY“ÍbKGDºÙ pHYsHHFÉk>XIDAT×cb“ ‘¢$ØÛ€›'H"³H0‚d˜½A2 Á’ q$à –1É€æÛ@‚ÏH7€ªc+‰×€Œ€‰×‚Äk1Åë@æš1ÔG™½Ûk%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemPixmap__inherit__graph.png0000644000175000017500000000214314030601041030212 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii222OOQ™™™………ççè±±µÓÓÕ*P4nn]L&GtRNSªvå’bKGDˆH pHYsHHFÉk>MIDAThÞíÚ1OÛ@p>B/Ái„h®ÂV‡UíVd‰‘³ýS&JSµ#¡‹ŽC;TB•ºtBˆ¥êÚ¡ª¡bç3TêÎÐw>'1jlb©´½³çÜýìçó)1Arµ;Êc+,¤nͨ/:©=\ñFêÊõÿÏSB´D_‚Àºm19µ×wXµ`¿5´r'“·IjU1ë ˜ uJ>šmÒ6qáP#Ç°ë×H…jGÃûOQ›l_éÄÁq÷ ,îÑë½|~(#+ÄO%tŒúƒ‡µßP­fˆ R¢ÍH¿6ÎúIïíÓ)Ø,>~/üŽ%ë_ød\ÿþ°uv\JR1mô%°úëWMØ?ÖîÕWV~·™ÆÛ°žÏÇ7åoÒCúõwk1íþiÜH=êcÛôYòøuþ¿™Ë_úç¹ü…ÿ5/ûþ÷<~Æ÷Oóøiß÷wsøÏèæð—èÏsø ôß²û òäìg„?ËîK?DËñü„$oå•W^yå•W^ù,>9ûù’œ¡Ïý 3 á ’µéÿ®§i}4ûaÕ¾§Ñ+R-ÁG³ÓHï#ÙOyeUdhi@eôs Ø¥³Csƒ cè#ÙOÁX ²’×"8‘ÑOsWÞ_„Aîž;È€Fxh«³"«™tÄ2„ÑOX¿ƒVñ  õ“€#ôäƒ#Œ~úþ(èŒð‘ìgƒ×±þâ!#OÃèëÇ®v(àQ>’ýxdŠâú•pÝ,*£ŸÝIaÐ(ÿ{ö“kÿ)ÿ×ø ÙÏ B›ý$ç?2RùOâ°ÊTþ£òå•W^yå•Wþöù¥ŒùÏ£Ðgýëý˳5å£~ð·Ë ZÜcÃYÁù¾ó¬³ÜkÕ²®uÕãù8÷wù¶Ç–q>×¹ÐÅÛ:°„õˆó&_b¦kºXÍKfÚ£¼Í»«Ëûáý·žXÜ™sæ¼à\a³†ÕÀJzk˜‰^>?ÀlìŠó.Ô™8xp’ž\?<^ÊGpÞCÏÅáÖâ¼Õ_¿À×·³¯?·¥oÍÆÕ?xbþtq±†¾É¤·/fý87ëcm›Á»Í¸ÿòz®üÍú¼ß¿ÝZ¶6kþõúŒk¶{¿]jE÷sn“·%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTicker.html0000644000175000017500000012767614030601040025204 0ustar rusconirusconi QCPAxisTicker Class Reference
Public Types | Public Functions | Protected Functions
QCPAxisTicker Class Reference

The base class tick generator used by QCPAxis to create tick positions and tick labels. More...

Inheritance diagram for QCPAxisTicker:
Inheritance graph

Public Types

enum  TickStepStrategy
 

Public Functions

 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Protected Functions

virtual double getTickStep (const QCPRange &range)
 
virtual int getSubTickCount (double tickStep)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Detailed Description

The base class tick generator used by QCPAxis to create tick positions and tick labels.

Each QCPAxis has an internal QCPAxisTicker (or a subclass) in order to generate tick positions and tick labels for the current axis range. The ticker of an axis can be set via QCPAxis::setTicker. Since that method takes a QSharedPointer<QCPAxisTicker>, multiple axes can share the same ticker instance.

This base class generates normal tick coordinates and numeric labels for linear axes. It picks a reasonable tick step (the separation between ticks) which results in readable tick labels. The number of ticks that should be approximately generated can be set via setTickCount. Depending on the current tick step strategy (setTickStepStrategy), the algorithm either sacrifices readability to better match the specified tick count (QCPAxisTicker::tssMeetTickCount) or relaxes the tick count in favor of better tick steps (QCPAxisTicker::tssReadability), which is the default.

The following more specialized axis ticker subclasses are available, see details in the respective class documentation:

QCPAxisTickerFixed
axisticker-fixed.png
QCPAxisTickerLog
axisticker-log.png
QCPAxisTickerPi
axisticker-pi.png
QCPAxisTickerText
axisticker-text.png
QCPAxisTickerDateTime
axisticker-datetime.png
QCPAxisTickerTime
axisticker-time.png
axisticker-time2.png

Creating own axis tickers

Creating own axis tickers can be achieved very easily by sublassing QCPAxisTicker and reimplementing some or all of the available virtual methods.

In the simplest case you might wish to just generate different tick steps than the other tickers, so you only reimplement the method getTickStep. If you additionally want control over the string that will be shown as tick label, reimplement getTickLabel.

If you wish to have complete control, you can generate the tick vectors and tick label vectors yourself by reimplementing createTickVector and createLabelVector. The default implementations use the previously mentioned virtual methods getTickStep and getTickLabel, but your reimplementations don't necessarily need to do so. For example in the case of unequal tick steps, the method getTickStep loses its usefulness and can be ignored.

The sub tick count between major ticks can be controlled with getSubTickCount. Full sub tick placement control is obtained by reimplementing createSubTickVector.

See the documentation of all these virtual methods in QCPAxisTicker for detailed information about the parameters and expected return values.

Member Enumeration Documentation

§ TickStepStrategy

enum QCPAxisTicker::TickStepStrategy

Defines the strategies that the axis ticker may follow when choosing the size of the tick step.

See also
setTickStepStrategy
Enumerator
tssReadability 

A nicely readable tick step is prioritized over matching the requested number of ticks (see setTickCount)

tssMeetTickCount 

Less readable tick steps are allowed which in turn facilitates getting closer to the requested tick count.

Constructor & Destructor Documentation

§ QCPAxisTicker()

QCPAxisTicker::QCPAxisTicker ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ setTickStepStrategy()

void QCPAxisTicker::setTickStepStrategy ( QCPAxisTicker::TickStepStrategy  strategy)

Sets which strategy the axis ticker follows when choosing the size of the tick step. For the available strategies, see TickStepStrategy.

§ setTickCount()

void QCPAxisTicker::setTickCount ( int  count)

Sets how many ticks this ticker shall aim to generate across the axis range. Note that count is not guaranteed to be matched exactly, as generating readable tick intervals may conflict with the requested number of ticks.

Whether the readability has priority over meeting the requested count can be specified with setTickStepStrategy.

§ setTickOrigin()

void QCPAxisTicker::setTickOrigin ( double  origin)

Sets the mathematical coordinate (or "offset") of the zeroth tick. This tick coordinate is just a concept and doesn't need to be inside the currently visible axis range.

By default origin is zero, which for example yields ticks {-5, 0, 5, 10, 15,...} when the tick step is five. If origin is now set to 1 instead, the correspondingly generated ticks would be {-4, 1, 6, 11, 16,...}.

§ generate()

void QCPAxisTicker::generate ( const QCPRange &  range,
const QLocale &  locale,
QChar  formatChar,
int  precision,
QVector< double > &  ticks,
QVector< double > *  subTicks,
QVector< QString > *  tickLabels 
)
virtual

This is the method called by QCPAxis in order to actually generate tick coordinates (ticks), tick label strings (tickLabels) and sub tick coordinates (subTicks).

The ticks are generated for the specified range. The generated labels typically follow the specified locale, formatChar and number precision, however this might be different (or even irrelevant) for certain QCPAxisTicker subclasses.

The output parameter ticks is filled with the generated tick positions in axis coordinates. The output parameters subTicks and tickLabels are optional (set them to nullptr if not needed) and are respectively filled with sub tick coordinates, and tick label strings belonging to ticks by index.

§ getTickStep()

double QCPAxisTicker::getTickStep ( const QCPRange &  range)
protectedvirtual

Takes the entire currently visible axis range and returns a sensible tick step in order to provide readable tick labels as well as a reasonable number of tick counts (see setTickCount, setTickStepStrategy).

If a QCPAxisTicker subclass only wants a different tick step behaviour than the default implementation, it should reimplement this method. See cleanMantissa for a possible helper function.

Reimplemented in QCPAxisTickerPi, QCPAxisTickerDateTime, QCPAxisTickerTime, QCPAxisTickerFixed, and QCPAxisTickerText.

§ getSubTickCount()

int QCPAxisTicker::getSubTickCount ( double  tickStep)
protectedvirtual

Takes the tickStep, i.e. the distance between two consecutive ticks, and returns an appropriate number of sub ticks for that specific tick step.

Note that a returned sub tick count of e.g. 4 will split each tick interval into 5 sections.

Reimplemented in QCPAxisTickerPi, QCPAxisTickerDateTime, QCPAxisTickerTime, QCPAxisTickerText, and QCPAxisTickerLog.

§ getTickLabel()

QString QCPAxisTicker::getTickLabel ( double  tick,
const QLocale &  locale,
QChar  formatChar,
int  precision 
)
protectedvirtual

This method returns the tick label string as it should be printed under the tick coordinate. If a textual number is returned, it should respect the provided locale, formatChar and precision.

If the returned value contains exponentials of the form "2e5" and beautifully typeset powers is enabled in the QCPAxis number format (QCPAxis::setNumberFormat), the exponential part will be formatted accordingly using multiplication symbol and superscript during rendering of the label automatically.

Reimplemented in QCPAxisTickerPi, QCPAxisTickerDateTime, QCPAxisTickerTime, and QCPAxisTickerText.

§ createTickVector()

QVector< double > QCPAxisTicker::createTickVector ( double  tickStep,
const QCPRange &  range 
)
protectedvirtual

Returns a vector containing all coordinates of ticks that should be drawn. The default implementation generates ticks with a spacing of tickStep (mathematically starting at the tick step origin, see setTickOrigin) distributed over the passed range.

In order for the axis ticker to generate proper sub ticks, it is necessary that the first and last tick coordinates returned by this method are just below/above the provided range. Otherwise the outer intervals won't contain any sub ticks.

If a QCPAxisTicker subclass needs maximal control over the generated ticks, it should reimplement this method. Depending on the purpose of the subclass it doesn't necessarily need to base its result on tickStep, e.g. when the ticks are spaced unequally like in the case of QCPAxisTickerLog.

Reimplemented in QCPAxisTickerDateTime, QCPAxisTickerText, and QCPAxisTickerLog.

§ createSubTickVector()

QVector< double > QCPAxisTicker::createSubTickVector ( int  subTickCount,
const QVector< double > &  ticks 
)
protectedvirtual

Returns a vector containing all coordinates of sub ticks that should be drawn. It generates subTickCount sub ticks between each tick pair given in ticks.

If a QCPAxisTicker subclass needs maximal control over the generated sub ticks, it should reimplement this method. Depending on the purpose of the subclass it doesn't necessarily need to base its result on subTickCount or ticks.

§ createLabelVector()

QVector< QString > QCPAxisTicker::createLabelVector ( const QVector< double > &  ticks,
const QLocale &  locale,
QChar  formatChar,
int  precision 
)
protectedvirtual

Returns a vector containing all tick label strings corresponding to the tick coordinates provided in ticks. The default implementation calls getTickLabel to generate the respective strings.

It is possible but uncommon for QCPAxisTicker subclasses to reimplement this method, as reimplementing getTickLabel often achieves the intended result easier.

§ trimTicks()

void QCPAxisTicker::trimTicks ( const QCPRange &  range,
QVector< double > &  ticks,
bool  keepOneOutlier 
) const
protected

Removes tick coordinates from ticks which lie outside the specified range. If keepOneOutlier is true, it preserves one tick just outside the range on both sides, if present.

The passed ticks must be sorted in ascending order.

§ pickClosest()

double QCPAxisTicker::pickClosest ( double  target,
const QVector< double > &  candidates 
) const
protected

Returns the coordinate contained in candidates which is closest to the provided target.

This method assumes candidates is not empty and sorted in ascending order.

§ getMantissa()

double QCPAxisTicker::getMantissa ( double  input,
double *  magnitude = nullptr 
) const
protected

Returns the decimal mantissa of input. Optionally, if magnitude is not set to zero, it also returns the magnitude of input as a power of 10.

For example, an input of 142.6 will return a mantissa of 1.426 and a magnitude of 100.

§ cleanMantissa()

double QCPAxisTicker::cleanMantissa ( double  input) const
protected

Returns a number that is close to input but has a clean, easier human readable mantissa. How strongly the mantissa is altered, and thus how strong the result deviates from the original input, depends on the current tick step strategy (see setTickStepStrategy).

The documentation for this class was generated from the following files:
  • src/axis/axisticker.h
  • src/axis/axisticker.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPaintBufferPixmap__inherit__graph.png0000644000175000017500000000206614030601041031525 0ustar rusconirusconi‰PNG  IHDR£kéù/jgAMA† 1è–_-PLTEÿÿÿÿÿÿ………iii²²µLLMšššèèé111ÒÒÔP+nnËKV{tRNSªvå’bKGDˆH pHYsHHFÉk>#IDAThÞíÚAkAàþ…éÆ•˜":‘ Í-iY¨·Øº‡z*¼:;éKÜâ¡©DôÖŸC+ieÁc@¼yðôàQp…þÿƒïÍìÆB’:… Ì[3³o?ÞÌì’°d‰¹Ž{KžtH[.ã1‘•®KRi²ãrÚžœikÀ2ÅX!ô™h•äY2€£Éõ5£ðh­ŠV Ž;auÈâÎLR¾•W{ÕH“xÌ! dØ¢”“ê³ç,…z!È0,ç`SV%µe˜)Ý‹ŒZÜg=˜"÷YM†c$«Ã ³ÉÒÓNx¯éâ˜`Û£²JäÇHO<¡1ª²ò:ÒyóHèWZël¿&ïtiI÷q•?ÍZR[†£PO|X’¡É˜?qö`Œ${Ú¥kX¸qbH¬‘ÚZ¡6«†OV}æö0ö’Upâ•Áöˆ\Íhâ{šÄ¶Vöt•êÔLüÉî,òvy1–°e‰ÛC#™”x&ÃÂuS·µ’á¾ôY”êN-V³HƲÑÍ–©XøgÜ“ÿ .C“·Ö¬ââÐ*mã¿6ò¯–‰ÖärþÍ5¹’ÿtM¾Ë¸&åùÈ1y‘ç—nÉjžÛn¹-yÉïnÉ$-·Ü–ü‚¤å–Û’¸áy>vJ^yéžÿ€œ„'‚tÿ iùbÝòµúâü1`!Hw7Pï  6é %tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/dir_68267d1309a1af8e8297ef4c3efbcdba.html0000644000175000017500000000446014030601036027201 0ustar rusconirusconi src Directory Reference
src Directory Reference

Directories

Files

file  core.cpp
 
file  datacontainer.h
 
file  global.h
 
qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-log-powers.png0000644000175000017500000000143614030601041025610 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨dPIDATxÚíÛ±jÛ@€ñ¯¡/‘©C ÓQú ÝŒ^¡S!c”§èÔÉÐ9“_!ºõ „ñTèÐ)o!:Ä(¶SK®/îÝÉßoç¤ ÿ©gÉN@’$I’$I’$I’$I’$Iú]êl˜LÃ4*l8‰‹ÔHÒ¡Ü°$csÃÚ½ìFׯqÉxÈÏèþ|7ø¸\¶âð†ýSï>úßGâøϦ׭8Û³É+,IÅx³±Îð%6IÂK+I’$I’$½Š6õQZêÔCD+ý(@˜À‘¨h‹o¨iRp*yÑq5]å…gmêlæ©G8îÍŠŽj½´t´„­±â.uXTÅ¿Ÿ;U9ª(á(Œ5l¬ßõ«åz}ÇV©£¢+¾ó¸Î¾d¸¢ à ¯ÌRÙP†á† Üö·ŒÉ¼úî«îÌ©x á3÷©‹¬(ψ.iOÙ?yìo˜s 4Åü­an¶¶µ$â6¬_\îýZþÏ‹CåL?TQZLj2Þ6˜~dò&NÜŸ>¿ ÷¾Ô—ä¬Èˆ yȸ!nÃZ5P³,è‚׊\Ù‡)4liG~o¦ Vä†IDAThÞí™1NÃ@E'(ã+øT©ÝSæ8 ¹;¤¸ƒ€”2âiáT®ÒXT9@šOáõzwb;6ÄÙDÚç‚ÉÌ÷ìäÇ»0Ècpãz€KÃ"ð†¼!‚q|ѽëYòNw*ÒOÈšv®§rÆŽÖ:›…ד9"0b†¼!oˆàì†ÿo1( ™Q@4Ó™…• ÔõV[íg×Âèq\ݶέ‡bF= )r¤`$:“ Ç!€䘪²jÓ´JY僨M äHÀˆ{¯d+ç:î`H%/5¥1öÒyCuƒñihenª `µÚ\XSödD`06Ö[Nj´¬.Ùá$†d*Êô™P˜Oˆ¬†ˆ#2ž¦Ã\¨îa¤Ê˜Ôš'Õ½{UsI-j²g2¤¸^ª™uo].ÓZ DˆP+ñYöª^K-j²Ç ét¨>‹ŸD+¡ØÓžöôÐP=έ/iGKýê…iKÛÖ»W­Ú.8Tm½Yí²eªÏ ".Öž4n™b®¸V»©Éž`˱zä↠·ê»ªÍ†½"ÃóPµç²µ‘Ú&vö$†LÀÈá–î_¥ýºV†Œ»n-¢ïÞ'Ã5re¿Ëì_áÊ oˆÀ"ð†¼!ëk÷Òÿxs´!O®'qJõîGþ¿ÿ6þ xCÞÁ˜>\pYüºò%”c%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_n.html0000644000175000017500000000451214030601037024056 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- n -

qcustomplot-2.1.0+dfsg1/documentation/html/nav_f.png0000644000175000017500000000042014030601042022430 0ustar rusconirusconi‰PNG  IHDR8ÎNßgAMA† 1è–_PLTEæëôÜâïÓÛëÊÒæÀÌâ½Éà¶ÂÝÿÿÿé¸5ýbKGDaˆë pHYsHHFÉk>IDAT×c`@`¨…pè„ $Á胇®E%-Œ%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_14.png0000644000175000017500000000111014030601042024463 0ustar rusconirusconi‰PNG  IHDRX#ºy½gAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>zIDATXÃí˜1rƒ0Eå Ë8wH“Úe*7¸'WPŸáIëÎ gp.ÁäQã¤y)fÀƒ-3˜Œ>ÍjY-oV+†¨Eéin€ühZpt2¾Ôfn– Ú«k¹ ïÔqnªAÕÎÙQûÅÏÜdŠ[öâz8à[€·*V±ŠÕÖyÞÎ<±}>íhRa•#ôK# í<CI€†µÍ0”çv ¹³G7á¹CÒÓ ,‚¦p~ƒPR‘ 6jŒ  \Y«rHU'âr…kØÓg3 !àݜ´“sb`9«V#íÞáj,”­9ý=ǵDߨîõ¦Yr´ëûÃ`Oàq›n¸ÀZ_ÑZ‡„„ŠCoO`Èìâež¾mV/v÷ì"Äâ6]>p­Áà#CByü6p4þÄþö<ñc¥ÔF½zf¹ØW¿wÉò?豈;:;%&¾ÉÞø}n’‹jèVáïe^8p¤ös#\§?B[í8Ú“•4%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPFinancial__inherit__graph.png0000644000175000017500000000471314030601041030026 0ustar rusconirusconi‰PNG  IHDRPû±pgAMA† 1è–_0PLTEÿÿÿÒÒÔiiiQQQ««·………ççè000ÕÕä,!!Wii™­­ÊCCz?BtbKGDˆH pHYsHHFÉk>ÂIDATxÚíMlGÇÇö&qhbܨ7.B+Ô‹\‘ª—ÁÇqNQqU=XU{âÁ"ƒ¸DM(E¥°Ç¸µ‡~Ó²¡ÐS+ù’{ U½qiÏ\:ovÖöîz¿gŒÞ%žd²o™ÙyÄÿ#„ P¨øµp"°ŽK­­É ~ ‚"¨z £j€¶Ø:ɱ:a¬­© škܬ‘ÊòÇ„Þ JƒjeÞš ¬¦“üÊÛÐZTce­»Bhf±¡èy@ÖÔQ]+O•NmQoC3T»‡Ðì…ŠB Œ"ãtmÆ(ï¨Àû„,SôpêÅ©-o“Ú9'>¨}a‰|З‹É½Ú%ú 9ñz‰иeMýñù ‡é @›b]¢•È_F¼«I­ÅTS”Ì®u|Öv»D­I«»^¢¨‡At²AY`ÉÝ:ã¢÷~pëY–êªë?Ë&ð©Þ®lÊƦl_š7Œ=Ù ¾4gOe3øÒ—†ñ‹l_Ú7ŒÇ²|©g±ì\;²)|h@÷dSøЀ>•MáCÇô;Ù>t@'c·Ÿ{*›AAAAAt„ ªºAU‚"¨êBPU]j€úpß¿ý}0Gþà>y±C¸ïÇ9òYÌ fìN'Õ\ÚñÅFPµKs¹„}  æª Å½EŽùµ¹ïgjý(¶`ÑØŠ FÍ—q S<©°u¸®ïé׬}PÍ~mÃv;&ëõQP»û>[uÍ·V®êå\íó’¸Îr {ƒMݪ‚ÚÝ÷ÛŸl‚A˜c¦ù>³Hy“lZ`ç4r/G~ÍzŸ£<,קÿV÷a5Ò„o?o•ƒ(u«kA‡%P›û~)»–ëF¦Ä@˜ï³÷û#š/6 ˆ—#ßl¯‘#`‰'‡#zúVÉQ4¡ Þ~Ò„w¥Z4»NoB‡ úÀ”±“¹˜Ø»wÎ2ß‹g´ALw;|¯^Žü!P~ðô¯ñyœ¿D4abÈ*O§ú]ÀàúÒ}Ÿa|z9ÄtËa¾·ž®CPOGþðÔ[Ϥ Î~ÑÞ~*@‹ð%Vש·¹ï§JäLë›PÑ`šïaêŲS¿Âÿx:ò‡S¦¾Íÿ\íšS/¼ýÚ†(”wñ©çô¦Ãb²¹ïy–Ða¡´Xy–™æ{¾˜DS,&Ò¥]êéÈJO}P¾˜fÙ¬pö[‹©,@gDPè‹© ƒczrpß“SÂïnF 9ÜäßH!2"qú\ 7yÎcü–4è4¿É·çâ쎡t`¿—†©ÿ˜ñèúŸ‘"}2—tr·1žŒb”½=ÒK¡B&ÿÕ(KáöCþ¶—<¨€ím„¾6c8ÊOŠJûüá,)*õóGHŒôÏΗ¢dœ?œ5&EEú¹J¬òNQrÎÎòLQ’7ùy¥(Yçgy¤(içg¹.lyçgÍ»ü-NæùÃY.KFæùÃYÎ)JîùÃYŽc§Rjê+ã×çe?â554’m2-ŒS‚ÿ×b¼¡AS¥Î_;¾8 qP{€^îƒÚx©{qÀh @‚ ö*€Å’#¨[q€C @‚ ¶*€üÊ*x•s¬®1Z·Ìþ¼éVà`OÔV+îï p|W‹–ÙŸº8XëÓely üô³MxT×úfêZ.¨­ à ÆŠ‚|Z%–ÙŸº¤;õ¶*€÷IvOk¶­¨²Ìþ+®Å5 ‚Úªd†ò…2Å×K—Ò¾Ùš.Å£5 ‚ÆU€[è« ªyu¦:Xú7Thm¡ÖÒÑÆGKt ôÏñ­¿³KÍ´ÈPéE~æÆ•„Pœ&j•*Ð0·|BêÅtA·ß"ƒ¥0õM¾™ÃƾeVBñ ¹aÎPsË'äRuy4Zr YóvöÒ?ÑUBac‡Z?(ЃâA*9ó!Þâ1Lt°ôϬ[Þ/ ŃbêEzR%7ÄÔ–þ™ |c§Äœz(;;4Ä–Sa4Z‚ æb,ý °±S¨äŒP<(Òo˜[~ú‹©¯H›¾J;‚"(‚N8hõƒ8• ¨ÏŸyÿ(ýGãþ¤Ö¿~zhn"~ ²—=Ùþ´¹à)%¥Pþ‹ ‰—RÆ$¨¦”ÍàKPMÙ– áG#×c¦¤1Ô9¦¢Iù¥.3©ÔÑÆ ñ‹‡&aÙvdSø“bV'EPEPEPÙŠ Š Š Š Š “ EPÕ… ¯<è kï.ŸoË­¬,Ií’Ž ª,hC Ð.»×¹ÆšÆ>Ôk80ªz¥þN½Ó:¿Ôi¼ÛÐUQý^§ÛiÎemè‹ÍŽÎ—¿TgduU@Ïv*€òåS¯Ÿìòa/Õ³ÀØR žQѳz§ÅÄ ÿlã cª€N=o(ß<#^T¿[Q”/¦¦¹˜^‚Ö—Ä L½~~QÐÃôdíVÅ ,¦kLÐÎ¥Ú«²3!(‚"(‚¦ :)§Ð¿þ^Ú²,P 5 ÿ›±…‘žléÍ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_1.png0000644000175000017500000000635214030601042024414 0ustar rusconirusconi‰PNG  IHDR@µ¤ÂÀgAMA† 1è–_0PLTEÿÿÿÿÿÿhhhPP[™™¤èèì)))ÏÏÓ××æ®®Ë""X*7cc“GØ™âtRNSªvå’bKGDˆH pHYsHHFÉk> ÔIDATxÚí_hÇÀõPèkGÚ»ÕÝ©=.mÚ5 Ø…ìy%Ëvú Ö`h-ChñŸžZ§)%†Ò¾rZ Šàh …‹ƒ†B¹*èÁ isÒC"C›Û+y°Kí QìÒFR;3{:ÝÝîÎÎÌ~³»-72'ÍÎÝÜÏßüŸï›o†PÂÃPÜÀ lvÃO†8àÈ)H¾É xÀ èÜ€@€Fì€)s ¡qsV3§Ñå“fš¦Öhš³ä}ØIpü…Ë…áâw'4ý<šœp‰®h,Lu=«°ˆ† ­@¾ùûú3§G Ã?2†‰P üdÙDÆí²9¯7 4Ž%W0ÍÌä´“:c>ihL)àY”5´ ÔÏO<­årÉÐ^XvN”Й"zzÁÐ~‚ã¯#”644ra¼ ¸0³`ÐX4€æôHáóèödŒÎ„³¸êpí#o €ãø/RÔÓøÇ ±ˆŠÝ6Íò§žÁ_þæ©`ñ:CI@ËÈI5È)ì4„¾F/ÇKÆè§/wŠØ¯>õ ’h¼8…¦_2´êÈÉå.@S ØéfšFéS³© #e„Û¸‘¤ÎýÒ,hN7s~Æ5³“Å.@S ˆÐ­ Pnƒ¡n8þš 0÷Äq¸hí<2Tî,d›‚ÈG`®Þ˜ÉHàš½U‚ÉI `ÍúTVJk̓å¥ð¨ú©åSx ”°Ö¨‚æ Í x£¹ü?†Ì·þ Ì ˜«¿ Í ¨Ï} Î ¸þWx>HÀT£œhÀtkO ^ÿ£ >8@%0߬&0SßSÃx¨ „L5*‰tð+a±'`¯õ°ÐL5J}OŠa³‡̺[p²×º% 0ïÑ‚XŸu?ã4¼jà€¿öƒ@~­ñq£̵ª¾€ÜZc•¼ö‘×Óbû•Wk¬‘DÉ™·€ó®.° WkŒ‹˜$âÈÈO¡}&1}€Zc$ÒÈë°€‹>³Ôþ"Òk'’0`¶>ÏäÖãJ€qdäÇ°E¼ê7 ìëf´Æ8>‚q¸‘¤[&`­1 àïFG2†º|Ã7)€³ÉL1‰d-4“¸xŸ‘˜@}³šlÀEæJ=¼¦8, î9 ì„ç¾›’:ã/„¼ûÏ»ÖêÍoÉåä³­rð›2‡ÖV%,Ÿ$à*‡×ê „`Æw–pü,¾Ÿàê߃ޱ#>IÀ`^Ÿ$`ó`â“ à«öƒ*Ÿ » ëû0ö2ò€Y¦ÓPö2ò€wY5pÍÞ-ƒò‰2‘+pö2Ò€7ýk`ö°õÊ2æé:dë•óæíÝ<Ÿ0`½ê“pǯ~2€c~+‘+Møê'è·[tnŽ"˜÷^ g/A›óÈìy=ÍÌm—Uñ‰z 0]WÒ|e¯nxQÛ»êðÄs;—lÐÉK(ÀÕ ÷³;>|¡4Æ'º2̶J®gµæ7½ßJclve$¸èž&Ô|»çP»3ã] º§ 5ÿî9À”k”cYÓÆèꤙ־Ѻ:éCæð&¯1–üýFOTgó jŒûHe3½´~)ÀXP^c, xóoݱì¥í ûý¢cô³ü·"Œwv›Ý ”Ÿ¨ÆžøÕ„‡¶˜0ß,}ÐÃ$?q1:›õÒóŽY»û˜ìÇôJTc ð5Ëz È'¬1F'^òÒóX–£7<¨òò jŒqA‡i$¶eYdC&mmðòÉiŒqg$˜Ã|V³Œ'ÔÖ}^>¹¡Îœ–LQÀ* Õäh¿!‚ àçà<Øá_ÜË£(¯b°qI“ªø!ïwD X·,2“Y%‚ä²æþÙ£M;B@w2<[°iU zwæúÅ–Õ|÷¹óVsÿºiÑ°×T+÷þWÞÚß´¬ç¾ƒ"-â1Ò@îp§Ú•²ÒKÊÕÚÙú¤âD´Å0ÀWÖWߣ¯„ïx-y’ò᎛†—ÿó®m5ï=þùq¾ÏK©‰]Úb Èç+뽞X‘0¥€¸\[¤\¦LaHî\z‘È÷>°èZ÷—Ñ…\qÚLS)\Àg¾û%µtò€_k*çã4zbSû6÷ÀÈ»†¥¡ˆôë¸SÞŽw ÛÄáÅ}¥{«ý€¼kØcÀH°¯¬øÖ°±ò®acä]ÃÆÈ»† Ph ÛT5…ñ0·o7Ä?à[›QuBáY:'°=›ù@ü“NÕ)àöãJB‹9JØ$«‘o'Q³d)ÜT 9Äë+ëýžXQ ’ů_´Õ-N†z}ey„/7Èë—è²ýÞ×Û¿ˆ?š¶­Ù£lÞxDö¶>)ç,횺ÐÆ,z¸tÎi·ó])i{¯+vTÚ¿mÇe]SwO–¹s–õ夡ڔ.õ½7CJ»½N–u×÷9Ží7ÛÙ2¢Í–cl{ƒìƒàÒþ^d€¸pÉþ៹¾ƒîÁY‘¾F$WrD¸Áý=/ÿ#2@ºG½ëˆPÀDKÖ5µ8`¾Ý|uÛÚ^á7rvM=¯IfZÇ]ë/ˆŸPÔ5õ CV‚´òíR{aÂ=!@n•±nÈJèêG+%ÄO(êšú†<àgñQ:Žr .·CÔAÜ|ß^ßèŠó »¦FÒ€émò¯+ÔxE]S‡D•~³žG[\n‡D.è;~Vo.@áCÆ’€ýÔwì 'QÑÍfœp³ïÄ’ýN²]æA¶¡QöoëZ&aä€i׎9›0r@+o¦…rô€fÞùº?aô€hnÏõ(WPñû¢N¨%½Îjd} á–ÛL'Ô’€Èë¸P)fØ è}àJÝYa@Ÿ3ÊNã¢uoï<“›hs>; +–²#‚gšex™©©h*€y†òæU{+~@Ÿ³umzøŠ(ÈòÔƒ2‡€.ù%Û'lÍ‚-f À1¶ q Ô‹”#ˆ·º¹KÍÅ ˜ Ò¾ià +RÎH<æþ½! çLC 0P„H߇rG"ç'P„Ä¡ L‡#˜ç° B¬ÄÈN:a©Þßœ%yDˆ…xÅÞ™0¨)‹'-+¤ÊX0Ï6¾ wq·ÂGÚ9ÝÁp‚/—àOKú¸ˆM ºÊºê# €i–'ù$¢u†‡¿p÷f.þÄ”ÅZç‰ Èò2)j›môü†Ôýg®¢¶ÙFfr'ß2 H@Æä_Ô6›\YL“A%Èp¶+j›M¯,&ÉÀ€éf… Èm›M¯,¦É°€¾]¨m6¹²˜ø¤> ˜iͳ¹m³É•ÅÄ'õ-ÐÏéx¸{Œ!}f5‰êœ÷l' ôn'IÌôØa&-zì ' ¸5dÉ̹;Ãdzt†!ï1†DýF4ÒÊb—Ê0çÕ’aÐ]a‹ÌEhѪÛÌ ³^— % PÙzp—:®¨9Ë x-¦ŠkEAsö…d¢õ¹‘`@´¢àfBØëáM+`õúÃð™¨D¹:´UôÚé ÛÛ¸QÞ´°ŽÝ€•!< °o[€AöËñ‚ºGWˆ{0»Q5€€.úÂ]r  ­…׫|…jUåtÅ4ß_ì »¿ØpWØpŒØ´ÅZ_Ñ k‹£ä×ã3æ“f!3ér«_[LfˆÖ8À@m1~pÿP­q„€üÚbüJ šj#ä׎œ\Ž_[|˜,F ûýÅÁ€Òa8Ù!œ¶¸Ç#µÀPÞ¨{=R«ÛY ÀÿÀ°ÕYuø/•ßÈ1µh{p%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_r.html0000644000175000017500000002105314030601037025074 0ustar rusconirusconi Data Fields - Functions
 

- r -

qcustomplot-2.1.0+dfsg1/documentation/html/closed.png0000644000175000017500000000041414030601042022613 0ustar rusconirusconi‰PNG  IHDR ÿîƒgAMA† 1è–_ PLTE2JŽÿÿÿÕªè”tRNS@æØfbKGDf |d pHYsHHFÉk>IDAT×c`p```â aw`6b‹Tù%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemCurve.html0000644000175000017500000014262014030601040025023 0ustar rusconirusconi QCPItemCurve Class Reference
Public Functions | Public Members | Protected Functions
QCPItemCurve Class Reference

A curved line from one point to another. More...

Inheritance diagram for QCPItemCurve:
Inheritance graph

Public Functions

 QCPItemCurve (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
QCPLineEnding head () const
 
QCPLineEnding tail () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setHead (const QCPLineEnding &head)
 
void setTail (const QCPLineEnding &tail)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const start
 
QCPItemPosition *const startDir
 
QCPItemPosition *const endDir
 
QCPItemPosition *const end
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
QPen mainPen () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A curved line from one point to another.

QCPItemCurve.png
Curve example. Blue dotted circles are anchors, solid blue discs are positions.

It has four positions, start and end, which define the end points of the line, and two control points which define the direction the line exits from the start and the direction from which it approaches the end: startDir and endDir.

With setHead and setTail you may set different line ending styles, e.g. to create an arrow.

Often it is desirable for the control points to stay at fixed relative positions to the start/end point. This can be achieved by setting the parent anchor e.g. of startDir simply to start, and then specify the desired pixel offset with QCPItemPosition::setCoords on startDir.

Constructor & Destructor Documentation

§ QCPItemCurve()

QCPItemCurve::QCPItemCurve ( QCustomPlot *  parentPlot)
explicit

Creates a curve item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemCurve::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the line

See also
setSelectedPen

§ setSelectedPen()

void QCPItemCurve::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the line when selected

See also
setPen, setSelected

§ setHead()

void QCPItemCurve::setHead ( const QCPLineEnding &  head)

Sets the line ending style of the head. The head corresponds to the end position.

Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g.

setHead(QCPLineEnding::esSpikeArrow)
See also
setTail

§ setTail()

void QCPItemCurve::setTail ( const QCPLineEnding &  tail)

Sets the line ending style of the tail. The tail corresponds to the start position.

Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g.

setTail(QCPLineEnding::esSpikeArrow)
See also
setHead

§ selectTest()

double QCPItemCurve::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemCurve::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ mainPen()

QPen QCPItemCurve::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

The documentation for this class was generated from the following files:
  • src/items/item-curve.h
  • src/items/item-curve.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/tab_s.png0000644000175000017500000000046114030601042022434 0ustar rusconirusconi‰PNG  IHDR$ºZM?gAMA† 1è–_-PLTEmƒ¶g|²aw¯[s«Tl¦Le¡HaŸB[š;T•4N1JŽ,E‰$<‚ 8ÿÿÿ$ ˜zbKGDo½0O pHYsHHFÉk>+IDAT×c`(T`0C0 †0là Àp€Â I÷¡\(߆%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLegend.html0000644000175000017500000037560114030601040024325 0ustar rusconirusconi QCPLegend Class Reference
Public Types | Public Functions | Signals | Protected Functions
QCPLegend Class Reference

Manages a legend inside a QCustomPlot. More...

Inheritance diagram for QCPLegend:
Inheritance graph

Public Types

enum  SelectablePart
 
- Public Types inherited from QCPLayoutGrid
enum  FillOrder
 
- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Public Functions

 QCPLegend ()
 
QPen borderPen () const
 
QBrush brush () const
 
QFont font () const
 
QColor textColor () const
 
QSize iconSize () const
 
int iconTextPadding () const
 
QPen iconBorderPen () const
 
SelectableParts selectableParts () const
 
SelectableParts selectedParts () const
 
QPen selectedBorderPen () const
 
QPen selectedIconBorderPen () const
 
QBrush selectedBrush () const
 
QFont selectedFont () const
 
QColor selectedTextColor () const
 
void setBorderPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setFont (const QFont &font)
 
void setTextColor (const QColor &color)
 
void setIconSize (const QSize &size)
 
void setIconSize (int width, int height)
 
void setIconTextPadding (int padding)
 
void setIconBorderPen (const QPen &pen)
 
Q_SLOT void setSelectableParts (const SelectableParts &selectableParts)
 
Q_SLOT void setSelectedParts (const SelectableParts &selectedParts)
 
void setSelectedBorderPen (const QPen &pen)
 
void setSelectedIconBorderPen (const QPen &pen)
 
void setSelectedBrush (const QBrush &brush)
 
void setSelectedFont (const QFont &font)
 
void setSelectedTextColor (const QColor &color)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
QCPAbstractLegendItem * item (int index) const
 
QCPPlottableLegendItem * itemWithPlottable (const QCPAbstractPlottable *plottable) const
 
int itemCount () const
 
bool hasItem (QCPAbstractLegendItem *item) const
 
bool hasItemWithPlottable (const QCPAbstractPlottable *plottable) const
 
bool addItem (QCPAbstractLegendItem *item)
 
bool removeItem (int index)
 
bool removeItem (QCPAbstractLegendItem *item)
 
void clearItems ()
 
QList< QCPAbstractLegendItem * > selectedItems () const
 
- Public Functions inherited from QCPLayoutGrid
 QCPLayoutGrid ()
 
int rowCount () const
 
int columnCount () const
 
QList< double > columnStretchFactors () const
 
QList< double > rowStretchFactors () const
 
int columnSpacing () const
 
int rowSpacing () const
 
int wrap () const
 
FillOrder fillOrder () const
 
void setColumnStretchFactor (int column, double factor)
 
void setColumnStretchFactors (const QList< double > &factors)
 
void setRowStretchFactor (int row, double factor)
 
void setRowStretchFactors (const QList< double > &factors)
 
void setColumnSpacing (int pixels)
 
void setRowSpacing (int pixels)
 
void setWrap (int count)
 
void setFillOrder (FillOrder order, bool rearrange=true)
 
virtual void updateLayout ()
 
virtual int elementCount () const
 
virtual QCPLayoutElement * elementAt (int index) const
 
virtual QCPLayoutElement * takeAt (int index)
 
virtual bool take (QCPLayoutElement *element)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
virtual void simplify ()
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
QCPLayoutElement * element (int row, int column) const
 
bool addElement (int row, int column, QCPLayoutElement *element)
 
bool addElement (QCPLayoutElement *element)
 
bool hasElement (int row, int column)
 
void expandTo (int newRowCount, int newColumnCount)
 
void insertRow (int newIndex)
 
void insertColumn (int newIndex)
 
int rowColToIndex (int row, int column) const
 
void indexToRowCol (int index, int &row, int &column) const
 
- Public Functions inherited from QCPLayout
 QCPLayout ()
 
virtual void update (UpdatePhase phase)
 
bool removeAt (int index)
 
bool remove (QCPLayoutElement *element)
 
void clear ()
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void selectionChanged (QCPLegend::SelectableParts parts)
 
void selectableChanged (QCPLegend::SelectableParts parts)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QCP::Interaction selectionCategory () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
QPen getBorderPen () const
 
QBrush getBrush () const
 
- Protected Functions inherited from QCPLayoutGrid
void getMinimumRowColSizes (QVector< int > *minColWidths, QVector< int > *minRowHeights) const
 
void getMaximumRowColSizes (QVector< int > *maxColWidths, QVector< int > *maxRowHeights) const
 
- Protected Functions inherited from QCPLayout
void sizeConstraintsChanged () const
 
void adoptElement (QCPLayoutElement *el)
 
void releaseElement (QCPLayoutElement *el)
 
QVector< int > getSectionSizes (QVector< int > maxSizes, QVector< int > minSizes, QVector< double > stretchFactors, int totalSize) const
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
- Protected Functions inherited from QCPLayerable
virtual QRect clipRect () const
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Protected Static Functions inherited from QCPLayout
static QSize getFinalMinimumOuterSize (const QCPLayoutElement *el)
 
static QSize getFinalMaximumOuterSize (const QCPLayoutElement *el)
 

Detailed Description

Manages a legend inside a QCustomPlot.

A legend is a small box somewhere in the plot which lists plottables with their name and icon.

A legend is populated with legend items by calling QCPAbstractPlottable::addToLegend on the plottable, for which a legend item shall be created. In the case of the main legend (QCustomPlot::legend), simply adding plottables to the plot while QCustomPlot::setAutoAddPlottableToLegend is set to true (the default) creates corresponding legend items. The legend item associated with a certain plottable can be removed with QCPAbstractPlottable::removeFromLegend. However, QCPLegend also offers an interface to add and manipulate legend items directly: item, itemWithPlottable, itemCount, addItem, removeItem, etc.

Since QCPLegend derives from QCPLayoutGrid, it can be placed in any position a QCPLayoutElement may be positioned. The legend items are themselves QCPLayoutElements which are placed in the grid layout of the legend. QCPLegend only adds an interface specialized for handling child elements of type QCPAbstractLegendItem, as mentioned above. In principle, any other layout elements may also be added to a legend via the normal QCPLayoutGrid interface. See the special page about The Layout System for examples on how to add other elements to the legend and move it outside the axis rect.

Use the methods setFillOrder and setWrap inherited from QCPLayoutGrid to control in which order (column first or row first) the legend is filled up when calling addItem, and at which column or row wrapping occurs. The default fill order for legends is foRowsFirst.

By default, every QCustomPlot has one legend (QCustomPlot::legend) which is placed in the inset layout of the main axis rect (QCPAxisRect::insetLayout). To move the legend to another position inside the axis rect, use the methods of the QCPLayoutInset. To move the legend outside of the axis rect, place it anywhere else with the QCPLayout/QCPLayoutElement interface.

Member Enumeration Documentation

§ SelectablePart

enum QCPLegend::SelectablePart

Defines the selectable parts of a legend

See also
setSelectedParts, setSelectableParts
Enumerator
spNone 

0x000 None

spLegendBox 

0x001 The legend box (frame)

spItems 

0x002 Legend items individually (see selectedItems)

Constructor & Destructor Documentation

§ QCPLegend()

QCPLegend::QCPLegend ( )
explicit

Constructs a new QCPLegend instance with default values.

Note that by default, QCustomPlot already contains a legend ready to be used as QCustomPlot::legend

Member Function Documentation

§ setBorderPen()

void QCPLegend::setBorderPen ( const QPen &  pen)

Sets the pen, the border of the entire legend is drawn with.

§ setBrush()

void QCPLegend::setBrush ( const QBrush &  brush)

Sets the brush of the legend background.

§ setFont()

void QCPLegend::setFont ( const QFont &  font)

Sets the default font of legend text. Legend items that draw text (e.g. the name of a graph) will use this font by default. However, a different font can be specified on a per-item-basis by accessing the specific legend item.

This function will also set font on all already existing legend items.

See also
QCPAbstractLegendItem::setFont

§ setTextColor()

void QCPLegend::setTextColor ( const QColor &  color)

Sets the default color of legend text. Legend items that draw text (e.g. the name of a graph) will use this color by default. However, a different colors can be specified on a per-item-basis by accessing the specific legend item.

This function will also set color on all already existing legend items.

See also
QCPAbstractLegendItem::setTextColor

§ setIconSize() [1/2]

void QCPLegend::setIconSize ( const QSize &  size)

Sets the size of legend icons. Legend items that draw an icon (e.g. a visual representation of the graph) will use this size by default.

§ setIconSize() [2/2]

void QCPLegend::setIconSize ( int  width,
int  height 
)

This is an overloaded function.

§ setIconTextPadding()

void QCPLegend::setIconTextPadding ( int  padding)

Sets the horizontal space in pixels between the legend icon and the text next to it. Legend items that draw an icon (e.g. a visual representation of the graph) and text (e.g. the name of the graph) will use this space by default.

§ setIconBorderPen()

void QCPLegend::setIconBorderPen ( const QPen &  pen)

Sets the pen used to draw a border around each legend icon. Legend items that draw an icon (e.g. a visual representation of the graph) will use this pen by default.

If no border is wanted, set this to Qt::NoPen.

§ setSelectableParts()

void QCPLegend::setSelectableParts ( const SelectableParts &  selectable)

Sets whether the user can (de-)select the parts in selectable by clicking on the QCustomPlot surface. (When QCustomPlot::setInteractions contains QCP::iSelectLegend.)

However, even when selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling setSelectedParts directly.

See also
SelectablePart, setSelectedParts

§ setSelectedParts()

void QCPLegend::setSelectedParts ( const SelectableParts &  selected)

Sets the selected state of the respective legend parts described by SelectablePart. When a part is selected, it uses a different pen/font and brush. If some legend items are selected and selected doesn't contain spItems, those items become deselected.

The entire selection mechanism is handled automatically when QCustomPlot::setInteractions contains iSelectLegend. You only need to call this function when you wish to change the selection state manually.

This function can change the selection state of a part even when setSelectableParts was set to a value that actually excludes the part.

emits the selectionChanged signal when selected is different from the previous selection state.

Note that it doesn't make sense to set the selected state spItems here when it wasn't set before, because there's no way to specify which exact items to newly select. Do this by calling QCPAbstractLegendItem::setSelected directly on the legend item you wish to select.

See also
SelectablePart, setSelectableParts, selectTest, setSelectedBorderPen, setSelectedIconBorderPen, setSelectedBrush, setSelectedFont

§ setSelectedBorderPen()

void QCPLegend::setSelectedBorderPen ( const QPen &  pen)

When the legend box is selected, this pen is used to draw the border instead of the normal pen set via setBorderPen.

See also
setSelectedParts, setSelectableParts, setSelectedBrush

§ setSelectedIconBorderPen()

void QCPLegend::setSelectedIconBorderPen ( const QPen &  pen)

Sets the pen legend items will use to draw their icon borders, when they are selected.

See also
setSelectedParts, setSelectableParts, setSelectedFont

§ setSelectedBrush()

void QCPLegend::setSelectedBrush ( const QBrush &  brush)

When the legend box is selected, this brush is used to draw the legend background instead of the normal brush set via setBrush.

See also
setSelectedParts, setSelectableParts, setSelectedBorderPen

§ setSelectedFont()

void QCPLegend::setSelectedFont ( const QFont &  font)

Sets the default font that is used by legend items when they are selected.

This function will also set font on all already existing legend items.

See also
setFont, QCPAbstractLegendItem::setSelectedFont

§ setSelectedTextColor()

void QCPLegend::setSelectedTextColor ( const QColor &  color)

Sets the default text color that is used by legend items when they are selected.

This function will also set color on all already existing legend items.

See also
setTextColor, QCPAbstractLegendItem::setSelectedTextColor

§ selectTest()

double QCPLegend::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Layout elements are sensitive to events inside their outer rect. If pos is within the outer rect, this method returns a value corresponding to 0.99 times the parent plot's selection tolerance. However, layout elements are not selectable by default. So if onlySelectable is true, -1.0 is returned.

See QCPLayerable::selectTest for a general explanation of this virtual method.

QCPLayoutElement subclasses may reimplement this method to provide more specific selection test behaviour.

Reimplemented from QCPLayoutElement.

§ item()

QCPAbstractLegendItem * QCPLegend::item ( int  index) const

Returns the item with index i. If non-legend items were added to the legend, and the element at the specified cell index is not a QCPAbstractLegendItem, returns nullptr.

Note that the linear index depends on the current fill order (setFillOrder).

See also
itemCount, addItem, itemWithPlottable

§ itemWithPlottable()

QCPPlottableLegendItem * QCPLegend::itemWithPlottable ( const QCPAbstractPlottable *  plottable) const

Returns the QCPPlottableLegendItem which is associated with plottable (e.g. a QCPGraph*). If such an item isn't in the legend, returns nullptr.

See also
hasItemWithPlottable

§ itemCount()

int QCPLegend::itemCount ( ) const

Returns the number of items currently in the legend. It is identical to the base class QCPLayoutGrid::elementCount(), and unlike the other "item" interface methods of QCPLegend, doesn't only address elements which can be cast to QCPAbstractLegendItem.

Note that if empty cells are in the legend (e.g. by calling methods of the QCPLayoutGrid base class which allows creating empty cells), they are included in the returned count.

See also
item

§ hasItem()

bool QCPLegend::hasItem ( QCPAbstractLegendItem *  item) const

Returns whether the legend contains item.

See also
hasItemWithPlottable

§ hasItemWithPlottable()

bool QCPLegend::hasItemWithPlottable ( const QCPAbstractPlottable *  plottable) const

Returns whether the legend contains a QCPPlottableLegendItem which is associated with plottable (e.g. a QCPGraph*). If such an item isn't in the legend, returns false.

See also
itemWithPlottable

§ addItem()

bool QCPLegend::addItem ( QCPAbstractLegendItem *  item)

Adds item to the legend, if it's not present already. The element is arranged according to the current fill order (setFillOrder) and wrapping (setWrap).

Returns true on sucess, i.e. if the item wasn't in the list already and has been successfuly added.

The legend takes ownership of the item.

See also
removeItem, item, hasItem

§ removeItem() [1/2]

bool QCPLegend::removeItem ( int  index)

This is an overloaded function.

Removes the item with the specified index from the legend and deletes it.

After successful removal, the legend is reordered according to the current fill order (setFillOrder) and wrapping (setWrap), so no empty cell remains where the removed item was. If you don't want this, rather use the raw element interface of QCPLayoutGrid.

Returns true, if successful. Unlike QCPLayoutGrid::removeAt, this method only removes elements derived from QCPAbstractLegendItem.

See also
itemCount, clearItems

§ removeItem() [2/2]

bool QCPLegend::removeItem ( QCPAbstractLegendItem *  item)

This is an overloaded function.

Removes item from the legend and deletes it.

After successful removal, the legend is reordered according to the current fill order (setFillOrder) and wrapping (setWrap), so no empty cell remains where the removed item was. If you don't want this, rather use the raw element interface of QCPLayoutGrid.

Returns true, if successful.

See also
clearItems

§ clearItems()

void QCPLegend::clearItems ( )

Removes all items from the legend.

§ selectedItems()

QList< QCPAbstractLegendItem * > QCPLegend::selectedItems ( ) const

Returns the legend items that are currently selected. If no items are selected, the list is empty.

See also
QCPAbstractLegendItem::setSelected, setSelectable

§ selectionChanged

void QCPLegend::selectionChanged ( QCPLegend::SelectableParts  selection)
signal

This signal is emitted when the selection state of this legend has changed.

See also
setSelectedParts, setSelectableParts

§ parentPlotInitialized()

void QCPLegend::parentPlotInitialized ( QCustomPlot *  parentPlot)
protectedvirtual

propagates the parent plot initialization to all child elements, by calling QCPLayerable::initializeParentPlot on them.

Reimplemented from QCPLayoutElement.

§ selectionCategory()

QCP::Interaction QCPLegend::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ applyDefaultAntialiasingHint()

void QCPLegend::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing main legend elements.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

For general information about this virtual method, see the base class implementation.

See also
setAntialiased

Reimplemented from QCPLayoutElement.

§ draw()

void QCPLegend::draw ( QCPPainter *  painter)
protectedvirtual

Draws the legend box with the provided painter. The individual legend items are layerables themselves, thus are drawn independently.

Reimplemented from QCPLayoutElement.

§ selectEvent()

void QCPLegend::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPLegend::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ getBorderPen()

QPen QCPLegend::getBorderPen ( ) const
protected

Returns the pen used to paint the border of the legend, taking into account the selection state of the legend box.

§ getBrush()

QBrush QCPLegend::getBrush ( ) const
protected

Returns the brush used to paint the background of the legend, taking into account the selection state of the legend box.

The documentation for this class was generated from the following files:
  • src/layoutelements/layoutelement-legend.h
  • src/layoutelements/layoutelement-legend.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/tab_a.png0000644000175000017500000000042514030601042022412 0ustar rusconirusconi‰PNG  IHDR$ºZM?gAMA† 1è–_PLTE  ( ; GS X!]#aÿÿÿ$ BbKGD ñÙ¥ì pHYsHHFÉk>IDAT×c```P`0@h0&a6 &— Á‚KºÝ%tEXtdate:create2021-03-30T12:49:01+02:00V™U%tEXtdate:modify2021-03-30T12:49:01+02:00'ĨéIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemPixmap.png0000644000175000017500000002333514030601041023771 0ustar rusconirusconi‰PNG  IHDRÌ ¶D¬!gAMA† 1è–_ÀPLTEÿÿÿ÷÷ÿ00õ£¢äééþ^]ï, û õÒÒÿþþÊÊʸ¸¸ÃÄÅ¡³·+Ô™™™‡‡‡gggWWW¨¨¨‹–—wwwGGG(((888HPThqw&/8Á‘ái­Ï_k—¥¢]î Ö™2ýþåÿpØÿ°Rû‘éÿÑúÿ .ÿèþÿûÕÿ žQ`l/L[ôµÿÔ©èf÷YU™2’êÏËÓH´ÿZðŠo³kÕÿÑfÿ-œŸ¡©×äG}5pbKGDˆH pHYsÃÃÇo¨d%DIDATxÚí}‰z9Ó®—ØZŠµ¡ Ô_Èž!cÇY<“œÿþïêTIÝЦmÇ@žA3ñ‚‘Põ«Z%UÚ¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡Ú¡ÚŸØŽONNNŽwÖ¿g{vrvt>x¾«iþ!Tž@ßÓöïÙÎΟ={v²³iþ!T×¾m¿ßö|0=˜ÎGNóÏ òäYüv:ÚQÿ¾sz2Gχ|œœæBå0Msgýû~ÌéÈ>>pÑ>rš•g\síß³>?*§ƒìaí„Äog쟺ï=•­}{Xÿ£§×&ÏžŸN^ö߆7<=:ƒÚ™©ûÞSION³‹“3fì¿ìè ½³Ïò±d¦î{OåïhONcj»%r[dþ7¨üùß ò?BæƒÊÿ™ÿ *ï"“0.dÑgäÁ¤PÅÆœ™ê°•vNå:ڙʈz¸ »O`R¥uÎ 1™é½sSëÙChìñÞ8g­ÓÍ%±§`â¬9Ñâá+xoÀTrjàc®¥B _ü"Ç÷$Ž*‚á„+Å%ÜæAÖ‡ØS07a1K%X–qþhݘ̧nj/¡˜õÒBpœ1é&}à$%”.wZZìBn]L† éÖÉì÷È//+¿kgÿc¢¸h ùjŽßÁË×sÚìõêEú×óÍèíj6÷¯>¤?~úë|8z ßûSSô]¶åàøQ¯a^Å^Í_,æóÅäböYJ¤ðÆH'‹â’s7óZ ǚć4X`kP¸.ÏóÿçJÙ<·–‘«á`88+ŸLázô¾:Çw¿À`?ô¡¯ìº"²Ih¤uXùÀ hKš)½™¿È^æX¾ ®ò¯ó)wŽgJÔÈý2øö%ñýüŒVïõ2ûRC· æ›óðï}ñãñùí§ôZßVôí§TLàËàólqõÏàÊϧÎEN2ä,|q Ðȯó+ã]P â.Ï(|Ę–£ž”€^n§‹+ÎAR  Gøgž›×ðìNiÌ}Â×o}諉´M´f«\¹¤æ=€¿?Çe¼ ç/o†ó¿/†ó…¸ æŸ/ðõb0ºx‘VüeŠbÞ\P­Ökpÿhü { N ×‡ây¿Á*½¥z3áZý2úp=ŠËïõÇÞ¡°ØF½¿ŒF?ŽVƒÏ_Àài0ÍE¸YLÜùÂÍÿVXüÅ…6ÚIc„±¹9úäbgz2|+Ø¿ßFâ iÇ&À×¹ãB`q1,®f³Å|‘‡ÏƒÏù×ÁK|¢ð©GŸ®Gç£á·ã}¥}è»×ýˆtŒÞãUBaTxñA"~åÎ)<ãÑà6+iFœ/‘„›á·¼q~:˜g~6°zõùüþt3ûœð}A/‡ðÐ^ Sg—õ^‰3‹ß°×üÅ—Á¿éyÃÚ;¾¹ÅUúWZ…¯?~ú óüøþèçèÃ&bˆ}¯a¼×ŸíÐq98@°âLzñ‹ß,¼¼˜éůÜ2#˜ Æ Ï:íçÅÔ}]Î4Áø:Bø ^}•äl6u+@ï‚KòÏüêŸùgy±˜-ò|1Ë-®Äbñ¢|¼æðNiEßÑÏádOú®5i0@Ð×C $>ÒòÌá-°*-83Î>‚ùn‘x‡,Á!˜°¸ЗØsáI=7¸ås ‹÷'t»Ôz%0ÓoØ †ÿ~þ#=ïŸCX|ŸUÀ¼…×Þß|<¾¾˜?GŸ€ÎÓHñÛÊà´“˜ùâÿÝ,¬½˜¹¯³`µ -5S„ €ÖÐ×ùÿèj¦éy q@Óm‰+lph@O:wµ˜š›¹v__Sùk–ÿ=œgŸŽó9ø°¢'|~{Ôƒ¾ëDM"íÿ 0W„‚Ú}ƒr‚¤üÀWÈ™¸ì^`¦Ù·À|9Ÿ¢Na¯ÞE0ÅÍŒ_‚™VÁ«{‚9út”ôcL\¼ø æèSUgzw³`73/Ïg@ÇgÔý¤i•×gz¹ó ¬Ó¥À­wø»˜àÐÙbjÌÅôÕüïñÝ`"ƒþ>0ß^úy»˜_Wð¾fðÝš_MN4 \M_d(ŽO¢Ú«!f`¢òxó!@£qþhÌÂO7·Ç ç^ û–Òçh˜¥˜ý‘Ñ%˜b:¾YpœüüÀ*LW ªn£]‰KXFâº:̯¦'‹¯ó™Yü `æ°b\!õ^/Á\ÑwýVïíQú H{T­‚…ëJÌÖÀLþòzp>B+àXWf>ŸMn@1^ æ‹——‹‰Œ°|KÈÃ[ 3q!\ÎW½P+_Pü÷*@+0AÉÞ¢nþˆ–ÝÍ „ë¸ö†ƒ÷€g_,SßÂ. É°¼°AaV3Pn`½ÍgŸ§ç³5ÑÊL“‰{çl€Œ‹u³éÕ|>µù÷â—ú2ø»°GK0Wô½¢kÒ‡¾hå”P BhÌ/ƒÛò—`Æ™8&¨œ½B…bEŠæ1®6‘¢bÀãÊ¥ºébÞÑÖÍÿøæ[):ßn$¶[0UÛòó¨Œñó+­'ZðWkÃTq­5ÈÍ%%‰-ï&NÙ¯‹Ïqç5W*žj‹ýI_w«ÌãUKx´f¯Áz†—'ƒ'¬²¸//ÆßóÕm?,ׇF®Où?¿=„¬µ`rËÓW3#„äl1[3-¢Á¬1hÚÌfSÉJâhFç_¿ªõñÙÜQœ£³)ˆ•ðÒ)pCËÿx}wƒyš•ÞS¥]¯”ÐŒ-—Üó Í^KC´ÓKê”È—=‘Ìž,εLâ4cBsQá]7_*oK’Èå|îJ'ó]˜ÄÐýJ€ÖH±2°öLbä:+†LÇ­×(wz¥)ét“§¹e0‰•Œñ¨6óPÄ'CÜ#©­Yeƒ4A•ðéì[Z}!÷RªÊf¨L¼r”¤5(Ví„—•Hþž€‰a9B‰RÛêç.˜&«ãÆÙÝmË`fã µðÑ; ¥´µM,A…°À"¨ÀòQ "'«œù«¹ÉÜR4ñ, p9]<ÃÀõ$ðm“ÙÌ H·¡+@B—Nt•#_à Û3“lL–EÒKÄæŽÅ#$}]“aótØ i:& ÏêßãÌo&Æ(›ˆ°Á“6þˆi\%JûÔEjR)œ."‰—Ïû€Rr¤¬G5fì8ÞCľzßT²Û’&Î|êZ‡Õæ‚T¥5¸©1 D7â"ñ<|ç»·Ä™G Ì5êÄ5ìÏqHG(o.V°È£DÉ´JVDNS˜-_`>µ2I`¶‰dyXy¿”h–$¢‡Ü¡V“vl@®;¢·¥ŠC'#´f×™iìúpW¦ým&í"VÓt/ϲ•&Dqså®óÁ[²fGhͶ‰T‚ÔŒ9:1 ís ÈU7¦Ë¶öJü¶¬Ùu~fLP†u»é€>MB†…åNZQâîÈ%³s?SÙM ôÁwÑ㎂³m‡’#t'±Ûª8t´>G{õº¾”®~Ú²N¹¢…Ã¥Lm/3ÓkO½m4®¥R×·kYpäû´%h[,';S†g1û³¶ša‘!SÀJ­?µíuÐÁÆ/óÓŠ©Cí:é³`RWÏþ"4Ö4dh[vÄ4ñöÞ”vªw¶7ÔM&fcÈðèºõÊY[AëoÇ(?Q™ÎsïŠL`ó¯è±,Š‚ Þo}2ëŒmìéMà ­—oem)¥ÀýĨ1^¼i“¼C0©˜> $‡õ¶£«f ¾¼ÎˆK€ÒVfŸÁ¤Ê4’7Ñ<¤D€5•´N¬NnË6MÀõÚjæ$¶uw‡`âi°ì<˜©e"-¸!g+(ÅC´Œcñˆ–ˆ¹ËÚ%˜TMÌÖø)ï|×Þ*㥙 ´MvD×ñ.i^j=•–TÍ‚ ²ß:ÜÈcÓréÙ–Ò$…õ¶LK+ZFèÆÿ»¡ÜJ<‹¨Óµ­V’ldVŠ·ksÅ9þŽÓÔiCˆÌz ñªæƒØ!˜Ó¼pó—Öè¤ã’¸*Î:•¿ Zçi7ºm» ’j@r¬e0kuo²ÇïÑj™©Ù7œ}myÒ‘Å;z©º¥,À¬WŠY•¦9JTÞ£ôÎ]`^A7µÀü匳_y¾(Á´Õf^‚àhÐüQ®ÈÇÎV)stÊ?V]Ï)GgàT°KZñw`üÙüJO'0‘Ädû<–Ä­Õº7e™–Ä“í"3µKÁdÌ5—­BDåY62†uÍt ‰`6Ë´T™±îGPô¢ë±µ^çyÕdnýõ’Z¥˜r¿»4ÍñéÑñªN±0í?ÀšøøÅ‹¥ËLp6¤›ˆSÉ87gÎé%o7C`Ô µLâ¹W½J³è~ o‘Jb©,oïîkÇX]fžJlSkÀ:2Tó&×S([®dú×a¬Q×JÎ9cûÆ™ÀšÕéR!µ¯í¤³b·L1¼¸lýÊ lLå¸)“t’Æ®9æ´ªå‰sÀÄ>xÓ„°D2` ôÖí8¦@7WØxïÀl&S’×–#Yéc!F³ÌW.×>•o)ÁŒ¹T¸…ß››’ Tb5_£ÄP‚õëK Øi¬BÐ’RqÅIï…æ{§3[-ži¯[EZ(**OÂpÆûÜHÙ:˜©d ž¥­3  ðTÑ[ÉV cÔ››­xÇâ ëäí˜Y{Îʼn‚åËc»*­°épåÎÀd–™r–δöó”²Î|˜°‹)sÜæ²Bu]:e!Öù1B€ÊÔÓ­RÙ/áuóœ%ÁãKÓ“Õ“K/fzmÙ˜1 C¬_%:6gÉ´]ì#”QýUg¤& '!†î'±—ÜnŠäžå[ꀨ+°ikÙ(•Ä\ö¹¿¹#0èkàÛui˜bšÝ¶rt¹)ê•%í4ˆX*ºDÄ8 ®êÀ\ÆÊö L¼®_™ùX©ðˆ(ÓdµçV®èε»'`ªñ‰€G‚õ¢+á/ÕV´™SreãÝÌ@g,FÁè,KìX›©‘¥ì*ä^ ‚µ2wf9b…P•¼*d,=ø'dou¦ jRÄœ–¡ÓDSAs¸O¾Æ3ýʘܤô‚ ÌÈC÷`é0]ÖŽUŸÍv©ì]¿ŽúÀ–…””ôL¾R5’7Ç"³ªï˜[“®t¬Õ’×Ý„â1y‚4\¬DÃÁx’‰"ü?vAt.Y0‰"ò%HY¾]*û#$Æ«ey{*$XÆÕKz cî+gf bNêXÆÜ­K¬N1¹O/u•·âèX΋Ì Ò5‰ž@câ±Y©¹ÆªÏ«‡³o`f|ÇÕ† h‚ž¬@Ç=—ÜnJq½;0¥%I%:››±½#D¥°2Zuß–­>mi üÓë–«t \pá!Ë*°w`f‚gÕŠJD0Ðó•¤T<&•½Ÿý³U0YPŠëXòÌM¦ò~ú †+µæk³bu&Í…žhl 1+ÞùþÙÊã)$‘`‰GYD•À¬Ãò~h»`Ò ñ4@Œ80U¦}ÃT½Œa4„Æ€Au­ì˜ÌDr‰9IbúT$ƈûB¹åë Æe¬ˆ8â&»°â~Ž;Ÿ¬/Ëñ´j`í˜õÆdÌ÷ÈÝÄëŒa²öi¿bÚ;s öì´ˆ ~ãl"òx@)áÎ3¢%</Ñ”uµíÜ=“KK€Ò„I “õܵÞ!˜™µY:)§˜‹Òi¥±œ6ã¥P}¢W”h‰ EpEÀWÁzxÖN%×óD¡_Ò¸¡¹ß`Ÿ2w3o@¨=î~.ÉnÀd¹˜äÅ9¬  DEÀpƒ\Ô`½m¬6ƒIäœóÞNÁŽ£8î¨í* È, pÁoÞ:Þo0Ë4•D€s21œ‹¼G†Äƒ‰W‚ˆ ©„$ø„z":…‚c]$9a›Œqe%›`‘-kFyµÑ‚++0JèàO mƒß •×™ãh 2sœ#˜’²Û“š\èx2/ n ƒÄ ŸEii6„,Ç[–aAoø‹ î“9¡µÄpµ‘ÁÈjc¼ƒëä¶ ›€˜Í€±PèˆßoïkG`b¥ 9 ϳcø‹Mæ®´}ú(~2qX;£Ã­!Xô®ë¬&ö‡€™ò"2¡$øÀŒóÜrBWŠÌÈiz™±Õ!ÆÈ„”.HjL¨ùØŒÚnOû³ Nh­Ñ{4XN«*£7âQO>`Ö$ð¬¯RL°b¦­Õ;.øñ›ÀÌ(î 1vÞÜ•T±1º$÷åÉJ# ceÑ@áÞEûŸæƒÛÊ™*›íÎ|³=ZJûðþ0c»«®IŸ–R9?¼?=y‘œ=1‘}ŠÔl˜åã–ìV¨ÜX×dó4kßîß.p1Œž=-‘}ŠÔÜÙ»d·Båƺ&©LöÛƒûg§§'ƒ³§¦²W‘š»Úc—ìV¨ÜT×dc+ú=¸ÿY†©?ÎNOž’È;‹Ôôi]²[¡rS]“''¦qŸ’ÈõEjz¶G.ÙíPyT”üxDÅÇõ?>9™'gƒ§¤±p¯óȶCåQYòãá7ÛžÐpðüøiK~~€mPYZíŸåcûCßgÏŸX—<~Å=zÉoƒÊÝ·çðˆFO]¾å±+îÑl…ÊC;´C;´C;´C;´C;´C;´­´UylX@äU;Ÿô›jöÓTë$ýøñÓ_çÃÑÛw«Ü¾FJ½žazî÷¿¯vÇ¡¥Vƒ ˆEDj­ fQë¤øñøüöSQŽ£×H©×›øÖ7çÃ^ €ÿÑ®)S©\óæføá¨ÇÒhŽ¾yè/°ê>®+ŠÓµVß}|~W—ÎI¬e”w0Ò§û,ùëæï>Â4Þ£÷X@$‰¿Åz'ƒÑÇÅVkU8Š¼ðX…£×HG±W™AØs!½°š5eª ê#ÌbsY—Ö蛇þë¾®©Ó9YèrÒêÇÚÙtN¢Ò½òá×£·oî© Lxþ?”·€Ès 毘±<þz=$ÿMX«u’ üô`ú˜òŠ÷)õºáê=ú9ì¹R¡•fM™eåšçqIm,ëRýd„6Tÿèº5ÜQÙåøüÛÚÙtN⨓Q~Âwæåj®ãS‹©Ê¯GÿW@~;żû ÄP,âÖjD0oáµ·˜;é1Rêut|ô×9vþÖo!½Æ75jÊT*פº˺ÔG‡·÷úçpxû©{èÖpål*ió{N¢›Qâç#¿ô.Šq0«µNJ0?¥Aîfœí1¬„>Ÿso·Ê¬æP€¹±H}tøà>CÇUw½ÌÚpe—¿€1×Φcë¥óN®«Üñ ä ʯTÁ¬Õ:Á¾hÌÂO7·Çqz}F*z=‡5q úªßBºNâð ÀÜÃELÞ§ú—ŸÖΦ=‰µŒòîŽÿýíaU8S»£µL´ êñG½î>³éœÄãèúƒZ½¦Ìò™<`i´žãㆮ wÙÜ æÊÕÚ>µÿÉFYzoloQ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayoutGrid__inherit__graph.png0000644000175000017500000000265114030601041030224 0ustar rusconirusconi‰PNG  IHDR‹Cøûà¡gAMA† 1è–_-PLTEÿÿÿÿÿÿ222iiiQQS™™™………ççè°°´ÔÔÖP+nnï8ÊtRNSªvå’bKGDˆH pHYsHHFÉk>–IDATxÚíÜÏkGpÿ i‚„Rj6È·ª®LqOŠµ ß:«}ò¶¦ÑÚ£ÿWk&GûÐB&ôÒœŒÉ%ÐCþrn·? ÿCßìÊŠ½š™Õ.µ]Þ3XcÏêÃÎÛ –¾L´Äꨥ%b˜õÍÒÕÕ0PZé´5LXz) bn–`Œ»0aȘ#{ê9‹2þ‹¸Û mó•q&dMÁ»êà³ô9Ðììug AÈ8çìlÌ>[üŸ?=›e²?ùl€¿ŒYpÒælëT83Yo|1û†àDS}ÇY`e>.*mDø‹à½¶rã»g³_¢Åˆe8h|ýJ1/¼lQ›oÛÎÇxòã@°[ë„È<ïºÅ]Øw|û¯|Î ªÔ] £Z˜â"æn(_:fÒ+¨«çE3禰’wÖC˜åä}Ì“äï:˜—É_u0ÿ$Éq ÌU’|¨Î¬$‰ýRÙ™Où³:ó륲3 c½Tv/T’\Tf®ó¡fT™ÁeÙ!†bˆ!†bˆ!¦±~ßÛã?Å”üæâ?Å”“y»Äè‚·yÆøq¦Ò­9†kSàǯ£.;£ ü~‡ïð2k=À3èfƒ.žá£ü6Ö3]”Šÿ‚Óàt:º³Ñ~o¦Œ:e}‹_Ó0/êVà‡ÌÊŒ¹PSb60¶˜Ý üpQá‰àçéo³øOÌüÜpÁÙÀo[ì⤽Éâ?1<Ò´¸LàWê..üJ1®EÌÅ,øåã?Å~ÖÜoÿQîW‰¡Ü¯°(÷³0£ÊÌ}yM 1ÄC 1Äs™¦sî·mb×°/42mû²"¦cÎsè̘3@gÆœ–g´à‹Òe€å[Ìt`ù Ît 3ã.vÏe€ïß1:Æ9ë32«Î¹ß®‰Ñå~…E¹_aQîgaF•™‡ÿòšbˆ!†bˆ!æ0Íâlΰßo;ϸ¿¯Ó½ÇûÈDr"FW‘‘9„@JZ1 eŽ¥«i5°0Þóqë0è}O< sôÆNgÈÃ(n©§øêÈžFÒïAˆ?DjF€“3ÊI÷ñùÓ³9Š¹ÙQL,ÕŒôc9Øqd²Þxå0îû×L xH,Éë¢Òå½(þ,J™‰bZ890i‹‡ØâŒîDGð£ZT°ƒÚ¡j±bl‹š]pD¶ä[Œ£Ÿg†)ck±”þíË<Ùªå.†V-Œ±ˆ¹¦ž¿ «ÅÛù ûývóŒ¡(÷+,Êý ‹r? 3ªÌ<ä—×ÄC 1ÄC 1÷‹i–Èý¶‹÷í~¹ 9¦m?ÿë"FW‘±ÆŸcÿŒ?'&·ÝïVÁSÜ Ùo+“Ûî·u*žzà>ûâ¤4“õ@ðã7ÙWÍWzQi#öq„Ì~ö¡Ý™Üv¿Í·mµ(|PŒû¢rÛý.¡›µ¸«÷Ïo÷cØì\-tc³ë`拘;eˆü4Œ!ü3oøsù«éPÿS¦–úô_æ×T8ñì¹Ã%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/plottable-errorbar_8h.html0000644000175000017500000001342014030601036025727 0ustar rusconirusconi src/plottables/plottable-errorbar.h File Reference
Data Structures | Typedefs | Functions
plottable-errorbar.h File Reference

Data Structures

class  QCPErrorBarsData
 Holds the data of one single error bar for QCPErrorBars. More...
 
class  QCPErrorBars
 A plottable that adds a set of error bars to other plottables. More...
 

Typedefs

typedef QVector< QCPErrorBarsData > QCPErrorBarsDataContainer
 

Functions

 Q_DECLARE_TYPEINFO (QCPErrorBarsData, Q_PRIMITIVE_TYPE)
 

Typedef Documentation

§ QCPErrorBarsDataContainer

QCPErrorBarsDataContainer

Container for storing QCPErrorBarsData points. It is a typedef for QVector<QCPErrorBarsData>.

This is the container in which QCPErrorBars holds its data. Unlike most other data containers for plottables, it is not based on QCPDataContainer. This is because the error bars plottable is special in that it doesn't store its own key and value coordinate per error bar. It adopts the key and value from the plottable to which the error bars shall be applied (QCPErrorBars::setDataPlottable). So the stored QCPErrorBarsData doesn't need a sortable key, but merely an index (as QVector provides), which maps one-to-one to the indices of the other plottable's data.

See also
QCPErrorBarsData, QCPErrorBars::setData
qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_9.png0000644000175000017500000000136014030601042024416 0ustar rusconirusconi‰PNG  IHDRˆ#åhŠôgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>"IDAThÞíY1RÃ0¼09?€Æùƒ©ýZ蜄'˜Þ€–šJSû JQå KYÖ]˜ c%ƒÖou:¯Ö’Ç €<œÅplH†($C’! Ëñô†žc«‰„+ºwç‹ñ)³¢-ÇÖ[:§-ý&¿áÿ`%¢´‡($C’! 'bH6Û•&²¦Œ2Êhí˜Ádö¸Ñ:X+<¸ZÙ^·öÆÁ!GŽ0j04`ÔŽ©aÐÚ> ÀàìE5U ¯Á(Ñà ª÷™Þþä¸'ÂØسrdšë½ëCäõB« ܈ ™¶dtT{ÙfoAIvÀ8Œn¯¢æ¦Òx!Ó6U)—]Ù¸Aá¶6Gƒ¥‹sôèD}ÉÉ%ÓŠ¼¥Òö‡†•ªÕŒ6Dfïr‡¡–vÒKvX@¹Ú°n¼ú’ë¼å3Ô oª¿1D¼íÒ/wôFïêeèô!ǽüM××ØÚgÀ‰ütŸÉ…dˆB2D!¢ QÝíŒÄüo ž!ô[Y$\{ç‹ôõ_"í! É…dˆÂ’cK8.|Aj/M–ä%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-pi.png0000644000175000017500000000146714030601041024126 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨diIDATxÚíÚÏmÛ0Çñ_.’öÎt²@²'(  €´€N] Y@îmBô`Y¦ÿ d•ïÙþ~|bÀïåg‚”hJÀLɺ'=øè‚èÁ_³{XYwïÅ„àl¼5a¥ïÌù´y•æÝX.[ÉCK¾{`TžGËâ Àù]{ØŒ€CÜZ8súñªRmÝŒ¤ ^I½Âg`¡RRå&Z©ø(8VÙ:‰År¸”Ó •~L×OúfÝŽ¤VVzQ{Å”õ¤W7yI_ ‚c•­“ú­•VjŠçðRö*9›¯×ZÑAGaZÑRÑÕÕSU+Iýt‡å%íh°«ì!‰N·›'Ôcù|à”ÐkwhXvTe¥d ž2°ªº?aÙçÕ™WöD·31ͪ{)„ºWP§î`%)ë³þ\}^Xçô G•í’JJº9ýqt¹ k½­V:ˆ¼j£JÒ AwºÓCáNvýÒI]Ox`ŸGP«¯Ì+Û&1Œ{X?Oý ‹µMÖ¯¼j­^÷Óß_ ºÙú;]Ýf×ÿŸ§ <°Î#¨U£ïÿù~eë$Ö=<+œ6y_Ò#aT3†õÉøqh%E½]]=eàu­£ åýÊ–I„ñ‡§(™Ük¾a³™³1%BÙl(F%õG·9KvdqË[6U·›¸ÖyÄìw°m ‹Ê¶ITêœÃ²‘pÁþ¤PÙ¨¿/G%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_18.png0000644000175000017500000007207014030601042024504 0ustar rusconirusconi‰PNG  IHDR{ŒÃÓ‰ÿgAMA† 1è–_0PLTEÿÿÿÿÿÿjjj––§QQUççë///¯¯ËÐÐÖ××åee•6*""Xc©ö2tRNSªvå’bKGDˆH pHYsHHFÉk>s"IDATxÚí½}Œçç¹þÇÁý—§Ùd‹/-ngÎí`€;€[Fv­ú2’g2îvh)çV²]-©Ô–±ÙtÆ=¾»Y$»n¸=ñ$¬Õw c؈˜-ƒ°E5(ÁŽÓ͆ Ùs²›Eð°-’÷¼Ézyªêyê•Õõ|4ɪbU±>ª§~ÏÛ÷÷Ï€P|õÏÿYÔg äA_¬%ðÅZqÆwߟú©ÃQÿ7Š3>ÙW-EýsÜ(Îøü½à_Èø¾€ö’¾`ö’ö>‰¾mÆ°MÆ´7¾ccÓÆߤ|€Yy>#Ÿfø¤Ñf QKWF¥&©ø22 _çµ{ãÐìÄ´ñÇ7{ÿ™‰¥o®dÒGÀù*>é˜DŇþJžÖîC³|çˆâo LH™„âxúÉ3`Y®Lȧ3²tZðßý%¾•Òßä*ºÐB¸M®)a| _È"—åi—25ˆ/}dbå°üØJ¦t R9[àx®<¸ûžƒ+ðMwožyT"øÞÐîCŸ7ðɧ¦fîOç¥}Ëèø4˜€÷ÚÓÃg\ðá…è­, |‘ÊXx‚Wd¹ Ñ€—΢[dî9NðIh­Š/DoÏlá9 n>ª ¡ ©yX0NÝu<…ðÝ¿Š ϧ>TxVàp!.<Ÿ}uã;ª ]^›g>¼Šï ]áÓÝâàm”)ðÙKSq€×^­S %Á°d^ÄUI‚kVa€‚ߺì“÷Éh¡ºÌdP$£­8äוMæÃ|§Ž.Ù{¾„°©¥Ÿ>0Z/ðÙkpYVË>ííͦ–۳øLPx;_OƒÛÕ%ýy ½€Ï§½¥7žŒ}à‡·UøJ"^T>¿àö©Ê.o ÓS<áCám5#"^•3Aœ§NIÁ—qÜâ; §>$;žø}fñ’8—û<9µÇðÙ†j”bAò_71”­k¬úþÚ(tï—~z·ñ. €Àg!óe±ÕæM |K©®›Âÿ‹Aѯ„ɧ‰xqp+ðÙIY~"9…¨†ž‘gH»'\W5îí|`ßÊJÉò<}Õ^Á—~èlÉ) Äíc)‰´{ðÀÙÃƽ½Ùs*Éâ<}Ö^Áwþ{eà"|³²DÚ=¡=¿bÜ[n}“ùð¢ÍÓ›(ølÃ@Tx.}K"힀ŠGŸ7™ Oû05ožzL"ížÔ“KŸ7™Cû0UŽ,K¤Ý“ºðIàó&Úeq ¹öf+Ï›˜/‹äëÞø¼)âqž³Ï2Jà£*b|?fÅ÷×Á]/˜½…$/˜½…$/˜½…$/˜½…¤8ã“Yc‡¨ãÃàg|/>û7Šâ¾ãÃàg|àJ»ù^Ôç­âŒ¯°Ýü<êsˆX1Æ—î5?‹ú¢VŒñ]hmE} ‘+¾ø ÛíjÔç¹â‹¯±]ú¢Wlñ•/¢>…1Plñõv£>ƒqP\ñ[¥¨OaW|½ßE}c¡˜â+¶ËQŸÂX(¦øz¨Ï`<O|ÅvÔg0&Š'>qó©Š%¾b+ê3Å_ã7QŸÁ¸(Žø J%êSÅßÜͨÏ`lC|Ye>êSÅßIQk*†øzïG}ã£øá›TJQŸÂø(~øæDÙ9Rìð¥·Q¥ÙÅS•¨§b‡¯Ø¬wN­Dýó8;|[è/óÌV>M­Dýó87|éíMô"ðÅ _‘4˜ |Dq÷FâN(nøº¤³ŠÏʳS2l#+1àó”²óë~_Ž˜áK©uv³‹{ji€OC1ƒ²;\yâCYäÓ†Ý3àóÙú}=b†oZ­³›]ܧÎÒñ¥Ðñ!¿¬ôì¼~÷ ø<Íâô½Ì¾¹ÛÚë µï<~w9³úJ%&Ë™#RFžÉ—à[pHYù\þÓG Ñ6Rîü)ŒLHúÝ |Áª7¯½ZûÎ{§æ3/¼NåûÜóÈ·sê…ÁÝ7Wà»/%¡m¤©Ã³_^Òï^à TÙVY{´öß›XÉÔÞ«?@ÌjØ·³6xö¡^ߢô_ø*&6 O“a Ñd päÛYSö ñá…_„RxšBá„ã»:£d ]Àä xŒßM!¿N€|;QáYÁøPáùü™yâÂóùK$t90¯ß?Á—ß°9sÊÎ/ÉKƒ°H—ä`Jî„ã[¬ë¯ÃȾ3SPXrDžÙãäÛ Cü‡.`UZ•àB5tY8’¡VNô”šõ)˜Sv.ÿôQT ´÷\ÆT:b Ç×4^ª}§{A|8NÍzSÊNxWÃ'¬„-ê3jä‹2_¡0ãû‘\ýøªî´}S¬ðn ÞÖhVÀ©pjÖ›˜Rv‚#Ï•Ô¨Ò$‘/Ê;‡È°p}©?Z æ´c…oúƒÁ» ðý[’ߦf½‰)e'È}uYj!7ù¢p/ Þ§óRN®sÚ±Âwµ3xçâ:8g1`¿sæ"SÊN¨WÔ¨~T#ߧIì —cû/Ëw¹=m{Å _¯4x§»üaà h‘ ˜jF6™‹L);Á_ý«U5ª…q®ùÂÂ-Àw,<åŒù´ýPœð¥•á[}<ÇZ;%æV^j2žš”ðÎwŽjQœ«F¾0tAa.üó$ ]ž™OÛÅ _a4ÆlprG€›0WØå%²%üÆ7ÔÝÁÈ'¢ªYŸ„§”‰Æ7=2“P¯Ã±óÜ„¤¹ìÙþÿü3e¼?TïC5‡šõIˆF3·ZûÈp¦ÎÞƒ^øÃ@„%2Â[Â=¤ï=Kv¸‚þžè–­OBàs«î¦á:¨øøÃ@Tx¢DFxK`Äg+Ï¥Ò­Žñ:“? D­(‘ÞÒPx:Hàs©B«nº8táQÅ%2Â[êC' |.UUûŒ×ÁŸÌí_ºÚ+wˆ¾àÔXð:±Œ4óbwžä‘fýþè}tø^ô‚ï9¿O8>øÒ»×GÄ(k¢øà+|¤qðøˆâƒ¯ø·G>¢øà›~øƒÑ(>øÖ^Þ}`Î\É']&ð8(>øÖ‹›£?&—ûoþ þß¿4FÏ>;õ¯äT|ðõ‹ã¢Âv=½Þ.E}f*>ø¶¦ç Kò½/Ò íJÔ'¥bƒ/{{Ý°èà¯!½jÔ'©bƒ¯pãñ’~I±ý?÷¶ÊQŸW´Š ¾bg­¢[ë½·x«õiE¬Øà›îÌÕt .üãzâéÅßþzC÷¹Ðôb„o­²®û¼ØOvÌI| ÐÕ~œl‹$F Fø@_û±Ñ¬G}Fã Øàëëð‰ì}D±Á·4½µ"{ŸªØàÛb'[µ¨Ïg<|éÝô({CªÙ‰ú|ÆDqÁ—½u¶/ ;kUqÁWø õñàý-‘ÃHUlðmn¨oóÛÛµ¨Og\|ÅÍÉMõí…Û^ö´§|Ag{j§QúlÆFñÃ7÷Ù-O{ÚSŠ¾é:~ShŸÜŒúdÆGqÁ7=ÿx¿itºÕ¨Of||uÒÙžmD{ÙHqÁ·¿Þ(£××;¯w¢>—1R|ðáÞÚôvÙÂöáRåš|—pQñý‚EâZÃæc7$Þ¬¸à»ZÚA/‹•·:ô \LZ‰Ý„³bƒï~±¤v•eŽÀ7κü'¨¥ì­NÊ*îøÆY—Ü„»µéŽÅß8ëò¡0liT,6ø|Ö—iš¾OÛÙåƒTv¦w¬ŽfNJ•Ñg|2xòÏ^³_q¥ÙÚÎ.ÏÕQÙ9iÙQkNJep?6xòÏ^.çŸÓ/êåÅ2Èî‚«óöGÓ&¥BøN£tT?’«ð/‡\YH³ò¼Í‘b¥Øàë¢Y*ÀÚiÓœ” žg«™ç‘‹ ü‹ÌX‘+ëóÈ¥ÕæH±R\ð=~À°%oÝ\mNJ…ђ§±[+²ƒ$‰©V`w¤X).øößùP´£dJJ¥fZ„>€ÍX±++riµ9R¬>zFI}µÀ·‰Ø]­;M“”j„žß}Ø•¹´Ú)V Ÿ.”?…– ð¥Î#÷$õÕßZN#§£‘¤T ƒÍªáÁPè°+veE.­6GŠ•ǧ åÓÈüvˆïÀ]m.©¯ô‹ºÖAÄ,k}®’R |v¢…òÇÉ­@x´”¤™EiÙ–mï‰Þ|á&(Üv:—>;QByâžQøshõ󃌲ËJø Ô‹šÞîœì³1ÏHGøOPà³%”‡Ï>’þÀ/jFÙ3jñI½¨…vg¡†ž~:Úýÿ>;ÑCyŒðK(­,f”µÃ7ÝÿlÍ°¥+½¡\wŸÏ¢‡ò¸ð$üìS"if3ƒÌÜÀâ¢Î½´³ t45JõÚ¿Ï>¿E åÅ“~‚4 2ÊÚáëš%¢G.?iÞ©‰ÐÅwq„òÚŠ<í¢fo¢ìaZGÈ‘µ>ÓCŸ8.¨¾b§x´6¯I¯·ëäh²ü!oÏ"åH1ÓxàÓŠ†o®2wý5¯Øyæ×›­ÿ·k±â®xàÛIïÜz_¢ub­”Ûh¶ØcˆÏE(DÁW¸]|—ÖdvÛyæ“ /@|ùui$ ¾ËóÒÈ™ÆW_D÷‚÷N9° 4Þ _®×öïîë~ûèƒÂ†ÅÇZ%~·Ùúz9È+4Ö _¶·UžýSWRûR5*ì¾ÕøŒõ†T³ž¾/Ñð‚—ëmù8Pðò§Û5°`¬7¤{ŸAx¨Æž`‚/èù§í'Þ‡1&¸\Ò-½ÐîµîTƒ»2±P øÖ}¥7y¥Íœ+ë»Ú/*­;•à®KL¾‹íšŸ»kl ñekmÃË]e«äu‰‰ÀWhUüÜ]¶sÖ>^ùy¾ÖUºb†;’ÿørÍþîï­>®ïM×ÝEÞ¿Û®~iâ ÿñüG_w—Þn–ÐkñSr¿½ áUÀ…÷C¸61ïø í²¯û;¹Mþ9?ù`x×0¥#ò_oÞßýuÕ8¨°uœ ð`¥áÓà¯L,ä7¾'|)ŠŠJªÐþõ‚²ó+ü>»SþÊÄB>ãKo—üÝßÐsü„2€o>aǪÊg|'ý[ÀÉV¿¦6”Ö烅9ñäÈg|ÝŠ¯»ËÏñ솲ó‹QÞ“"ìÈ_|EŸo¾ETtf7š;¿€1Q}°TX å/>Ü>â²pWaÑ™t¥÷=yÓõN÷œ|ÅçŸW㿯 .*Ÿj±,VÔu y$_ñÍÍû´£B;ßl_QÚÞ°7vàè’IFò_nÇû>  òº¥ëJÜt';¡]œñ—Ÿø¦}©Že›»O@rž~Ä_·Öµ‰üÄ7|:yÛ‹ÒFìÅÐkØèàŸ§ËÁ:ô¥B>âKù¸\PjéW,lâ—Ëá’ew¶MZb?Çñ‘ø¬ŒR¹4©ŒTÒ­éÞ /åá/xÒñùñPÊ65ø6õ»GFºéíŸø ~Ô¦5ô”t«H§»6îø|ÄçGÙ9zð)­þ;Uݺ>¾¦½Å>ñᇒÇèoDïCS8ØGC•²ÚðˆzÁ%úÙe Û˜’ăÁGúÝmTe …ƒ}4?L7Pž¬D¯Á¬-TC—dØ**`Ô–e UÔ—Až²œ; œVWÁKmßlª­Ÿë© ³Û|µìÇOH2>Rm ƒ–Q_xfÀÔáYäÖÔ(Ñn ¯¹›†F¢ÑÌ'|ÃÜ4¦`Ð2êË Ï 6œ~z° ˜ÂÁï&´~¿ßì·šèu$Ï'|…u×@ ZF}ÂEUb÷®F‰ÆpPƒ¯×ßnö>½üÁ7ìÆ1ƒ–QÁW™zþÁG¢DS8x¨9(<çª}ƒŸ§ÍWµeS–³Œ¯QÓ]M0HðÑ¢>„o ]–0>5J4‡ƒ'z*¾µÊºÁÏÓæ‚«¡«ÑJ,¿!¹øFiÙü IÅaƒà»ZšÛ4­¤(‡ÜœPé›A‘-ŠhÁ) ¿{õ)ׂÌ7,?ù‚¯0ì¤ÑŒTÛ÷×5£”¬vìü_5öII$¢Òxù-£¸¤Î?S¶}¸¡âÓßÕ¹V½¯ß\àóßzÙ·³y‚tQg¥dH'ðùÏŸíDðÆk] ÎïÍJC¿ÀS˜kRBñ>òºò=Td^¡Í®M0WÖ-À±é‡br´' xÔ¤‚*w8m¼¯š`­bܼÐü"ÐË3îòŽO?tÖ³.l‚á$ÛºnM<^7l\h~ζ׽*ïøº^w i3»Ðî) Jë.íš&˜®ë·Íö> ô⌿<ãKbéžû¼Øo+º$)Mc•|Ïg¼øÉ3>Sb(Ÿ”> ÀëÈWi¸¤iÌÛîo¶XÊ3>#ƒw5w~©~hVõø®Ü*xèxÈ3>Ÿ#½²ÍNvC¹N¡T&75ë "•ƒø|Ž\ :Ù*XÇ©¦”zas´&ç·e},å_úº·ï;©‰¢“7»­;å4Äwc´â௃¾4qW|¾¶¹Pt’4½Ôl¿ÓšO}<\îw¶˜Ê+>C0è»ÒMR1Éo4[Ÿf‡Ýí鑳u¢åßåzÀ'xrà Ÿj);Ãîö ¢èÄòŠoÁÛוÛV{m³í­®¢Vã³ÛÕ yÅçgo]kÍyüšmo‚vTãçD#"øR·=}émòôËîÞ[éûP5¾ ÜÈUyÄçß8k-’0%»û1Ø"UD•o ø ȨH"–ÔÍÛW2Õx!ÏøÏXÐÊïà¬7©Û7 >ÐxUãƒ?p äŸC“Ùî! ߧìen½ÿ¦>Ú%‚ 0}y˜\%Ùò†Ï©³o–×Ðsv…²—âMTwâ›ë\ßy/ꋽ¼á+|l¿~–w‡S+”…éF Æ,··0¾¬ZWA]•P®ÑË>§&3ð¹ß |×1¾“Ã\-'à#°ü%gyÃç4ÀÚ'|Å÷w¾>Ƨ5#¹§éO¢¼ák”í×û„/–ž*>}¾ôüÓž÷¦¼áë;¬·Ä—±XBÇW6øÖæ‡KÕ`Õ§ºÉ¦›se¦â;"σ ù4ö7#—i€/uÍWy´Zà›þlWŧ™G/ryÄç8ÊŒà›8ut ÌÞó%ì.˜FSχøüñÑòÎ_ᣅrîvâ›Ip´ò„ϱ¯–àËÌ ›ø{{GYÈJp&sDBKá‹”EÀØ99Ÿ»¹ñ­ÕG >oøgö©øjà d8¸û°»'ò¤©ìñ5^û˜àÓ6ó|Þð9žF|ê³{B"Ï£ć_$dšƒd…ïäáüÍu°£‹;>oøœOSáIqöçA‚ƒß·ï ã.-ñ5^ÝÝm¤Ûº&òÈsÅŸi¶¤»ß§•%¾ézw·‘muÌ&ÂFñÆ7´@ööû´²ÄWÜ\Û]Ï*ó…‰0‡Q¼ñ9ÍNIo|È»KK|©Š»ë)ý³ rå*go|³#³ÝÖxwi‰ìv× ´$8¾æ0zû.³ŠÖ¤‹ÛpÍg<àsãùfózÕ¿ÂôÓí…â Ê…ñ1‡QzÃäd+J“.@vÙ”³ HðÙñ¼ØúÌÏgh|Kéî×ÑïFÃœ¬¢5éB|ð_ÏiÝŽº³ DðÙŽñ<ÔB‰fy­Ž¬Xípí_*ÛxÒH>7šmÐœ¸lEiÒ•Q®(- 8Kƒ<à³›}°Wú3Pkú/Úmì0/Œšo§Ýg×oñuMºà˜D^þp–yÀ·n½êb«ä÷‰?ßm5õ{|º&]X€Âؾ}élgi|Ö Öo“{ÏWÞ¿½­¯öÑ/Œe¨MkDÓÒŦ»ÂSߤ PÛJ…¿Ögé—Üã³n°.l×ý?ÑìÍÛͦ~íÂX‡ú´Ff-”»ÐEפ+Ëw¡Ø…½KÖgé›Üã³¢›m1û.½{»¹­_d¼0?‘ìÂ@}Z#pº L{sWqphÒS|– Ö`¬ªvn+†i}ú “~èlÉ. Ô§5œ=LÙ›«j»½ÆŸÑn +·¸vìîm£Ã§þÂœÿ^Ø…ú´FË0PŸÖÈ —âŒÏ” Ô´óÆn[ß_D-<­Ã@}Z#‹Â“OqÆG7%(Tt»}§½¥ÏÃA ]¬Ã@}Z#jè«ãËÓë ÁÙå<¾Ýê軨膹gß dá£tyâ&ï~˜µ»Y×Òƒ‚LMºã‰^oè–;ÓýÍ^¥ø;í’ÈñÅx  µÞP Ðx³ ò”‘f~)YÃt©õ†n…s/Úß„ìÐ,é¡>÷øhý Å =–.£ºÒSàsÖßÐ+x¦s­tir>à­¿¡HN€¸Ò>W-9Œ\ãKQúuîÝp¨‹“ªLjj&£èî;br4Ÿ(㔂½ù ¾zéULkNôkðâ%}Ã\‡{/óÄÚ·‚u¸- r¡^Ð'ÕkW=îxË->S½!½]ôD'ø²;šý¤y'УŽ»Üâ3eß(¾ïf7ìšV‡¼0zúRžÎ%¾¬©}ÅPeç ë0X÷ª2xèe·käMz½•àÇ–K|ÚlBd¡ÖÀíäéäêÙhËë ¤a<›ìÇ–K|¦î¢5ÃîÉ)ZÑ&ªô>âËã>áTo§ôÕ{¹Ägì.Êk ¾ãknŽ¢¥"¬Cz[åà/ϸË%>cwÑIceÚo|Y¥®ÕøôD‚ëê¹Ägì.25eù¯¨”5ÇL)I9U¹Äg¨ö™›;­ñIÎ{§àÛßÒþ“ù™"ò¿a¹ÄgÀe \hÓ¾¿L¬;‡ø¤á»Ì°µ_?BÁ7· Ão+±žø¤ÑXîðª}émÓ”ißÿXwJêÒp[ÕãØák~ æÊêûc­Ã ;È —l¹Ãg¨öQZ\(Ó¾+0@= Hè1;ÊÊçÀ²<ƒ<>/É¥Üy‰Ì> àË+aÆ–B.ø?4†r‡ÏPí£ôÓš§}Ožýw`êð,Ðbv4õ‹`ùQìñùÌ£ð“õÝWTJƒh7Õü¿^iW£¾xÑ˾ýuí§,%›ÙÉüçÕï#'4oKuËA6gЂsÈãnl‰F.àñz—ï bÎõ`»‡c!wøôÕ¾“›æ-ÌNž°è”2UäÝY|è%·„<ŽìðõvÕ3éÅQÚÓ†ƒ/P䟾ڇ|džö=uÿ‘¦ž¿ðbv„ O„¼R}öÕTxVð×LøÒÊjKÏÁ[åáÒl/ñlÝáÓUû¨c\ÌÓ¾'ä³wåÎ/¡ÐeI5;B¡ Æ7¹rIž¡Ë>‹Ðe2Cã3žÐµR ~îð這+}À…“§V&|—•*Ž—RÓƒT3á/®ðé«}ÔnvÍÐøx„oñ ÊB›>]áÓUû&©#ã}ÅWP>BÚ|Ý\L§z‰Ž_\áÓUû´ãžGòßãÊ<ü[ØjUt‹ý¢›¬aºÚÞ¾4}| ¯øz¸|.`ˆ‘Fÿ½ÈaÄ)­Å%?ñ¥<2þ‚±èSTÜáÓò¤—¾â{ON™l |&¹Â§q°(;ùwø4ƒ<ÍS°N|èß@Á {ðMCƒ>Wø´ž ô²³Ðü‚q_ ºŠÊÎÉvÍä\u#ÖŒþ] “ÜàÓx æ©eg¡ù¹§Ø„q'îmVDÈ1{çª×Â(7ø4sû¨eg¶ç'½¢cÛE´Gãð¶¨s1~ÃSç 7ø4sûhegºçë8”9¥¤Öô½ŒÑç0Š)>Mî"ZÙyÐ×nÔ< \Ž‘æãÐî¨sÅß\eð®ð‘yí¤¿ƒ¦•úÀ\Ù8!;êF1Å7î¬I¢>ßCÀšíTSµn4Ú/GÃ(¦øFõ/J*Ÿ`•Ï‡ƒ[Œf$Qç02G¾ÃÔ)Z¾aëGÁìXðyøób[Ó#dxÒFÃÈù¢q!&¾ìš.0‘Ï~ž¥©™Hd0ð:‡‘)òUGeI™#r5w…¶Hc†oääÙ­×=áóà½9E; l3aEÃÈù’!­ßóSßß·òŒšEbÌð À¬‰UÚ÷›O7‰Ïô*ê$8¦Èwˆ¯öe)s m‘Æ ß°Ö>½i\õ„#¿Òup¢©l¨9Œ>Mä;Êÿ–fqh‹4fø†µöFÅ°&í£ŸgyîÖEE©ë–>RðÙ…õ³D? #Sä‹C—%’~ ‡¶xß®‰Y.ð ž@殾¢NÖÙEi5¥³ÞŽ„‚Ï. ̤gçÑ«D?"#Sä‹ßÏâ„ô …¶äœ|»(f¹À7b=i2ôÇÏóí*üs—duê…²ö“_î°3p—2²”A6ó ý¾ÝV#ß1Ã7¨µ_®Vøsóe›óh*;’iúCêð;ÿWÀ> ÌÀu¨ÅSB©ŒàÿÏ?S6íÍEµÝQc†oP‚™š\ü¹ùèh`|¦ýé­µ—oêì=èÅ. DøP‹§„RÁué{Ïš÷¶çÍrê=aª6øsó½­(·³]…^+èb >»0ž$¥ÑÒ·$`G±Ä7¨µ›œy|1ÓMÁð¯Ýl|æ6ëD¤ð´ 3éó¨Åó)”ÊÈ¢ðäR,ñ *_Æjƒ?fº¨ÔlÝQñ¡‰)†Õƒƒþõþ6%t± Qŵx®JG–%jè©xâëWcµanÞ‡ÓyS;¨ÒS* «ó„š ò/¿Ûo*­þÃÔËçº4!øÔ! ÆžZ_Ìt³ƒÛ«U‡U1ý=}±ÝßVZ;wÞù[ý@AF'û󾞦^üøÔCÆÞ†·:¼;¢¨¡…÷ š?4zþeÜèBºýk_+«K¢ÆË‚êp=} ¤&›ìs?òŒ›ü~©Æ“ŽfçèB³'ðƒ°¥ìüþÿ4\šÓdçøøñ©N®ÖuKµµ¿ð‘0¦õ·úÅšúŠÀÇOí´é–uKµÃuý§> ‹5c„E#~|d^{NÿèÓ™éú…/»ï¿š~±¦­ÎÓ$&“’19šÔÚ ýÞ'µOB:>‰¾;ë™?°¶›C+†o,V€Ð@ÜøÈxCg‘®—]Åçaæn¬HßgêÀ/‚¦D‹*¡ï,Ò7wªø¼ÌüÁß·8|°¹’â%n|ØUÓÐY¤+¯âó2óɲ©Ðb6}"Å•Ð?ú YT|^fþ Yâ 8O`¬Ä7ºè}†9šF|.fþ Y7Ôš"7^âƇ‡Jè}†XÐTxòÏüA²Æt¶«‰ntÑ7x¦ …™1tq1óßòò£æñ¤‹N9¬oð4vi+îfþàïÛôr¾þ; „Å‹7ºœœ×.2NTVÛ½Íü±Á—·Ÿ*^|¸Ñ¥QÓ,1Mòó«ÑÌfÝ…`­ÆG¼øp£‹®¢`2Ó _VÜ~D¼øP£‹n˜‹9ƒJø/^|¨ÑE—³½h2Ó _~»ìu‰‰xñ¡FÝOs–Ÿø^~ÄbíÛþMfŠ³xñõ> ÅÒ7|ú‹ÊôµéÞ|WgìÅ‹ïºÖšP[@¦Nótrÿ™Õòód¨‹Õ‰ZÕ¨¯ÝˆjtѵWSšÿù ~G±ZNæ*[žÊÁ¤§à@âć28hG)¥ù;ß´#5òÝA“þÖ´Y®‡ñݲÜOº'*¼ø 7ôtù[ÀÓd@™90ßê¿S³:‘Á_±ÒÚ æü]§“F»×­ I4WL¹Õµ&xE$°åÄ«|ÚJ»‹²s­nX@æAÓ° QÖ7@þÁ~SÙ¹V¡l 2ÀqâÛ_×UÚ'?âú6’ÙÅnŽfB€uB`kE0×Kx*^|k]èaº•U0g<*X×®(õ"ØÚ¹VÕ¯O5¾pâkèoþ²“6lò³¨\¬Þç„ÏÁÍsÕ/>Ãt9ÔÕ¯.Üæú2ÞAÙ¼ Ö>g+s:‚ŒNî"‡ÑP}]O;ÿ”Ìm”Xº§T˜Ýç5Å^|[ºÈ…v+ÙK×Y1Ô[·Ðcì0ëN0Áþ;e_î&hT‡ŸRü.5ßÖ(‹Âö{ìûùö» Àlj/õ¶»~+Ù)küD«Î³¯o¿+ðqâ+lj#“!¤£ŒVþz]ál‹2‡o\Ë{¥Ň¯Ø™Ü~ÈÝâù*–ð‹í ÓnTE™Ãˆ3ê *¾éyMÉ?S˱í`»Æ±»(sqµAYóðá{¼®qçorq¾~«Ì¾»(sÅßZEÓæÒåù&–sÿDz‘£:ÊF±Ä×ÐÌnHñbhcËsð‹2‡Q,ñuG9\T˜Úزì½Qæ0bŧF¸ã¯¯aF¯Ûéò<ËVìü¢ÌadŽzMµƒÌðϸàÛelwÑSËø°L±ò‹2‡‘9ꕨÛ¾ÜÍIîjCõa™bL}e#sþ"ô$]–gHd;“;Šjø/„l>øRƹ˜|äEIXe!ÆÄÓQæ02ç/B…ç2š—½L½€n¼”4Nø&=Á_m0'¬²Ô±Kóu”IpÌù‹ÐÝw`¯ú3È¿~œ•Ç _±¿9x›åîmàúÆÛ,ü¸ñeìVºÁ§5®GøPÞìUOð-}k¬ðM„Ù7>S¿ÜáÙúg ü øXÂ@5P¡qäËadÎ_4À#[ø‚ ÏS¾ý½Úà-‹gÿ?>–0Pmá¤âãÊadÎ_¤âC‘-|Á¡Ë‘å±Â·6ª,p?ú¸û'~æØý7ÂgÊ_d¢J:|Cš>8]Õí»âÀõŽ¾ÆðñÅßbÆ_Ú^qâ7ÄgÎ_dâ&2€ÿàìaýÞ8«íÌ | Ã&3S G5JÜçvÑßàRòY…~3AŽž_ÑïÍïF3Uc¯Û¼3Lr–‹FG~|,a *<ñ´Pð±*Žøš¥Á»>Ç·°Š®œtìù O–0µp¢7¸é“Rx2+Žø†¾Òü>þHëŠ]üi]XÂ@Tq€oHÓ§)táP ñe‡³¸ø}n=Tíø™.¡§ÆÏ=oÔæÌýès1œ^• ¿( rºØ•Çˆ_ñÆà÷£­«ª‹–ü¢ÄÂÃ<íYîGÿpú‘,ï?1L— ßåŽú†» ÎÜÕGÕÏ,úÿ>.|Ãì¦Üa${WU'šÔþw _³¢¾ánð\¨y;Ë•ŸÀǃ/7¨öåxûúø;*4?1/9Œxðй}üÍÕæƒSøù6/:“£‹ƒª·!ù›³ø§"™•ê%Þ„"|Wã”ÖË|Çð'mM¶w½Î5‰‘8ð {û®3…ȧ¤Qù¾ùcI¾¾ÚðUàõâánb³PzoþmÄŽ/ݾAÞðNnpÕÕG×!¦„ ;¾T{“¼ÑLñcÒ¤I3µþ"øk#±ã+îtÈÞJ»Ë®>º.*ŸxßÉÞ;¾é…yüÊ]çm§Í­ZÀ×$FbÇ·¦Îå­ƒ»ïê£+ÛèPìøÖ×*ø•d?e¿s–ƒD:;¾~ƒ¼ê1ÈKWŸ…6Z¿ ð’ÄIÌøò» ä g5À…s–³.*w‚¼(ñ3¾Âd„DŠóQ汫ÏB'zíRp%>bÆWì¶2ÞÈe±ÈyçÖE 8ðM¿GJAÎîï]}V:$j€øÖþŽ”š2×þ}èê³Ò‰æN)°ÇDÌøPÀ¹øÑÕg%X€&=‚aÆ×'^‚œ‘‹?]}–z-é7 +¾ô.ÏYúÔÕg©ìBëσ=Âx‹_ê#ÒOÄéŸ$‡W‡}²â+nWÎÈ%ز+ Ÿ€|'µ‡ÄŠoºs¹„^ùxpwÌ»ÒKͤöâ²â»\š«îÙ ¾võY+·®Ü©†r¤q+¾F%æ\üíê³Ñ‰n2KPV|}‚âä<ÏÎýîê³Ó¡fëßsŽ«®„wvA‰ßu2§ÏÄ3˜æj Ír«^ ñì#>øÌÃ-Ö|ó2èê³÷ücŸ”G*F|…(g4çä”@ºú,%ðY«ØA9£A«…ßíÚ‹>kMÏcr> ün×^$ðYk­„[¬GVÖ r‘$Ç‹¬ñIôÅ Â× V.\õ¸»úhRñ‘çÁ„|ån@æžh‘DÖdfôˆ„¯OÊM®¹E.L輈 ™8ut ÌÞó%”99d¡eÙ #?G‚ð]ÓuÎÎ>g¦0‰à÷šçŒòÍÀ|HèÏi9³4!cWÏÕ§ð¦ÉÁ—» ®–8‹Cw&tî¥â«7Pꜷ¨½ð"²¤{œ­fd`3Oø )9ø`Ø9WEñ'ÇžCj®Ê€å-ª¡Ïo CH´,3õ,qõ¬‘¬EÉÁã4ÆškjXÈe§©ðÄïGø$ùò“ÄÕ3qøàm‡‚NžÀ3Ìæj,cèßÃÐeXxâtaÄÕ3q…'|ðõa0ÂãíàÁ„Î4äì)‘÷ÃÐEŇ\=º4ʨÎÀÕwZWß@ƒ:ݾ3²$ß»|§7:7bn4K¾>@-Öd°›BíêÃmž–ÚEU\w`G¾)Ÿ$ðY Þz…M®ÇYp3S,%ðY©p·Xs´x†ÛÕ‡%ðY ²ƒÿãiñ rfŠ…>+ÁZût'𠹫Kà³ÒÕ:ò“àhñ zf M³Ïrj”ÿ&¾bÂרµ PAXrWÖyñ=;þIú-&| ¨»,0ï4ì®¾äŠ _³cg⧠˜ðm!‚9öf°°»ú’+|\¨sÛYzsubÅ‚5˜mqd ½«/¹bÁ7¹ Ò»VtoÍGý«#|ð¾ËÞæ3êÌ”d‹ßt•ŸÌ4þÔšBnÅ‚ïr u807X‡ßÕ—\±àk”3Œ˜ä5ß”»Xð- Ç1UbP]}É ¾>ês`®7„<3%ÙbÁ·…†¹0×"èêK®ð¡F—µ «…uÀ&tB:1àK} À\µÞEW_rÅ€RZg®7ø•oJˆE øPÐÒeío]}¡Š$Ñgío˜ Å„NH>s^g­7ˆ®¾PÅ€qÙEs£Y$ºúB¾ª;0ŽS]}áŠ_Y!¯³íÎ÷|SB¶bÀ×G£ä½èDW_¸bÀ·…úÛÙÚ¡Ã5¡Ó꧗çqôtÆ—‡5¾â'lÏ´f¦¨âwóÜŽžÎøR°&7ýûM¦½…kB§÷ ¤øÏrpƇ*ìÓ–EØÕ'ðYõß]mÔYvaWŸÀg!ÔÞ²ÆÖ‰aWŸÀg!ÔÞÒ`šžesµÀg!Ôä¹ÀT틲«Ïìæ™ÑØ°f`”IùRð!#³>SL|¾)k™Ý<3:]‰ö¥$àC^t}¦j_”]}7ÏŒ,]‚7áêÒ*\"eŽHy&w^Ê?N“{1 øPÂÎ&îÂÉ7e!Š›'¼ãžyTʼ0ûÂ,Â÷<òòœzLžg«xó$àC½V‡aW¡›ÐiEqó„ødYÊ”á_xy¢ç Þ$ßurJaW‘võQÜ<áŸsèýñâå 2Õá“0 ø`Ô’RJÎ{ ß„N+³›g<ž}uEƒïÔc¸ð|þR‚𡹠¥ì¼§hg¦˜Ý<3`†.3|G–%º,%šZ;ÙfØSø&tZ1»yj•|›°>Î`’ñÌÑêBj†žf@]W–ÀGj±žþØyGÏLøèBƒt÷o:î' :­>ºP‹õåŽã~¢žÕ'ðÑ…xÎÍ;î' :­>ºeKN»‰zfÊË¿uó­àCãs{e§Ý„oJ¯ÔBë·Üv{ÂÑÓjÉÜvÜM¤3S5wJünž{ÂÑÓîppÜM„egª×úetGXŽø®Ã›c›Y„3S^k^¯DvðÈåˆo—eè{d]}ùõÖŸGtè±>4D~ÒñÞŠjfJ¶×®Gsä1‘>4D¾èÔfUW_ª·UŽæÈã"'|xˆü ‡DÔÕ÷fó³HŽ;Fr‡¬ÌßtØI4&tW”ÄÓsć‡Èwì·‰¦«ïbë½(;^bÁ×è8l³Á‰_lÕ#8ê¸É ê/êÕí·‰¢«OÐÃr‡2f6붛ä9Ãù¥c‚–¾«%”Ší&ÌL)l‹ç–¾µ È*5ÛMÂ7¡K5‡}È1•¾FÛ-ÂïêËõ>ûã*'|ë°êgß_z¾©ôâ¯C>âøÊ ²!·¿½Bïê[^çC9áC6äöøž™òv»òÇX ø·­„ÝÕWØ.…{À±–>ˆnͶ° Ù„.ÛA§FNø º†mwPÈ]} õpã.|¨·¶kW<†œoê‚[trÀ‡f÷õoØlnW_¡U ópã/|(‡ƒ­/Áb5Ä“ÍõæC›Ÿ« *HqŸåà„¯ŠÛuËÕaæ›J÷¾°\'ðÑ…ðÙt¶‡ÙÕgWgøèšžÓ‹ËÕ!šÐÙÖ>º¦ëàªMæ¾ðÊÎtïS›µ<ø$í‡=ŽoÌ5,׆hBwaËn­½›'ü¼4ú@–gȇ=Žïj ¬[;é†×ÕWhUíV;¸yJiÍíI–'ßZt­tÃëê³-:Ý<¾Ó2€÷à%H¯ÌÀòÞpôtÀ7W}K|áuõ½íиãàæ)˧°…çð\œ[Â+È÷8>øÜ»nÙ[Zsuv»b¿ƒ›§”>—O#Oy¯ _ÜãøÖصü—ZW_ãS‡ Ü<%pþ?sÏq„oé)²kã[Ù›V=z¡å›zÂñ@nžèîƒøî_E…§4[A+*ø+{_¤nZ=áÂ2¡Ë9nqpó”å'á²Iy‡.“OÁûºôAaë‹uaå›:è<>•›'ÒÇ·Š[›ôUa™ÐÚ5ÇmD£][ Øߤ¯ ««¯×qÞFà£kL?Ò¡¯ É„Î9nŸ…Ò»`¿Eê¾f¦0Ä-@à³Pþ&¸|pžº*$ºƒï³l%ðQ•½ æ®Ö©«Âi®.´Ë,› |T¥>ëh~-EᔋóL› |T¥>]d§kV8ÍÕEƆÙgŸýWŽqwô´ÇW¸úÈN׬PLèÒNžýøYEq…/ø6Áuzg{(]}¯3ÎGÉ.(w*aœÐØÉßä&Ø¥v¶‡bB—Ý®2mw¨¹ó«Nge¯¸™¿Ií­ ¥«ïà,[¥º­¯‡p2ã)|ìm*¾0òM1UòÊjðç2®rÂWø€ÖÙÊÌ'+5¤½vr¬¾M©0ºú =‡”;µàÏdŒeoz¾ø¾0f¦8WRÝvRC–ðÕ‹ŸQêçatõ9×Ø’hy"'|ÓŸPŒ¬C˜™’Øh}øYŒ½ìñí¯O_»a^BWß5öT¯üIŒ¿ìñ=^züÝMÓÒºúò#;ßlnU?‰ÈßåÊÚÅŽii&toÙß|•;ŸB,do­2÷vǼ´ôYåí›Ëµþ"è3ˆ‰ìñÍU”*^ðÍÕìîïôzÂS§h䀯¶0]7. ¾«/»]¶^™ëµ+_–¸È_£ÜG¹kõzk>蓺`3§!ÕÛª~Ub#| ¹d\ø̔Ԏõ ‰O[¤“¾ësUòàMèæ¬o¾"m‘NöøÖÁ–©³=𮾔uG‘ g¾ôîºqYàù¦æ:Vk~¦ˆ ƒ^öør7µ„À»úR–©V¯ˆ¤SFÙãëš;ÛŸ™byó‰”afÙãë>0â º«ÏòæI§(rÂwÃ0V"p:«›Ïé޻υ™gü]ÍðMÇJÝÕ—µ¨ó]qº÷ܘy.¸Ë_ñS¾ óMY4¸8—œnPì}|†±Awõeéûgxî |fí?Ñ»ÎMlB÷:õæs,9ÀGÓõé‡oèÜÕ—£v5°Ðø(º¾ÿÚ¦nAÀ]}oÑúùÞfª1|fm=¾±©ýpWµ“ý[ªL‚™ò€Yy>#Ÿß2,¸Ìê;q–¾Ëú¡.ç›:I™È^h2MTQQÌÞ`fbé›+dƒ¥Á‡–Y}'ÎrÀ7w¥£ýlW_º[1-c¥§¢XRfyb’,çΟËòWå²,NËçÀ+¯Â¥šïÄYöøv'ç56¡+š‡—¥˜{ˆŠ§A^ÊÔ *r÷MžË.?J–ÁÿÎVŸ/¢¥šïÄYNøPÞö¡ž™bXí1¤6à#ϾŒ,ƒ3ð¿!¾§ÁÝàÉŒj¥»÷ñ­ë†ºkBW4uãçzìI†…'ÀøªÈÜþ7,PAæ+R¦ªûNœå€oAë+pWßbÝ° ½¸ÅþmCè¾ÊÔó—>¼ìžUøvBžAK5߉³ðõçj£OÁvõLÿ8Ö¼‡ÒTŽÀŠ|/탡ËÁ‡–MÈZªùNœe‹/½Û×u ¶«¯Q7,8È•"z€bµÌÿøÊß;f¨K°ÍզɴùFãŠV“ò7¯kZÉ‚íê3vÓ>Ñ*q}_à3)sK3V"Ð|SÆž¢‚MÚ9ª>“r7w5ø-; =E©&ï@ϤìÍÝÑP—@óM¥õ=EÙ÷p\ϤìÍ›£šW &tO諹*|ª>“²»·G•±@»úôÕëüô>³ ¾aCV &túö²ƒ<ÕuU/Ë.Ü ÷<¾Q •@g¦èªìosO¿Lß×Uþɾ¿ð'…#'|Ã*AšÐéÚ˸« Ùf+¡vžøníÞ¼ ²¹zn~ô>Å66b¨(­‡«žÜXË_ûú¦ú6È®¾¬fZC®÷9ÏW_î*;¿îÌÆ^øv6Õ·A6W¿Þ½opè‘·“h?HG|ò.H:m•ýà­2ë×rè‘w gü倯ß!ï‚ìê+ŽªìW˜ûˆR ŽW4rÀ×'ï‚4¡[î»À:…ïMXj¾SöÊÄBNøêøM]}£ZkЙôxE#{|-ÕÒ6È|SÃZCž©:ÿnSù}ÒyCÙ⻯Õ{ÆÎLuô±´t&¹ŠN“ ¾¢‚´S_û,°®¾'Jà­AþEgßÿ£(í‡k¡_£1–#>¥ÓPjfJc7=hŒ+8Ž<³lðe ¾JOiu:zOéÃÇj(l©Ûn™~°«\Ov&»g_Ñk£=8,Ê) ª*ô:NaK^TÑé²Ã×@øn¦Ñ_ý§ *À=ÿþݵ[p½éeWÙỊÀm¦pZâàÓhÏõ9¥uÑæö~sATÑ-e‡Ç.õIô—1‘§ÖЮwaálL]¶£‰xÅVvøPÙÖÂzö-"|]„P¿<×# ÒïöZ¢Šn'Ûj;¾°ûáßù`Žb£-Ä°UÖ.N/*¨PTÑe‹¯§( . žvôT½u”T.µË¢›þèFSTÑe‹o ]׆ҪslX,·+¯c|Úv·Ñ‚¾²óõrÔgüe‹F†Ux ¾Ï¼7>=Žj}¸rÙÒøH[ˆWXd‹¯€žAM–¤®ÔP¾ÀQK[Hf1Ï ž¶{Mß1KÃKåÿ…ÿÿ÷®œ0³ÎvšM¸÷ÿ¨(ÿM¿P1? äÆÎsz"|³–†—ßÿÿÐ曥æwŒ =åçïpcç¹ =1>þ¯1à[qwBù—7šM},ãÏ ù÷­1ÒØáè|þþo±&ðùû»=á â„üûÖIà‹µ˜ña§ŽßMÇ'9~…OçÉü­1—ßyLȧaW¢üR¾ŸÔ­w¬âÓl˜ìa´#ìXeø*9ŸìÃ<¿ÃÞι˜ÁÏý[1ÖßÄ©£K`öž/é˜Ä„/¿®lZïXŧ5Ø<¿ÂïµfpÈÞÎSµ8³øVŒ5—™oÐï‘Òø—ÊK@úÉKðV<"eä™ÌêS@Êiœ0ß„áý¦õŽU|ƒÍô“gÀ²\7xF–NËðà’ ßj}7ñwàùäÅ>K;O€ñIèGÀ›3·g =5øjà ð4úêÝw 33¹òÌ£RæyRRæ…4rÂL¯ã®xë«ø4›+Ï€åÇV2%dw¶ ž+“»o軉¿3‹ÿi¸Ágiç©žèGœÊ­ìCO >òì›eÈì.YF×cý}HC'ÌÓS8ñɧ¦fîOç¥}Ëèø4::œ¤óÝÄß™ÝPøŒvž@½ûàXýØ;†ž´Â?+2÷K÷‚søÃÒ·T|UõkßQµ¢^ ¡Áæ+²\…øÀKg±Ç:À_UõÝÄßùwn’ƒ§_öÈÊÞ1ô¤….ßý«àÀ)ðì«ÈóÔcjá9pÂü×ä¢m]³Ô%ø4›©yXxNÝu<…ðÁÀÂó)ï&ù¹µ[×8doç9ÄÄwSÒÞ1ô4TPä-á@{R^™\ çþ‘eI ]N˜©[á©1Ø<Ÿ 0t™„!˪$t€K2z«õÝÄÒ. O+;Ïá³þˆ#òÌÞ1ôÔVÛ÷1¬üË»¬¯¾Ä›Ö;VÛy 6‰àùœè¹Âçt´ŒÅ·b+»V—Ìi˯¡ß ÃÃMë{l4Ë­»Ãg¯Dá³þݹõŽõžÛ<_âšÖ$Ú<ýýÝ¢É: |±–Àk%¾ÈU|?!ÿ¾5Fr‡/úÚ»wì7qïç=EŒuaÆÇg£ø7 K“äÔYPƒV°‡ÿ–çw¸±ó܆žßm.&üïYü>‡‰îè=;jÆlñüŽ],ö†žöIpRJeq¤›­?×,TÇAdWprÄ/êkÙã+ _‰š%½UÖ.uhïô¤EWw_Be¯¨Üžƒ¥$šÄÜ._À§€| |Áæ+Û²Ç7­´×¥Ž§··~5\œ^$S¸Þ ä”. £—_yßÙ—=¾ËŠ2‡nƒž¡0KÁÇ_-»¡\bærN¥ÒÓÚe>ô¹:öÐ:²¾a]P‚˜½üyô)¿yóýä1!£ìñ-¢«o¿IÓœ­ùf7Ç•Eå<^S©ˆùí²Ç×#ø”÷šÆjznà‚ôr¯õIÙç“*(ó åz/9dÌCvÈß0„¥èN™¾Mú¾fÛïGÔÁÚ¤R?6¸á…·‹¥ìíXønM+­uË)îù¦ÿµˆN ïøׄù1]sÛÕ°šRnæŒÖGÁ 4ˆZÄ•QÛÀQákF“->ÕѳU…OÁ:x®L:§ñëÁÆÿ¥h®ÒØÊɤµ£´‘üÿ?6:v{ $mjÿÉ OOQ•×ɾð¼óÎM°S-vÔ!0½c¿·¦}NÅèey€þõ§  zB›Fä£4EU~('|8wí`Èž]ôBä{:­˜ÒüHNøpæèaþ©¢s*#ŸƒÐ´Ò4§Ë¿Û¹°œðጵ£ìoO£R ÊVÅ·\kmÓv&‚XNøÖџ°g=E½–Fù„¦”+^&ÉÎøæjèïh¼úël¨>¡‹·ÔL<&á‡`-Øë3ær·VAGÉÓV×Ò¨ûôdÜkZÙ°ü'“øª¼¾ýuôW“úÔ©ò7”_AhºyÛæŸ Nϑܪ¼¾éyô·ðÑhÉAfWyŸ‚еÖ1Û;ÉQŒ>µÅE3Y+ÏZ|Be”ë%Àâ¶icA7©tz%ÛÃ`ßëò1ǃèU‰ð²û%F|êhÑ$½. B½9k6oîx”håœfž+‘]tÿ䄯°‰_ty¿×¹’rÀ ôë΃Ñí¶¸Ü*w«N;Èmü–ï—{˜C3>rÄ÷yÑ<ü@Î!Û—Q/7½á+(óouœÃ9Ó&ø²¤Æ®O^ûgðœ7| y;ËpDϬ´ô5jڥϗ<â[kƒFÝqEjf¶“óÚ…YÎâÓ#¾¢R*:'“ø(ê“—ÂǺ¥Oð%w0»m˜AK$ÃVR6RÓlIG@o%íæ‰Â—¾®_Ì}šÝ6ϯж°Rc—!y5Í–T­– ›'ß‚úºXÓ-ÎqTÞ)n›é'Ïì›™ø¾„nÍVšnIÇù„[ÒŒ,!CÒÕ¥Õ%|÷Áw.À&_C}Õ?üPå½Æ~“Û&òöüÞðz–˜Ìá J‰ô<Ú‰fK*dHúÂì ³|}Fu M>ÒåqýÆ°â௳Ln›ÈÛó•s›{j¶°T³.Ï;„fK*dHZ†ÿ|ð.À&ßÕyÍ›ó½y棘Ü6‘·çÝOlî©ÙÂR4}Æ¢Ù’JÄ4T|ðõœºy2ðM×Õ7 eÚSÏ;–Émó!0uxi¶,!sOÍÖg«íݲý64[Ò§ˆ!©\€7L¾Žúæjݸê sã‹ÉmóHŸ\‘&e6gÍÉN g[R°*aCRô,41¾Kªáy2ð Æè‚âoL묵g·M§Š=Œ] ã4,mIéJ¾ÉMõMÞ|õ˜_<¶º@õ:°ô¬Ùn"Z](*ܼ£<{XkÞñ­ÁÓ8Ù±ÝDà£(5ì*º\7¯=¸Åtïø¦oÂS±/=>Šr7æµéÞ€AÞñÑLÍ^Ån¦á?ùíŠéñç_9Yg·‰ÀGÓ¨­šÚlUhWœâPjðm·ƒÀGSøŽÞèaܵøpÏ\Çf ¦Ñ=G{ø¦ÚŸ³Û¦#¾:¸mÕÓ–ÔØeK9ã[¾ËÒ/^¶9ï´g·MGgÍÇo ¿vc&~ìx½f¾ÖÈ™¤‚eÑgS0΀ BÓ8. ›Aœñ]. ßZõx_a _<ªH<^ëÞv³ÇäŒLRÁ²xøÁÚ;ßÐ7*CCqûéäŒLRÁÊÞ´Úh­õŃ²¨æ°ÁŒÐPÎø†]XXÈ÷8úÞÝI©ã—Wfª½.g|Ã.¨¹’ÕV©&Së™5;äµôâ$g|£.ýhܬyØiOÞÔÛ$¯YGw’É_J3;%uÓz»­`]7o¨ožÅçPÎøòZd}› Öªy¦áP¥Æg^ö³§äŒhƒJë‡Ô•@ùÍ « Ím3¿ÍÃêbÕ÷Ë£23”fžXˆŸ¶ÀLÙ¶< ¿ýšGÞ•v5ØË1à[Ð~p˜è³¿imRœõ[å ¯JlÄ€¯¡ûP±ßø6YŽ¯šÖ¥¤ ¾™'bÀ7˜å€¥ó( éPPõ‡b³ªù”_ü¾Ç뚎3 ÀE…sæ4£ŠÍ’öc¾§Mj–T1àÎrÀržåú³æ'AœiÑ0(*×ñ >}eÁéáUè]¯ú¦“ƒFÏÒë=gc#n|Ž?¨l·]÷ýL F|(Îõÿ0ñ>ÕXiðé#Ç/Àc£å{ÃVa{Ó´ìÿ‡‰—Xð} ûèüðCúIÓGCdrÛ7Ì ßlnÕ‚¹0ñ¾¬>ØÔºÓÙ(ÕmùëÒXh@Yšê%úÈ€臗°<ü°5wJ>ži¡Mí­J¯· tã!|zK¦‡VvA½²,N›§½v-F)½Ök¿çlÊm# ±àÓwò1ø ¥Þ€³~¸k¦v­ºi³ë-N+O&Ñ8ˆß‚þ£ÞÎ^©®r§Æ2ûÀyÆAjW)[­{Í-†$àkè? zìõf·õ‰_øJ–+>kÍUt îtNJj~è¼ ¾Ö¼åJÏZº6k³;£²pÞ†_{Ór¥Àg-}›µÉÎY¶…§„ÿ²àÛµ¾í>k¸ð=üÍi<€ƒ¾ àÁ÷‘õü³a¨”­ÅŸm¾_¹Á7ùçïèdvÚL-ýôu¥„ÿ²àûÀz˜¢Ù0T‡~¶û^|Å‚OßfM5è±Åis¾ž–3àGË^É‚ïF£lµÒd $YÎ?–å¯"W,øùà«ÄØ3¬>¥ý^|Å‚/e|æ˜ÜéDqÚ¬Â×³Õ xî1 ¯dÂgˆ¡42†¢»oêð,X~tùQ žú£bì RR慵ߋ¯XðåŒfw:{Qœ6«¾Ï€§ó^É„Ïr~¡Ù0»Ê28ÿ“ðçœ\%Æž³2Üè í÷â+|ÀXX9~§ÍlÑȉÏz”©É0ã«¢cIä1(}Y¾‹X .}+aøŒ­œ¼?³ÓæÄÒOïÆø8 Ï[›Ö}&ÃPȬ2õü% ¾ã_9Cðz,Y…§ybŠ“3ªAf§MX‚Âø8BˆÏ²¯Ñd ¤}0tYÒà{ü>i¼AT9§¤ÑÊ|­Žµ¡®Àg#ó¤L¾‡ŸOøæ­'× |6Òzƒe¹~>á«ËR[೑ÖD×ÃÏ|Ø—Ç"ŽÀg£¬¹±ŠëáÇà´éì®™ÅC] ôÒÓÙ0ԥ蘋 _Ú\Tr=üXœ6gœv’U*è…ÞàãlêÒFtÌÅ„˜g²fo²|ÏOå”*zaÉ!±á£tsóÕü|PŽÌmOqf­ÞÛbÃGaekЄòª5Céäˆ _üÈÞ '¥UcbèÅö‹ Ÿ©ÑÓÞ. |]ìs©$KløhƒLú,_ôS|'S¸'FløÌž<üŒòìY;÷¼ØðÑt¡?ü†óÃNråŒßÓbÄ·i^–r4èñYC|âöŠ ¥Ñ“Õ£À7åG³3ßÁ§*6|YÚÆ`Ð㧲šÉµ"€*6|iZÿ³G?Ji !'EÓ >@›ÒçìNç« ZCÈF0¶w±#>j%/܇_¡Y}ȉlXŒø¨ Ôá>üŠMíážÅ'#¾ma¸¿¢>^ižu'bÄGiôä1èñCÅî¼öcž-gõ#>ú̺P~ÓttŸ ÛuWûÙSbÄGkôdv§óGû76õ ÞÙXñÑ8C}ø=~í†aI Y?â!V|›´¥¡>üÖþÎTÏ 2ëG<ĈÚèÉåNçYsUsÓO€Y?â!F|Yz ;W5hmIw#gÄ—¦Šç6èñ uó,Q´t”õƒÅ5”ËA4bÄè>fœîtž´‹OÊâ‹ÊÀœÅ5”ËA4bÅGÙÂíNçA}‹Êç‰æõ ~Ã0“B+çY1+¾úbnw:÷ê[ ÏÈv[¿D¯Ÿµ,ü¨B|øõ-Â_¨CÊõ’Àg§µu1·;{]·™W‘ê¶îT>k™§·cq»Ó¹×–mëKÍÖoùö—(|Víc¼îtîµeY‚c¥7T|×ÐŒÖŹˆ‘…‰Âg5ª“×νvfv ÕჟïðßDá3zzÄëNçZ¨áÀ~d0Å54#K—àMˆm<ágdðyI† ц‰Â—²híá—¿éÔDNq …7Ú3JÄÆ~FŸÏ•“x÷Ybât§s-ÜêjÛDNq …¤dY"6ž²\EŸO'²ðVí+œît®…ñ-–m¶ ¸†Â?ç F‚Ò+3Èà3¡ø¬æƒqºÓ¹.½mc³kh<ž}uEÅ—;‡ >aáIÌ “…Ï¢ÕŒ×ε0>Û+f×Ð X…¡ËŒŠ<„ >/Ép!Ú.Yø,ë\!y`?tÛ+ ®¡Z% u¨ ^QåD‰½] $ÍldÑjÚÃ/…SŸÚ=ü>YŽ*ãs§s-’Ù®‰\೑u‹G8?‚Ïnp”Àg#«V³°~¤ð’åŸR–ÃZÂyø©Ç·icøl”³ì+ ÇNmtÍYO øì´e¹&”‡ß`¤ébÅj ×P>шŸµ‹R(=|ÅßYmÁâÊå ±ã³¾ÇB1èÉ©øò!û‘Œ·Øñ5,ׄâN7ç=Wáhq;>ËV³Üéø&Ãvsg±ã³l5 éá7 ºµŽ±ã³™‹ÊÃoØ_|2¼±¥c/v|6ŒBq§–Ð9¼ ŎϺÕ,‚Ñv®Âáâ!v|)›a^aôŒºû Â’g v|i›Ž¡0< 4—F‡‹‡Øñ›¹|a¸Ói&gÚîw³·ÄÏ®vÂÃïriô¾1üñb!|ë6ëBxøiëâ駊ß\Íz]?±“xúqà»Z²^‚A®Þ™Ú®~À8ˆßtÝfeð?ýÔè ">Û¦±àÝéôÎ@yá'ˆÄÏœÁV£à~†zçd»ôc |d¨žÕÊà~†òù °Óå—³ë• ÁÎÐÝŸï}ø!Ç^øl+0ÜéŒGvº|øl;Õƒ7è1ybvº<ølïNgŽ|/$ÝΓ Ÿ­Jît”ÈWرr೬Bp§£õ鯷8M<÷˜µ'>›ÁJ Œ‡íþþ§‰ç³öäÁg_5ÞŽöìåœØ@W|§;ð೟J¼AÍÕPàc–¥Ÿ&Qàît´»_àcVÖ~HDàît´FWYiûâ1pw:Z«/>‰¶0ø:õ‚øQš}4^<4Ï/ÉKÃ’úyô ÿ”|ó0w§›«˜9˜x.ÿôý '©øtJ¾†ýêÀÝé(±‹ƒ‰çSp,–º ¿,¯‚eyF–ñÝß!O¤„à³ov Þ£€Ò©è`âyä¹üx¶ À M½ñÁ5¤ð„ï¿'RBðÙ7»„àNg~ø:˜x澺 ?> Ÿ‹22µ7À0À‡ÞÁ¥H Áç4,psÕÒÁÄ€WàG dî9NðIC|è]•ì$)ø6í×nÐóÖ¼q‰ƒ‰ç_ý«Uø⻕žZe€ù{"%ŸíhÉÃÏÁÄsVþ.ü(Áu«$tÐöɽÀwÈß)!ørÁ»Ó™~\&žé#ôå Ág?Ú„ðð3Í¥àju‘OÑ—'Ÿ“…Dà?SÍO´yrhÁa}à?“…ŒÀÇ!»IFHÁ»Óæ>ÙM2 üá÷VGÿYàãnŽMô ÷·ÀÇ!Gÿà z žJ‡ì¼]°‚w§3”žœ&ž{ÍÚ“_ÊqQàît†Ò“×ÄsY{òáK;6«ïN×­}„‰p üÃO8Òiĉϱl ÞN8Òiĉ¯á¸EðWØéŽÄ‰Ïa¸àg2”Äñ'>‡á ƒ¼ ʼnÏNîto‰àe N| ] Á?ürÛåÀqâs˜¥‚‚;Ý…Nà‡ˆ‰8ñe‹Æ~YQwPʼnÏq¸D(=`n>øcÄB¼øÚ4C¸5 !¥«{ñâ[wÞ$xw:a§;/>£´•Âð%nÖD¼øLÖFf…ñðvºD¼øn­ÜéHíTC8ÊØ‹ËPÀàÝé .8ÇÀ />§iHÁô@¥…$àÇç4Í)xw:|”V%ŒÃŒ·xñ9÷·‡áN‡uáV9”㌳¸ñ±ŒE ÜŽh]Ø!sãc¨·‡óðƒyïóPŽ3ÆâÆçÜ߆;Q¡ùE8[qãsîoàG•Ž_–ÏÃóë!c âÆÇ40pwºNlcø~ŠÓÄ3¤S TÜøl“q ¸;ÝPÇšŸ ÞrÎTðevDÔâÆ—b©ÔîN7R¡¹U#ï>9“!>ü ²½ö{øÀÇ"¦éÀÝé4Jo(wÐá>1Í! ÜN§7{í_|l²Íæ0Pàzå7”_©ø;˜•ç3ò)d€5Œ5%üF]–P|4Cp“‚w§3èDWi®àw³÷˜™XúæJ&}D‡oèâ™l|¶I4‡ Ü£À¤£‹+øu LH™Dé8dyv.Ë_•gà‚Kréà«j/¡øØfðnÐc–Zx> òR¦ñ‘»yv.?ºü¨ñ=ó¨4õG+ɾûç·c…üðC2â#Ï>äÙy™wB|ðé—“«ÉÆÇ63xw:“T|£Â`|U€=¾s|Y¾+Ùø˜êíQ<üT|ÃÐ |äÙ9À÷ì«+Ç¿r&S!Û…~‚ˆã(êð~ÚŠÃXq€ï¥}2òìà»$Ï<Ú—èÐÅÑ—Ž(ü‡ß°Ú¾ZfÙ<©øZƒ0Ü錭.LbhúÃOàcã†à z ø˜ÄøT ýá'ð1‰qnðît |Lb¬øïNgÀÇ&ÆDa?ü>61Æ”Á»Óé5u–Ë2™#Íc‡mîtzMðyx>çú@÷¹KÄÀR7ø ÉUíUû·Ùá87ø ÉU…`Љ–Ü}-ˆ‡­|¬5º0< ¢PÌñ±N¿ Á.ÅkÅo¯>übŽË}øÅkgÂ}ø|ºñ¤†-ô¹Åá ŸS&ªöèÃàÓ'5l1Þø{üöêÃoIý«OŠ¶ý‘Žÿwò940%W]–g&à zI.8°Ô>ææ°0ÜéÂÁ§O ?§¤%ðÐÔ /’S£ ñ¥K8…<ùÚØàcš¢‰´7~|äÙ7+KÀ“šÜâg€´oy§'_|ΩŒT…âNºŒ…'N¿ô-)ó•Œ/ñ¡Ám/%)ä±Æ`­ø…âNº ¡ ÀøN=&¥ä*<—éáQ^ø»àòò…NÅ>æžØPÜ閦⠎'…%ä‘e œYºÌ.£Ôðߤ¼„Æ–8°Ô>¶¡žP';œsÔTÛãIÓßµýÚøà›«0nŽ;]Ȳju‘çm¿6>øØæøÐÜéÂUÜÍ8ÆA„äNš¾ýà#ÝØãc1e% É. ¥øn[Qv~{|,¦¬Da¹Ó¬¸ö$·Ý¿öµò(†r‹cRˆ?‚oâÔÑ%0{Ï—€tLrÀ7Ú©#·ø8j!ºÓ|™øµláACÈK@úÉ!/ÁL†XêNý/ïâÒ³Ú©#·ø8j!>üT|5ðx¾Ü}23“+Ï=¶B€!ÁÈ3}_/¹øØûÂ|øð‘gß„,§¤Ì]Oç%>¨—»°Î, ¹ÆÇqK…÷ð3žxŒeæžã`é^€ñ×á‹¿\ããž;1t!øî_NTxÞ³ žÂ›|ùwëaY@r½Ï!ćŸ¦â€†aJh»<)¯‚Ì €¡Ë|·*¡-¾ìFSÙ ëÌ’k|<®-¡ô ªíûÎVüå]úÏS+o.$9òdt$' íágÕê’9mX0Õ"õ¾NH'”\ããy …æNÇÞh¦VÛë!XPrkêeXîtìøþ×&ƇzÔC:·@äO<Öãǡ€ùõÕñ,ÕpÎÏw¹ÇÇ<Ï„çNÇÓ߇ùÕиé ÜÝ÷ð/ÊᜤŸryžÏŽ«·=Õö¶çønu¶ÿ>fíðq…“áLÓ<úÖ-qµ½ÐÔuùùƒ¨×}»ÿpŒ:Ýããšø†AOvCù-ë ½ó+è)SHEnÃVlnC÷ø˜­±‚÷(Èo4w~õcæA—36»úù5rZ¥® =Ùìm­_îj’[XÅÓâ ×ì… ~G»ÊÀv?šë0:ÄžÀÇU™ îá‡zïµsUÿ ¿ ÷>žFëà~‡`ÄЮõBÕ{t>ü‹êžÀÇ>Å)˜‡ß‰në“r {¦J h8ñIø¯ŸøȽáã#„;]v=À‡ž¥~~ÅÐ<€"ÃeàK}f¿sZòyóVd‘G|ë<ðð{©Ù§Ü4ŠÅÐ3µôÓÔd%Æw±éP[6fp¥ìø„ïr‰ccßÝé² ¡–›Z1zÂ5à´œ?Z–ðæ_ª«(lø û¾$—¾,¯¢—ÌêÒpñqÝP>»Ó¥7š×+¾î‘CL†žU¸èl5ž{L›ÏÂÒBaÅgØ7J8ÿÂ*ö}av¸Gø¸BOÝéNôZ¿ôqwœb2ô¬fd¸I PěϮãbN|dßÈî½”G{ôˆ/ôôÓnCÙªø·7n1zÎà1Á£‹½¨0i…¶od w|Ž¸dû„/ôôÏ.ÕòÖl†žK?½ãždJZûš­þë mßϾº‚ Oä ªÙ£W|\¡§oîtÊšO»r)COX˜žÂø†¡K~ƒ½ð4ìû’¹Ó¢¾õ€KCOy¾ÖdÅGI>ƒóixÂÇW—óÅn£¹Uõa7ÞäÊÐÕû²]f|柢œ†'|.ËÜé"êyhó<äàé^›'¯ë€wƒžCÖõ´ÚMÖ€wø­Gw:ÔÌâi¾i¯àã«Š{s§{³¹Sòò}µWðñÌóæN—^—[ì||S‡<<ü ½vÐ=êÚ+ø8GO»v§;Ôܪy9OŸåÊГq¤ÙYö=zÆÇcP\»ÓÁ˜ÅªºÀ3,Ò¿”ê® =ÙìO_ç,y~ŠCeOàóö}¾f3>wº”seÏŸä´wí‰ÅÇ9|“çáçTp"Q†EÊr -’Ô-Ì ?¥tÕmIó>±ø¦ç¹6gø¥7ZŸ9oEyLB‹$u 2“l|VûUIó>±ø8cæ‡_ªËÔJF™–²x°¥¼NËé'Ïì›™ø¾„Ìuß]FÃ$ï^V­ñøû‰ÅÇi7Ǻ9KÁ‰DyL"ƒ-Áp¶:±ò øÞ§P¿wj^&©:C¢ ð÷‹×q‡íáçqD‰L<Ñh½ ³œš¹¼rŽ¤PÿÞÄŠ:Lã#`%çè[ƒž,[Á‰d*<‰‰'‡l<%ðŠ,Wï~§PÏÉò9u˜$.dÉXÉÅw²Îµ9ÃÃïDϺÓ(cè0>\x"O <¦/Í–Q õÉðŒ:L{ªïût5C—g|œ5qgwºC¬'eX¤ð`K ÙxJàHŸ\A)Ô3%pს 2öT7ÀJ.>^«\Ëgeþ üw½Å3éËzX¤HÍB«äâã],~nÜÐRáÙ››F³Œl:…ããôŒ°24H)-\_(síM´yzÝgŸ‘ÕøŠ†¢Ô7ZÎypÏëØs¸ѧ%‘7j‹{8Ò_®ørŒËÛ X¶i4{Šï±—Æ~9+¾\…ããíB§¶o¡¹S·˜÷‘S=Vî¨Óá¼*ÉøÖJ\›Ó zrØ™¸e\œ®š7MëœSųÏó.xŽ)¿ T_÷üâ¦~Á·|Ýtý‡¿VS—ð ‹ô<s å>Êíd;üò?š–ü™:¯ûºnàe®§Üíò‡8MéÎï¯ý'íx†Ezƒ9†òåvâ~©(æ—(¹,™Ÿ%Oºþÿ¨E}¹ÆM~à3Ç’žI³ …bÑÛêM·m¸é„TùÏKzÇGÒ,´biï¢üÀgö»òŽ$9i‰òÒ^~à3û]yƧzØ°×*?ð™{Ü™ñIËg7ðí׎èªÄF¾à3Y~0¸RfPfD3>5Q÷,È!€Ÿƒ|Ág²ü`p¥ÌhœJu‹É7áÿÓ÷õLí0Bzù‚Ï4ë™îJit¼„[H¹ó§À²üUy†¼™‘u/ÿ.êË3îòŸÉïŠîJit¼D…çÔáY°üèò£êIs÷ 9Ë|F³Gº+¥Ññn!!†gàêOþà3ÖüèÃ/Ž—h)2•0NòFàã’?øŒÍžôá—ÇK¼têùKŸú&S!ߌúºÄD>á34{Ò]) Ž—øÙ—;¿Dð©oöÅ|ÎHÈò Ÿ¡ÙÓrø¥­ã¥F›|ÂWÐÖµlu±u¼ÔãËn„“t3Æò ŸááçC‡8úeø„^~áÓO›õŽïå®hód_øŠ¿Ó~ò«ÇAàs_øôFÞï>Ÿèc·—_ø@£¤ùàßÏÔÑKb„‹­|ç›ççCèruøÝvLâœpù†Oç¸ãrøå0Ì?ÁÊ;â‡ÛâÙcþE5ê«5vò X¬ŽÞ»~©IåÓêÿ9äwc¸G5{ìï¯Q‡-síäY‰€7ù‡Ï‡S´¹˜ZwlnêV{0ÞókeÃg]y®~…•øøüʨJ“,Mƒ\[íBݼ øÙÚùý;ÍR×ml>Í‘ˆLþá‹Ï»(`j'T|–FÙè6Ô4ŸwôžäŸ­6¹ •ŽÝ–è6ÄsÄÞ©|~(ëC *>?ÚPﾚã毖¤p{ è¦;AyV™¾¦j~è´‘d±\à©È—Õ®ƒh–_%Í«FjáyDžÈ:P–K0¨”ð2ûñ¤ŸFÝš÷}ä{UøwÒë*_°~‰à›8ut ÌÞó%lé©òqO*ðiôzLJäПl«¡´z­*ãw¾Ì |ƒs¥4ÂwI.ý|Õ~<©À§QÊ¿ž¿+îRš¬†[*¾x[<’»%;ÿ£ûñ¤ŸVsóþí«„"˜Û¶|ÈÎ:ƒGåäªýxRO«‚÷–­²½V‰iCcá‰> ,ç_–ï²O*ðéÔ˜÷uwé&›Ñ’1tß³¯®ÿÊûñ¤ŸNŸ‡7L* ƒŸ¼¶â€Æ–JàÐeæðýxRO¯FÇçýµ› üfûÎpî^àÓ+ÅØVª‚rŸhóôK~íïþ»©Þ–ÓFŸ_J÷æ}Ýߤ2Ÿê9ÝŸo*ðù::ª· R½Ïí·øüÓA+Åf¤šöÍŸŸjøúøËoß„·ôvÝnÏGe›Ì],ZkV8fÛþ"ðù©Bó°Ÿ{k¡QW쩳n 5éáb©@ðÿAù÷3©kùwñü‰õ[eËãýص“ç ǯr?šÔò§'>ï‰Ôµ‰.Oöêðozѱú°Ü&µüi^ >ïg¨ÝC¡MË÷|nà•O3¶“†O-=aõásWûòKŸ»=¼…KO¿C"n |îöPh«swµêAœ.£>ÉæKd]†¶‡ÁÜÝŸµ"¼ÿ,ñe¬¿CùÁqÁÇ–M]äc#¨øæ†ó'.òç9òMæѤè—ΙÆJʘ–Æ[6ui ‘¼Pñ»ÁÛ+­¿âŒYdMŠ~Ø«øز©£A™páp6uy†Š/µ;À}¢É‘ÕW™G“¢_ö#<š žøIhpé—åUô‚RÄ£•‘%òiu‰öÓ¼)H|lÙÔñÝw€dS)‰ŠoôðˆgŽF¿dMŠ~Ùs­ý:4¸ô…Uô2L/©Ÿ^˜¥þ4O Ÿm6uY®â…(÷¬l¯¡õ¼ËrfHõKæÑ¤è— O¼†ðÉèÍøe"^R?•é?Í“Â)õSÌð1eSRîZˆË™SYà›ÜúX÷yƒ';¸_2&E'‹ Orâpɳ¯® Â¾ Ră§Ÿb†)›:‚‰âÐåȲ¾Ü®!#ljÞN)ˆ3·“y4):Yº—Q”2CB—„ ÿ¨UIý3||ÙÔé{¨oÌÑ™]hý2ˆS·ëhRR›`þi^‹F3¨†9Gç¡æV5ˆ“·k£©Ë3ÿ4/Š ¾Ç×;¦mR]îDáž$Ú<]ï¡x‡–_<ÜPàs½‡ÂGÔá‡ð¼Ä Éá‘æú§yQ\ðånöéjî„PÄ^NŽþî~šÅØiTé[f”;Uà—R¦›e'IÅÝç~ÝéºÕ¶'` ZöçÄ MÝEÕÇ° ›à%æÙ'»¸7é76žØ´<\– ¿òã¼O4‡öÙiÕEôÎ(s®ëѤ?̓‚Á÷¢çßø×Æ]^þ£énØåÿ¡ü7¯ã/+àX“äø6öðm©7ÝPîG“Úÿ´±Ã€¦ç¯–ø4ìrdíù3ìÅE2÷¯ý‹¨1‹bƒ¯Ø16›ùœ(gêßÍÏ¿V‹úײ*6ø&7Íf~ãS} +QÿRÅ_áCš« ð•¢þ¥<Š ¾ìÍÉMý¿ñ­¼†ïÔ£þ¥<Š >°›34›QñeXvEÝ Mõ{œú‡ò(>ø®C³™yØejiÀEƒ'Cc•Úb Efj}¤õåQ|ðõA£¦[`v9uÖ3¾˜)>øºàñºnyØåñ»Ë™Õ§ÐÀnYΑ2Ƚ“$ˆG.žw/«®ž3Y4bC–‡ŸxG_ ZקI¢ »¼wj>ó‹àT z ¾œzÜ}ÈÅó¹Çfžh0¼û†ŸxG_ j}˜‡]~o§_ýbVS_b|u$©j扇,‚¡Ç'Þ‘À¨æª†ØÅ4ì2'Ëç™ì<.¾à«’™Ubæ©â«ªŸxG_ º\síÓ°ËÉð *<¿›"YáO=† Oô¹x¢Â“˜y’³2ôøÄ;øÕþº!½¸iØe¦ Ðåˆ<³Å+GP¬BÄ#Oº`3Oºì“‡Ÿx?_ š®Ò‹s›xf¢Ñ%ðªéyCzqÞF³Ì`(]_ *v`øRÒ,ð½Í¿¼\‰ú‡ò(^øt5¿ ð=ØmžÁáÓÕü|Ç—¾¯)z‚î/Ò¦xô½·½)úû‚SaþÑV|Æ·_ô¶©Â  /=ý¾ûþ7‚Ï8¾l¬|)‚Œ?ü5ŸŸ³¾Mtˆ>@¢ŸsÌuÑ`²°$mú57l¤äáS½UoÏ ôS–¥è:³¸•’‡OãPd͈ê§DáéYƒ %àÛ*:>I󞚟š²ªäá •(ûô£Šnå)¡ejwïŸdþvp®1Ä|ÎQÆ"º•§„ |lN+´Ëa›nå‰,J32ò ”gÐ( <ŽT ÓÔ3FøÖ‡ï¾ö±éVžªE©„í<Ñ[4rT ÓÔ3FøÃwYû|bˆnåIFÂÿfeuð!Êr¦©gŒðÍU‡oŸ»ø¤[yñá¥o ’‡hê#|—K£÷ë!çá[yâÂó)ø²óÄ…'9¢©gŒðí¯Þç{¾¦tÝÊ»«¯J«²ó$¡ËR¸¦ž1§óå)„ûøãO Ž©gœðu´Ÿ®„jGÎßhŽ©gŒð¡¡f]l×Â;¶hóô,£5Ázˆé>ÏÂc•4J/†ÇOàó¬¬ÑÔ,?Ï»L= ùÅv5œC |Þe¥”^o—B9´Àç]4;äC­o„qhŸÇ”úfê'| Ú‹£t8÷7ÒÒï1¥~™zÆ ßZ…¶ôDsG]]úôÈ'|nÖÙ5/dš]Fz‰$øÆZÆzûH©åNEàoålFx¾ÖkÝøÆ[¶ÓS^î |ã­®íÚ¼9[<-=ü`ÌžÀ¶Ì9üt2g‹§¥‡ø¢’ÑŒÜ S¶xCzx4 󒜑%ÍÖ1W¬ð{ü 2e‹7¤‡Ç¦žeq÷E¥œýìS¶xCzxlê) Ïèd»˜²ÅÓÃWÀ¥ô†žF™²ÅÒÃcSÏ2xJ»uÌ/|ö±‹)[¼!=<…yI«’fë˜+^ø ·íÖòe‹ø—m»‹huw5*6+¾q—íÃOàw¥ìl%¾±W·l½Nà{]®[¯øÆ^vUoüeSzòe‹ø¢ÐëËU/F1Ò2ZÅ_! K³±Uìðií…â‡Oc‡,?|¹@íc¦øá Ø9^Š!¾Â-ïûØ+Š!>ШG}c£8⛌ÀuLG|‘Ø!§b‰OÜ~ÅŸxú O|“"ø$Š'>Ðø4ê3Å_j»õ)Œ…bŠ\ÙNwLW|éž(>A|ñÂv)êSŸp«õ)D¯øâ ñø‹3¾\ﳨO!rÅH5?ú¢VœñB3Ülã§Xãƒü^~Æ81àç.±z%êó÷ª˜ãƒ÷±#w—X}%êÓ÷ª¸ã©Þõ pi6=µõÙ{Uìñüzë—_Œu¨y§*ðÅW…^ën¾'ð‰îû­å*Éz‰À7.2'VGžžh‘DÖ|ù¼<£n+ ¾$ð‹Ì‰Õ‘1Z&‘ 2ÿá芺­4ø’À7.¢$VŸ%'ÅJOË™ ¹ó@þXÈØIàQ«× œþ9[<ûïàG¸êI¯Ž$ð‹(‰Õk$ý6NÉ —ýçÕïÃE(³:2öDøÆE”Äê3|ð3È¡2sÏq’^Ià™«£ÐeXxJ`êþÿßÌý«$½:’À7.2'VG‹KͳwÁÐeR^%éÕ‘¾qbu ðD›g¬%ðÅZ_¬%ðÅZ_¬%ðÅZ_¬å*±º&?\LµWð¹K¬>õi{Õ^Á—P |±–Àk |±–ÀkýóÿþäKQïhF%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerTime.html0000644000175000017500000007573714030601040026023 0ustar rusconirusconi QCPAxisTickerTime Class Reference
Public Types | Public Functions | Protected Functions
QCPAxisTickerTime Class Reference

Specialized axis ticker for time spans in units of milliseconds to days. More...

Inheritance diagram for QCPAxisTickerTime:
Inheritance graph

Public Types

enum  TimeUnit
 
- Public Types inherited from QCPAxisTicker
enum  TickStepStrategy
 

Public Functions

 QCPAxisTickerTime ()
 
QString timeFormat () const
 
int fieldWidth (TimeUnit unit) const
 
void setTimeFormat (const QString &format)
 
void setFieldWidth (TimeUnit unit, int width)
 
- Public Functions inherited from QCPAxisTicker
 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Protected Functions

virtual double getTickStep (const QCPRange &range)
 
virtual int getSubTickCount (double tickStep)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
void replaceUnit (QString &text, TimeUnit unit, int value) const
 
- Protected Functions inherited from QCPAxisTicker
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Detailed Description

Specialized axis ticker for time spans in units of milliseconds to days.

axisticker-time.png

This QCPAxisTicker subclass generates ticks that corresponds to time intervals.

The format of the time display in the tick labels is controlled with setTimeFormat and setFieldWidth. The time coordinate is in the unit of seconds with respect to the time coordinate zero. Unlike with QCPAxisTickerDateTime, the ticks don't correspond to a specific calendar date and time.

The time can be displayed in milliseconds, seconds, minutes, hours and days. Depending on the largest available unit in the format specified with setTimeFormat, any time spans above will be carried in that largest unit. So for example if the format string is "%m:%s" and a tick at coordinate value 7815 (being 2 hours, 10 minutes and 15 seconds) is created, the resulting tick label will show "130:15" (130 minutes, 15 seconds). If the format string is "%h:%m:%s", the hour unit will be used and the label will thus be "02:10:15". Negative times with respect to the axis zero will carry a leading minus sign.

The ticker can be created and assigned to an axis like this:

QSharedPointer<QCPAxisTickerTime> timeTicker(new QCPAxisTickerTime);
customPlot->xAxis->setTicker(timeTicker);
customPlot->xAxis->setRange(-60*3.5, 60*11);
timeTicker->setTimeFormat("%m:%s");

Here is an example of a time axis providing time information in days, hours and minutes. Due to the axis range spanning a few days and the wanted tick count (setTickCount), the ticker decided to use tick steps of 12 hours:

axisticker-time2.png

The format string for this example is

timeTicker->setTimeFormat("day %d\n%h:%m");
Note
If you rather wish to display calendar dates and times, have a look at QCPAxisTickerDateTime instead.

Member Enumeration Documentation

§ TimeUnit

enum QCPAxisTickerTime::TimeUnit

Defines the logical units in which fractions of time spans can be expressed.

See also
setFieldWidth, setTimeFormat
Enumerator
tuMilliseconds 

Milliseconds, one thousandth of a second (%z in setTimeFormat)

tuSeconds 

Seconds (%s in setTimeFormat)

tuMinutes 

Minutes (%m in setTimeFormat)

tuHours 

Hours (%h in setTimeFormat)

tuDays 

Days (%d in setTimeFormat)

Constructor & Destructor Documentation

§ QCPAxisTickerTime()

QCPAxisTickerTime::QCPAxisTickerTime ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ setTimeFormat()

void QCPAxisTickerTime::setTimeFormat ( const QString &  format)

Sets the format that will be used to display time in the tick labels.

The available patterns are:

  • %z for milliseconds
  • %s for seconds
  • %m for minutes
  • %h for hours
  • %d for days

The field width (zero padding) can be controlled for each unit with setFieldWidth.

The largest unit that appears in format will carry all the remaining time of a certain tick coordinate, even if it overflows the natural limit of the unit. For example, if %m is the largest unit it might become larger than 59 in order to consume larger time values. If on the other hand %h is available, the minutes will wrap around to zero after 59 and the time will carry to the hour digit.

§ setFieldWidth()

void QCPAxisTickerTime::setFieldWidth ( QCPAxisTickerTime::TimeUnit  unit,
int  width 
)

Sets the field widh of the specified unit to be width digits, when displayed in the tick label. If the number for the specific unit is shorter than width, it will be padded with an according number of zeros to the left in order to reach the field width.

See also
setTimeFormat

§ getTickStep()

double QCPAxisTickerTime::getTickStep ( const QCPRange &  range)
protectedvirtual

Returns the tick step appropriate for time displays, depending on the provided range and the smallest available time unit in the current format (setTimeFormat). For example if the unit of seconds isn't available in the format, this method will not generate steps (like 2.5 minutes) that require sub-minute precision to be displayed correctly.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getSubTickCount()

int QCPAxisTickerTime::getSubTickCount ( double  tickStep)
protectedvirtual

Returns the sub tick count appropriate for the provided tickStep and time displays.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getTickLabel()

QString QCPAxisTickerTime::getTickLabel ( double  tick,
const QLocale &  locale,
QChar  formatChar,
int  precision 
)
protectedvirtual

Returns the tick label corresponding to the provided tick and the configured format and field widths (setTimeFormat, setFieldWidth).

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ replaceUnit()

void QCPAxisTickerTime::replaceUnit ( QString &  text,
QCPAxisTickerTime::TimeUnit  unit,
int  value 
) const
protected

Replaces all occurrences of the format pattern belonging to unit in text with the specified value, using the field width as specified with setFieldWidth for the unit.

The documentation for this class was generated from the following files:
  • src/axis/axistickertime.h
  • src/axis/axistickertime.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorMap.png0000644000175000017500000004067014030601040023430 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_ýPLTEÿÿÿ“““ÿþþÿ ÿ ÿ"ÿ%ÿ)ÿ-ÿ2ÿ6ÿ9ÿ=ÿAÿEÿIÿMÿUÿZÿaÿeÿiÿqÿvÿzÿ}ÿ‚ÿŠÿ’ÿ–ÿÿ£ÿªÿ³ÿ»ÿÃÿËÿÓÿÛÿäÿìÿôþûûþôÿêÿáÿÝÿÕÿÍÿÅÿ½ÿ¶ÿ®ÿªÿ¢ÿž ÿ– ÿ’ ÿŠ ÿ‚ÿ}ÿvÿrÿlÿiÿcÿ]þYýR"ÿM%ÿI(ÿE*ÿB.ÿ>2ÿ95ÿ59ÿ2>ÿ.Bÿ*Eÿ(Iÿ%Mÿ"RÿUÿZÿaÿeÿlÿqÿvÿ}ÿ‚ÿ Šÿ ÿ ’ÿ ™ÿ¢ÿ¥ÿ®ÿ¶ÿ½ÿÉÿÍÿÓÿÛÿáÿêÿîþôýýôÿìÿãÿÛÿÓÿËÿÃÿ»þ´ý«ý¤ýœþ“ÿŽÿ†ÿ‚ÿ|ÿtÿmÿiÿcÿ[ÿUÿQÿŠúúæÿÃÿ²ÿªÿžÿmÿiÿcÿQÿ^ÿmÿ†ÿŽÿ ÿ ÿˆÿfÿaÿ[ýU ÿQ'ÿG,ÿ@<ÿ0Gÿ'Lÿ$Qÿ ]ÿzÿ†ÿ –ÿ¹ÿÿMÿIÿÙÿ™ ÿ†ÿzÿn$ÿL0ÿ<@ÿ,ÿF™ÿ®ÿÿÑÿAÿ=ÿ9ÿ6ÿÉÿyÿ2ÿÁÿ¥ÿ-ÿ)ÿºÿ²ÿ%ÿœÿ!úÿõÿóÿìÿÿ ÿîÿæÿ äþÛùôíÓãË×Ç÷¨»˜yÿœÿ‡´x«h ÿT£XœH“8‹ÿ¸*„|tlc[TLD8*âÌ„bKGDˆH pHYsÃÃÇo¨d=âIDATxÚíw¼WÕ™îh)ö®Xb‰Ñ˜„JQD”* ˆ(‚ˆŒ  Ø@¥i)" ˆQºJìÌ`N”˜(‰uâ½Î͘2C:“In&Ÿ»Þþ®µ÷þsü¸¸œ÷“?àÇ“ó=Ïó>ïZkïU©Ô§Õëo7|žÿéϳ|‰ Ÿ§¡v¾ÚÞ~Ê>Ïÿ%6|ž†Úùj{û)kø<;ü—Øðyjç«íí§¬áóìð_bÃçi¨¯¶·Ÿ²†Ï³Ã‰ Ÿ§¡v¾ÚÞ~Ê>Ïÿ%6|ž†Úùj{û)kø<ø·5üoÇþ_=k—¸vµú‚ÕãúR•ÚM*ûGü¯áÂç‡ÿ\ãÆMš4iÚ´Y³Ý÷ØsϽöÚ{Ÿ}÷Ûoÿý8ð ƒ9´ùa‡qä—:ú˜c¿rÜW?ák'~ýßlѲUë6mÛµïpÒÉ;uîrÊ©]Oëvz÷3zôìufï>}Ï:»_ÿ >gȹç 6üüŒ¼ð¢QsÉØKÇ]vùWŽŸpÕ·®¾æÚ뮟xÃ7Ý|ó-“&O¹õÖÛn›zûíwÜqÇwÞy×ÝwßM¿¸*üÙí·OzÛm·Þ:eò´i·Ü|óÍ7Ýxà '^ݵ×\ý­«®š>}•÷\qùeã.½ôÞ±—Ü7fÆÅ3gŽºè¢‘#/¸`ÄùÃg ›=tÎyŸ“šó$»Ë.u€X'„»åVu†!" a`xÿþ$ |ð¡jç> OŸ7ÁÂGz-êóh@¸¸ÿ€Ç_2äÜ¥sfÏ:ÙO\xÑò™£gÜ÷ä½@ðžñÓ=Á[&Mc€Âïê)*øåÝÈR)2Ä[n¹%0ˆÂð*f Þûä%÷Í=ú♣–_4ò‰ F,c†;0Âݲc† Ãf,Ãá¡€ðÈáÓ‚pEç¹+OYÕu5ˆpá#kõé»6ˆpÝÀÇ/q"\>ób x)d €@pZ )ø¾î™¨¤R¼ýöÛb"1~+ O I‡3fŒ„Ãó‡6lv‰+?„»U¯”bÂPe¸÷Þ‚ð BxÄ‘Ï}Ìs_9î8C¸>BxÚê<]zÞìYá#‚ÓIƒd¢Ó¦°Qßzß õ¼üö»Ï ‘b€8 ¢ÙL‘aâ`x9xé½A‡cf€ !ÈpÖ°¡%ª0XY!Ã2Df¸‹g¸Ç&CDØ'­;BôÑÁ瘎 6zÉØ{‰à„«Áë'N€ ¿gÞ ¡^Ô ¿A Fƒ8…8I„ ÁLA‡WCl‡£g΢•–‹°aÂzòËâ"´Cß I†Q3$„ÁI——Oë6oþ¡žÙZ!ŠpIaðÑe Â`£cÈF¯œ!¹(šè­H¢þž'z¯¸bŽHÑC¤Ž8)0¼‰^k ÑJ¡θ˜¬e–‡°Ò¸. «k°NEo¦»$ ƒ•†LJNêB3„¯„:®èÜe%RL3Ô ¡Š0tBÉ2—‚!Ê@’a‚h¢ù!½‚úg(üƒ QŠ¢¸iÌð:aÈV:–­t¹XiÐaÉ*LæÌŸÂ,äR¢ÙdÈyÆERE¸ñ57SBah…f–Q'”,s%6B!mL4X(:è /">`÷=)! QŠ ‘£)0¼Y¼B,½tˆ G« Gl„ ë‚°ÎÅ,C“¡9)4Ç Ïä!¬„«ÂLÑýŒ ÙGBöQá!Žj– 6Šûà6Q” (¼ïÇ… ‘"+Q’Q‡n¶˜n‘fì“÷E2>¼<„•ÆÕ~&„¯'U¡“! <Ý3ÂÃê€p>¥™Gûž ifù(N Â1OŽE…yâZsQ1QúC~oÄe"04!N¡L£³ÅôKi²àTŠ³!Î÷ç—ˆPT˜0¬hªdl›\% ²“Ê\aͦŠ„!Bš Cš%θm”B”&H|‘Hø~—`GuIˆÁK'Ë€(ípÂ'Cd¨2Ü×5ÐTC¨ß´J:ˆ–hP†x„FÒá E(tñºH±¢Žâ0ƒ"¼;á4m„Љ`ð}W†‘!Rª†4[`;4+Å?’!ïXÐÞo‰*lÚ´˜a~ )aä¡ï½WÀð¯Ä„!X©sR™ 1Ï!ÔÒ~áデðHÁy|”:a(&a…FˆI†’‡¿>øPꃄbÌû¡Fš©4á'2†¼c± æBÌ+rnò Ø¿¤å(& ³2ÄMCj†Šðk„°MÛ<„¸6ó8¥ðÑQ¡†¡à ΄"B±ÑÐø÷ ñû©RtB„Ž1ÔvèÍ5W_ígC@x1mß—‡°Òªˆan7ÌA¨6ê¨ä>ú裔"¸iC•!.Ð4ÇÍ FxbŒð‡é9˜fx¤ < c=vBX—¹m”¡ ¿ÿP$%2CÖ¡·Rh‡·ÞwCZíƳPºa1rd©*4ˆ†¹³aad£Êï£l1Ej‰&D],¥D ÍIq¿ VIq¶®êºgt¦ÀV8t–Œxè Vf¸NA>ËjLð­·I‚AàÿŽJ :3¥L£VúT$Cœï¯½æÚ±ý{=‚±6)a}šÛÇ\ Q…H #*Â} ¶hYŒÐ§)`q ‡BDh"¤(ã2Àu…ƒŸ’M‡2ZÀdA m·Ý6Å/•ºý{vÒ’Vš6ÍÑa~7¬‚B±Q¯Á]9%:3U†â¤»ïNj“á‘„ðx@¸9aßµH—žGƒ=Ž¼Â +3f¼ßà,Š`Àö\ D¢0T+}Q È—Ù|  2ŒJKTa³fUuXU†a¢A£÷3-G‘ÝôÍØJ}(…±‚'Ãgh»©!ϸM1{l…c­Þx„ˆ£N„o£ßÿ nÿ&At ­‚ ¿Ãƒ…-³]Ÿ.vË"[¹›UÕa5†¶¶&"Ìt…"p%²™¦ e¼§šCåHªŸ^߶GØ#FÒÌ'áÏau —fh«W}4ˆðŸH„ž t¿ÀbŠh§Co¥/xNñsEÆI2iy+ÍæÅ:¬B²QõP¡÷KWN‹Â¼Ô[)Ï4Ý£“†f¨ƒá7a»m»ö¸:!„SÀ€×f(ÍÐHÁ>z+ù¨‰ ~àþŠ”H ÉKÕJ5Ñð|ïæŠd…†w~q¦\&:lRÌ°„¦AÓß/“bŠä¦â&ÇPeÈhh}æÜnªŽö{ñØÌÈå8b+¤‘‚óh˜ 1Ž’1ÉAø+-¤È úSÇPiÀIŸ‘e6hb'åÍûå¥#¬ê­š‹ ¿Š1 Dé‡b¥J1Ðà[sÌ3´c˜‹°§!ÄR ¤ciuíêkd®>úú¨! "¿ÿà"ˆÆP¬4–áóN†“ó2©ŽÁIËCXi&å& 3Nš"Üä:Ídˆ¨ÄÀð=`èÚ!lÊ\A®áEˆû½„~¤@ y % Áÿpå†v!üA¾“~Žë÷4Ûî»G #9i.B™'TƒÆï×¾c€( ñÍ×r&Å56‹¤tôö| º±PÖf!°¶ÆaƉP þ†+bˆíÐ9©4´B ¥Óð`p^3¤ÝŠòž/ †.˜f·,âuRðóј  û-”ƒˆB$/Ýôz$Ã&䤔gp¸–gû„‹´B)bE%‚ïw¿ûC†ÎJÕI}&å=§ÉÉXA;Nr’­T#ÝÝ1lVU‡u@È9Ç(ÁßÆå CŽ¥‘ eF#©,Ï´jýÈwi£¢¡¦\ša„à£4P€…àï¤ÃT†‘“>o‹l®ú½{=ŒXAP¡Q̈UM„¤AÏï÷P¢g¸‰dˆ³aãÆMx¬ 5¶Ã?ºyy¦EËφPZá‹0Rp q”D¨ÿŠ¢—Š £nˆNšE8-á½Ûá{x†Í2b¾kCü}Zä¨"5Ä÷¤ò|dÈc…6CÞ«¨/Â{ð̬Í`š‘©0öÑÐ ™à¨„¡ï†q q}ž¹ÙòÌt¿>SEy+‚0b“LCL¬Ô1ÌA¨…à]E"4Ä÷Þáv¨¡Tœô^ŸáHÊ_ÝJO­†ðÉ{/S„Hy°wiÆ|4 D þg(døeÈ?ü !6à «·) Â=˜b6˜¦^Z„"ÂXƒLŠ Š'mJNj9’†Ùž¶*áÊê/­/B"øŸ¨ÃÏ¡,±m+„ÅŒ «9©Gø±GH‘ÚŸ¬˜"éPnÂáPL†œglª¨;±yŸÏEZáo ¡È0j†‚ð'Š‡{@¨+Ýá„h•´T#ÝsÏ=E§De˜Û ãf˜A˜dvŸb F"x)2 ©4rRš 5’òTç¹ë„ð¾rêúL„ð&xBÆŽ“ê¨R6ÚSFv*fZØ £Ý¦!‹0øiTQÍŠ•¢“ÚdKl‡žƒ°#aÜ ?ð½ÐéÜT!kli/,Fh ÝáÌ2t/Çp×#6®®CvRFH­PEHÿœ(Ñ3ÄD£WºáQŒžª@„'¯„=ã¶Ú㌠ÊPñ+ ýPñ+*2q¦>G—‰°Ñ^¡öÌuÓ¬™VAø¦CˆC!5ˆà_´ b0S°RI¥$Ci†„ðÛ‡Ò`è¾æ.,@˜·G£ÑþñâLf´ÏO¤ù½ðaÖMstXà¤Y„Lð/I Ch‡Ú acÉ3¸ehO$„íÂ…3£ý]n´g„uY`ÃÕ™ß/*,‘Þ81·–Š°²÷Þ{í+1Öa.CÓa>BñÑ?B%ø_\"ÅOQ†h¥Ò !’g=ŒO׿T„nu憛ôØÅ ¶Ìý.ï5EËÜU·*rWgŠ†ŠmÖ  B×ó½4Û q×>A¨0¨‘!êÐwC]cÃ%6 i…{„§WE˜®‘¦;ï(Û…´[h…`²S‘]#Í[`Ë",5‘î U?†92¤á>‹m”þÕ•1 ‘Ædhc…FRíižªP„§Õ!ÑÍ&¤¶UQeËWD˜¿ç›¾¹`´/aeo©Œ›æ3Ì´C7âi¡Dr£B†"ôC”á/?þˆ–h,ÏèT!;†¼Uá¾!Ä]{ØòÕãøWàƒi¼_8Õ")íÚëá§ÂƒÖ ?x×oT¼¡û…E3ÏU”¨Â}B™•¢¦š"†±•’ áÏ!vB²Q$ø7_$D¶R ¥è¤.’òT!Ë3)Bxã…C¸N?å¼ÐlÏÇØ@†ÂÐ~úÕ/Œ`Ú q,„‡¶ó·|åä…GXî©"ôJŒìÔAôí0¡8iŒÐü¿\¬DbHÝ08©k†nªƒaÂÎ]T{Ç=±¡×a䤸[Q„QtHF~¡á×sö®Šð:9Á–æþIÄ0:HúoþiáynyPtj-ç¹KVá¾ûî³Ãåšz1|“óŒ4Ã!Dt§BˆÀdÍð_|žÉExB.Bz8Í!LOôTÐ6}(†N’&çñ `Jð­øµø8wæø“;HZ*Â}•bN®q±&òÒ´ª ?’fø[L3„DHü»3„T NJÍðu—gÂTQ!îùæ!¤7?Él?~‚<¥KlwéY`±Ò‚§bô8¾|7çù4; ŸÈwÇ–°²ï¾ˆiG¬•¡-u¿gyÆ«Áÿ¦BˆÄðÓ?i3ÜôzáA9ùä¾´$FÈùBï¤òlÚ?>›¦øX‚Ž aê£É駀pü¶;ÁÖh?(£h¹¦aãx´P†oš eÍ!‚7‚10ü+;)uD('/è½3ò”¯<œö‰<ä+ïî¢'›¦àÛ.žzÆž}[f0ô‰&ú0c>š¦ åiÙcÜ÷ªÃ`¥8W|$Æ#ü« üïÿŽÂhñtÒÏ„p¾ýIŸµçÙžŸ/´í¦kå¹™îñI{cÈBŒžóågµ?xÿݼGµy¢Ð·^ˆ'^——fJ>¨<†®%ºh1äL“ZiþãÄPeX?„mrž?¨½_Ê=Ž^‚hGòåQ}Ì÷myY¼+!yÖþ§úÆ„ˆà÷ã—^Ü>5ó´}Ú ËEØè~ch†š¸iC“!.Ñðx_ !„~„maWB¸(ï¡ DxÅxyg ?Û¿.Á¿ñâÃèôÊ‹÷ãW^¨ÂâZ¾ú'µ]š)áþûÍMój*•PŠc4Ãg>ýÔ÷B#H ë‚ðàÚê¶ýcúDž*äÙ&z™löÝOòî®wå½3òæøÕûöÎ £D0óºyPÛº§b¶Áó…•ý©îWŽq<õJ¬ªÃ/Épè Ë°á?ª"¬62¹+ !¿À«ÿ€ƒé1ßeñ“Úä¤$C ¥Ïë ØÞrï—?}ðáKÆïaã—–ä‰ÐžµÇÛÆ”þ”o£HÅ8›&µ:/åùžÒ9)#üG½ÚiU„~ªxBÞ¢§¯`»‘_<ƒ2üî ò&Òj¯`3‚™·!Æ6 /x¦÷¬ã»§ÛKIõÝå"Ä2ŽBQ•¨Ù4—á2 ÙJi®ø#mUˆ TH‰GûœÕÛ©ÈC8_Þ„Xô/{)Ë_„辕ó"Äø5zAË22Ö§"Ô÷Î0Âú¾ñ¢~Ï>145JWä¦ цü„áë Ãj2´^ˆsáÏlm×]wáŠý¡îÂŽˆö|{æ½xF_£G¯#½^d¨¯#uo¶·YÖå¤j£wº8z³{Q¾÷Q~Ÿå…#K|¾ðÀ¨”cÔ÷U%îµDß‹u(‰FFÍ0òQX`³ ·åûÀAˆð¨! p qíù>b¯¢GµµâKአ~)ðd{­3¿—û ƒøv?~1ð÷)ÉèKÖé=ù·É{òå .ÿ*D!¾Î²D#z-:;ÍÍ4Ñ¡ÆR† [©+òfŠ\„tvæècÝfS1Â%á0}4Cy›%¾\e¬ô»/$ “7s¿Ì´×äOÂW¬OLÞ„8Î_Sæ;Ø*r%¥):;M:¢kˆž¡lY$ e6t 4DP}ôãdË×Ò§ÓjC(/v^ÆÍÐ^ìŒsÅMîýøă©¾_ý­ü÷«¿Q !¿EÏ®Pƒ<:ªÜ7!6:ˆ*áQÜÇ»i”jâPc eÂÏ´C›ïa™;Zåv­N°Ñs1þi>B~§lünî àØ18V\áeè†~È ‘”˜^r ïÇÿÁþ ùtñÏ]zÿÖ4î„×Ç…¾t›!Lûé¾N=Db†ánÂð£},µý Ýkú+/rãÙØ´ßM|´qÁin>þ$OuÃ`ˆSæ™ezÓÈ8}¿úõtíÜö#wÅàE$E¹kä-ÙˆÜ5bïLJµQy37ÞrÅQÛ*´·—û>Òƒ¹òµxÔ%3äoK©þ×_eçþoñ†¯‰ð‹É¶ƒ‰¶ßìâ†aæÍÎCá^zéɯÑk<ÃWøÂ-»ïG.Š~|qÓ+¢ÁïØÑ@‘¹ldÛ¼›»Ñ·©RŽDÑI±Pˆ™†˜eø[¿ëħ ìôÆÑõ4·œœq'ý+/R„Ýìýê‹ûÓ-°„0Èp´¾#?¹ùŽoÝz†î½KoÝ’ëšôæ-º>íÅýíi8Ú­M–eä)Ýé»-Þÿ툡£ÈR´‰í´Š£P³é͹Ló[¿ûkgÿlgŸ>z/aü|á‘!¾µÄÎs¯È§;DåJ»³iüƒ¨cˆBˆéÝwîþ»W^µk·Lƒ™û`·)ÂÊ!TùbtRÔdã!Rªq¡&¦´‡/ ÉMÿ?TA‡HÑF7EÏÊS¾ÑƒÚüú'bø{>l6úÿº„èö½¡-ÏÐåwKÝM¾|‰¨\{Ã8àû;(Ÿ‘k`åX_|‹(_#ªúú{D݆t‘¨ÝÙ4ÆÝ^"ÂC¹‰XŠ#Š–ltJˆ9 1­ÏªýIŸó€Ž { ‚|”[!Ry›eË!¯°…©óÌ9ˆ¯òÅ+(©^uµZ©1¼K! ŸŒz(J°V‚Ñ}¾£J¿v«ÒœêÐ¥QŒ²?鋳 _÷û‡ö°“¾ö‚Þ— ¯KðO¦Ñ«ƒxà ~…_§»Óè^ŠÞMÞÎ-‘t‰]‰Ž×6É•èœh†wÒ•öt#z|¡6ß©-7£À<‚y£Ûý…¸2SòÍi‡I5 ª©Z[d)Z:•–ØÌ„˜ì>ñ„(§Úþý×Ñ{ è9{L2ðÞ™/éƒi$Bç£Ïú÷«Óó…Â0U<*×ÚSžÑ똹^‰‰¦ Qˆ¤Dº–Ùßkÿ Ð]ŠžGPÓ¨Nõ2Ql‹û 3†Í½"¤ªQ´Hé”!RKtBÜÅR{Ö‚N—þÒ¿‘^á•óÖ™&U^fù ڨؘ"ìÅwP ážôÂå3ý•ÚiC¼U[„x÷w”"qDvÏ?/üP€ P%CÐ_|'6Š7ÅŒñI™·ˆ.uXS™Rˆ.z7mœë¦ï¸— ¹÷ì^£§/,á—ÎÈûÕé–½ñÞ„˜‡Ð.óå{DSÃk"†‘•~ú rÔÂß?¥ï¼ƒïÒŽ Z#tj_e™R/‚mt¸¯H‘)EI7%î¹gÜãñ‚æ|}5ÔÇú¢õü;e³ïA¤[ØG£wsË+ò‹âXÁwjÏÍ2ä[µ=ÃÉ$D(GIðò‹N™–Ô+Ñu³>”NxAÙ×1?è+a) 5àPc| jŠÄ&qK”q“>È­XÈEÙ÷:ûWsã{ÝÕiY„«BX%”8i@ȉ†¬ÔªI‰¢pÔºûnÖœ:‡Á Añ¨or#ôiÔ]?Y.Âʾ"Œ‡{SU1²¡z)2D0ò²é—øn<»HîQK/97sgn‹Á 1ÍÐM°í;ÂÓéJí0R$„ÎIY†9 D`(J¼IÝ•ó€x‹6š&ÁñL7ëGÓTÏg•¨Â#ÒJ$ib$-¢£"Äýˆ™c×äÄþëÉ=¿oF7\qàoNãû˜Û¶‹ÊU°I¡žg£áÅ8X°•:†(D0ÓÀ”¨“Â#étg¢ê¢é<1úbí„@pX‰ÊTªI?u¨ •ØLítWo§_’ëøÊ_½ë>¾²©Iñ­[za›|„I©êhH2¤DíPŠ'OŠ„1-Àü° 2@"H»¼®ÆðR¸–Ò(¥#¬™­ˆ¥ê‘\M• U)R°Ð¢+Ñi:¡úh‚°#ÜëRžÁfH™”Í’hÄJ¡ {⤠Eäxk\S&OV~¬@– j ÞCy"„FˆY„³f-a#&wÔÑRG%E0=GÆÕK‘FÅ}mÅ&=^c7Êjí*ùBt$È6¦zŒ£ê£Ü áÉ;9„02B+ÐIáÌ$CL¥ÀP½ôšk¹#Þ(R$Œ£«ðûI“"ò(ÁL‚au[Òè#ÎG=¯D„G×Ržã—"EÕæ‡&IŠÑŒáOœfkV 4 €6zØáA„GM·ÚóH­îµw,Ü"a¬'¥ÑÐdˆ~C(ÇI„rþ ?v3+P²¯¢U5ç¢2Ó+Á`£(ÂV˜Ô1y•Q&™+§ÀH!5`¤9#tEʧ{“ŸîáOØD÷­SÁzè{AXmw¦A'Ä¡—fÐGÛ¶ÛÚÁ#œfû-IC3Db&ÅÑ0tÃ0X@¢†”i&\õ-„xA$ŠŽ£Ñ“¨½•à“tê0%8,\Z¢ ™Ös9•EI0ãC@Qú¢‹ì§ûÄ;ûMÓÛ¼è—MP€ÍÐC@§A´QÈ2*BCؾÃDxÊ©†"éZtR8MŠë¤³!ʬôI§C¢S"QDŒÈQ‹éI T€,ÁˆàX]•‰!ØèÒ²>wlµŠˆ*FìHĨR<ˆVPYŠñi7½˜M«) ²C’‚0O †8*aGŠÐ áŠ!M}áãä¤0WàJ)1¼" 1¼7%ˆB12È› ë(¿EÇã0A½'xQDpÎҥ疇°Øä`û TJS%¹ªi‘û"Kñþûý¼¿•Ïªñ Y‚ûíI&”,c"¤Ò€pëkB ÂQRi†â¤Ø e°¸X^F Ç+Cƒ$¡»áÁç$h&*½ôÁFU„ÇCž["ÂFyìòË¡4=’1¥R_tR¼ß-½ù·IIíŽøÀ`¹PÚ <œ!Œ|4 ö[q¦ˆ¾}oCH2„nH‰Î@†ì¥÷\yå„éÓÑMY‰‚QI2<Âw N§#&*½hÐGá¹ç©•z=_˜b;®°b”£R %ÛhWdŠò ½Öé¡þ€ß>`¢J0HPF"Ä‘¢]{ ç>!Ä<ÃklÇ2”v¨ý rGTˆ‚1­ë®#|$@*¥ FŸ(ité¹C†”÷|a¥ ¾¯ZeHŠ ÕT#‹~Ì°Súp.”  Ð>H!"A¡´Â0†É> ìJi0$„± q°àvH:† ÄjDÁH }ÑGQWK E€Fp¬#8Ê4hpÈsJ4ÒˆÜWëT†’1‚YŒa¸iÎKáfÎiØ é—ð¨Æ¾ ,«Ágõ"ä©Ð® »„¸éKÍ×Ø8Ð8f²› DÒâ5×H+ú(Уˆ=×DÕDàÌå‚ЇœS&Â\~ÇW­$Û*Qü2÷E^¹9ÈíIÙü®ö~CÑC%È<Â(Dá‰'ââZ+š a…g !ª†{tR 4N†Æ0Ì8’™ˆ¸àM‘µHztÅC|È/H&JQ”4xa.Á%KÊCXqìRT'”'iz$S-*ÅC‰âr¬ßÞQä*è(1Š2An„$BX >ŠÛa,ì\!ÈVJ9•ÊhA ±!DTbÐb ˆj4”ÌNåü$ÄÀ$Ä6HÄ΃xÞ‰ b#¤ƒÆ!|Šñ@{\+|ƒÑCC ~™ ‚þ˜|TZ!ÜœæR$¥±"L÷h`¾×vH«¥ÀðIœ.T‰Q0fkñËÅ­ Ö í/±‘àRh„ƒ?^ŠôD'ÖRž£Q¤¾H†jK7¼E,¯g BzÄ<‚LÈ¢¬A&("Ä]ŠöØ y¦p)Ïà2)é†j¥Ìú!¥šK…â规1)ô‚j d€ä¡*AuQ胰ËkpðãƒJTa¬¾\v_¯R’ÔÈ9ÝDS¿`<ø ¨@ŸÂ b%‚Ú 7£1ršÉ \#ÍÙÌJY†Âp ñ`xï½—r8 I‹ã$~$¨/èÏ*Á1c0ÇÈ8ˆçÕ@ƒ°¶MÏ‚+ajp߈ë›ßü¦ýÆqtb<¶ˆ¢{ Ž ðA d€$Aç¢ ÄQ¡"\áâ†!!D'E–“ Æ0\±%ŠŸ¢£†º2*üãS~ܵ ÆmÐôÜ=V"ÂJä±ìlZ›7ov¿sMŒ˜nŽ=ƯÝpg´g¨¤_ø`H1 ô°îÎd‚,B\šé@Ëk†pÞüI!N†Ø ½ !LøÊp4uDvS²SÂxÊÑ|ñQ~ æ"Hk2BP¢LáÀU¨ú‹l3—T‹GÕ‚>J(#ÅT 7ñÜáþúu߃(À0γ¥¢‹"Až(¤Æq¶O.¡Áb¶z)BB4!¢’Ç Æl]v™óOᇠ€º¦FQ: ÀJE˜5O°a1´–Ù $[´ØœKQÇE¡˜ž§SÇG€ÀgE‚Ú)nƱ>Øh1ž½8ÏœeFÍlXï&/U3ÍnìæÄKÅRskœÉo¬„æ1Æ@¤ ã šÁVRÿŒé!?®ÕÓÙjÕ 8Š›=E0T4díÆÎQIá‰Õ€ø@ê‚¢A!lDøj»­à£H»$!’z†¹‚ š,".E©fÆ´SÕ"©q\Oð¡þžt/&ê<¯m0uÑÖ•¨Bu?á'âkÙ Šxµµ>.øP‰rT1zCuŸõ‡T¹Â‡ž¥óWÇ°qV{FH"lK­EØ¥¡É»ah‡¸ƒþ2œ-h¡…8!š #ƒ§ôM4FŒ& Á A#x^B°‰ÿ”ΧÞÙ²¥àk-ôÚ¼W¨õ‚‘ÄZD)~UÛâsñ¦|ú‘Nï‘g—bˆ z¨kƒ¨A £¤ÁÅýÊE)PøµDù?U_Àð¶nmê5_ðíÚ½ ƒ¥¶Š!êÊÍqÉŽø¼Çqd¡&ApÑN„棈p•!ì‘Aã½k‡sˆó!„f ‚¢‘ãÓ£Jè¡¢þ *%8‚Ú²¨Hìwvy+ž ЖÒý 'áÛ ð:tèpRTáãÖ Çà¨(EÎ66fï6§2Å;–´X„±‚¥3ÁW=¹¹m¬Æd“ép覒›’"Ë1ª3ðc€aœ‡rŽA‚KqQl58–‰°Qê -¹rv÷ýmÜJÚ#|Bl~_k¿•¤¸þéVœPUŠ'$ÛÅÙSdz=Á–-…`øÏw8I§Â•¡®’F2Œ¢—††¨B¼@ ’Ÿ*ÆÑ3¢M…ôÈ@—3¿ À`¢sÌDYƒëˆ`©ã #&ÑDóì ü[ÇŽWp…_v E†øÒzH¨Q>ýšÛšÊ–¬µÓœJ.Š[µ†FØV:áÉká)„ì¤h¨Â `xŽc8œ:âË5¬ÅŸÿ( H-úØÌ™?ÅúCR í,qŽQ Á~@ð¬òV2F 4ñO’X&Óp!Vhuê´‚(v1¤PbkóSÓ¢lgz(@ŠXh¢Ð’A„Ò ¥Î¥@êöT„&CZ*†çÍñ AˆŽâräˆzL ÿåóa1&"H$% –‰°‘LšaÄA9À?0Pâ·ÅבèÍ;·‹Ôܹc#Kq#åÓ,DÙaŠ0Ô™àç¡ËTa6Åð¨=Œ\Á!¾Uáûˆµj`\Ùe.@¤žnúöÄV´.û‹ßŠ™³ p3¹( lTÃÌÜ.ð_„Ý!­±õQ„ý(ÑÀz÷e8g(1„hJ…¢p4”ú{ ÇøÈ@ åÐЙhEÁµ}û>Z&B#¨ë0â¡8vÈ ”Â÷Ð*`ˆ$Ä0'¶…9±õÓ Qµøô‡_!bcP‚¯bœeÍ „õ™GÌIi¥´_ch:D/Õ\CM)¦•]„OèRÌyçÙ0ˆ H –ˆ°Ò‚v"8‡¶qJK0N²Ø©ûVž¢W¯^Ýk5A!nØà'ŒÖ°'‹æ¨ÙR~´¯…_ÐK4Ô³9¢‰¯z™žÞ}¾,±“ºn¸X" öÃ%C "ì]̚ŗ¡cO8vŽŸê'yR ®Ç¸ã\ôÑGûô)Q…2H<­1Ô¾öZBHJÃwpÞ¼îPóNˆÈ…ˆfÚáµÀPsn,ú“QmŽ\ âTÏq´¦ Â-½X†®BÑ! Ú‡Îæ\CZüä“£Õ.Ì/¤?쀢@ZŽ9G»à@&؆ &Ø»\„Jp=çP}ì()”®"‚Ý_ð±PóDfÈfÚ‘ç‹ví¸%> ¡‰wùíȆ?×ÑB]¡5›h[þq¢8ŠÍ˜¿Ša˜ ·àtïC©1”2äžÈ ã2Õ£|ì“OßpöÏaÄC ö@!8È.Ž .*a¥¥~¿¸ f vôsDJ†ïßÂ Θ„xš5DŠ¦°tº±äÚäÇc7-ZI>Üá§ÓõFp#O¥(BExª"Äf¾„-à:©uCd¸c)2¬ "&Õ"×'Rîc„o–›"$†2@1Q&x6ìûhŸÞ½Y?aÕëù–>ˆÊ(è‚( ‚âJ9%?ÿ°4òHÏ…=@ˆÝTˆ<èSGÜHvÚ7ùIŒ-[ÆG©Z¶Œö'¥+s*f;<…i&B¨™t‘³RŒ4”iÔL!)Qüu“Œ`ò¹'ñ;Oô\,tq ö^´èÌ5%Þ_èDi;)ØÖÖ­n1†vŠ®" ’A‚={öDŠ—R¨¡ñâ$\rˆ°^ƒƒbk9q#ç§ädŽÕqQ1tiÈUr7†iP‡LAˆ¤D6¬E£Ã8<¢7KÛ&vPQ {èc‰‡ Á Á3×”h¤ÑÏ<í“Q‚–B½»A ·l!„ó»K¦9åaf Ýs ù)SD(ÈV­ZÙùŽõº¾Ç_Îkêèâçà£Y„˜I×ðxß×EšX‡ì¦ì§”OIŒŽ¤Ö0à#~K—FcŒÉ昵¦Á3×ô*`£¨ê0XUƒ]±âwŽ¿u†p>ÈÐúaçØ70CØÛgˆxhªuz.³Ci³i„¾E8O¢ {3Cm‡ýi™jGT%²¡:ŽÙÂ?Eût„1‚Hôà \³¦W©]Äè°µ}B0YAõ?ü!&`(+5ºÞFnÚ6öÙOõô›Õz;âÑÖYÂk«ä‡)E8Ÿ†Lºæ bˆ%–"CK5l§ãœ\IÌ Ú6H(À(È€ô,a”Emg·å;ÖÔ°s©‹¾ìÎÏC(2¤Xú°0ì¨ ñ€M;Õb¦ìˆ\¼MikìEôÐ@£ ײ™b¦!ˆ!Ù©$›T™2zìŸaPh¡úû Š&Ú7&¸°<„•hkIÕxkÞýØ#ì‘EˆV* u?ƒ’ˆ¯¶Í)’`Î>׊º Ü’0<ËeqSË5$Eg© Hý˜¨Ob†€Ð']P\t ,a#Y‰Æ ÝÛåi" £Ýx]-!Œ÷h¥KW>Ì»ùt´F•¸u+rz5[í¢ƒr'¹Ÿ'²„¡[#ê!ì“é‡<"¢›’R[\"–:$†y®}šã{œÆ@#Ö±àÙcà™¤A¸°G‰Û(ÁvÙ(Ó©SL¿g– "„  <]"Ã.Êpƒsc?•#Ä1Á¸:ÔÞÜp²­ñYÔP‡ è,"†ÒE€°÷Ò~A)4^@G|Ì(.‘r³ì &jqŠ‰ƒhP ¹høæ,XPÂJrÆÉôŒP#är©¾,›ÀÂ;"*“ 9j\ @T œUuÇ=:ºº!ÄÙö&„Æí”sÍ@¦èÕ¸D¬UMÓÐø$ÌåwÖÚt” öÀa«TJ”ÁÞc"¬IDx ÇÑ¡BLª †5)C<žV{9)·q¯‹¦›øËÉGHVªí°o!C‚HÙ† JÅरù¡þˆ{èbG°/wA—cPJD(ëX)ÀgÃÃ\ù©g b+Œ"Dh#†è¥VpGä\ÓAOòÇE'üM‚üó¤_Ù9µ¡ ‡²Þí ÅÅNMŠÌQbjZ3;4OÕµ@XL‹r(4A‰1Ô{ðuy+u:dáÂ&}z†…¡äŘT‡zÜŸ%ŒÃL.Â0ÒlH=óŒ!‡SÖ¢`$ã4ȉåÇøP€¾Š‡ú Ú£}KJDØè¥h]ÍlÔ'ø$Ìx„qØh„º!l<±Wà Õv0„r` f…u„Ýçë˜J×øÑBeH “Ÿ®SGe5:”^zHOõ×_: ‚Ê¢6/ÈÈ‚Õ|8ÑP.Â첌$xG?;¬—r6UŽi™7¸“ã……¡¬40Ã3)Ó„ï,ˆ^‰Jq©±¨¤õ±}â (ø|Šqj„I9|GÊCX‘‰0^Êrk£†°ka‘l”òhHÝR¨Á1ŸÝÔ8*Jýí{ꦣî–"Ô•†3!lßs;„á‚®]ë:¢ù)ƒ,¨ôôo“þ4È?‰1 @-Þu+Q…þ™%~`Éòd 3x^Ô!ì>?‚(=B,V>Ìý•XSSÀ0Ÿ`MGø°Ò$_u+¥nèû¡g+qñbƒ¨zŒŠÿDºŸW ò[-ÆØ‚šDQþv¬.¡>õ¢ÇÕh$ÔMÂ|„°v„ÄdÈ:¤ñB):ŽÆOr–á/G[sá<·âç’5™ªEŒ†±¤Êué^l .Ň*Á4vg‚§•‡°BYÆ-oËÂLg·KX !A4€èüŠPB©1ÖCmŠ C#ˆÉk°i3ÑaoeˆÁF)ö+¤XÄÏôg)”È*ég¿ JV!wB 3õCUøš#„ CDˆ#>!„TSÃnj£"Ö@­¨Bê†zŒû!3”ÓG9œ®õ#Ûj^õë©Ïù'ೈ ÜÂ›ß è'z/sœÖµD„nƒÂ=ûÂ[Å‘a÷ÚžÖ5¶Rj‡”LÑM;ž\¥@OCí|µ½ý”5|žþKlø< µóÕööSÖðyvø/±áó4ÔÎWÛÛOYÃçi¨ÿêÿBµ'}Ì/=Œ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractLegendItem__inherit__graph.png0000644000175000017500000000436514030601041031646 0ustar rusconirusconi‰PNG  IHDRQû!¨ºMgAMA† 1è–_0PLTEööùÿÿÿ222iiiQQT˜˜˜………ççéÒÒÕÖÖå!!V,jjš§§¶Ö,±ˆtRNS±ü€[|bKGDÿ-Þ pHYsHHFÉk>ßIDATxÚíÝÏoÓVprà²S_[÷'j,R¹­tAˆÓB›©½ÍŽ_È@ªµ;ôÐ?`—Oæ¶ViLŠ¸!:‰Ãn» íÂF¦Mc1ÇMê?iß÷줉ëÄö{ϱ ßW©ñÏ/Ÿøùù5åË—3$'mìLÚ”¢4qéù•Ø­œŽ”Ɔ––Ó‘š±Ï˜@)J³)Õ Ñ2"¢5B*tS£×+ÃÒÊ«­PÝ"_h”ÂŽIööJ³ =é}~SšßëÚÚ²Öd+ÚÆ¡+½î‘‘åJëú ݸòIïÝÞ_y´œi÷)ËÐËÛ†Nªd®d‚tŠ;#ªœ)!Åýþí³Ÿ :#m©¿ÑͼH7”¢¥ïƒ”Æo)IkZkkОB:ÒÍyª:bBÒçeN¤çœ×9‘>pÚ9‘;Î~>¤-Çy“ é¼ã(üÉH@úw.¤ç@ªzð'#=©êÁŸŒ†¾ã4ó ePÕƒ?i‹I7ó …þW¥(E)JQŠR”¢¥(E)JQŠR”¢¥(E)JQú¡JÃùo*Oë•ÆOä—Më•ÆO@éoñÓQPŠÒä¤zF¤Ãù5Â2¥OIµt¤ÃùµNÚt&¤‰ügèuXÑ)åÒ¹Ò5bЫ´ì.”á:§! Nä¿pžI½ÞgiýÆ]ã®· §tMƒùŸüäIÙ5eÜ/áË[HKœÈϤ³]i“íÒ» i(қȽoèZouÓúõî‚VHE˜È?#ªbèã”ߧnZ¿Þ]OgDÅIäïoéÏQƒù³&ÚPŠR”æS*È/™Ö/*˜ÈšÏ/šÖùü˜Ï¯¼a>¿ú†ùüÊæó«o˜Ï¯¾a>-;˃R”¢¥(E)JQŠR”¢¥(E)JQŠR”¢¥(Í«t2b|h>¿×®$&N–èoѳDbKë¶Ò†R”ŽN‘pXâÒ=jØv‘.Y´fo/uõ^T«nÚš¸´¸µ½´g¬]¶E»t9ËRÃÞ«[K¶mÙ•FÍ´«t®²EëµájW(,Âz«AKìÅ*ÁÖjÝ‚íî¬FjÚºµÒFq¯nØÕÕºµµ ¬ Û¶Ùw~M/^­[Ÿ–Ü—"?¶ºk°>b)­YKEÛlÔoWoÄ;˜ÂwWJ)Tq_,v“ºk°>êÞ‡¾¥ë€°¯V9Ïú¸Ò•Â+“²»+õÖF%å#ª#ʶWìÛ—¡co¯m¤[%ÖûlÑ^ ÷Ù ÈxQI»O)Û®ÙßÖÝe—`íñ!‹ÐË«t‰¨UvœÅGl÷ÖF%µíÒz´§}£4tw†fS˜r" i(E)Js"ÍÍgÓ±áYúŸ·œß{Wç—á'l$&Þ~ô§H;΋}5±UJçvN%Ȳ”Ùö¿Y“þÀ3$_öm[äù/2&åPçmÿƾq7[R–r|*çø£*Y¡tš¡þòm\ Ú˜¶”gGïú7¶NßéKŸõ3tûMƤ_ýsƒÇyþG¶¤Óíæ» |óV›ÿš)éÎ3²4È^‘9wª2é}69ý°cú­·3#ÒÅá—íøYf¤Ç¿…¼‘fF¤SaÃûñŸÙηބ1ÛÚÌ„ôÝ?¡‡,´÷3 ¤ˆðn’—†ö=káwHòÒ£h£eJî‡?R˜F£ò$K^ù©¾(5©ÊKcÌ”R“ª´4Ö…’™T¥¥±n¾i‰IUV:ö7‰IUR÷!9+þP•”ÆžxÄ'U9éBûIâïMT /…'U)éc‘çcÌ1¨D*øƒ¼à¤*#|Ž NªRá¹QìDq©Ä‡øã§#•~#þ‹‘™¨?'*‘NÉ|.:x¨ŠJ%¦EÁ³E¥’Ÿß&UA©À4ê{§¯F$•þ=Ã\kw$ÒŸåww?î¤*$•ûè浸3œTÁïã¿]é95%ybÞBÒ9%emçiÂR‰i´¿Å{Ô1iX­}_sB(÷üÂ߬FþCË\*[kßßújï« !™T¶F¤¿õÕŒT|¥( ¦õ®è¾õAÇÅ‘êYÁ!O¤½µö)ÝÕÜs´>©V×N‡õK}Á{¤‘CžHûjíßÓÕJ}Áå¤}µöYõ³´É²Ä5‰A yÈ/4+³ÖðÊî—Çh‘Uâïá$õã%ü!pFy"í«µÏ®éŃe÷šZÄ`‹—xq}VfÿâA§ÚþÄ…"»Ý"üƒ¤¾àn \mF íܧ7æyåúI¸¬|‘R&Õ¼U¯Ú>«pïþŸ¼¨Ô ÎNãIäA½ïÝ—žTÛ8t¯ó}¬Ì>[mºÕö½°M¯xï»Áùiì¿tˆ2`Du¤¬÷ ðu§èöþÊ#¶•Ùg]åVÛw»ªÐ-Â:¢Üà¼÷Y`.2à)Ցˆ§ãt îpoD•5v§›îíÏ«íóÛœv‹ð’ú‚óÅë$rÈÞ'¿¿ÖþàvO¶7ðÉ<4¤Ðlª¹ÏîXRéïÁ¼R”¢TPª8E¿¿ö¾²LVk?v+ôH/$VA}Cé‡-U=œ’jŸýG}L,Þ¼h%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_q.html0000644000175000017500000002440114030601037025073 0ustar rusconirusconi Data Fields - Functions
 

- q -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPStatisticalBox.png0000644000175000017500000000365514030601040024653 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_‡PLTE“““ÿÿÿååÿMMÿ à ÿ--ÿNN«‘‘ÿccÿÿÆÆÿ11¹ÊÊÿòòÿÿÎQQÿ""ÿ‚‚˜22ÿŠŠÿ„„ÿØÿ tt‹ÔÔÿzzšDDUTTU11;VVgZZ\))0aat99G¸¸¸fff::µÔö|x†³bKGDÿ-Þ pHYsÃÃÇo¨dMIDATxÚímsÚV…‰\üŠ‰±›;!MÛ$íÿÿ}¥3ýÐ1¢½çj-ç ãÌäÌÞ=:«‹‘ä‹‹™ KÅHA˲T„”‰Á),ærþf~‰«Êö ¹úéªÁUåAZÎâoûšEt‡8…¥\ßÜÞ-o®aUÍla9«¶}Û¶+XUZ©äܶÍþß2ºŒCœÂRî׳w³õ=¬ª™-,gÙÎ.V²x<´ëö!ºˆœÂr–wº3¡©¥ªH™œÂéKA˲T„”‰Á)œ¾´,–Ô挪ôRùXW§°B =Hc¤ ꤲs9ot×Îq ‹Á^;ClRjÑì©ìÚàUè·ï*®oöÊ®M!pã°j›Gäµ3¶°”§æç÷¸ªxƒô@ô_÷£Na)hYH)èµ÷ЯÂ×&º€c/â‘Å<Þ™UÙÂÉWåéäq §/- )•þÀÊs¼CS¨h–þ7æÐæµ-Ål»æÈb’?…Ìæ¤Ì£!ý…i¡h ™}‡¦Ð†H1Û®„9²˜äO!sù)óhH`AaZ(šBfß¡)´…!R̶+aŽ,&ùSÈ\`þAÊ<ÒXP˜ ¦Ùwh maˆ³íJ#ëæ„ÑežC ‡Vµýøüš—ƒw>nã{µp4LÇB¡…Ï: …@S؃L'…¶ðÓ±P'¥°#Ð ¾C•z?íöÓËóËÿ½>mÃë¤RÀLö Åài-”·3=¤lá¦c¡NJ‰w¤åRøywÀæð­Ï#W5,Ü~ùå5ï m–éÔYÞ‘öÑÒ5Kx¼çOa. ËN«_G®JØ«ºRƒŽ¬ŽÓê!¿îF®ª.ÉRX$õÛn䪄½ê’²…õ«öª®Ô`”ƒ´Dj°…C«ª‹S8BUÂ^uIÙÂúU {UWj0¤'áŽP•°W]R¶°~UÂ^Õ•ŒéI8…#T%ìU—”-<&Ut[ ÁBÔ` ƒ´ª…BœÂ£R“I!ÁÂíÁ×Aïø\X_j0ÂãÝ;Òµþ¿ºæO!ÁBÝåOgi¡Nj0Щi9ÐédRh ëW%ìU]©ÁxžáQá͘ER¿ë¤|‹èÑã݃4Dj0¤'áŽP•°W]R¶°~UÂ^Õ•Œ/È?‰l),úuën䪄½ê’²…õ«öª®Ô`”ƒôð‹Æ]Ç—‘#WU—l)<ÇíŒ-¬_•°Wu¥ãö'áŽP•°W]R¶ð˜”î¢,a¯êJ †9H¿}?`søÖ·èæ9…½<·¿KÊ–µP'5æ íðp¿œÂXY P–-¤H ƃô$œÂ@·3¶°¨…:©Á”}CäAzB …¿9Ëí ³¬ªÏÍf¡NJIÕ§1{×ÒI1SÝÎ0-¬º¹Íf¡NŠ€é‰Z:)æ eöÊÆ,)¥Ä;Òr·ˆv¼†þQá-¢Âªòß"*”òŽtòœç j餼é!Å,ˆH)ñŽ´§p„ªêö j!lGúúÓ½‚Rw2¦9H™½²…1 dJ)aîH™8…1 Ì?H«>#ºìÑAÌÖ•"ðµè/j.S 4…ÂÑÐÏãB)fY¶0DJ ÓB&ùSÈ\`þAj©)(¤}´tRÌs!³W¶0fL)%L ™äO¡®ªÛ»%°*ª…D©«ömû€« ;H…¨}Ûʀ¦x.¼_︾©å¤@ —íìb%K!³íJ€ÎÚµî\($ uU-½#¸ÔåüÍüWv ‘º¹zºj¢WÓ4…Àsá¢Ù/°YˆÔ¤ƒ4úÕÚ÷Óª¤~ü±ÿyó#º3/ÝÑ ˜ÂU»˜=¶«vü'ù©¬ª§æÏ÷¸ª°2¥Þ!«‚R!þ²©–N x.Ô.0ÿ µ…!RJ˜2ÉŸBæóRK…HAñ í£¥“bž ™½²…1 dJIÐ?áŃ´–¥B¤ eY*B Ši-¤Tþí ´,T~ uRPWIDATXÃíØ1oÓ@àö'\ÉUDˆ¢ucIK,QcÉ,GýÒ£^k©ŒìŒ¾èP&DA ØXÙŠ¥° î,ÝYØxïl¥Ķ|*µ~R|¹»|ñ»w§(ò[ –Î+noVŽ)öªãàWÏø|`Ž/‘=è± ÀC^7ä‹€yƒ7L<•1ïáM‹!P¬¹ÛÆ4"Á¡Ç“]&Vº;9¸ÅÖÙ=ÂÙï­vnŽÇé¢àðÀ+Áéš(–Nxt]g˜”¥mÈÏX°E߆àe†[¥Kñã„©¶yµƒù*K{£³UQ¶U„V!a¼ÃÚX*œ EV° ï\ºÿÏö<]v?a|ÈÜqAÔØCå8Áýœ¸û)of0Źñèsát1þùÍ7yâŒ×Œ9vÆ—9rƯùâŒóÝÿ1æ‡+^1-G¼FøØ_!üÛ_#üÁ¿%üÕã)9*œ®qk\ã׸Ægæ?иý1î–ÅÕÿæ§aq¨"9“XÎTóð°M`¢`¨ögqa Žö¢ýÑ°Sʼn–wä …ý¨‡z,Õ„&=-cC€³ØÅ&íøªþKå#NאַwéΑÞöiÛÙ‰¤§kV>&0Àqå+jl‡>£ŠÒ¶‹µX½Ã‹ÆQE vë9 6±Ë0¥­ö(w[0ÄØ¡´çáéV¥Øl vá ®DjêPÁæa­»~é©š=6•çBX×xQ¼Ð¯gÜw ÿÔËŸv«VV«‡Â¢¿Ë_%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPaintBufferGlPbuffer__inherit__graph.png0000644000175000017500000000212714030601041032141 0ustar rusconirusconi‰PNG  IHDR­k÷0ÙgAMA† 1è–_0PLTEÿÿÿÿÿÿ²²µiiiLLLššš………èèé111ÒÒÓ+PnnEE|B‹éûtRNSªvå’bKGDˆH pHYsHHFÉk>AIDAThÞíÚ1OÛ@`–î}$®T¿ %aaiŒÛ5~Á˜©R-±ò1:±!jQ·b)Œ±uíPÕTbgéÎè{wvˆª85•-A{7Dçó»/ïÞù%LA!íù”q‹wól­¡kçÉ6ë÷nž%(7“ke–la‹I®-(cwfœÄá-°pc8ÆW4ÚlLÊ·ì¾wÀ^[q"JÝñnŽ‚#•§1ɵZÔq8®"ŽŸZáZÁ[D˶ªMA]8¦,[xØâ«#A:¥âw(n¼{W°Åî‰h—ZÖù'p§ë4q`F”Γ|g󔈸ËYs¾K4° “]ªo£\·.® l0vAy zÕõå>l»p"UÄêUÄ-v§}ÎÀù» ûLñUEpeØÝîÄ„}ƒuXâ:¼¢5×(Þ=Uuà.÷µ[Sù®…Ê]ü\OsÁŸ3Ö.¼o42KÛ¾'ª(T—ûÊ¥+*Xµ{É»™v.f73Ÿ…ôö¯ý|0îãw1Ïvï­di«×™ÂVjð°¿wæ¢ì±q?F;…¸wÑM!îmô­·E?Špç£èºw.Š¢ÃÜ/äþ,À½#÷¦÷–Üïù»Ub³?ÙÝyv3?ÙÝ—¹Ô² ã׸Æ5®qk\ã׸9¹™¿½øšý vóý´Db¢\™s Œû7nè†îÈäá‹”x€©nˆ ð$âv€½‘©p¯'{ñÄ}ÄA ch;ØNs÷{«=é¿kKwÝ úáH^\Wyº2I×?[ux“æJ§÷)ܦ,)›.Ù¥™”6º6†®§,l:üvüÌöiŽq;„9ìÆùîÖU¢Zp òõh ¡Ât¾&óÝà,”ÝÎ7®¯îè9JW.¥LŽä›ر‡.¢šž^½aÞŠ$steØuÔM S7¥rûÚíȤþ¿ï›§÷M»½vìvT¾gjÁr‘ß-Ù7 ¤:xmåî5ì±îð9‹Ý°«Ý=äú vm~À(Œ+δo*Ö¤§Ž9{N‡M>šslÜÿÄ-è÷q¶o/ÒjOôÿ@ž’›û¦©öúŽÃ}Nýq%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_t.html0000644000175000017500000001366114030601037024071 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- t -

qcustomplot-2.1.0+dfsg1/documentation/html/InheritanceOverview.png0000644000175000017500000007017114030601040025327 0ustar rusconirusconi‰PNG  IHDRJëïàˆ>gAMA† 1è–_LPLTEÿÿÿúúúõõõòòòôöúOf«)}d \`*yYn©êêêîîî'z/‚†˜ÊÖÜéæææáááÝÝÝÙÙÙÕÕÕÑÑÑÍÍÍÈÈÈÅÅÅÁÁÁ½½½¹¹¹¶¶¶±±±™ž©Wh• m3€?W¡4†®®®ªªª¦¨«Ob™ q¨·Ø¥¥¥Ue‘'r¢¢¢‘•žaaa^^^FFF‘‘‘}}} QQQžžžiiieeeMMMZZZ†††‚‚‚&&&===™™™mmmŽŽŽ)))"""AAA666...999vvv–––222yyyrrrJJJŠŠŠUUU lµÀÜWe h-E‘#l.@vÐÔÞ¯ºÖmy“(p f‰‹ŽÂÆÐ*AŠje%7q…†ŠïòöLc¦(zc(uM`—…—ÈZk˜©«®Qe“˜£Tb‰"jÒÖà%m‹ÄÈÒ(>†hd&uZ Q MQ%iM_3~ƒ•ÅÎÔàŽ“Ra‹2z¤¥¨’—¡“œ²¾Ú+CŽlw’Ž’ÆÊÔfc%8sVd‹†ˆ‹Vk¤òôøŽ’škvÈÌÖ«·ÒitŽMd¦\TN`’£¤¨,|ØÞëXi—5ƒÖÚåÌÐÚ-\r­œ¡« 6… p EÔØâÊÎØëíòJa¤EW‹—œ¦0zL_•ƒ…ˆöøýÚàíØÜçÎÒÜ£­[p«-?t5¯Ã‰bKGDˆH pHYsHHFÉk>mTIDATxÚí½‰#éyß)€#¹'&$@…:í–]eI5Â<, ŠÕ$D<@‚Ý Ž<#EÒ(²,Ë–K¶ŽÈJìÄ»9kÛÑn’½²Žs9»ÉÞεÿؾoU¨ã­B €bÏóýLÏôL7g^¼Ã÷[ïUÏïCBAAAAAAAAAAAAAAîOnã<¾–!$—Ïom˜|>ϳÙm‚ AÞøðG~êɦyó/üôv!Ÿ{,-C$ÌýØÇÿ¢ûì/LØv)º”¦”8JÅ£êÂO¨¹SÄ)’$ÉSÕãg~öé'ÊÅBîq´ A?÷ó9ºŠ(øGkp¤–'pÜl¬Vƒ#µV ŽÔé•XÃÔ©Úð O?Y)Flv[† H„O}:—wûÛ'þl°rS‚{w´†Ÿõ¢¨²†él ê~ ã­Ïˆ•¢%‘Ý–!&÷„<ù½áZ,²úÑÊz⇗ Ç={¬NF«1¥^ûMU(ûþÙm‚ òdÀnÆk`íÀ1–¼ûaζ̶ØO|o´RžÔåÊv~]-Shãî×2A"Ðë-!XÛ³ÅÃŽ æ.¯ô'{µM2`÷[ÖAtñ0U‰3`}Ï}wÀÚ*_Ê3ZöŒüiËèOŽÊeç?msT*àŸ’øæ#v›4êX ²¬ŸJ¼–m8-ƒ4-C$BþI~ŽJÜgvå]8©VOàXnžò<ð¼Þµj œõ”çÅUbDlO«T⵬ ‡ü3hK}Ø©ÕO‰JÊee`•Ð?Â*q}Ò:¯ËÏZ,•È‰*IÕ2A"$«d¶¯Ù¾ ö¬]­¶/ÜÑJTRÓ@—Þ2.¤“0gÿÀP#£õšÌn|*ÑìHgª¤½Gšµ×.–Ú{nˈJÊ¢ã:?!íº5áTªVéôøà9_ÕYÞÐ_·L–µS ¿•4îÒiýMD%º7+¡ÿÔ|NZÕh7Y-C$ÂL% ›äÑoÖÉ£ß6«UÓžªÄèZd´6'*iŒ$ÉÜÑêÃS2`­fÓÑÚêÔV •Ø΀X*15Ò,Í,–L}ª’鬄ÎI®[=µ}NT2Tö`¨î™|Íö]—D[&ËÝV³Ù¢*i8sg%S•´öG]Ë0®¬ýÆÕ2A"Ĩ$²· 5¢Èx=•ZD# 82`›Þ* £öeù…IFkSQë¼U2O%À‘fqP,AÅmÙt¯ÄS‰Ù¬Vub9ÐxÑùÁ×êC2¥èMTh™,›ûŠò‚ª¤¯ÒÆi!•t £†a¾4Œ@• H*È€MuLâÎJ 0+qŽIÜY U ÝxiÑqN¬.Ë:8{%ä©_•lùf%D%¦æ©ÄkÙD%à@Tâ6‹ü -«Ÿ[•ZFþ +/§qÎFID%´eD%î¿U‚ ©H«’öQÉYÿWâÞÜ {%âT%æž­ØÞ¬dß|•ÌöJ^±UbÚî¶ëT%nËèNÎL%Ó–ùf%‰*1_ĵ Aa•ÄàT:°#ïÀ¾ÿÇ°ûpa«;•ÀÚiÐK·#ºéTRŸ£’&<ãŸÁ¸ä?Á™ª¤ITrÖê v•÷©¤õLvwrNÄpË|{%•Ü°Tre=ï=k J$‰*ñ_Lß5轞Þ+y5YEèÊÁ:ôìù]—àžàœêQ•Äà$¨dûüKiË&÷J¼–•\;'8gäŸT²kÑ[/‚p nYy |*¹rNp(ŽJ W%õ[zU‚ ©˜Øâ•Û¸eß(e¼Þ‘Wlï¯Ú¬öebËâîº ìk%¤U7æý[† H„T*ñÆkŒ¤ë¯3•¨©¬m×ßNR‰JRËæ¨$|AmØ[Ãû· Aùw>ËPÉb﹤Qɼ]W»þ‹ï†T²š–QnÉê˸ˉï½Ä[™R¼èzeŽ]$õ€ýÜçCç3Û2A"äÿÒ;ï}¡0÷'¦*Ùƒ Øú¿ôþ—m•/æAˉßþË_ù¥¥  ~uéÃ/íWšu¹ê/2Ù–!!W(×Ôú¨?^ XîË)ý¦­ œ¿ôQf[† H„\¾XUÃî-,÷åÛФª‘Ý–!%W(UYÕ—–ûrŠ¦Õ`1æì¶ A(_ÿÕ_ûÆÆw$Þüæ¯ •rh?"»-C$ÌýØ_ ¤ÍÄDÍ0b"&Ç'ó¢f¤)ÑòÌÞ!ÊÏüÆÓOpÑœŒ¶ AnÚL>&µ*8^ƒ•‘Z©Î ×Y÷o=ý6yöçEˉð©OçBq3þçþ4´j~RDð2Gh˜Fns¨‘"ïo}“/ò¢e‚„É=ÉM3"|£•õæœo°òì•CâÓ>x#,0Vû`¿ù¦\-måAˉsÓf|ÔðX£57|àG·‚CÕ±Ôx¢‹Üvî´ AnÚLšàª`Ž[Ü•–Žéß/A½þÄVü×7æ·Œ6dg’ÑóªZuZ4rJ©@ÌÕyð^6\ªe‚DH© ©ÑÑê*Û‡;mÜ^F%Ó´™˜H­˜–aGÚmÚ±4:u 2ÒhÚ²d•,Ù2A"¤ÍÁñŠ»¶«Õ†¯¸«„sæ…WÐ ä[S!£Õ¼Q&´t†h!v¤V\ËÚäOmÚ´YmWhËèü„´êÊ„S´ì àŽü8ôÍJ&=Ú m/Ö2A"¤ËÁaḳsRI«)›»²¼k*·V§×¦W ;¼"®e¦Aþd˜´iS•Y‰·À!3’ËVSoŸ“– õ gæT%N@A3pn­ÒÄÅZ† H„´‘Z¨UA8}Ay¢ÉUÉX–/²Ü¸Vhi÷&¤R‰½¸J FþT£ÁÁ‚§'šg¦³#6­íjH*Øä‡_%ME¡=æ UíÃb-C$BÚH-÷Ñ ÂqÏHf³O%d¬ÚÐë­¸Q2é* ¥UI98+©C`V2i™£÷?ï¶ $§e3•Ð­Ò4÷÷ JdIÒæà¸4Ç¿WBlãÌÝÛU’zžJäÆím[VÌNúbe çcZæî•4‚{%~•˜M¯e *1Oo‚ Òæà8'8“ Å Âñnn8'8§¢h ôqk¢’]ÓÜ••[ë…~Óx •DZÖqNpö¦MNp\•ÔjÐqöJ:ò~#Y%·Öñ²*A%I­’I? ™\óî•ì[ו(¦©ÈŠzIƒkØ*Y '®e;´E³{%¼O%—Î Î5ùçwA•8iŸ>•h4íæh±–!!u¤½OJƒpҧͰ.o褒I÷÷ÉÁY²e‚DH©UuƒpæEDHìñºd¤V\ËlÐ+iÃ+¬e‚D`ØI›yÈH­Lµ A+ ®Z0mæ·ÞéµõDj-Ù2A"d'¸ê;™ÔúFj!È<òß],¸*øÿC X÷nú¿÷þ÷m%©•Ù–!!¿ýWðÛË–R~€àª~íË#Cªøª‚d·e‚DÈm•xÅè5›ýe€¥¾Ú¡Ù««µ²?R+³-C$J~›«ÉzÝ^ XîË)u]*UDv[† H„±’â+±~`™/¦¨ª"Õ*Å@Õì¶ A(_ÿÕd!¸ê“|¥TGjýµ¿þ;¿»cɯÿÝ¿ù{ÿU´e‚„yã£ûx|pÕ4m†\ÅN›‰ ® ¦Í„‚«~öé°¤eëoK‘˜›êfYèèÑM࿪ :½ œ;‡8çï¾ÿ÷P%27¸j–[åWI@"ìà*vàL0¸*| ËŒÐô_xúm.¸Œ -ó*–°*Îdžõ+‡íµZþ~¤e‚DøÔ§'&aåh5žÔü‰I¾óFmxJà²o}³ÆmçEË à ®b½9ÿìg®gæÍC¢kŠ½©ƒ3Û2A"xÁUÛáeDèVéôå`öE8ˆ78Z´™àE°ì¶ AóspüÔwi¬ªô'{µÚ$V‹þÕ:Y>R‹/¦ËÁ9¤aZ´]ô'¯*§=§øÄ]¿#¿õâAZ† H„Ô‘ZT%ØUvá„çOàNqcµ'ÀDQ¿2SI4""ô:_|ËÆ°#îÀ¸RîØ;%*©V57¶Â-îÆPÉ 8Ð;íi‚ RGjQ•x¥¢yÞ-MTB+Õ"*5¥NƒÌlY¦±Z2­àx–ºX™S`(e¤Vû¢LôœJÑNˈJªÊ4L‹ç¦¥’vM´$©qíJ&Å]iò—Fše¾ÔX­ô-C$BêH-º¾1m`aò¼`á¨d:+¹µ$ÉÜÑŒá)ª­&ùÓ‘>n§®0´HŽ©—i˜–“_á´Ì?+¡-sôH»œ0-ýÂ$Mk†TÒê«æ±ª›ê•u2jÓ· A©sp¨Jœì*‘ŽWÑSÉ$V‹rã®o ZyLÇëåxbe‹äàOZÆMÕr[æ´c4S‰9® ¶IÚeˆŠóC’@•ä€J:ŠzÙPÕÆ¥j¾Ð´> Jd R‰;+À¬ÄÌJÔK2+yi9ÝÉP%ãõe Ì»¥rpâZæÎJ€ÎJ*“Y‰s€3Q‰”EÚ%8¤"8³’ JTEíA³ =ÍýݨY‚Ô‘ZT%í3Æ^ ÝÛt÷JÈxݳ{7£(w°’H-w¯¤Áqí=¶JÌfm¢¸‰JgžJtYnºédJruÕP5ód±–!!}N…¦iÑœôçØ=Á™©D½4É*â@7&*i¼ÐR©dñðŠ1Š‡pÂqÞ Ž«ÞUɘ8îºÕ‘NÚ•Üx'8ÖÀè´&*96ÍcUscµÒ· A åàÐ{%pì¿W2Q ½Wò¹»—•¼¢—PÒž¸.–ƒCô|÷Jü*¹àk‚¦PÉä^É 'ùËS YÛhª¦;±Zé[† H„ÅTR¥±ZÙˆÔj\&wÅH-Y+©‚«üïÊ ¾‚´™Å#µlÐ×’ƒƒ*A4¬+¸jÞ®«]ÿŠÔZ¼e‚DÈ¿óû°¿õnèâ|f[† H„,WÙ*ŸÑH­`ˉÿî;?þBʳà9ÁUì’ióŠxï¹ü7ß{ÿêJ5©•Ñ–!!Wø‡?øà WýÑ¿§‹œ¿^If[† H„\¾X•t»7j.,õÕ”QÏÖe¾ä+¡šÝ–!%W(W%UŸ¼O?`©¯¦º*ñå@Õì¶ A¹üv©*ø6î,÷岢ȒÀ‡j1g·e‚Dùú‡?òSß‘x󛟬VŠ¡RÌÙm‚ a–‰ÔòNORFj¹‡(1‘Zo9‘Z¹ÇÑ2A"°"µ˜ùUÁÁ ÈcGjIì Þh ¦ãýÂÓ_¯Glv[† H\µµ÷Ќ՘ ÍH^ºlÏðMŽ·>#VŠùÜch‚ ahÚL¾Š›‰®b=ñY«†èÓžÓë¿Xúö›šŠÔÊhˉ_Kp¤ ®ªËÕíüš[–.R+Ø2A"0Òfh9¡ÃIpÕçæUÙ•ŠÞ°vܪÙL꺣•ÖšÀNÇ+Q‰Sé&¾Œ ® ¾ƒ3'¡g‡ÆjQП¼ª:¥¢#¾4ž‡ýŽSMú$Ð2 $x‹´ AÑ´™> ‡0¦ewû”ã€ãÔU©´ººð¼åªdúè‡à€ö».àŒW{`.©•˜Ð3†i:\¥ÇÒ蔨¤ÊëþX-–JdÙîZsU‚‘Z²0ÑÛÞ#ãõ¢].·÷ÜUQ 'A¥’³ŠpC«ú4<˨y…ÝE‘–H¼pûάDíÜÊÊ>ý]͉J44½>ÖuëÀ0îZ÷ŒÔ¢*i_pN¬V¥}á®oˆJøY¬VMX-QôÅjÑéÍÖP&´ EÑI+¯œùÒBa_‚DˆFD˜:¯ºéEDp³Y‰u>r6$ÜšîÏ$uxZ& 8Pš§Î¬Ä¹a:°:öPQÌ]Ã>mÏf%–F&ŽÕÕŸ™vݼ¹g¤U‰ip4V«R1ëîNIhV"¸±Z¤en¬Ö™é8Îîš²|KZ×*äSí÷†“Y VœG%ˆX¨ñZ/¸ŠªÄÉö®Tt2Ÿh×}  |*¹nÒUÄD%æ‹é*†é^ <Ót󥮿4u½qu5¼oU ð¤i5:YªU¦³¥Vs¦s,¶IZF#µê’J§K”1iݾ¢4AQÍgÇU‚ KM›qg%˜•LŽ[õsËSÉ‹–»Œ˜¨ä¦æñL%4m†¨ä¹±5™•Ô¯È¬l]·A×_™ðò¾98³Y f%•¸AY³ŠóÎÊKéXG²«¢0P%ò0D,k¯dzsC†Éç•&è>•Ž!2+1/zZ{%“Y‰uyÛ^F%î^I£Riï±Ub6Ý]×€Jdy †lvÜ]Wœ• ÈCˆpOpNè ÎÎäÇQIë¹àf|é€=› ª’Ž«’ö‰ì¨dßUÉ•»WGúIcªûÖÔȼ¦Ó±Îõc³^7ŸÝ;¼br‚sR©t`×=Áág*é•\·:ò~#¢¹q-_ZûÚMƒî•œô†D%7‹…}!1`i^Õì^ÉT%;½_â†VÑL-¸&S’KïçˆÞò¤[pµœE¡[·³½ë9YÜœœÚºµgwÖ98œ«å»W2S‰Ó(щՊªäØ”•KúÉU?'ÍSµ+z‚ƒá² 숈Æel¤VúàªàÒ‡ÎÁ¡4.7Ò2A"°¬ÚGDÌ°¶]{q•Ø o¢e‚DÈ¿óÙŒ¤Íü£wC*Élˉ´™Ï}>tq>³-C$Bþ/½óÞ Û©Óf‚…ÉlÀÖ¿ø¥÷¿l«¼?'³-C$B~û/å—–­úi3¿üµŸ4ërÅ_d ³-C$B®P®©õQ¼°Ü—Sú#[8é£Ì¶ A¹|±"ª†Ý[ XîË)¶¡‰4M_ËF÷–øZ «e‚DÉŠ•š¤ø*ÞXê«Ic¦-dU_ XîË)š,`™h™Knk»\á}uPï,õÕµ*W,ý_ÿÕ_ûÆÆ÷JÞüæ¯×*· ó¡)x¾£ÕûË}9ãÊa“,™ƒSY4'T8z’ƒóO?Áa¤‚Ìåldàý·¥íJÜ_[%>°¯š+ЇëFG“,gÄ„o=ý6™• K$‘ȳ?ðçÍJRªd–ƒƒ‘Z’Èœ ¼iÞa ¯í’¿ß «d6#3úç;XhÀ†ÓùârpÚÄqmΩïêœEÁ)NÕY7¤§æDàÂ$çYX%¤]ô×NuU=¦åàH³m›=)©?á›Á’LrpÕ˜<ÿi7†c©çDàU°™8Vš§ *1Uòg+I%éÓùÂË.S'*1LΩ:ï©d:+¡³%7‡¨d¨Ñœ “¥«ß·ºª ¯ŒN[Ó®¬ýfc«¬W‚ É$«dÇѼŠSÖ½êDà5.Üõ|p.;*Qhìž*I@ë»Âù™”œ’!KúZ4 ÎŒ2ðâUÉx^GÃf¼4MwVbÚ®J­^Ï8*´šMk@m«IÆjÇTdsh@_½çôYã±Õ] "">RË•€3+©L8^n £×Î}þI•èI˜ñL%º¢ ªÏ[`hšû%¨¹'Éx^G#ð*<ÑU‰y"'¦3`ÍIÚ7É ;#¶utÐRÀ]ß8}7šöÒ\L%1ûÁî^IƒÌ•öØ*1›îÊ 1^%Þ¬„¬¼€ÌJNÒ· AÉÁU^^`VâœÝLf% d ᨉ¦i:ßd¸îšæ1UÉ4 ¯®iuXB%³éÒÅC8¡;8Óœ©JhHÏu«#´ç¨¤Õ·ºªÚ¸1¨Jn­›úóªAîI²J¼<ŽFàTB÷JjÓY‰˜•x#Ö4ªób¤¼YÉÍ2³ßÊËÀñÝ+ñ©Á 霜 J"{%ÎÞªî‘ßz¬iú-Æamâ J$Éx^žsƒÃÀón•LNp­ÞÈ8¶K÷Jº3•ÐËtÈn@Ÿ5î°÷Jî©Õ¸\"¡‡^+ÌÁAdNž÷üŸEàM¬{¯Dé±"NOp´ˆJ¦}tP_`À&çàØ MU’2¼"xRæà J$ óƒ«èóÿ2ð`ÑËnÙƒåà@úð ŒÔB¹ÌW‰·l,:`³©õ[ïo¼ amv®J"é|™‰ÔúFj!È<²3`#é|ß],R+Xa Ð2ök†q-›6ν„ûÅï½ÿ}[ÁH-I$»xùí¿úƒß^¶ÐãDjýðk_Rë• HÙÉÀû•f]®úŠ ä¶J¼lôšËK~=¥g(µ2ŠF$2œ—ßæj²NÖ>ËË}9¥®+‡ëI$»é|4TƒãE¶{K}µƒ"Õ¸"–vEdœt>Y í;.Ȳxš¦©Ñ ¼¯ÿêG²©õI¾R*à¤AæÛ*rUßYÇ}€å¾œ"D,+V#²A©Ø&N©‰Ôp"µ~öé'*ET ‚Ìã¿ûp&žýß®”·ƒ«/R«©ÎÂI<¹çÃ)¢,4ýž~82¸gò­µÄH­yÏþô‘Z^@O0 '”ΓP¿Æ¨ߘ˜Wrh¤–Àa¤‚$ÊԊ´ ©¼ìH­¸ôŒ4M©|ö/©Åº¨–©nKü]µ½‰‡Á2I¤;Þ3øìgDjMÆlp2gв^ÇÕßúŒPñŸàä"±„Ï4a¬gäØM‘¤X ¼¢† spžýá5Ä‘Z“1Ëž‡°£ùœ1k¼ý¦Z‹FjÅÆj8ÌÚ®`°†—†ÃPL –4"RKÅ‹ó’H~Ï~˜óì—ýÏþy*qË2u*•»e™xÞ)a¯’I!•9*™« H„tÏþJøÙ_«9Ïwò—¹oáÀl Ú¼H­bšH-·a^°F¥Ò¾pG+D+N¥h·Þ¼Hƒµ4QœkNU¢ LhŠu§ª»-ú›“'%áX A",óì_ø…>XäÙŸ«áæiq†Y©˜õêD%¾Y‰ ¸ÁZD%Cý†Æ™9UÉ­Õ±ÛC奩ëæþdVûÒ2VQCùÜëÙ¯ÂD%4jÎL°öE±Ó ó[’àÀz!ËjàÖ™•¸±ZŽJÒ?û“c5œ<-¬Q©@ÍSÉ$XÃS‰Ù›–Â7Dê’:«iî+Jµ}u{®¢JäXæÙ?QI£© ,Q4w4cxJTÒK–Ö‰=tTâÆj%ªd‘H-Ë Ð2‡‰JÜ=Vç*®“]1S‰û+Šzd T ‚<÷ö;{%ŽJl<öÝõ’ #YÖizů¤‹«d+©e^°™/í±Ub6Ý•WT%fÇ]yY×·mT ‚<Ë<û'³Á›¹q³$y2dAŸ¨ä™åîm.¥’ð~°»‹³Owqv'»8^ËjÐ!*¹nuäýK%—Ö¾vÓPvé^ÉK'¡'a?U‚ )XâÙ_›ªÄ}ô›{uÙö©d6+qcµR%ôxÚ ÖðŸ-ÍZvéœà8ÁZ,•(—4?K±^Ñõ*t‚ƒá²8Ë<ûC*uÜð©äÊêx{%n¬VœJî©ÅyÁ÷ŽÔR0R Aežý!•“ßyéSÉìçÀ‰Õ¢*Y`ÀÎÕ˜k,«*AåÉî³Å‘Z ÔÂÿ¨™GvŸýùw~éX‡ŠÔ‹ó2‡ì<ûÿñ“Å"µÖ«Q·¿óy[åQ%’DvŸýùï¾óã/¤zÍ0ö-Ãä× ƒ¯º&ù'ß{ÿêJß F$²ûìÏþéþpÙBÐóGü=]ä°^ ‚$Ažý_ùïç>û++öÿ¿Gžý²ÿÙŸË«’f÷FKË}9¥gë2_Ââ®’D†žý6yöûËæ ¥ª¤ú¦/÷–ûrŠ®J|'%’ˆ©¥Õ3ðì¯ëRµ´hÚv©*ˆ¾Bl÷–újŠ,‰Õ2V‰F9Ðg¿ ¨úR,©EБÕbþúÿø×þ§ßùßùÝeøK}5áþ½ÆsE, óÈŠ\ÕW õ>Àr_N©ñ\4Rëoýííí„¢÷Ì‚ÕÌÂ÷‹æU̶…ßþ»ïÿ=LçCäˆL|¥åï,÷å”Rq{+8^i¬ÆÖ–¿,Sô¡ˆZbÂ+Â!8ì0 V kÝø_ÞýõJ §%2—Ü$¾âÞÀR_í°•Ï…F««ÉÁñÙ„c¨d6Ka¨DJT »>™ž¼õ±RÌ£K$ ¹e€¥¾Ú!Ú '¹ü$V£XL¸×Ÿ2V#¼ÆaåòÌ<â¿öòö›šÀá´AV¬àßոϥþä˜@U…¤X¾i¬F]®â‚¬žU©„QÀú†iP•ÐŸ¼ªTœ0^µ ^ýFL0ý-Ö {×5¤NI|±ø‚¬žÕ¨„U ¿‡Â!ŒiªÆ®Ø;å8¨TÔ5S ãR?ˆ¢~e¦W‰Q ¾Œ ka}*iï‘ÉE»Ìµ÷ÜQIE¦q X‹Ð -¥V›i=s+2ê Ip ŸÐˆÑHàÊQÉs¸Õô@ÛÖé¿#µdc¬V%þ­S'*ÑͲ[¿šã*tVÒõÍJ.[#­}NT2Ô.蓪DÒ¯,¢’VS–ͽ>•ð0&*¹nÅ“vX%Ú¥9 Â9Ð: ðí•ŒÍF&-7õç ¢’—:Fj!ÈÆXŸJJN˜½ Fï•Tréœà8AZNªÆT%ô^ɧ’;'bCQ4­áœàô‰Kô[úoÓõ+²Ê1P%²!Vª’ÈùÆeèE¾Ec5”Ä÷‚Q%²)Ö«’:hX _[ÀúmT ‚¬‡•¨äÏf$V㽋*Aµ°•Ì©…Ÿ&Vãjá•|îóxqAÖÂJTò—Þyï …Ø\ôµÅj|ñKïÙVyÌÁAÕ³•lÿå¯üRjáÿò×~Ò¬Ë,2€ «g*ÉÊ5µ>ê÷ÇËK}µCdcé#Y «PɇòÅŠ vo)`¹/§Ø†&bÎ'‚¬ƒ•¨$·E\"«¡JðˆÕ…*–‰Fu°•|èë¿úkßØø^É›ßüõZ¥„;%²V¢’7>ú±ÿÅ|~kË_Z{¾4…‘¾˨Í*A¾ «i?óO?‘Z²V¢šƒ“÷«„•a‘⪠+‡e Å™žëé·ËÛ˜] k`%*ùÔ§'=á(œbüt$ØWcÞX‹Ü4a ÄwÙä­oòŒ ë`%‡ÁOrñ‘ZÁp>ŸFbÒùbÖ3¬»jÑëj¿ù¦Ì—¶pZ‚ +gE*É{S’i¢VB4Ë#ŒõLpO$]¤–ñD¹mT ‚¬œÕåà0#µœ,ΫYâÏÂáy`_w .BÜÞê¼H-[Á‹%²Ö©ETÒ‡ñÆ\Å­¤FTR­j]«J=µ¸úàoáÌrp0R AÖÀúrp¨Jh}Wî¢Íqí wyCTRUhEFÞ—…£ Â, g¢’@ŽæFáhNŽ¦ÓßÍzŸ–>Â7ƒd¬/¼‚ª„Vç “s²p<•Lg%nNSoŸ•8Y8ú…9S‰…c»Q8û´¼ë­u2j‰JZ=N%X¯AÖÁzU•(þ(ÃQ‰û»µÙë:¨$³ä6ÇZ>ßúrp¨Jܽ’G³p˜*1›î®«WqÞ¯7 §§ö|³’w×U‚d™œsù{Ó¬Ú(k ¯ *áx'ç;Á™ªÄÍÂéH'íX•Àî¹µnŒ— T ’arB½ßÙ4c[Ü.¬ø’õª¤ìdáøï•x7å‰Jœ,ÁɉUÉ$ G?w¢pÜ œ™J0¼É9Ûà î´`Ë%üNZìû­³wÓï”n_±Þ*‰¾áª¨F³^.V:Ö¬ÒMË%rpdÌÁA’î¾Ú~EÞ76ÊSbÞ‘O¨£žþ­’¦VYmížõæàÐÞ²Ý,œEÂ+$¶IP%Hæé•ÜÒüe6¢ÅÓ=„_l­^Js‡[eƒýjëdpØM±Z\åûhëSÉ&rp0R Ù,¹ëÕÖ„r=Ñ• c-Ãx;~2.X¯¶ºCc¬­ö}´×;Rë·ÞéxÛÙD%¡ãÌàª&¸-ÂÞˆˆÛaUÙ`¿’ftêÊJƒ\^ïH­ï`¤²Q¢* .÷S‡äñn@tzºP^á g%*ùîb‘ZA 3v¥ÓªdÚyî­ù/~ïýïÛ«51‚$’ï„^meÏÑSNÒÌЩ¤©‹«LrYI½’í¿úƒßÎ@¤Ö¿öå‘!U°^ ²1"*Ix°&hÍ&%æ3úBÚ³™JŽZ®J^µ˜*é]•WðQW©õ×þúïüîrü%¿þwÿæïý3~Åü$O%§mMj\‹wæ±À?o—ŽeîˆJZQÉÕÀ¿U"€ÄV‰ š$µdåäAwª ꪪC}¶¾éž»ë›îyT%…] öVñQW©õ·þ6™Ë±.û®òïáÔ˜÷p"GèÁª®1§èNçý¿ûþßC• ÅUɉY*ëf±uw}Ó½,—E¢’]Ó20—-0OªÕŽÖ¾F§M8¨=#?³^B“Ìe®Eƒþ‚}~%Ëu[Gr³ Ðê+=ú÷/Ú¥¿ÿ¹®·äßwh­=c|JþÑþT%™¹’5ÿª"µ¼Š%¬Šó‘C0öÅœµ0¯øÅl;ýý§ßƲIò:ÚGd$pPÞzÃÀº)«ÃÓrÕ|^™ãÀ|!^YÕªy$vù»6ÏßÀ©^« .tíÂlóÖnžŠâQƒ kGî¶e÷Ì«Qý¼¥(¯ä›ÿUƒ|ëw¯G½kS×Áܱ»¦aÀ‹¾98i-O%» §ÂÏx%uU‘ZÞ L ÷…c"µox6‰ÏöŒ;V×ßú&n»"k˜ ©J@#ßÿMÛUú+çwÝà8ë†Ó¡S©HP­ÂžHÀà–çLa²¾axî>L»W’äÔûM‡]ò­o€¢žÈ7ÿù`ò$½df2ºë:¤KœP•Ü LX)+èÓ˜H-ÆÎuŠY ãå¥ÈŒ$v©ó£7ñ0YÌ¡äÌJ¶#Cà¨U„Š«’}Ó Œ8îtÛ±È(°Íju×¢‘Ö.Ï_uÉ8лtð›ŒÜQꓤg¦ó =h‘y 'D%­2Zš6:wd¡YdìƒñÊ2¼QNUr8ôþæ|Ó=•/R+òÞÁb¯Äd{²–5 98xE Y *1íbÙÜ)šMW%gçÎH8wG6wuJÂÕ9/h0›çÛ¯ÈH°}E¸n ºãš’t;t†Á +ƒAÆÁù©¢Â˜xv4ÍêîÛúmKï¶éÖë)Ýu…Ñt0tš½=§ )ô6ÝU©‰ËÁqò´¨JèOŽ¸Yž–©Å¼•ã”‘KÜëRÔRñâ<²T2h‹z»],^XãŠrp]jP“4é6 ÷¬Å5àF~eÕƸg•4yÞzI†<“z—p%X­? *!#¡±ç ƒÖ‘ÜêÖÇ]³ITrBU²¯iplt®` ·`gt 't×ÕvìçíÓm×>Õ—µé®JMŒJúp(¸ìUc$*©TÔ®EUÂǪD”쮕úªp4¼_çCÖD‚J*dm1(“pAV ]©uª’Ö™{=ƒZÍjõÀkÌó 2ŽÈêæÒÚN,0‰Jºš—¼¹ßh÷ÉX v0èŸêä÷_Y:‘Ñ Ýu5öäŸ]Ô}‡ÁeÒ†»M÷UZb"µh貓§µç.oè?™NIª¾<-¥æËÓ¢*‘  ³’Ö±,ï"éçòk»ªJ{©Õ$.&{ZÍÁA• k!N%[ÎQæðz-ïòÅ¿'ﻢöbXÜtg¥$&¼‚&W”u/O‹öQ‰æŸ•\¶FZû¼æËÓ¢µ]ís‹ªäƤæe"3Úgôïvë½Ó6Q‰ÕéX],l–d•ôéÕ’Ò\•ð÷UÉœwù*y<Ĩª¤û¼<-W%t¯d4S‰ÙçùºIT¢ ²“§åí•t$Z$º}{{N&v=E‡žj€Û}= *y©ë/MT ²Y’T²Ô»|˾\íTâÎJ 0+qºo¢÷¨ªFó´&%çÁë>¢²Ü§ÉZŠŠó†Î3g;š¨ÄÖuP%ÈfY™J ìÑ#V «pTh¯$ªsäÎꕈa•Xg—í€JÌ‹‘>ÂY ’UÉZ·J^•xÍÓš¨dš§5OÚ1*Ù¡»#7~•ÀÝŸfï•`ÅydÝÄ©¤PH_AíÞ[%s*¨½f* æiTâäiÕœ<­•XGî ÎL%dÅ·à?ÁÁð dsÌWÉf¶J&…Ž_'•&yZ©ñ"F• k#A%¯ FTb?j•D{°îæi=LxªÉl•4‹[…›§*é_•¬,'N%dN÷Q%Ⱥ`«DÓÂ*Ù@±yúXíGºøØÞmÍ¿óûKçàªw0ÄÌJXïÆ^lµûã~OÊ[›î¥Å˜©ïâÔ"ý÷ÏÛ**AÖ[%®Þïlžñ¸?Zq:ß*È÷¯|an‰Å‚ Ë5tMòO~ïý?¨+ÕÇÖ}Èã„]ú'_¬Hº=z€$–eƒ\êš°ÒÌàU+üÓüa"µþèÿÀ^m ‚La«$W(U%U¯oCWÄÊ£«NšË«’Vï––ûrJÏÖe¾ôÈ–‡È#%¦ a¾PªÔDÿ)îFD¾R||OUjbQ m- ,÷åMùòc›Ó!”•äò…b™ e-¬J…+m?¶9 …˜˜ãk¾ {K}µƒÀWJX%Yqe’BÇÛ§°•„&¡±ÁÛÅ’¯Šë=€¥¾šR.—¶ ³ÿÇGBÅõ\&ØtÝ·æü2Àr_NÙÊ£Hu±š K„²œCá«aäQ‚*É*øyTÌYàä7ÉûÉŠ*Aqß°B®»ŽëÂcÝv}P%È£"抚mpwJ²åâmäùƒ+§ï—°BççÈìܸËáÓ KÕhÅíªKP%È£‚ý +éîÚ&Æ!¥ŒmæKj3DrpC ¼bÒT¹GwÙõ@• ö7ì¨D3·| ¼çZž’àö$D’’«!… ÔGWü`ÎKP%È£‚ý ÛÉM´#³‘ø íÈ+®¬æ=Dæ 1ƪðØÊ•<¨äQÁ.2@URð—Ü–Ý`m‹°5Ü ‰{U^XdZx£cÈзäQ%È£"N%Ì$— °HWÀ§CË€} ßmE• Š˜2ѹ`~v´Øò^ÓUeì<‚ŒªyT¤SÉrU— °è4hñT ò¨˜£’‡ °¸gÒÇ^ñ0 JGÅC©¤+Ù*A• Èã µJ*WCžˆd¿`ÝqŽ‰J:pNT²Û ¨Ä¼‰Q‰ù\Vú4­Ò|¶ J ‡•MwÖæÿÏ HVI­’Ó¶®4åòÜI³w×àªÇ4õ¶Õh‘õÍÕÀ¯ ¶JTÐeåUKQ4¨§Ê™¨D¸…óM÷UþÏ HVI¥b’“+•{f¹¶»ºé^V*2Tª»fˆJZ·-0÷yþÄk_§3–1\ˆ‡ägÖ$õÉ\æR¶é/ô†WJþ¤9:hu´&œ\=7á*²ëê©äE›üöÖ¤U‚<.’U2›”´_•Jå*”‡WÞV‰õ²¢ O+5óYÔ*æ|eñ¼ùJÞé mAx §¶(Îêú™)õÌÛ^ÿT–²¬X;Šòª¡ª=óªß;oi‡ÐíA»sÑX(¢ã̤â9ØtWeáÿ ‚d•¸øñ°J@'*Ñ¡lŽ\“Ôèè>—*×duc½¬Öá„çày¸k‚н„W¦4Y߀4hW^Q%È£.Á¨$¸UÕR¹üªUÞUÉ Ó9ÀQ¡_­ž^TwÉ„„•[@4Ò:„A—xÄèÒ…)AÓUIëNVž™Š¢´TÕûiÝ®®›º~gEUrg•Mk È"ÄÏJ‚ÔL»T®˜»e³éªäúÜ9 :ßôçüÕ)QÉÕ9Ýu½A€‘ ´÷ˆJ¬AG“.è®J /+·C¢•ÔÝM×Æ…®†î#²ÀÙi»#KØtW!O¢J|·J Ùh´Ëå3«ÃkG—\û€š¤jµZ=´ø¼T÷ Î·^Ê&QI_¬ç4ÌåPi^•d ôN—ª¤#+=ª’Uµ†}ýæ´£™;ºÞÚ#?^E´é¶«êl–œnº«‰'­Jx2ÿTÊeî‚ ë®ÂMUÒ:ó®§Á® VŸçÈ_N¡  €MTòŠ¬nn­cißs‡î•èÐ!*90Æ ò«{š}üCòã„­®»!¿õdÓ}… H,q*Ù*D^>ÜkÁjº»®ö슚tÕú m¼"È#"½JÊc“‹Qɽßå›wAÍö_œ/”7ÝY‚Ä‘¤’¥Þåà]¾ JÉ.+SI̤U‚ ¯%‹ªdÔP%òhˆSI¡_Aí¡w]uT ‚þÏÝiÁVhÛ8²i’#çÿLÁ)k«8&hÀùP?ó§Oÿ}IsÓÿG‘U’ª’­à¸+2Oj"³ž=+y`•ÔåÊö<•üÜÏ;Ë›ÈéÓìã„·ŒÃ^dI1")´Ñ£†×h¿ðô“,BóÚ*IG‚JÊl•¤\ßÌU c}cÜO%Ÿúôdç˜5 j$é؉½Yì|†ˆ@*4ô·>#V‹øÊ÷kª$T%…”*Yd«$j’•©$÷Ä5Ià*á ëè:q·8àyÜä´ØxûMMàæšy\ JÒÁP k×U‡Õ¨d´„õM@%…ØðdºÝ8bNªXainãÙ"¬¹Hì.qýI]áÓ8!TI:&*)_ +d ž4¬ã’„]2ÇÐ%£p§P‰¹³Ub¾Å¤ß*Ùké Ò±À<Yî’¿+=¸³.T­O¾äÖ:Ò‡½I¿nÜ?híc¸¸:4áÊSÉË•Aìúf¦’Ë–ª¶n‹Å=ó¤Z?%*)Wv€¨„«î@@%üƒ«¤î©¤i`æâëª$žJÚGduÀAqxë-¬›²2<-WÍçHdšû•U©˜GÂa·z×®VoàTçùÁ…¦^˜µºy[ ÂAƒŒGë5‰aÞŽŒó–Ü„=ã…Ù’móªY?o)Ï ±o€:"ßiÁX7u}¯¡ëMsÐi-cΛä7UÉøÖ¤žñaªÓ.Gf±hŽÝQÉ!uÈD%Ôƒcðày:Y©AÌD%c"¼—žJÈï3ŸËÏM8G„Ï ó=Õù'èôËõäv òåpqN~ J^[>è*´ qQ‰E2aX¥¿t.”¯eÎzÁéÐá8‘<×aO$öÁmµzdÖ&v¨ ÏÝ­’î•(*t‘#Iç2(u‡òl':ï’§»Ê…©«êÔá9yÆï‚V§k›ó®»äéÞãÌ4ÈÌä¤>&*yÞNó¾ê©Èâ¦Å"T=•x+ò—ªëL<³|³’Ús³gʵITbí)Ǧ§ëB»3eóZ¿ÙºÐïL.ëw š—õ[ªgVbÙG¦·½çªäµå¯’”¿Ï›•GTrÔ*BÅUɾéìZÊ0*s§{ÜŽE9¶Y©ìZ@4ÒÚ­òW]2µ3i»*i‹âsÓYßxÃ\†&QIãNöþ^ívÉJáÎRaŸ¨ä¬¥ï˜d\¶ŽtÝû F÷Ü0îÌzýÀ²ë;Ï%f1þ#Ìf%½ð¬ÄÙu÷ø* T%˜ªäŒ6½² Q‰ó_ÁYÞx ×e·Ñ ©*ùsˆo¢·±P7¼¨’×TI:<•˜Æv±lîÍ‘«’³sG%ç΀9ç®NéÖë9ÝmxA†"ØU¾ýŠ Gëª)ó×(®J`$Š—CW%º»ç@F¤lŸ€áî:4.ˆJç*Øš¦›]ýꔎËùÑs·g†1ÖëÝ¡M÷Jìkg…sÿ‚{%g“½’rD%Ö…3+1ˆJêd.µ+•œ¹³•î•H´Ù•(Öi7ÑU ™•\º*ÓYIO' 1¼¨’×TI:<• Ú¢Þn‹V¿¢Ü]—ÚwT%MÈP|ÖâðB:2õJãFØ3‰JFUÞzI—6ÏDû®jÖ@m¨Jú¢Ø8rTb÷”ýÓ¾l^/-e뼩ݜŽUó ËÖ‘fžÛ7 8ÒT%ûdl;öóö¾aîFë¢^oíÙÞ Î ºïªÅ~„à = vNp¢*9±ÀêT»<ýqpÓ½’~Ë™•P¤1ý9Ý+‚Òi9³G%“½} ï·œY ªäµU’Ž\ǹÞU!£cP&£p̺b : [t(êÀÁŽ ­Q¥r`‚5®VtÔéD%GdéqiíÖèFå3ºWÞ’¤&½Ÿr$Óiu²LlÌWäߤÃr¬=#Ãý‚<Þ©Et2û±é…ó‚ŒÊ1ù±_¯Ã¾=½W"ÝB+ö#LU²],¾2…赒ȥƅ‘q­D»µXoÛÄ^+A•¼– JÒá©„0¼~¸ ¡[%­‹{]›·}·] »FÜGð«¤sg> >JˆÙ^&ª$| UòZ‚*IÇL%}³”^%©_ ¶‡ÍæÐTïóZp@% $ª„›§!~V¸V’8)A•¼– JÒ1UÉŠ* (dåÔÝ«ÂÀÂ*)ÎSIužJÂwt•TbÛöÛ¨’×TI:•¤/VRe«d%R«äÏ&ª„]´‰Y±)qR2_%ÿèÝ‘.âÅù× TI:âT²T±’‡©0Z%ïý˜¡’4»®üB*™·ëZ¯çó==MIä1*IGX%«Øu]±Jrÿò¯|¡°\‰pÉ´˜WK ü“ï½ÿ}[åKXdàõU’Žû©dÅé6f:•lý«üᦋDþè¿ßÓ¥ ÷¼f JÒ1QIöêºÚ„tóÛœ öhÓôl]Y,·y JÒ‘kç©$Zl>\m~%»®Ä$½q*•ä¶ŠAVõM£)Ïá¤äuU’Žœ¦³T’…]׺ÝÓðŠùÅRs…b¹Z ¯¡ÆWʘqüÚ*IGn»©— þ-Ë"[%1g :ËáÍËH¶§ªv0cÒ´&{%ýN¿—®*Y._(b7B©„™Z¯!¨’täò%£ßÉ&ãþ¨®¤<Éùbp6ÆŠä5U’wϲ7jfQ¯®Š)76ž¼µE3ƒS´sÃÐ`cŒ6^TIJÜ=K-°W‘tM*i"ª²‘ü¯ÿMaŽLK;?¨’´—Ð=ËÍnY²©U¹bŠ'38çÍ (̼Oö=ØÐÑT(i+zÎ íóoýÙo<ý·Åí$ñ¥mçÜ8°øvŠóÚ©’vþ¯ÿ¶ˆ{:éA•¤Æݳä²G¹”<4'x™Á³Á¹ÍŒ Ý• q3w‘£ïùy3&õó[O¿Í%M¢’ÛYb·3x¿P;•øvâISzP%é™&îf­tq73xË78ßf¼ÛÇÇNBÄ„×û"§Po}“,Èâ›+ìúâîê²&"À¼ZGƒ> ¹›ì’¦mg5];˜z$¶ô]!TI:P% àž¤ne Ú¤TB‰ÆO‡ç¡éDàpýÉ«J…Vmô|AŸ eÀ¡/[´D­§ðžò1AŸþÌàÞ n§[¢))Û˜²CZºK=BòŠ‘&h¸qêro0·Â[Řô´ JÒ’꙼£6¶¥íT—¾fÃC´;â!Œ¹ÊvÅÞ)QIµªu-O%µø•ÍT%/ຩ6B/!ÎË .[°7¿‘]V2ÃŽ´jµÇró”æ•Õô®õP*©û”‡*Iª$-¶Ámå þÓ…È1ë­áÀVfôR½ïœ!pæ<§üa½isiN-ã‡hû‚4ó¢Íqí ·‰4z\I:-‚ß0t0hnºMKGI¢Y8Ä#N¬–ܸõš·N²–fœÒÌ öõj»ªW4,¿@;}½Ù¾ Í'íluŒ¥¨]k<¶R©«½¥U’’Qivš‰„_ö¾ßÃB‰NAbŽCï÷…^ï³›ã¤!638¢àI“y=^óTBh&*¡ Ö@h‚$ DóD÷Í°Jt…û‹tÜ•ƒy£é/cUò»ƒ4ÙÆI*if& žJh“›•˜Q´A$•¤}ÒBóD–G´±MȬªæªÞÌQ‰*YTIJ:¹é¹ãd¡3 Wˆ]ÉÄTŸ«ú¾óýWçǺ= ´ø§=•p8³’ÊdSÆ¿ {dˆ6ˆGî¨DÍJ¨J4W%P×t;V%ÿÛ©gsFOÇ´3ØÁfÎJ 0+qú×U‰ûoEP%I£tóe˜4ÓPUUò  JÒ‘£*‰šdó•œÁÙ±''" -~ˆÒ½î¢Áqí=–JÌWš¨“!úÒzÞf³]rô´Éî^ ¸¬ÚÜYÉ“foÏrFw/ÚÕ¤[sUâî•4‚{%3•˜M·k§³’±ÿå5g%ª$43x²ã¯køƒ>o†¬+j[©I·©I_˜‰íÔ—Uɦ¯;?è•èÕ ¥MüµtÑ"*)næ«deõ]—W gƒ–¨ÒdÍì­#3xª’â•Ø`ÌþŽúÖyÜœPIFï-î0Ö…”÷¡W3”Gm-ÝEK¨$C©Z‹©dÞQ ÀYÜ%ÒņèœÌ`¶JBœ6EðàTyx^ iýíy*ÉÑ{‹“ÂtÓWÂ׎üÛôÑoÖÆØ£¿Ð ã"#ãÿŒ>2ÖQL7f(ù»(î¢Bb±4—,X}Äì"1®‹TÒEKצY•Jj€¡H>çM È*·éþ®ÖƒTëóÙb©Z3•4Oí¸6/3x¡!ºTfð/¾Ÿ¨’w>ûp*¹ )QÉo½KTRJP‰wo1rš1Db RalÕÇî°1¿y¢O£é]”Òê]ÂJ.ÚbuÑö|ƒ0û(U‰s»È룦RNUôgÑÏŧ’T[%í¶­5Õê¨òNƒ?hñÂÔiT¢‚q/•,ßMˆJÞ{/13ø¡âÇçÑÏ}>éiOÚ¹µl;—ÛÒ™´ó;ŸŸóNϹ·ªÐ”<<o0F°‰óÈÐðßðßEªøraÕﱇ’sµ3®„—lÙIUX}ûº sþ±@Õ¸åÞÜ\‘JnL¾ZmšÕ&4ÝÏ}~ë¼"r~ë|êCz úBÔéÑ}Si¶éMM¹I¯hŒ@éÑÌh‘(G%¶s…´ûÑrÿîÿþ’OûÄRGJ¬û—`¾ø½÷¿l' Ñüwßù±/Û¸4¯¬gSš’Lñí¬OÚù}[Iz38¸·È"ISôÈ`½%$¯^X‡}ÑÏ5–«¥åž¹÷J“.*ÄwQÂËj)»(¾"÷ŵ¸>/›¹¼J˜»®=òù¨ž^y`=ãÓÓšõÌùäƒ3C¿0EÑìHRëÀ6¯zF·%µÈg?4娱`ªV§i8WRá þ£å ÿþ¿½éâË„~íË£Äz%…˜lã¯}¹—\¯Ä»l¹·šŒÄ®ôýSôèD$·òù€üõ¢­(Ý«Uò²Ëjrø³æ‹Q³GÍf“4›Í^]¸ø*jùbUÒíÍÇ„Œl#ùI•÷]6J±+)bQIì~jÒF» \ð;¥SW–'K¨$rµ3yëyc]ÔcÜ_úóÇtÉ"*©‘nØkUAr;á¥éôÄKÓé£kÒ÷ëEñà\6%è“ßÙ:&í¥u·Xyý但f!á£å %^Ò {ÓÔuU¬$­ e^R7¢krrm×¼o/~ÎæaÂÞjÒ+⬧mü²F×ã8žš2sí‡Ò¶MÚ[M8šI³í£’ÀÿíÎH—Zá,®’T»®æ¨Z­™ÇU³ãvÅåÐéË¡Ó Ö`¬Š× Q´­‹}›…|øóSF¤Ì=Eñ‚*é4ë'îÄä6é£ýïÿǯ}cÓˆ'o~æÿTÄjRÉÔ\~»T© Ò¦kÕäŠó[|Z•°ž¸ÑÉ{œJÒ -v˜Ô;k¨á«’‡ê"~µ¶M:U¼÷çg}{/¦’AC³íjõÚÚ£K¾qäôDãÈ}oõP]Âé ^HR«kô»fS†3­Ó†gD%' ­olwÛ•»£S%þ£½ñÑý•¿È.9ÙCŸ}”jìC”ñNbòù°ó9þ¯·žþßB%±ú2éêíR9ø˜Z?Wžs×À¯’•¬oê‰ûz¨dŶmÒšT’g«„ý #žtÉ"‡?#K™s‡Ñì^‘•È¥uLºá´Mz¡Ùh7eùÀ:†ž¢ †±¸J¶sjžB#þ£¹ù2¡íôÙ‡ ï3N\ÙáÑoøä+kÿéÿÃÏ)Õ*9¿ ón@nT%ê£SIÆm›=•Lúâôrþ]WÕêÇÌÍî1+qvè+g±WÔh¾Œ3' ŸÉ±6ÒÃçù|´ÖJð.tö¦6ÌCÿßúŒ4÷lrÓ¯d¤y/ƒ¨d+æmŠ}â.=yÿ€ªd1ÛnL%s¯ÍŸ˜µy¯ës)J’¶J*Iøhþ|™"[ˆŒÿÁ}¯ÐÿIæ\D ¼…[]¯¿ý¦¶ú³É5àSÉJ'{â&LÞ³¥’Ln•l@%©¶JÒUhAK wÃ=* , ’ðÌÊùÌOÀºýå6Ÿ½He=Xÿß¼š©uåu…XP%››¼¿*YíVÉšU’z×u­Òª$ÿ$<)ñ>“‚C?A8'ÅÕy·cì=RˆNI¼Pˆ×¡C%Ù|âfB%Y·í¦URN­’•½¼ˆJXWcúN µ±¯†Z¥â¦àT—W‰“ƒ³Ü~6x8•¬ø‰»I•äóë¶í½¶J2¨’ÊãQ‰÷)8ô•Te˜dó9)8ú$GvRpD‘¾=$MRp`0£ªÇ´âiï mëô—mŽ”>zÔÌT’­ý5WÉŠ7¦7§’¹»®I*UIòVÉ’*qRpt/ÇSÉ,›¦à¨ÓÁMÁ™ªd:+qfT^¶¦]Yû£Æp2+1P%=œÈ„J2oÛu«äw]¨®+½ŠÎVIÊ|¨’0IÁqTâÄïúƒU¨¹)8‚[o>¢e0·ÚjóFÓÆðÁSÉJ'ïMo!Ù„EŸ¸~•¬L( ’{Û¶ ©¥¼Ø'Oøü rÍâ<•ø.JÆÜ]É®+1IoÌRIäÿjLŽ;+oVR¡³·õþ禮©n Ž(ETB›MTò¼榹îú@¨$íä§Å°Òµ7 Z «êÃâmH½UrÐr¿AZ‹n•ÌTÂ_ß.ý±cH©_U®H—ð¤oöi—Üqí’c'Þ(…mÍ—¢Øt¾Ï$鮕j}c&Øv¢’›Fëá>?ƒœ¦±T’…]׺ÝÓn¸§J¼Ä`7‡¡ó•&hD%N ÎdV"&I#†JH›h ΉÛèˆJÒ¡‹kž›‚Ý&Ën[pJšÚ :3ûüÊUIëH¶i—õeˆ n_’ªêõÒèÛiš3…é'©¤sNËà??ƒÜVÙÈháìñ¸ß¬«üÜZ ±ç)8G>•øRpˆJîÈ·¹ ¸'8ÁŸJöÈ¿â˜|cßÒ•®_9'8¯³JÒ®oÚ{'äxxå=e¬ç´ý }Ì .tíÂ$³¾±(¶tóÖÖ»-é9œÚ’Ü=³ëg&éfó™10I7wlóªoŸ·Ro••Ü Ý*«Û{SI¬mÛ¯ÜMºá•×GÖËŠ6<­X/\¨ÊžI¦Å}žoÝ‘.1´nK8h•<·Dñ AžÄÖ¡«×Í«fý¼%?ƒný´ûÇ ö¼^:„Æ‹:yÀé{$Ûö'•:îµS²@P~›ÔzoóyôêšXÙž÷M’^1IÁIªtxÖîW45räôº©$Íúhȱ U³ïö­[ KAžÍXÉwx$îXâù€t±Òž©L:ä&¼””>(Ã.éæ:¤Þ*©ŸY©k|=0ÃJ|¶ºIggŽÜ.rÞv=—gßdf|~ÄZüy—ô‘ B÷Š|îµE±{%ŠªóŸèÓ]×s¯~é2¥Meª×KDÑ:=ÐôóA‚m—þ¨i¿mr[ÅŠ hFÑi¹¥;“TR÷RpÂ+h Î"*ÑãT2/¼âñ°Jj¤_i1,wœð7¦Ó³^M,Ý-†%ç’ùLô¾7¥A—t²íþš|`‘~îÝuõ~=õú¦þìÜû’ÝÕõFºY‰_%ôèðUË;9¤k@ç›ïÆrzH8›çïÎkæóŒÈ÷`k‡|v‰j[Ç¢øÜt¿ïZ^À<ȃ®¢ìZŠrl©Þ?Òº]ÒAw–¦·Žº¨³eº·UÏJ¨K8^£Í¢ÀWJó Š§ ¯à˜GÙN}„³ðµùûåàÐðŠw_O•$›½J…§Å°Ænß:Å°xþòÜé^kÐW„ë† Ô­‹–(ÒEÚÁí ÒÉÖ £Ë— yÐ&ý<*Ýsê ÓŽ~d-3{OA¢JX¶5ír¹bîrfßí¢ë¡£’ës§‡¬«¦Ä_7x^·öZ| 2që°A2_‘>‰Òípºë ^ÚQûBQ®†¤£ÎU¯—´Æé î¹®C'I%MCzÞ^Ã^ɇ¨Kh=žMä‰ÂqåRšu…WÌW ¯xM.Χ¾U2h¨^1¬aZ ‹wþBEýLê]™» ì‹¢unËû§M2A¡ï&ì¨Í[È-xV¿ S÷Ö‘b ûúÍi'õúÆ=Á±Ïï?NRJ%þ.4£Ñæ¸3«SÓŽ.¹öóÍ×8pwêž ö5ÐMi NøZk Ž¦-À…Ü?…—D%}Qj¼šîºZç#õÅéX6Ÿ)Jëý¡z½¤™‡¤ƒZ¯ˆJö稄+ˆ—°êŠ¯àm¦(Ð=ó›Ÿÿî;ï}!A%‘³ìà'µJ´9 œ/~éýŸô^‹XoO%©îq C2Œù`1,ºàP;rŠaí’>m“þ5¬#I‚éä=òk·Ö w&Xût×UÓ{¯Ò¯o&‡Áå#óžã$q*)Ä©„§]R%ßsô¶«p`;ß|n—TÝ.Ù!}4l“oÀ­F–Ø{4æ Qì’žó;Ût×U¦ïwX¯ˆxGNASòCu{IÓ IzˆÎHˆJíø‰›w¯$ÿ¬µÚ{%›®Ås¿=^Û ÿð+¿´éÊ®„_þãÿ·i¯¾jñX@%tœ^οÇ)[Í¿5¸íz²²Óà$•ÄuÑé%ì#ÆE Ñê­üÖ|ð¶«VYì“'|þd6í{XÄm÷V‰WŒQ¼iúM'_æµSɼ[ó'4g-Y%zãüÁßS ]œ_÷QIǬ̻5¯6º«gïà¸Lc”3F:£8çÙ†Ým–^¯®Ëük°UBT²µˆJæ¿òÚ‚–úತ’Å»¨-yåå\Ö¬’7>ü‘ŸÚôÚ€Å7þä§iN}Š> çÙ5IÆ ­M畉~¸*Yû[Á‹?q±Jæx(Û®M%þÑ}ü?Lf[[Ó\öÉÞg¸¯Xo ³2§Y%D³ÇbäKø³?}ú‰y) ¹­ír…¦­n€_)m§ioÖÙJß*Ù´J…mצšü@—7“Hö”}„ô9IŠ«÷ßa÷ÒT·Ú·ž~²šâ^ɇ¼€™`bü(·S™/óU²Š'îMÞ?p*YضöUò©Oçr^UX!Ñ@ª@Õj•=‰T^fè#|eƒ]Ãä­ÏH|)]/Ð ¿ יͥÜÛÉO˶ JM‚*IGî?¾óã/<ð®«g“ÅTâ׉«’/~éýŸ`²iP%éÈmý§¯üö“Lòïý¤‰é|ȦA•¤$¿Í‰Z}ÔÌ"#[—«µ€ Ë‚*I }Ÿ\Tõi · aèªX]ýKä’ª$-ùB©Â‹Á‚›Ù@k•R'%ÈFA•¤&_Ø.qþb¶Ù€´ˆ+ k{k A˜ JÒ3K Î…­µ¼EŽ  JbÓ/C¯ò%iY†äz%›gգ䃮Ry b†ÒþÈOmú¾Ä“7ÿÂOÓJr+•Éb*Ɇ^¾Åi ²iØCé~ìãÿÜý6õ –&ÙÛ‘äö¸7Ú"Y[$²ÐÏÀ¥ÏIÊÖþ§Ÿ(W[–2½J2aWßø“ÿ²rá"È\ØCéç~ÞyþRx°5âwHäe¶`y-èiRßÔ!;ãÞ…ño=ýduµÇœ©UòçÄ®ÿa2)™ùuÖ9aÃ2;ë¤jسþ€ÔZ°§ÞÕ¡üÙŸ>ý¥ AæÂJŸút.牄åi0j9úÚ #<8ò›\°ƒ'o›¼õiµ—¯R«„ÚÕ1I!ìWÆDÍí¢ˆcYÅ‚o 3Lví¤Ã¦¨T¸x¯Ù4ìt¾'®Ifdz‘|ÔÆÖZ& À¨ˆ¯Ìñ£7W|%<µJ\»nìŸaýSX6œÑ¯IW©ªšPÃä­ÏàmWdÓÄ©db’bÑÿ.,s[„¡‘Èz&0@Âõ}Ô¸°ñzÝx²l(ð}>? Ï®ó4³‰ ¯i„¹‚I(ƒäõÕo®Z¸2—•Ä®l˜µ9X3’Äa;Bõ8žŒô•'/ôI“>l9¼'»šaï;‡glá™HB¥'øf0²i˜C)? È ª¤¯~I•èq*i+­Ä±Hfp>f÷yóõ]‰pÅ•'Õ#HéTÂ>’ˆ”‡‹”¨’„I‰§)k*IW”±¿ ýàõ]Ÿ4ëXE Ù,sTR\F%1“’Ô*©gL%[ÁII†Rµ°L4²qî¡’%·J@y¬*)°U’ú®¨dã,¢’¸­’]Ì]:TèOöj5 4šd´¼hXÞ` JÒm•#Þ³Ï7.ÜáBFŠ ‘?5n½)<ÜÐY‰v 䧋¬o²¨ÖVÉvÄsÜvÅÞ)QI¥ªu-:)è¬ÄUI̬„½ëŠ*A2NŒJò ¨Ä´É€±Mž7í©Jè¬D„æD%­¦LU2°š}ëµTIû‚tËE›ãÚnÇé¦*©]™p*×Z;‚ð¬Eg#•ÈäWÛé¢ÀÁÀéòÓv]UáÀ|©Ñ/IˆÂA• ˜|5A%‘­È€ɈÑS ¡Õ'*Qœi<-}ÉQ‰¹/Ë/` jA%N§˜:éÃä8Ó˜ªÄ?+¹l´öymß”$s웕HŽJn­±Ý>']tZ?ƒaýÌT”[ë¤×•´N쮜• J ?+I½ëJf%wÝÑ3+™·ëºz•¤å«ì ÀY 8³’Êdãà8*qÿµÚ ª10+qÕé"gWšüpÿQ‰³Q«7éU‚lžD•¤» vâœà¼œà8§/àÌVw•ÈÎ8鶚M+­JꟕTB·H¸‹ǵ÷‚*á½YÉÈ°YקQ•˜cïpk¦óÄí T òHXX%Œ{X»&Àñì^‰0Q‰øÒ°vf*¡'8W]%Ì»®ôçN|'8A•\·ÆâI»öÌ%s_€NP%—Ö¾ú¢PÉ­u£¿løTrƒ*A2MœJ¶ ¼ËWå·«x—Ï$YQIž­¯[vˆN÷J‚*©]“|W³è ŽpéœàÌöJ”Kò«•h·äÍTr5;Á1P%HI¡’ä jîxA­’¥Þå{D*!ýÒ¸¼Ç]ׇ¸6*A2@’J6þ._–U­0`ƒ¾‘ ¨$ <¼JRU{íT®Í~-x%P%HXT%묠–I•¤«0£’‡¨0€*A2IœJ …ÍWPËœJ²YaU‚dù*ÙL5wŒ›»®¶#\T ²aØ98ÿòÁ6i.¨Å«Ä.1C…™å%_üÞû_¶µ•&¼¤VÉ{ï±Tâ_ßD‹Í‡«Í¯¤D4QÉç>߬K¨d£°URøW?øÃ'›ç‡_ûòÈ«Å ¤óåþ£c×Ýuˆ6Õ¬D¦iá~éýŸ¹Û*—2öPÊoWDÍ57N¯® + xI­’­ÿô•_Ú´Zã„û+MLçC6 {(å ¥ª¨è†3}Þõº¡)B¥˜Ï€J¦vígæÈÖ¥Ê*çn2—˜¡”/”8^”1ØkG–%çŠ[«œ¸§V‰cWUߨ[ã”kh_Âõ ²Qâ†R~k»Tæf«þMP©påÒö*ç$ ¨„ÚµR7êÖ8åJµ*é§u~Û H˜Ø¡4赆 …ÂÖjM²€JrùB‘Èu“nƒ+ +î'™CÂPÊò…¶`sŸ?Ú!¾;ÀY‚(E‚lšE†ÒëÈbŸãrÝ”qd¨’ÅÈe‘Mw"‚ÌYàlúqK¸›ûüÌ.É@ŸDûe‚lž˜¡ôƇ?òS›¾zõäò_ «ÞH¯’?ÏB—°zé_ÿ›•oN#È\ØCé~ìãÿÜ}o¹\"9[ño´ÍÎ:øЫ(µèåqÖ‹:Êþ§ÿ¢´½Òk%éUòç¤KþÃdNì”éIW [Xe‘¸ðK:³»õµZ­Æ~»:¡åÏþtõ½„ sa¥Ÿûyw&?,…Ù`‰h$4J¢¯ÅúHX ³!2Ó—OÔo=ý6W\éÝ«Ô*¡]’ó4ÂPH1^#•J|×DŠ3LúH’:ÈW…€vÕê{ AæÂJŸút.çydvÉ#ú›_#Õðƒ6ðó‡7DÔ¸o}F¨¬ôºkj•¸]îW#‘n‰ø5v‚VKÖ‡_!ñ5LÞúŒX)á¼Ù(ì¡ôÄ5 kÀ0‡JäaxÌú="³æ q ã7ßÌÈë|“.‰hÄë—˜ÅLuî4$"Y·3ö[Âô5áß|S9¼îŠlv‘'Óa3»»-ÂÐÈœýÆ$]c½E_7Œ'u…ÏD‘ª’B058Ô+‘=‘XÌÎ kV vP|¥£þÄVy|3Ù(I*‰n#³ø³Ï7.ÜI}ÍTâ[ߘù“aV*fÝÝ*™ÌJhÇЮ´z=kà¨dЬ$gH’5ì8*X{H:k×°OÛŽJn­“Q{8/€U‚lœÅUÝ*¨D$_Ý]Wg¯¤/ŠG-QlIRûööÜÙ+Ëþ‚±ÁJ%P#ªA¥5O%Φ‘Û1´kÌŽ œ˜ŽJÌQÜ7‰Jút¯ä”Ì=š²l¾˜.plpTb¾Ð´> JÌL¾ÊÊÚŽ vg%0•Ð ç§õJ÷Z’t`¾£’—-0ïÙ*Y½JÒòUö­=Ƭ³ge3™•YÜȤw@A¡³6¢ÙÝHê[¤‹tG%Ï-ú_tTâþÇ礣JŒâÌJÒ_PkŸñÓ½’šO%¶;z’uvÙöNp”;Xà‚ÚêU’–Ü“9*á¦{%J¥½7Q‰{ ìî•øf%âlV2Ù“6À™•ÐÎ1/zÚÈ›•œ¤ G• e¢’”·JÜœÓW%¢xÙ¦G§—;t¯äUIc_K­’zFU’p×µãœàìÓœ]ïÇUÉähkºW"Š]ºWÒõTÒÚÑl:+¹r÷JàH?i€·Wrc¼l JÇI’JXW:éÁÌñô^‰0Q‰yHUrhZG’ìžà¼¢P©Jòl•.¨íŽØ©øî•L.¨yndçØÆQ‰s‚£z*¹#+šÆxz‚sGþ5·®Jô[ò•GÉ[%¨$«•lRo•87:· ÝuMyAÍ~d*!4n×~mU‚d• JJsUBÆÉê÷WIìÜ=Ã*‰«0`ƒ¾æ ¨$³x*Yê]¾e_ ®?.•„+A³_ ^I…T ’YB%ñ._U’®Â@ŒJVRaU‚d–•é¥_Ɉp$H®ðïðKO6Ï¿ö“æŠÓùRwÉÖúJº„Á/ÿñ¯4m­†é|HöÈå‹UI·GÍþ†iŽêYIÃÍ+¤K6Þ#ìn²u©šá"Hˆ\¡ÌKšA×᥮«bµ´•…™{®Pª’.Ùt014™ÏÂ*AÂäòÛåª M–îCk•RFÆHž¸D‚©àÙ@‘„j9S7 “ËŠenº}¸)*\¹XÈeC%N—T‚¼Ù Z)— ùlô‚„Èåò³«óc»¡!âtɦ{$¦›2±D6dèlš\Ff$ÓÙ|—ÄôÓ¦»AAAAAAAAAA%øÿ=3Óg>4f1%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/globals.html0000644000175000017500000000362514030601037023160 0ustar rusconirusconi Globals
Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation:
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemLine.html0000644000175000017500000014414614030601040024633 0ustar rusconirusconi QCPItemLine Class Reference
Public Functions | Public Members | Protected Functions
QCPItemLine Class Reference

A line from one point to another. More...

Inheritance diagram for QCPItemLine:
Inheritance graph

Public Functions

 QCPItemLine (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
QCPLineEnding head () const
 
QCPLineEnding tail () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setHead (const QCPLineEnding &head)
 
void setTail (const QCPLineEnding &tail)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const start
 
QCPItemPosition *const end
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
QLineF getRectClippedLine (const QCPVector2D &start, const QCPVector2D &end, const QRect &rect) const
 
QPen mainPen () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A line from one point to another.

QCPItemLine.png
Line example. Blue dotted circles are anchors, solid blue discs are positions.

It has two positions, start and end, which define the end points of the line.

With setHead and setTail you may set different line ending styles, e.g. to create an arrow.

Constructor & Destructor Documentation

§ QCPItemLine()

QCPItemLine::QCPItemLine ( QCustomPlot *  parentPlot)
explicit

Creates a line item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemLine::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the line

See also
setSelectedPen

§ setSelectedPen()

void QCPItemLine::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the line when selected

See also
setPen, setSelected

§ setHead()

void QCPItemLine::setHead ( const QCPLineEnding &  head)

Sets the line ending style of the head. The head corresponds to the end position.

Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g.

setHead(QCPLineEnding::esSpikeArrow)
See also
setTail

§ setTail()

void QCPItemLine::setTail ( const QCPLineEnding &  tail)

Sets the line ending style of the tail. The tail corresponds to the start position.

Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle here, e.g.

setTail(QCPLineEnding::esSpikeArrow)
See also
setHead

§ selectTest()

double QCPItemLine::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemLine::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ getRectClippedLine()

QLineF QCPItemLine::getRectClippedLine ( const QCPVector2D &  start,
const QCPVector2D &  end,
const QRect &  rect 
) const
protected

Returns the section of the line defined by start and end, that is visible in the specified rect.

This is a helper function for draw.

§ mainPen()

QPen QCPItemLine::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

The documentation for this class was generated from the following files:
  • src/items/item-line.h
  • src/items/item-line.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/QCPMarginGroup.png0000644000175000017500000001046614030601040024146 0ustar rusconirusconi‰PNG  IHDR·aÆþgAMA† 1è–_ÀPLTEÿÿÿZZ_øÆT YÉúÿé©LlÖüøÊlqØýÿóóÑg( '0^°òÿ4JMÿçŽ.0—ÿõºJ  úùêŽ9 ”êÿâ–9U± I1œç²L&+èýÿ 5„äþïª`®æ¥eUfƒ±Fj¡ùüøÎa ¦5_’SÕëöê–'>o¨ŠØõþáz`ÌK²ñ¡¯HýÚt‹§ÄÁðÓ”‹¨­“““|âÞÐÒ`:ÞèbKGDˆH pHYsÃÃÇo¨dIDATxÚí] [Ú\LIEDQD_¿«í†vÛmíúöݶÿÿ_mB p“s/IÎ$Î<<…&‡Ë™LÎäo‚ç5ï´ LP0P04]­V{{ñºãÝcmÏß­í´v÷ž¿s±NËðWQ… Eåê‚AúûÁà`Ø9.׎gB¬d±NËpUhæº"ÈÉøtÇ›œuÏ_F­D o²þòƒÓ‹¨@‚`÷,úç2ª‘£qt¯âµ“ëVpD‚Ì¢n“ównµî¢…ï“â—‡£àôÊ럵‚àxo«u<®â·û»{ÏÂ'éâ8&:8ˆV·÷îGÝ­Öå(è>%Hú©É§T˜«« =?Nîêƒ|¼nþëÖ §ÁÝá§$³(›HyT²"$¸wÃÙƒ›Qÿ÷r8ù<8ôƒHÎH»Ïß¾&2°ÁN²öÑ{ŠŽ!ó¨dE*Èåv*H{û)Î."y¿íK1Éöv¸x»n,žý'Ú81É£ÉöbÔbI>uþ)çÕåê*È4Øýûï¿‚xÞ?ãàxQ!ñA}•¬‚´× r´ÿw–ôo¾ºx¹×]£w'Þ9ünQ$ŸºZ!¨¹¦ÇƒÃ›3AîGÁÍÁ0Ú+n¢ÆE¼¶³<†ÄQÉŠuõRM®®‚ÌÚîÃLpÚŠ»¬ø)¸•BX¬_üËbé†ÁÅ ¢N%á´õ{öâd¿_t2Ž¯©ºg³jâ9T&g]?aÑ;xèï_ïGWazGþEÿìr˜Å¢Bˆ*¤TrY|ø9þþïk|ÝÃÎü•÷äÿÈbfYõ ’“%‹ðº½ýäϮ·½ûÑ{ÂcH¨X±èøWž÷ç¶Öý6ÝÝK×Ì.k ~ýò*{l.,=ÿ1œ½8ò¯°v+kAp©X°è.æ—§|÷¯êf¼ ¢2c1ùóåitñe2 {¿ô÷ïÎFQkr‡ÒšØT8!‹^ë*¹ú}':Þ=Ì®ªë&{Àne#8!¾Î__©ÏÂæ›:8Âéú«ç,ÔOY‚N¥èïVoé\Ö›aÑ *úU^v…Ô ú»- Œ1Y¨·&ü‹¡ÉbýbVˆs0Y4‹Š~•³Ë’° e9מ1Y¨·&ì²Lë³BœƒÉ¢YTô«œ]–„-Ë9¸ö,(ˆÉB½5a—e²X¿˜âœ…tÊøb’¸ùTÍ¡²œ2>Ÿ$n>e±¨–³ß‘©ä²H§ŒÏ'ø™OY,Ð,«Tò±˜9Ÿk>°°œÛ‹LEÌ"œO7ŸêSÆí¦"f½[½Å ©¹ñ6ˆÊbÊø|’¸ù”Å¢BXÎ~G¦"dÑk]-&‰›O,@- œŠàSÆ9ûÝd¡~ˆ³ßMëƒV8²h ý*ç_ %,hYÎÁµgAALê­ ÿbh²X¿˜âLÍ¢¢_åì²$,hYÎÁµgAALê­ »,“ÅúŬç`²hý*g—%aAËr®= b²PoMØe™,Ö/f…8K~žMêû]˦7’Jaëôä Ó-+™Š&Ÿw÷ o˜noY°T¬ðä_y7L·–Š Âi\؈7L·—Š îGÉ ¸¦[ ‚KÅé$ÌÞ0½‰Túãx&ä Óm+˜Š:§qSyÃt[A€©}oñ›z õ@<—e²X¿˜â#̸j¢>,DåÉ¿ûèHD¿ÊÍ ©5•“Î~ëôàÁ…ˆþne Rk*/‰|«!‹ÇúRYÅý™ÜŒ‚ Û]K¿5y!H}©¤èƒmG_“ºç–oÕß­LAjM%Å÷Oó ?úTcM£âý*ç¼, ~1tÞ”Åú#a-Q§R‹2µ-K¢–¢N…,HE¿ÎiY´,çàMY¨·&ì²Le j…7iYϦ&CÍP¶™ŠæÔdÁ eH ¢bNMÌ.«–‚LEsj2ÖüKKA©XÀ˜š,˜¡üËfÒ±]ð†‚ S±Ãrj²`·ª]*;,§&cÍPv•ŠæÔdÁ eH ¢òljrþ å aY!ÈTŠ€þnÅsY& õ@<—e²(cP+¼ÉsYÖ,jY!êTÈ¢Tô뜖%aAËrÞ”…zkÂ.ËdQÆ V eIXÔ²BÔ©E©è×9-K‚–å¼) õÖ„]–É¢ŒA­@Ë’°¨e…¨S!‹RѯsZ–„-Ë9xSê­ »,“EƒZáMZÖÉ~+è>x÷ç¶ýLEŽÞÁCÿr(¿?7$‹†Qù:8—ߟ»B8X*+„×ímÈûsÛ KÅ ÿÊâþÜÀ³ß©Ø ç?†³²ûsWkAp©Ø-îwn[A€©Èñ4ºø2™„òûsC²h•ðzf¯ïå÷ç®vM¥èïV<—e²P?ÄsY&‹2µÂ›<—eÍ¢–¢N…,HE¿ÎiY´,çàMY¨·&ì²Le jZ–„E-+D Y4Š~Ó²$,hYÎÁ›²PoMØe™,ÊÔ ´, ‹ZVˆ:²h ý:§eIXвœƒ7e¡Þš°Ë2YØ,.%¸ì ©Š3ò§Œ×F(*®L¯‹Qy1Ý/¨ø…*‹Š+^Lˆ­¯ XT®›2^Ý£HAÀ¨¸bu·ÒGaR_¬¯> ;†Ô«SÆkŽ†PY™2®¿‡àPi û¦N   BY`…€‚€‚€‚€‚DX!`  `  `  `  ‘V((((Ad  ’þ RA°ÒªóCA*VZUbþc(hM«Ì i…`¥U)’C™½|åWPJ|<Ç;Œ´ `²Žâ_©ñîGatY9i厎`ƒï˜‚|“‚Ì EƼt¤‚`¥U%?†’Á\ãŽ-‚´$ø@_µßÔß° ¶;¬D=--°BJ p)1ÀúÎà&Hc¡_!6iY ƒà}AhY&sõv†]–É|ýbV-K’–ÅÆ@p¾3°Ë’0g—V!´,0A*-Ëd®~Ãt·¶¡hY6!ÀúÞ@Ë’0g—V!´,0A*-ËdÎ.«¼вJ °À–ÿ(d^:VJ«ZôÇA6s.+7-Ù00b„ÓË1Œ Ë ÉOËbc ˆ±õéaÆ–‚@¥U%úû“”ùúyÿ¿læåÛ?ÏæEZ`‚ô§íádβ$i厎 D<Ûý’Ë+õ½a!XZ"üóçÏÏññ/ƒ¹B—%IK0 R€-K’–ÅÆ@p¾7ð\–Éœç²Ê p–eå¥e±1\ ï ´, sþŬBhY`‚TZ–Éœ]Vy. e•à}o eI˜³Ë«Z˜ ‚–%aÎ » W]¶½j eI˜³Ë«uËÚxc ¸@ßhYæ¬vY’´,6B€ ô½–åý3^ÞÓ[ß²lÒ’  Eïð[ÿìn˜Å\òi¹µ€‰ñµ‹rÇbòpÒªÿŒw÷²˜+ÔóÒÊ+@ŒN+,n!s9‚ -°Ga‚x^ÿ¬›üzŠ¾7¬VPZUçç*lÒ’ Eçãmÿú4sWÔ8†Ò*rk 2mY4ü¥#+--Uˆ ­Üѱ\ÀsY%¸@ßx.KÂœ1«uËÚxc ¸@ßhYæ¬vY’´,6B€ ô½–%aÎ. ¬BÔ-kãà}o eI˜³BÀ*„‚€µ½‚? f2_¿˜]-K’–ÅÆ@p¾3°Ë’0g…€Ua—––ô+Ä&-‹a¤8ÙoÝÅœM›Ï*ײi¹µ€é<ô÷/…óþKÇòr¨´ªÆ×Aæ¼­ƒzNZ¹£cX ¼nog1W$/-‹`Î|R³Â¼ÿ,AÓ*€Éèù᜹øewY¹iɆ £7º¸õ2™«XV~Z!@Š§ÑÅ—É$”1/© XiUˆðzfÐﳘ+Tˆ$­Üѱ\€#ˆ$-‹àý“F<—e2_¿˜ç²hY’´,6B€ ô1”0g…€Ua—––ô+Ä&-‹a\ /-ËŽyé`—%aÎ « &H… e™ÌկµIËb„вJ p¾7в$ÌY!`BAÀ©´,“9»¬ò\@Ë*1@ŒpÚú-e^:–‚@¥U%&g]?‡¹F…ÒÊ+@ŠÉ‡ŸcDAòÓ²ØrœÈ™—Ž•cRZÕb…¹ú¯#ؤö(Eõ:]–E… 8-«¹`…Ô­B(Ø7õ ÁsY&sžË*/ÀP–•›–ÅÆ@p¾7в$ÌY!`BAÀ©´,“9»¬ò\@Ë*1ÀúÞ@Ë’0g…€U¤Bв$ÌÕ»¬¼„¨ò*\uËbÛ«Z–„¹z…äåPì²l6B€ ô½–%aÎ.‹]–$-‹à‚Àfq)Án–U‹1þòƒAöϨ’Ÿ–ÅÆ@âÈ¿èŸeÿ † ‚´ŠÜZ@‚Ä?AðäÿXTüÂÀ»WÓZ<½þˆ€Í1mo{÷£•;« òzZÛ»|AÂéî^:ks1ÇótÞa¤åð(¥Bô‘ZVZUbÕ¬õ±öò¶p4ŠÚ™»¡vs,»,¨´*EÔðwaöDã{NZ‚w›A    BY`…€‚€‚¥àÿ V;|ÓqG%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractLegendItem.html0000644000175000017500000020600114030601040026613 0ustar rusconirusconi QCPAbstractLegendItem Class Reference
Public Functions | Signals | Protected Functions
QCPAbstractLegendItem Class Referenceabstract

The abstract base class for all entries in a QCPLegend. More...

Inheritance diagram for QCPAbstractLegendItem:
Inheritance graph

Public Functions

 QCPAbstractLegendItem (QCPLegend *parent)
 
QCPLegend * parentLegend () const
 
QFont font () const
 
QColor textColor () const
 
QFont selectedFont () const
 
QColor selectedTextColor () const
 
bool selectable () const
 
bool selected () const
 
void setFont (const QFont &font)
 
void setTextColor (const QColor &color)
 
void setSelectedFont (const QFont &font)
 
void setSelectedTextColor (const QColor &color)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual void update (UpdatePhase phase)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual QCP::Interaction selectionCategory () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual QRect clipRect () const
 
virtual void draw (QCPPainter *painter)=0
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Detailed Description

The abstract base class for all entries in a QCPLegend.

It defines a very basic interface for entries in a QCPLegend. For representing plottables in the legend, the subclass QCPPlottableLegendItem is more suitable.

Only derive directly from this class when you need absolute freedom (e.g. a custom legend entry that's not even associated with a plottable).

You must implement the following pure virtual functions:

You inherit the following members you may use:

QCPLegend *mParentLegend A pointer to the parent QCPLegend.
QFont mFont The generic font of the item. You should use this font for all or at least the most prominent text of the item.

Constructor & Destructor Documentation

§ QCPAbstractLegendItem()

QCPAbstractLegendItem::QCPAbstractLegendItem ( QCPLegend *  parent)
explicit

Constructs a QCPAbstractLegendItem and associates it with the QCPLegend parent. This does not cause the item to be added to parent, so QCPLegend::addItem must be called separately.

Member Function Documentation

§ setFont()

void QCPAbstractLegendItem::setFont ( const QFont &  font)

Sets the default font of this specific legend item to font.

See also
setTextColor, QCPLegend::setFont

§ setTextColor()

void QCPAbstractLegendItem::setTextColor ( const QColor &  color)

Sets the default text color of this specific legend item to color.

See also
setFont, QCPLegend::setTextColor

§ setSelectedFont()

void QCPAbstractLegendItem::setSelectedFont ( const QFont &  font)

When this legend item is selected, font is used to draw generic text, instead of the normal font set with setFont.

See also
setFont, QCPLegend::setSelectedFont

§ setSelectedTextColor()

void QCPAbstractLegendItem::setSelectedTextColor ( const QColor &  color)

When this legend item is selected, color is used to draw generic text, instead of the normal color set with setTextColor.

See also
setTextColor, QCPLegend::setSelectedTextColor

§ setSelectable()

void QCPAbstractLegendItem::setSelectable ( bool  selectable)

Sets whether this specific legend item is selectable.

See also
setSelectedParts, QCustomPlot::setInteractions

§ setSelected()

void QCPAbstractLegendItem::setSelected ( bool  selected)

Sets whether this specific legend item is selected.

It is possible to set the selection state of this item by calling this function directly, even if setSelectable is set to false.

See also
setSelectableParts, QCustomPlot::setInteractions

§ selectTest()

double QCPAbstractLegendItem::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Layout elements are sensitive to events inside their outer rect. If pos is within the outer rect, this method returns a value corresponding to 0.99 times the parent plot's selection tolerance. However, layout elements are not selectable by default. So if onlySelectable is true, -1.0 is returned.

See QCPLayerable::selectTest for a general explanation of this virtual method.

QCPLayoutElement subclasses may reimplement this method to provide more specific selection test behaviour.

Reimplemented from QCPLayoutElement.

§ selectionChanged

void QCPAbstractLegendItem::selectionChanged ( bool  selected)
signal

This signal is emitted when the selection state of this legend item has changed, either by user interaction or by a direct call to setSelected.

§ selectionCategory()

QCP::Interaction QCPAbstractLegendItem::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ applyDefaultAntialiasingHint()

void QCPAbstractLegendItem::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Reimplemented from QCPLayoutElement.

§ clipRect()

QRect QCPAbstractLegendItem::clipRect ( ) const
protectedvirtual

Returns the clipping rectangle of this layerable object. By default, this is the viewport of the parent QCustomPlot. Specific subclasses may reimplement this function to provide different clipping rects.

The returned clipping rect is set on the painter before the draw function of the respective object is called.

Reimplemented from QCPLayerable.

§ draw()

virtual void QCPAbstractLegendItem::draw ( QCPPainter *  painter)
protectedpure virtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Reimplemented from QCPLayoutElement.

Implemented in QCPPlottableLegendItem, and QCPPolarLegendItem.

§ selectEvent()

void QCPAbstractLegendItem::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPAbstractLegendItem::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

The documentation for this class was generated from the following files:
  • src/layoutelements/layoutelement-legend.h
  • src/layoutelements/layoutelement-legend.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/AxisRectSpacingOverview.png0000644000175000017500000001704314030601040026124 0ustar rusconirusconi‰PNG  IHDR·aÆþgAMA† 1è–_ÀPLTEZZ_ÿÿÿüÛÿÿM´üPÿhþï²ÿÿOÿèýÿPÁÿ‘-ÿ ÿ ÿÑü§[ÿrÖþþêÿ. ÿ–éÿ .ÿùúÿ²ïÿÑóùñïöÏqÿÎbÿ*`÷Ô×üadÿ)“ûÛ–ÿi ÿñËÿ,,ÿœ§íg¢ô¬Ðçééé“““³Qì³U ïݧR¨ìéÒYYc^XæéçÙÔÏή‘ †~†ŸTHNŸž¢‹‰~}}~ˆE ½bKGDÿ-Þ pHYsÃÃÇo¨dŠIDATxÚí]‰Zâ:¶¦I©E ¢@Y\QD—¹êÌû¿Õ='iÙiºÐDò3¶I¦æÏÙ²œ2á@"4!’A"4!’Aó!´„HMˆdЄH1B fqK‰Ò¯àcSQ¼n™¤\IðÐÛ#,w¸ð±òˆ’bNH•b×à‹cBÜ:Ÿ í7fç9Í-íÍY[Ô¢Gx½j·N¾Ük×"?ôöÇàØDÈ©­~˜óAÎ:V‰|ét[n½gøÈ…OàbdÌY{·_öØÇš»^©—ú/·‰·.¯„R0ñáI]óë4$†rŨ–±«N•ªÝ1Ý ÎÀìÁŸ‚9¤¤Ñ2.P"mJløUùô» ƒÑ‡Czˆê¦²ÇD‘UÐ#d /ù œgö8Ør¡õ‚Ù¥¤Å›š·ÍŸŸ«ð¿ ë ´€„ðÛá#:v+ïŽßFˆOŽð£j_!¾Yöà·9Z¼RçEü4½Q¥P/â³ß~~Í-œVÚä×ìão»HM/@›mÒdÃ5^- Ä5{† %}Úc„4*ôå€g­ÓóNÐÔ¼mþ4ìqˇ4ƒË³:Ђ‰Åg·Ù³Áo+ ôyrrBpt§A—Y”2v|r6]̸¢±¾Æš^éWðÁ: …¬\€B] „W[ „ýßU4YØ2£¨Þ Š±ÆÖ´< Þ)àˆa—½…:L®ƒÛá£èa„¾É™££€Öè†wn`o¶M®UBBNI«O)%Mÿ  ƒÖiÈWƒ]`T—ñxµBXIFð!A1ÖXÐÔ¼m/|š6>&)†—êœ $¸<4ÍMË‘™ á_f„X (:mc¨Ÿ˜ylÓbX‰@¨Z/!‡Ø;s Y&ä”Wc„”æÒçrc}iÛ Ÿ&ìàò¬Î¢„³ú(,ywüFBÂ/àeµ˜—…îVgÔ q‚ñ J˜YñC«f ÌbhCì¦e¢"ãÊ´ÏmˆO: ´¸ç3!aZ"„UÃ~·hÆ‚‡š>´! „­²aã-µÍŸ†Ÿr m¿ì„uì¹ á·Ù³V $Ä,ñÂ8„irB±ß¨Rp]H ÆEÓ2ó²˜ææ îõ²ø(®³0d°xD´^ö𲬹—5#$( çrÛüi°5t£ìf8Â:K^–={D’b1R÷ú‚ÎÇŠƒÿ ¸ÊòÒ’Shšð’?H6Xš:qKT(„Fˆ7jBgJÛ§ÉÜÍ…¦’ écd‰D“‹ Á˜/˜»ò“©ŠÅ¦`p‘´…ì g{%ƒæC2h ‘ šÉ  ‘ @H§;´m'¢ÊBa·“÷Óÿ@t v»ÝÑhtÑél—¼NçÊB!%ݼÿçáÀ £Ø•G$ïÇÿy88 '±+ŸhBR‡6ê’A"4!’A"4’AKˆdЄHMˆdЄHMˆdÐ|H-!’A"4!’A"4!’Aó!´„He¹Dl»¯T&ºüÛ»W.W>¿~Ù~!•¢QÑ„hBr#$ò/ºŽ¼»Y²Bˆ:ŒhB$C4BTÂ^r½?r/ª Ñ„ìž•°^VîÃ^Kˆ&$:¶ÌeEïY°'sY¹û}‘MˆtÐ^–dÐ"4!’aOTV„ÜŒ/Çgžq;¾¼;4´É}Ø«'!·ãžwsw<¹»ŸÞ<4ƒMHŽ„ÜáßÛÇcø(©¢$ñ²¦O¿ï+7-còØ >R#$÷a¯ž„0«qnÜÂJkñr±ùÞFBRì±éçA†+‘„L>ÿ½#/×y¿NÞþ^ÿÁ~}é@ßþ{Ï“7Îüø9ZéÉk(ø²,q¬¶3Ú$!ϯ_$m‡ «Êýtñ”w HÁûóõì.ëÛ«W>Ú_?GÁ…u½|õ¥Ò²ä,…"¹i_V¦„lYsÕÿεRØ·ü袋W.+“7VjúúoÜ|~½þÕªh¹ˆÞÛ߀ô—÷7,óʬÌí·_„¬•×¿34eŠ‰ ê„̸zzùùõeþýn¾~þy¿Æ¯Ë•^?ÿ] Xúú)ûVß±ð{'B¸Ëñ÷ïo9 5SôŒ~a…gNÞš†æEåäšwü4™ç•J/ìúôk½A]”%(ý™›ÊšÜ“‹w™Yõ$sYÐkKß/„} â€ýÉ2^¸þZ$dVéùåõ3(þ–™KãBöx.k!s ánï¿ÓXïÏ NîëçÇ'Ónì Ôûs1ó®/°ÍÀæÏ¿gV#G ‘ŸïUß÷^ô¾Šð3èÖ)üܹ !ºdf³È}ƒ[SMÈ2!k±Þ¨/«¬rx øy6úù…W¼õÀì@›ïžCó£ ùFBÖº½/^WQ!¡Í¾æEç‘:›?AÞýÏs®¤QYxRgrå¼N„| §okë¹5¿ (‹„ð{A¥WîõÎ%ðù3ªQÏ–éSϸ¹¼”uú§NxüN|þåÂËó"!óyEfÜ™p)àFýåùê*¼ú§3#ø…»ºWÓö_®ñ‚ö $¥Þb›­{òN¿Opfwqr¬ópa¡oÙÕùðÆ>æ?3·÷ú€ !£ ‚Ah~4 ?™ë‘aN‘úß6Üä›d$„O¿sÏ–ãåõà}«Î! cÉL|=xÜ^ôŽ?FóÀÏŠát Áà4Ê$€œ™>/Ïdß—5}ýn²|÷ÈÔ¨O>Ï=ãö_†V=…ÃéÛ"#?xÅð¥e‹ŽGG*Ù€&‹ŒüÜl@“»û`¯\þ“‹[ðòþþ±höÈÎË:É2þ#$w=$…Êšo¶>Ò„ÈAÈôéòþåi,k`('²Ëº}¼|¨eG‡–A€ˆÜe* š!LŽŒÛ;i÷eI‰Lç²þ¡pLG‹ÔoÇ÷žNÏ´ƒõ×ÿ"Iz^Fé™rïey™ü¾»Œ¦²nžî½ŒRk¨„, 9y{¼¼¼fAnïŸtz¦L ™>ǯÑ2d@áû+FH&é™®óN½í6§gJi_Öø¿Ú$"!`1N²“•¥—õöt9Ž–z,:âA§gÊ:ù ØôÇ"Cœ¥ºïd”ž)÷^–†ÓÊE<Ž€*+£ôL*a÷e­GîE5!šÝ¢öv÷ûä^t/$$÷^Ö„,¢”&D¿L:h•%öDeåÝÍi’û°×¢ ‘š•°„ä>쵄hB¤&D%h/k¹Ý ɽ—5!Ë„¨¥ ÑsYÒA«,É°'*+ïnN›Ü‡½–MˆÔ„¨„½ $÷a¯%D"5!*A{YËȽè^HHî½¼/„ìÍKÁT!DKˆtЄHíeI-!’A"öDeý4BröêITgÇou6 9¹ýï|ú4K”v6 • ‘—u{w¬39È"!ˆ›‡–Î$!·w=#£l@ŠüÉ80÷ž¡%D ¹e¯]×6DB0ÿÏÕ•—Q6 • ‰—uÃÔg/£l@¹{õ$$.4!’aOTÖO#$÷a¯%D"5!*A/+[Bröû"!ú•tØ•õÓQGB4!š<Q ÚËZFîE÷BBrïeMÈ2!—ý‘{QMˆ&D¢ Yé—Ë­w²)¥‘u„äÝÍšBTadÛ\Ö¥ŠP™}&D2hB$ƒ&D2h>$CêB¼onz$Aµ˜-+†ô é|só‚&¨³eÅ:!CÚíŽFÄìûi4êvé0Aµ˜-+†Ô ñºC›Rò”Úî— ZÌ–ƒö²$ƒæC2h ‘ šÉ  ‘ šÉ !¤ÿ˜Xü{dʇëTÒ©†Azg5÷Ó>‹õÈŒL%d`6Z©T³»N×^¾fÕÉ°kÚqþ™‘%!§Ô¦öqÕºw—. L,ãÖý”=@†„ Ì¢á–H¤ÔKâÕú6;ÛÞ¦?LD2$Ä"Gð%QÒfW+˜üþ©&$2Ü:˜‚v£Šœzµe· õòOSYµëÐFÓ2Éݺ€ˆD®æ•‰BDIÊ¡2’693IÍu†5Ð>GYT³hcÔ¥vÍð‡Ãó$%Ù2è÷ ·O0…‰eF÷ƒDª À£g•AØCË»–2ð¼3ÉU¼þYD>«ùLYê´†ÿ6~L€˜>!èÿ€ÛŠÃ\D“l­¶˜û,$¬°X4R>!6!… u«åUITɈXíK`>0X\ÈpÎwÚk"mq GAõÔà‹È ÝZm}`îš¡+6¨í¬Ï2Eê*Ë!å S=!×g[µ y?0¾I‰ø$ŒH߆ø´!¬±¶VÛ˜[ü:ÐÙêÿ Þ:!§tˆSƒbkkµ¹OyÀ#!ïHŒ4 Ë ºþÐ(àÔ`t¥ÚæÀ|ÐMw^V[pŠFR¤IZæ`jPd™"Rµ00ÿ—KG`[(¡÷]&HUc*?áSƒB}¥Ì;kâr·‹Rã:µ]v[vH׆€e™Ä´Qª±ÀU1«…ø&.XÌU8SWg%”ßÕS%¢™bV[ƸÜs^µëêneLjC@õÔŒSá˜0fµElŠË;žÓ8QwR+±—Ål¨oŠv@Ìj Ø—[´iÑc_tÓ‹4H!0Ľ;žðï³Ú ›âr¯T>Ë^_Ñ¥ªd„´M»foù‰[m ãrð¨±aGÑ3 ‰9¥]œ~ܤ·Ú 6Æåžs^PS:IqëÅ~£2uûcV[ƒMq¹Eª*­$„Lì á ï˜ÕÖ`S\î:È‘šJ+‰ÆòpgÂ)ê1«}Åwq9*-w¤`ÌOB:0öÓ>¯ƒ°Ì1«m‹Ëu9*­6% žu‹EN}œ’³!9‹,÷Å«ö 0._˜ƒÒ²h¹2Û8¤âIˆoÚ%t-ÏdĬö-6æÚôSå {L£>À…TÃ5OÌjß`s`Ž\x¥†ç\Ô‰­Îv­¸^–[‚_²ME‡zÌj›±90/Ô]ä¿JìZ_­±øÀ½;ü¢¶ØHYí{lÌ %Ú8wf)ÃG, ö‚˜Õ¶!̽îùº¿Uræk )­„ÌöîˆM}Ĭ,07úäë$O ¡”Ò$#‰{w1«EæÐõÃFkuûÛ‡ÐP-¥%FH|/æÞd[~¾E¡NjžSY·ý”ÖIWøPPBØÚ«èÞ?èŽ[~¶±¯ÝþÕ–B«ì¢&„­½ÆØòÃëÆÛòÕFeýö¦´TZe”vYt”óp0S†£:­y£‹u7•Ze#Ä+Ñ8Y³Ü™ŽÓŒ¾IÈšs?j­² 2hFFŒµ× ZVï4K9q»‹–[…5›ï‚`^ˆ‚ò¬t+‘úÉÕ"úžqÎV ÁA›Ž§uý•5’ ˜ï(aE„$„ÉÇ©È1Û-ƒxàðô3? {8YΗ xÌ{ Ï¨ éiøðqjäãD¤}"‡-Jdš¹u<Ããõ×fü˜6­•X‰.!ÜrÉ뉺Ý%ÔÞEÚüA­±­»wJšUÛQ`u$!`4ð0žÍ’w†”ˆ=êvw³¼m™¤1<ƒxÝZ9ÈÞ÷°Oìõ32!!˜>Ìi€§_b Q¨Dvär‚óënwxŒéЖî`r@·T[7)¢Jˆ52ÁV ¯ˆòüÔŽpº˜ç·Š–Ûùz$Ô2Ë>¹›G‰‹ˆ6„%¨„_JÄsEç¸@‘Š~qwà ÷úÐÕ­3;{”XˆhÓ= ¶ÛBSQ,M¢‡K¶§;ÌOéÖ7NîôUX¥Š&!Ià°ëD);&âÅy,ºÓ3Vg㙶ªqH$B®˜;–é9ÏÙñb„[ÚÔï…¡§×£bQvÁµWç0Ÿ±AêR5fJ¾ !´Ž-úBæ6Ícf8X`ëT™)ù‚ï q¹Õ(øõ²hhg2';•VK™™’/ø^@ª„ž1Ϥ*º>ãâ©ßL}I$(3SòßKˆEÏêÄ>ä b™ÍÔ;¤Aw®"˜)©H–¯ÁÒoT &NÄ惕,˜×ÌQ8S¢žÙBÈ€ûvkЛp˜­då÷{±™’I”› l$„å³bG+c8ïâ+Y©Ã­áÞŠr¯ÕÛDH˜Ïª`Š»*±V²R‡Å¶µUK»I@Â|V†x*ܘ+Yiƒ®(÷º° 2Ëg… £Ñ…}ܸ+YYÀ÷ºê<±ž¯3ÏgÕŽþ6Ás%+ ´qYÄuF2+6Á+¶’•)ØHÕ–æy¶bÆꇞ®x>«jMðŠ­de $`ùw›„X'!¥2ÿˆŸ;•¬\&xײ[…z£‚.ÿn“ë©òÐCèEèa ¶Ëg‚w ð7ç¤|Âw›ø*¼Xo!ã‚æ ã­de Ÿ6ê¤ì6q”xÛ !žƒ¯¥Cϵ+rÊ&XÈŠµ’•)¬!„¨l·É·ë%Â2!n‰‡Änº}ÝGÆl!K|%k@îÌÌï²€à»åƒY9!̲„W²vÂðg~ JÌü.IH`Ʀð“ϲ:R¾—@¡™ßeBÂw2 ?y¼…¬a6ó똻8‘Ë6$8éíSBøJV¼…¬]Â7£:vM¹_f±Lˆe³X4òäG°’g!k§h“r‡½\ÉýR†`ÅíõMÒõI·Ù„+Y²¿ÓÑïzÁf분~Ç«qa¡±@ 1[ÉZÈÊ…ÐBÊMH²Üï +Y Yù ÀgN$÷~“{%+x%d¢P—[·&"$ÁJV—eÔÅ=à2?mÂdüñW²ò€U§ô¬åJ>! V²òÃr%A"’`%+7 ÄgêvŠD’`%+7°ùÓ‚¼Ùw%+O‹ìÒÎóÄ%$æJVþ(Ô˜>Ø“uÛCLBâ®dI·Ê–reÝö“¸+Y2Àïy†¼I6b Hì•,9 q’x%KHœd#¦ÊŠ³’%$N²“+Y2Aâ$qÝ^ñ•,HˆŠ®diDCâwk¤‹äo‹ÖHšÉ  ‘ šÉpp@ò~„TàýŒ_½,:És$0&:£¡÷3¤„ƒƒ“!%˜œ}è.aÄqÁÐù‰æO¾o›ÿÿÁÃ,?!>³mãóeH‘!øogþzø Î@9ˆeááøÓ²£¼„!DChB$ƒ&D2h>$ƒ–É  ‘ šÉ  ‘ éRH#yY*( 1>ªµ³u[Ç„àùÈ­C ÍO¶Î·qxN°evwíh«¾³FöB‚/Ù±Jä_¦Ùét[¸_ÎG.üu§Ôñ®µ’¦Õ“wÛ¹$!„ŸEwë¿Üà5ªlcÕ®Õ2v4¾kªjwL|‘ ˆFx_â\dûTH¯Bsnöf¯`)iô)¾r(–(˜]JZ>%véWÁ9kwË-,\ E^Ç}C³?Û„Û¤ÉΑc1/^¶¯`—‰%Ä`¹a8–ûpúÒhcî^¸‹ÙÚlú¼ÈSñ¬%Äëã“yV¬XŸR”3ýV¶z{whCÂÄ&!¨šŽC[À˜‰iš0é{›ñn›âôUBCBðÍ÷LB—%äp/ ô²ZÌËBw«3j„°W Á€y`ÖúЪ“f¥P/·À¢ q41óKhCi‚À ®=ŸhB¢Á ãþ¥É ,o¿Q¥Mpˆk`CXzov×'‡è^aBæl9s/kFHŒÍm†¢Eìº&$2¼~öy±<%_¯–„§NÜR¦gB¼Q ìɾΛòM.z:ÊžW(KHƇ†l²÷ЄHMˆdÐ|H†ÿ^Ùß»ÈÖðç%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractPlottable__inherit__graph.png0000644000175000017500000001763514030601041031563 0ustar rusconirusconi‰PNG  IHDR¸¼Ç—Ë—gAMA† 1è–_0PLTEÿÿÿ...jjjQQQ  µ………ççê®®ËÒÒÖÖÖå-DDzbb“V/ÛIbKGDˆH pHYsHHFÉk>”IDATxÚí_lÇ}ÇGKêtw4åBF‘‡åò¨³ä¥i;FÔ¢ Od¤/ÂÙ…<yj ÖbN6è‡=;’¢6IÀHÑLEHMPªÍæ!Orâ4hþÈË?OEÒŠ¹Z $N|±;¿™½»ý3³;{{ËýÃßÇ0wovo9ûåè7vö;„ ‚ ‚äŠÆH¹?éûIcÕ§FH}>éûIcóé½ZæAqcÅ7FÄrèâ“5×9šû×%ÇIcŽºqY3Î’æbO\}pžN c‰‰©Yšê–¸šAè±Ëö«!KŽúËÍÅñê_ÍkÅY˜Š«_×…âÂOýÚœýjÇ’£JÆum„zµxö!2clŒsš¡ÏĨ’[ÝÕ‹TÜ·f· ¯‰ôYaâ’ºýjÇ’ã<)ëÚ·ØŸœÌ¼2¯­Ü¢šÍÒ´&y¤Õ+¹Ð¬À6Ù9äñk:÷Ûö«!·¸Æٱŋäá ýÄ „Þ‡É8-§çû1÷azUé9MDqåx¹i[T8òµY(®D{úU.®G-q!‘‰K`Xâ®Ðy†Œ]¦ÿäÇ6šäˆûò4„…s\\ ô?šÈ£ߚg⾎š{S¬A›b„ÔÈ)VV'i5­ëôÈ4­¶Ø.aÚ ã„‰V…¶¨Aý†M1}9¦[£¼`÷7FPÜAqcÄGÍàM~ТrµãˆŸ¸ÅúeØêüSÄ«G$r|C9Çi¿¬ªºf,­IŠçhó«¼P£Çç¶Â\í¸"”£øÌì ˆKûi¤ %÷íLŒ-žœ‡ÎÅóл:û¼òÕŽ/B9k.. "о-Œ œÒµ%èòÒʵ…yÕ«_|Å×aA'Õ¯ÂðÌcl@†wŠ«„_X(6/à Â9R{Ämž…ñ„± ·†5ü*4ÚƒA„i½1âjó„UhU‚š!äøÊ’ìÁå0W;¨Ë¡Í7Øý7FPÜAqcÅ‘±¹?!ù¤ï'UðiûŸÆiûq1ÑÞi%‡¼‚ÚÆG±³ÛJ:¹¥³›tòË•½­¤³[ÞÙÛH: ¹¥b$…ÜRêþ4é,ä—ΓÎA~ù6b㔹‘tòKnl`Pˆ…øè|˜tòË…Ø(v’ÎB~¹ý“¤s_ ævÒYÈ/X›ÅGe/éä˜ö~Ò9È/Ø ‹l†ÅȺm½GK±»4ø€^Ž£åö]Ûœˆ7RÊæ–íŠ;Rn¿oÿ„âŽgÁEqGÊGÁMÌË1—m²kÄ&)/Ç™<¶=\71/ǪÂ9Y 2Έ›œ—cÅ]w‘'åå˜Cq‹Ý ñ ¹—cÅò<܉ÅËñµàœäP\û¨‚ãFêåø—æR`N¸¸öFŠaTÅyËSÞI£÷r,tMeqí½XÏ´¸™¸£ór¼bšêâÚ)L\þ­z=‹¶›Áˆw?Ó6Èkk¤ÐÒ_(í©•çcÈ[Ì,ï äé Œ™œ½O‚p‰Kc®^|l ´m2ý@y‹—’è‘o<âjû‰;,@‹ãU°¢»%ëâ,‰{çP$‡è¤•¸ÃÞQtµ ÷B…[#…–ÜØ@ÑÝÏžÒåyK'Eá$á H+q§½£ðjo‡×ÖH¡ų¤1â6ŒEyÞÒÉÔ]QªûÊ âS‰;í‰öyÁÕÂ4Åü)×ÛÜÀõ…'ˆO%î´w$§o ®¦Þ‰ð';âVÄAœ706û4l¤•¸ÓÞ‘†š‹³¢«»î¯ á½K\i%î´w”Š«@®Ä-I¦Þ ´wÚ;Ê‚ ¹÷ö¡Ú ° MZ‰;íÅš¹·»ê¦[Cý–ã)î”l–~RÖgsäõ$©Î’7GÖ ;ÑåP!+ÿGŠ¬:Cq£S”Ug(nt¦ä/¡¸Q‘Vgèåyu6˜¶?"7Çû“¾×#çà3ÖÌ“ÎdV‘Wgk毒ÎcV©Y0½kþ,é¼ ¬ÐTÈ®¸î§gË~ëª oóÄCCþêü‹ëzÛ·à;7™G몞Pé×Õ[>…jäþѺ«!Vð7 ÁI!¡p5Äü .ŠçˆX@ÁEqÃá (¸(n(JŽÁÅ ‚‹^Ž¡˜:´ *¸ŽzÛÄiû,/Ù>\WÐÏ1‡œ·O¡»‡ÞmA8æ“«Üïš»[Ig=ý8Blª}©xmHUèl öKŠ¯øbHP£hïûn~¨ô5sg#é|g‚Šíu_Å‚{C‚"öÉúwÞWøÂD^Ui·ú»EŸ'g}h¸]J:ÏYÁ>ܸ~7øüµîîvÒyÎ ¶áÆbw#ðônC`nœ v¬¸gþ2é g Ûp£x±TŶnÃP 7Nù/•ÛX•…bê½þ®Ïr<ŒBw·•tv³Å äVÜq½˜Ð Bîò¾ï‰¸^Lh!·ä?ÖxÃD¯ò° B®|YD×4‚~È0[>§ÝÛ;¼â¦ÝÛñíùv° 6ƒëÓó¥]‡ …k!.ú ~Ôv8îX;ò–ÛaéåÊ;ímWz9*Ñ|&í@”ÛÞ./z9*Ñ ¹ÒDI4œ€ñ”è=>»#yæ+ÔÅU£³Í6²uÕ©¶ñË‘[q­+yQk‹â*Q±zeí%ÑÑBW2Äxô^ŽaÛ'ixéÄš$&n‡º²!Æ£÷r Û>IÃëRÖ RÂI£©¶ x9† i—¿“ZµÃ¤1ap«Gèå˜Aq-s7¼~b´ðëÀ[=B/Ç Šk ” ÆÃJ]¿G:Gïå˜Aq¹ €`<Ì_Û¼•ÅÕR#.(÷Ž‡•ºþŽÞËQÐ>1¸ëˆK×Ôˆ[d-0ï;’~™øVÆËQÐ>Ñ…'¦F\>éÙ³Èo9HÛ¼>Ž·gŒEÞY,/@è¡5b˜4÷íVp 4¨m^ŽG 3`ßØ„Í؃Ph¹Iƒ¸ì=÷°Â„Â’ÔGo7Øå¿Ñîã%÷!¢C„nhªÆ R".ëB¸ª³¢ÊrßáÅÕG#®ÝÇÄ“̧_e—9@¥C\Ö…(8],Šm•©vnqm>ŽZÏ Ô©«®YÍ•U¼>Ž=q_§"j¯¤F\ö6µkšMGiM9—¸vG‰_£®ë—ÙŽðj^ŽGKÜ“ÌJgZc&5â².„³:ëxžEúÝ*àñq!§«¬âž†è¦U ¸áÁŽF£"øYjŸw^M±)¦Ü>IVÜÊ/Y¹:µ¢¶ƒ[ø8Ò° =Xg7Ý°ZŸSq'ø¡ÿ/<Þr^M©¡L²âÞgþj—]GuveoKíËý[ø8BÉmñŠ»Åzº¬>gâ²8BO-^œu]m4Ý_‹¤Å5wº{¯Ù«³Ês?ÜâÚ}AÜ^ÅÍÅeõ9„^±Ó#D$®ÚoT$qqÃAÊ õ¹v®°`÷qì‰Ë*n…VŸkÅæeØ9GDaAñ7*’ q`¿÷@ÿZá­º}{Ⲋ[c«Ï¡);Ó:=â­ÐBüF%’÷Žåpߢû›{„¼fAjÏ­íã(¼ÚçØIVÜÛV·è.,xf.­…š7~ôÖÃúA%+î¦%î.+Ä»!ÞwøÎÿvM9ÔÉߣõeKÜ%R„Ío¿öÍ{´µÿ»ÿTCüM ù2×ö§„¬Ã¶%>kÍ>ŠSzá¤þEœqD‡i C7Ý~«ÁCÅì?¥xó“þ69ò(îíF´™b* ýA*¦%îßðÕïþk;9ò(î2*áExGpJÐ`ð ªñÇ_tÈ^Ž¾´w7Í{ š¢O |Â쟻elÚþõððç%—zIéÛæ¿~êû°ýðû¿'8áoº¼—ñÁÆQÿÝGN=üß[ÖNw•O˘¶þqÆ©‡ÿŠLÜ™ÕQpÕw?ieF@úÄýú®a³Ì’>qçiÛ–¶ÀÞKZ™Jq )¾p´2#@I\þ̳G(qkb ›®sš.qó%®}€š¸oï‹Åý’A·ÓÆ™¦1·Úx®'nÍ.¥a<×ä 7ƒ¸¼âNÜóE.nãÙÆs/Í=õDóÅéÕ…'„âÖž¬'q]ˆQm’â¹[ÆŠÖÐÙD€s0û¡Ö÷»]S&îÌê—jÍ3 WýŹêê¬q‰–å¦Q›1ViY®t·ö"·n\‚V-$Òsàósy×>šc‹'a%fíŸpšè°¦#·ÈfIÄ­®Ré.Qq_œþRmfuöb­ùìEZ8giZ~Z%°Ûà»þŸXäÈŸ¸÷õÞe.û´¸ Ý‹ˆ½£¸þÜ×™‡½±%>«àôë`×ë=´ZSE7T¿W†éºâNtñ7Fâåd§õ15hÇÂôgÕ·~ß´^89B/G`&3­ž¸‡lþóAgo;Ä—ÞËP}·,ù03ek‚µMU göÐË1[âNö^C¡wa½‚K½—c¶ÄåïBX-­¢æÊ$7~/Ç Š»³¹?H öjsgÿ½UÄÕS#î)s§m.9,ŸÜ1½â¡—ã@\{åÔøå¤OÜòÇ­7>r¹»º¿ %îz9ĵ7QšŸ{Ý&dzÄ%|Ž)‡/qAñë£÷rªÖÏ#¤ &€ÎXÅ8âNìzµ+jÖGïåpqívŽ,x÷'€2cÇ‘çnX`Ñ£åGÒ›ð{°#;ŠÝ à—ÆÜóÄ>ô!+0¤C\X®Ëmû¼¦RvCe_¼Z(qívŽUf¨ÓŸš*q™eywË™¸¦PvÙ÷­Ä}Œ‰š—#àªÐ`ÿs¯é¶  ©—-‘øÆ¡+UA]Aö}+q#G¢æåØšb–ã¸1»b›š*qÙzÊÏžwÍ„œÙ/7H@%îcäHÂ6ÅÄMÍu½À¬2½~ðê:²}á P‰û9’°1)—™¼ V2Rמý±Ù§aã[‰û9’ÑuE¹K¾Â‰»J£ü“ÿd¸¾•¸‘c12&.7Ö¾#X=æ_uaÁ·÷1r !FÖÄ]^"’õ'}ÕTh¾•¸‘c1²&. ºî^çÊÞJ¸ìO·¼iQ ¯âžbA·ò#ѱ+ò¥ëî”31f³æöÄD/³~C’™·Gë,è’õ JÕÅI!Jð ;!YRùI{ÅUÂZËÏþ,ÍŽ¤ì¢¸jð +]Æþ†°ì¢¸jð KÚ’ãïŠÆwÑËQ teKVP÷ß=i8m_‚$‹­ßU|&ŒxèòÍ¥gTPÝaá+¨ŠV¶À²;,½™ Ëûòs*毕®…¸([A·â7S¬Ð 1³ïã¥öÎVÒÍ"wöùvÒw!剶òšSȀɞӾxl¬Uw)é¬fbïÙúúûþçu伈 ¶ü/±±–ÿ‰W5ÄŸû­ÍÀ3ÿÉTXTz5Ya'èÔ5SýÅ „ñIo§³tj¥»»tv³…ÕèHpJ]l4„b0w¿}xrñžùˤ3œ%Êý;ù#…Ó¯˜?K:ÇY¢½ÝÛë.)œN«µm…ÓÆû½=ù ;¥6ö'”©ô%-ú÷û§ÝÃРÌ`¤|]©èòuóãí¤s–Wz{E™#‹›Bw/ÌRÁÇÛ‹”wÞWü ØVaÐ#æ¶ê·Þ6w6’Îyhoõwo«] ŠØÞF+ù<º&tü˨f†$­@ŒTlÏx6?ô;Óå‘ôìˆ §“V Nºƒ]ÿ¢«:y>$Cg‡þÈ (º(nx쮾EÅ OÑ>ɯ袸CÐYìû]¡¸ºøÜ@Ç2q£ÍV­%­ª3_èáSt½IlƒÅf2Ó?³Ð”.Xònš×#)‚£‚¸óQn*-âÚ;i´›v×?¿#²qsqûÓ€ ©£®Ç#)Šã€œ‹[p<ú½#×õx$E±qsqI·eû }$áñHºÁÆq€õùïÜ¿.”¸žÖHzĽ½oÿ´.™QêñHŠbã8€‰[î˜qí­“·h×¹–Žö £êÍl¨8ä,J{<’¢Ø8:Å]ëš2qí­“™¼Ú—Ø6lO/Ö½™MŽ¸À,‹¥âŽÈÆq@ð5¢Ýé^“iú‚pŸ'ÃР4Æþ9Á Š‰Kÿ '™Mθ ™~W÷w¯íN÷šL“Æ#+Üç âA­Ìš#4±è”ÑP4vi>Î̃3.ŠpÒc\âJ<»\%»ùSùÉîóªN?ÀbîyÂôâ3P‰–­83;]çGïâ¡ÃåWW8'@\»ùm pŸ'PµÔ˜·Äe : TÜ‚±1lfcÃå Pß8ò ‹@Ó®´iK lígBz¶z_TX~ÑÚ·ª2O£©Î—ˆ¬Ðèþmù<ÑVùì)¶¡ahÉm@Xxõ©‡R'nÅÕsXþÈ_ÜÁòå´7öû¯Ï÷l&.¹Öš*xÅåKDû6Å,ó§ºñîót‚Öd cñ¯ÐÀ ŠþíÎB…ö8m ¦MÜÁ4hNIÐ îå÷T.úµÎ`aŠ%wlÔù@ƒ^^ G.niá‰Åñû¡ûÀ*zÂZ¤s[qýšbC¶NR%®ýað=osŒç·øÌì w‹†?ètÑ’{röŒ5ˆFbl A{'а°2öàiòØUÞñ=¥ó3 ¹:ûü@\ŸNĤJÜI÷`X÷@œß…ÇZÄ&.¹ä¦ïçƒTU>Ðõ;KÐÈõymû&¹yž‰Ëêõqþ4ýÚÂü@ܨÝßt‹KÜï®{›cqûaÒØ0slì 4PqY‚FhØ â~áUà==@<âzÈ“¸'¡Žû™„=, *4ªÂËÿ¬óAª 5Ð@Ã$@É¥û§‹Õz FxEÿ2LUp†…œ‹[q×Ü‹yÙ+4ÖƒŠ\gŽK|aZ×­Z¡AÄ\ÚT»0vùä<4ÅXE\šˆ<‰ë_ lºävæ÷ÄC#ú½ÇB\×øŒŽE~¥âF2‚J™¸ž¸à¸ùx´ÞÃkÓ´ìhŸá¤x–6 eÇ°9Š‚·S¶nOBq£ °oëØpPÜ(xã)™+ý}Uÿå,$}ÛGCIðb}6ªiúÇhÚ¾û|Ç~zâ†)Áë<[`@"PÙ:®¹ !jM¶;? {DDE¤ãD÷ÃÐBŠ+ÒY¥HM]Ê;ÎXˆñ41l„ö’(µÔUY· @buSñ_ƒQ¢h¶„éoºŸ¨!CpûPœ¾Œ•Zt$U)¶±/Ί8½ÔÅ&Cd¤îmó·Iç-óȪ4h2(,uø"«ÒÀÊÕˆ—n Å¢â³(Ǫ¿E9*¸œLDü IK]4Ë„ï¢=t׎@Ùÿ±Ù=óã¤s˜eåXë¢ÿóð-ÊQî˜ÿÛ—ÂN¯y.é;K¾K¤_7Á†§× ÃdàXùž¹³znÞ1™u€ÂÊk]ÅŠ)•ÑÛ¿@q‡Bmew8Öï*œ$Wæ݈â2”V6ðÚ;‚ˆ Vö/ ¸•• ¼öŽðÊ*ˆkM·Å唥O$xìYÊ[³[ÌúJkèÆb]·ìÙ©(®ÅfðäF½#³ `6Žðã©é5ݲsd§¢¸¥àYÏ{G&.s„ÛDt^·ìÙ©(nåà3<öŽ,¥/.!ú–tËΑŠâö(]½#«Ðúay]è–#?5é{JQ×cïÈöûײsd§¢¸}£®²½£nmQÜËEW¹û«[[w@ioÛ÷8Ž-Dá¶ÿÚ‰(n&ü_äAq#qǷ袸‘(ú>’@q£1å·Ä=Š‘ö¾ü˜ñhHð鯓ŠÏ†ÓaÅ}$é»I|¯:>Jø^uŒ¼ƒ/IÅGÑkTŒŒŒItb‰‘ÎO¢_‘P—Öcd}7ú5¢_‘€!Nл-N°Å#%s?é,ä˜É½¤³cnìl'…ÓÙi%…ü2ÑƾD|”ºh·T7F ]|c=> h#h'å6º-ÄÈ=î¶Þn øºÉB®g …6Þ!–BÂÉb*€UŠ¥vx/ W™·QÜAqcÄk·`ºí¸f‹®¯ ¸ªxítÇq\Ó]_AqUñÚ-ètÓÐçŒÒÂ2g0q*ݳ DP\u¼v 4,hÈìÖ؃§éOVÀmî­Üâ_AqUñÚ-èt³M¦?nÂOr}ž¹-3‹ü+(®*^»mt&.ýIŠÌm¦~m–ÅUÅk· [âBXq¯3·úy£É¿‚âªâµ[€˜ âB…¦CSl ÜtzŽÕ&FqUQ¶[€âª‚=´AqcÅ7FPÜAqcÅ‘Ðv h¸ Nh»4\@A°ü?XŒ7ÖhÍIö%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_d.html0000644000175000017500000003635214030601037024053 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- d -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_w.html0000644000175000017500000000362214030601037025103 0ustar rusconirusconi Data Fields - Functions
 

- w -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayoutInset__inherit__graph.png0000644000175000017500000000234714030601041030423 0ustar rusconirusconi‰PNG  IHDR‹û¨z gAMA† 1è–_-PLTEÿÿÿÿÿÿ222iiiQQS™™™………èèè°°´ÓÓÖP+nn‚f¨;tRNSªvå’bKGDˆH pHYsHHFÉk>ÔIDATxÚíÚÁNAp^ah—P ÆHjêÍŠ%O¥Ý¤Üœí~e•xh¤ yÚ%ÃM<4ÞôÔ/&|M\Àwpf·Ô–ÎÎÌv7 æûšÀ´»ûËÌ7ÛÐþÃÉ¢ææ1`V×WUÂ@b¥R–0nâ¥ä/JˆeÂ,@‹Úl‹kfeì#¿šwß–­B' ã’<µªâä³ðhPrö±²MZ@À%ô-ò öuÌY¦Ö€_?œÍ"uÉ«Ük›4ù‹>qNÊY?¥ÆLÔ¨OžYü@^üäG €–ù»¨°îjÕËÂ¥ÄÚ:‹˜-Žï„.Â~îé{Á£E­})o8óÉwJšd¹ârfŠ—-®êBŠÇ“{\xHb*Ñ] íL˜øBæfH^2¦W©óݸ#} [Á7í)Ìbð= f%ø•ó.ø™ó;Ž3`΃à"=SýVé™;œù‘žYáŒv«ôÌWÎh·JÏð ‚Ajæ\0Ù0íÔ _–þdAdAdb]à÷Rÿ &yà7ÿ &ù—ÌÉÊ!# Þ¦Uàg‘nM1–„Q~ÖeÔ¥g¤ßxÁŸP€Y®l6¡ ª|†SŒ<ð{°*˜á¢Düçœ:§Ã•ÍFø >1a=çဪ5øq¦0bâ ”-&ã_”{B­~øjÿÑÑÀê+6œŒ~K¼Å¶Cç!ìMÿÑÑ`^Òâ$_¢»8>ðKĘ2×ÅÌø]ÿøis¿Qü‡¹_*s¿ØÂÜOôS3·ôã52È ƒ 2È ƒÌ¿Èäs¿ “kš†}®’)ë2éuh̨3@cF3ê 09#ÍgX”,LÞb"Ë“o8‘e€ÆŒA8Û]<•Þ¾÷22Æ8ëS2KƹߖŠ‘æ~±…¹_laî§aÚ©™ÛÿñdAdAæ晼"›Sý¿ßÆ$cþµNú%oÄxl¦B&)scE(ùÐbWaŸ?ÆŸ)˜ân§tàÔŸø½bÆaž_'Ù‚ñá¾Çì:¸ü‰à³&”Ä„mØP0.ëy~ƒ_?œÍ¡ç°UÿqE0b6ÍMÏß­±Gü3a¢ÞÁë°–ß°/>­nsx†‹b‚qêžÏ ™^Èpm6¹fÐâoqÄ´jÞ!ì‰E95®…L·ÞaküŒ†É†ó1Ÿy±é1`=Þb>êBȈSjPêªZÌX¥1¹Í½õLîb(eÂh ™kg²ùË°TŸ­¶&™”õŸ2™ÔÝ?T”‰f±´3%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemAnchor.html0000644000175000017500000004242614030601040025154 0ustar rusconirusconi QCPItemAnchor Class Reference
Public Functions | Protected Functions
QCPItemAnchor Class Reference

An anchor of an item to which positions can be attached to. More...

Inheritance diagram for QCPItemAnchor:
Inheritance graph

Public Functions

 QCPItemAnchor (QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId=-1)
 
QString name () const
 
virtual QPointF pixelPosition () const
 

Protected Functions

virtual QCPItemPosition * toQCPItemPosition ()
 
void addChildX (QCPItemPosition *pos)
 
void removeChildX (QCPItemPosition *pos)
 
void addChildY (QCPItemPosition *pos)
 
void removeChildY (QCPItemPosition *pos)
 

Detailed Description

An anchor of an item to which positions can be attached to.

An item (QCPAbstractItem) may have one or more anchors. Unlike QCPItemPosition, an anchor doesn't control anything on its item, but provides a way to tie other items via their positions to the anchor.

For example, a QCPItemRect is defined by its positions topLeft and bottomRight. Additionally it has various anchors like top, topRight or bottomLeft etc. So you can attach the start (which is a QCPItemPosition) of a QCPItemLine to one of the anchors by calling QCPItemPosition::setParentAnchor on start, passing the wanted anchor of the QCPItemRect. This way the start of the line will now always follow the respective anchor location on the rect item.

Note that QCPItemPosition derives from QCPItemAnchor, so every position can also serve as an anchor to other positions.

To learn how to provide anchors in your own item subclasses, see the subclassing section of the QCPAbstractItem documentation.

Constructor & Destructor Documentation

§ QCPItemAnchor()

QCPItemAnchor::QCPItemAnchor ( QCustomPlot *  parentPlot,
QCPAbstractItem *  parentItem,
const QString &  name,
int  anchorId = -1 
)

Creates a new QCPItemAnchor. You shouldn't create QCPItemAnchor instances directly, even if you want to make a new item subclass. Use QCPAbstractItem::createAnchor instead, as explained in the subclassing section of the QCPAbstractItem documentation.

Member Function Documentation

§ pixelPosition()

QPointF QCPItemAnchor::pixelPosition ( ) const
virtual

Returns the final absolute pixel position of the QCPItemAnchor on the QCustomPlot surface.

The pixel information is internally retrieved via QCPAbstractItem::anchorPixelPosition of the parent item, QCPItemAnchor is just an intermediary.

Reimplemented in QCPItemPosition.

§ toQCPItemPosition()

QCPItemPosition * QCPItemAnchor::toQCPItemPosition ( )
inlineprotectedvirtual

Returns nullptr if this instance is merely a QCPItemAnchor, and a valid pointer of type QCPItemPosition* if it actually is a QCPItemPosition (which is a subclass of QCPItemAnchor).

This safe downcast functionality could also be achieved with a dynamic_cast. However, QCustomPlot avoids dynamic_cast to work with projects that don't have RTTI support enabled (e.g. -fno-rtti flag with gcc compiler).

Reimplemented in QCPItemPosition.

§ addChildX()

void QCPItemAnchor::addChildX ( QCPItemPosition *  pos)
protected

Adds pos to the childX list of this anchor, which keeps track of which children use this anchor as parent anchor for the respective coordinate. This is necessary to notify the children prior to destruction of the anchor.

Note that this function does not change the parent setting in pos.

§ removeChildX()

void QCPItemAnchor::removeChildX ( QCPItemPosition *  pos)
protected

Removes pos from the childX list of this anchor.

Note that this function does not change the parent setting in pos.

§ addChildY()

void QCPItemAnchor::addChildY ( QCPItemPosition *  pos)
protected

Adds pos to the childY list of this anchor, which keeps track of which children use this anchor as parent anchor for the respective coordinate. This is necessary to notify the children prior to destruction of the anchor.

Note that this function does not change the parent setting in pos.

§ removeChildY()

void QCPItemAnchor::removeChildY ( QCPItemPosition *  pos)
protected

Removes pos from the childY list of this anchor.

Note that this function does not change the parent setting in pos.

The documentation for this class was generated from the following files:
  • src/item.h
  • src/item.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerDateTime__inherit__graph.png0000644000175000017500000000175114030601041031624 0ustar rusconirusconi‰PNG  IHDR¥käç_-gAMA† 1è–_0PLTEÿÿÿÿÿÿ°°´iiiLLL˜˜˜………èèêÏÏÑ222+PnnEE|ñGƒtRNSªvå’bKGDˆH pHYsHHFÉk>ÓIDAThÞíÚAKÜ@`/½;ÝM©[´ˆ·ÞVwEz겉D<¥ÉKGs*5°=úJ22°'‹+¼HñØ@úzh‰ï^z÷GôͨÁªé&éH­Ì[ØìäM>æåMXXv‚(É mÞ©9·P=zcL«:Ùm3«×ÚÐæ_šF-Ó‚i‚O6Ÿz9ŽS×lÒ=X+sÄÙuîÖ2~ës¦œÑ£íé¸ô·sZ]Çhy­îâC%ó€’uaî:ýFod¯„~lK³ñ…‡½Æ{‹¸µL¼Ÿf»I:²hs†G 9¡Ní¤°> ³y¶sÓšÅwâÔìyÒ&‹#kŸßsòÚ›¯/?U4Ix±—ù@Ø"ygÈS²Gà`Ã^t½ª&y¶FÊÆý}6µùðL¨ã̳ –‹2æì³0¦³²3Ë›ûÙ¦ró,;QnžfßT›SYöCµ9“eǪÍé,˶›ûhþTlž¡y¢Ø Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- m -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPColorScale.html0000644000175000017500000024752314030601040025156 0ustar rusconirusconi QCPColorScale Class Reference
Public Functions | Signals | Protected Functions
QCPColorScale Class Reference

A color scale for use with color coding data such as QCPColorMap. More...

Inheritance diagram for QCPColorScale:
Inheritance graph

Public Functions

 QCPColorScale (QCustomPlot *parentPlot)
 
QCPAxis * axis () const
 
QCPAxis::AxisType type () const
 
QCPRange dataRange () const
 
QCPAxis::ScaleType dataScaleType () const
 
QCPColorGradient gradient () const
 
QString label () const
 
int barWidth () const
 
bool rangeDrag () const
 
bool rangeZoom () const
 
void setType (QCPAxis::AxisType type)
 
Q_SLOT void setDataRange (const QCPRange &dataRange)
 
Q_SLOT void setDataScaleType (QCPAxis::ScaleType scaleType)
 
Q_SLOT void setGradient (const QCPColorGradient &gradient)
 
void setLabel (const QString &str)
 
void setBarWidth (int width)
 
void setRangeDrag (bool enabled)
 
void setRangeZoom (bool enabled)
 
QList< QCPColorMap * > colorMaps () const
 
void rescaleDataRange (bool onlyVisibleMaps)
 
virtual void update (UpdatePhase phase)
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void dataRangeChanged (const QCPRange &newRange)
 
void dataScaleTypeChanged (QCPAxis::ScaleType scaleType)
 
void gradientChanged (const QCPColorGradient &newGradient)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void wheelEvent (QWheelEvent *event)
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void draw (QCPPainter *painter)
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Detailed Description

A color scale for use with color coding data such as QCPColorMap.

This layout element can be placed on the plot to correlate a color gradient with data values. It is usually used in combination with one or multiple QCPColorMaps.

QCPColorScale.png

The color scale can be either horizontal or vertical, as shown in the image above. The orientation and the side where the numbers appear is controlled with setType.

Use QCPColorMap::setColorScale to connect a color map with a color scale. Once they are connected, they share their gradient, data range and data scale type (setGradient, setDataRange, setDataScaleType). Multiple color maps may be associated with a single color scale, to make them all synchronize these properties.

To have finer control over the number display and axis behaviour, you can directly access the axis. See the documentation of QCPAxis for details about configuring axes. For example, if you want to change the number of automatically generated ticks, call

colorScale->axis()->ticker()->setTickCount(3);

Placing a color scale next to the main axis rect works like with any other layout element:

QCPColorScale *colorScale = new QCPColorScale(customPlot);
customPlot->plotLayout()->addElement(0, 1, colorScale);
colorScale->setLabel("Some Label Text");

In this case we have placed it to the right of the default axis rect, so it wasn't necessary to call setType, since QCPAxis::atRight is already the default. The text next to the color scale can be set with setLabel.

For optimum appearance (like in the image above), it may be desirable to line up the axis rect and the borders of the color scale. Use a QCPMarginGroup to achieve this:

QCPMarginGroup *group = new QCPMarginGroup(customPlot);
colorScale->setMarginGroup(QCP::msTop|QCP::msBottom, group);
customPlot->axisRect()->setMarginGroup(QCP::msTop|QCP::msBottom, group);

Color scales are initialized with a non-zero minimum top and bottom margin (setMinimumMargins), because vertical color scales are most common and the minimum top/bottom margin makes sure it keeps some distance to the top/bottom widget border. So if you change to a horizontal color scale by setting setType to QCPAxis::atBottom or QCPAxis::atTop, you might want to also change the minimum margins accordingly, e.g. setMinimumMargins(QMargins(6, 0, 6, 0)).

Constructor & Destructor Documentation

§ QCPColorScale()

QCPColorScale::QCPColorScale ( QCustomPlot *  parentPlot)
explicit

Constructs a new QCPColorScale.

Member Function Documentation

§ axis()

QCPAxis * QCPColorScale::axis ( ) const
inline

Returns the internal QCPAxis instance of this color scale. You can access it to alter the appearance and behaviour of the axis. QCPColorScale duplicates some properties in its interface for convenience. Those are setDataRange (QCPAxis::setRange), setDataScaleType (QCPAxis::setScaleType), and the method setLabel (QCPAxis::setLabel). As they each are connected, it does not matter whether you use the method on the QCPColorScale or on its QCPAxis.

If the type of the color scale is changed with setType, the axis returned by this method will change, too, to either the left, right, bottom or top axis, depending on which type was set.

§ setType()

void QCPColorScale::setType ( QCPAxis::AxisType  type)

Sets at which side of the color scale the axis is placed, and thus also its orientation.

Note that after setting type to a different value, the axis returned by axis() will be a different one. The new axis will adopt the following properties from the previous axis: The range, scale type, label and ticker (the latter will be shared and not copied).

§ setDataRange()

void QCPColorScale::setDataRange ( const QCPRange &  dataRange)

Sets the range spanned by the color gradient and that is shown by the axis in the color scale.

It is equivalent to calling QCPColorMap::setDataRange on any of the connected color maps. It is also equivalent to directly accessing the axis and setting its range with QCPAxis::setRange.

See also
setDataScaleType, setGradient, rescaleDataRange

§ setDataScaleType()

void QCPColorScale::setDataScaleType ( QCPAxis::ScaleType  scaleType)

Sets the scale type of the color scale, i.e. whether values are associated with colors linearly or logarithmically.

It is equivalent to calling QCPColorMap::setDataScaleType on any of the connected color maps. It is also equivalent to directly accessing the axis and setting its scale type with QCPAxis::setScaleType.

Note that this method controls the coordinate transformation. For logarithmic scales, you will likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting the color scale's axis ticker to an instance of QCPAxisTickerLog :

colorScale->setDataScaleType(QCPAxis::stLogarithmic);
colorScale->axis()->setTicker(QSharedPointer<QCPAxisTickerLog>(new QCPAxisTickerLog));

See the documentation of QCPAxisTickerLog about the details of logarithmic axis tick creation.

See also
setDataRange, setGradient

§ setGradient()

void QCPColorScale::setGradient ( const QCPColorGradient &  gradient)

Sets the color gradient that will be used to represent data values.

It is equivalent to calling QCPColorMap::setGradient on any of the connected color maps.

See also
setDataRange, setDataScaleType

§ setLabel()

void QCPColorScale::setLabel ( const QString &  str)

Sets the axis label of the color scale. This is equivalent to calling QCPAxis::setLabel on the internal axis.

§ setBarWidth()

void QCPColorScale::setBarWidth ( int  width)

Sets the width (or height, for horizontal color scales) the bar where the gradient is displayed will have.

§ setRangeDrag()

void QCPColorScale::setRangeDrag ( bool  enabled)

Sets whether the user can drag the data range (setDataRange).

Note that QCP::iRangeDrag must be in the QCustomPlot's interactions (QCustomPlot::setInteractions) to allow range dragging.

§ setRangeZoom()

void QCPColorScale::setRangeZoom ( bool  enabled)

Sets whether the user can zoom the data range (setDataRange) by scrolling the mouse wheel.

Note that QCP::iRangeZoom must be in the QCustomPlot's interactions (QCustomPlot::setInteractions) to allow range dragging.

§ colorMaps()

QList< QCPColorMap * > QCPColorScale::colorMaps ( ) const

Returns a list of all the color maps associated with this color scale.

§ rescaleDataRange()

void QCPColorScale::rescaleDataRange ( bool  onlyVisibleMaps)

Changes the data range such that all color maps associated with this color scale are fully mapped to the gradient in the data dimension.

See also
setDataRange

§ update()

void QCPColorScale::update ( UpdatePhase  phase)
virtual

Updates the layout element and sub-elements. This function is automatically called before every replot by the parent layout element. It is called multiple times, once for every UpdatePhase. The phases are run through in the order of the enum values. For details about what happens at the different phases, see the documentation of UpdatePhase.

Layout elements that have child elements should call the update method of their child elements, and pass the current phase unchanged.

The default implementation executes the automatic margin mechanism in the upMargins phase. Subclasses should make sure to call the base class implementation.

Reimplemented from QCPLayoutElement.

§ dataRangeChanged

void QCPColorScale::dataRangeChanged ( const QCPRange &  newRange)
signal

This signal is emitted when the data range changes.

See also
setDataRange

§ dataScaleTypeChanged

void QCPColorScale::dataScaleTypeChanged ( QCPAxis::ScaleType  scaleType)
signal

This signal is emitted when the data scale type changes.

See also
setDataScaleType

§ gradientChanged

void QCPColorScale::gradientChanged ( const QCPColorGradient &  newGradient)
signal

This signal is emitted when the gradient changes.

See also
setGradient

§ applyDefaultAntialiasingHint()

void QCPColorScale::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Reimplemented from QCPLayoutElement.

§ mousePressEvent()

void QCPColorScale::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

This event gets called when the user presses a mouse button while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to selectTest.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter details contains layerable-specific details about the hit, which were generated in the previous call to selectTest. For example, One-dimensional plottables like QCPGraph or QCPBars convey the clicked data point in the details parameter, as QCPDataSelection packed as QVariant. Multi-part objects convey the specific SelectablePart that was hit (e.g. QCPAxis::SelectablePart in the case of axes).

QCustomPlot uses an event propagation system that works the same as Qt's system. If your layerable doesn't reimplement the mousePressEvent or explicitly calls event->ignore() in its reimplementation, the event will be propagated to the next layerable in the stacking order.

Once a layerable has accepted the mousePressEvent, it is considered the mouse grabber and will receive all following calls to mouseMoveEvent or mouseReleaseEvent for this mouse interaction (a "mouse interaction" in this context ends with the release).

The default implementation does nothing except explicitly ignoring the event with event->ignore().

See also
mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented from QCPLayerable.

§ mouseMoveEvent()

void QCPColorScale::mouseMoveEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This event gets called when the user moves the mouse while holding a mouse button, after this layerable has become the mouse grabber by accepting the preceding mousePressEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter startPos indicates the position where the initial mousePressEvent occurred, that started the mouse interaction.

The default implementation does nothing.

See also
mousePressEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented from QCPLayerable.

§ mouseReleaseEvent()

void QCPColorScale::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This event gets called when the user releases the mouse button, after this layerable has become the mouse grabber by accepting the preceding mousePressEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter startPos indicates the position where the initial mousePressEvent occurred, that started the mouse interaction.

The default implementation does nothing.

See also
mousePressEvent, mouseMoveEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented from QCPLayerable.

§ wheelEvent()

void QCPColorScale::wheelEvent ( QWheelEvent *  event)
protectedvirtual

This event gets called when the user turns the mouse scroll wheel while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a preceding call to selectTest.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos().

The event->angleDelta() indicates how far the mouse wheel was turned, which is usually +/- 120 for single rotation steps. However, if the mouse wheel is turned rapidly, multiple steps may accumulate to one event, making the delta larger. On the other hand, if the wheel has very smooth steps or none at all, the delta may be smaller.

The default implementation does nothing.

See also
mousePressEvent, mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent

Reimplemented from QCPLayerable.

The documentation for this class was generated from the following files:
  • src/layoutelements/layoutelement-colorscale.h
  • src/layoutelements/layoutelement-colorscale.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-fixed.png0000644000175000017500000000145214030601041024607 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨d\IDATxÚíÚ½qÛ@†á×,„‘Ó÷ -8R§*@)‡ 0b§îÃÔÇ…`¢èg$RßZÒûDXìánq¼;$I’$I’$I’$I’$I’^`2ªQjÔ·Žº*ypIz –¤w㱂5½ð÷ËÜŨF5ªQŸøÝ–¤wãËÉuÍBœ$=Ç©•$I’$I’$I’¤³tLtÁx‘‰‘öÁóØ0äZ 1ÑG#ŽLLL áL{ÆpÔ~Ét ÷ãn¯é±óh3Œá‡é ãÏZ<׶”Œ>ÜÂÃòvs*Êòܶqaþ(äbßEë zÓƒ:ˆävL<Ùìù<Î95}œ¸c`ø«®\Á&:¯»ëEèM—9?ú3˜<Àúxu8¹~{é¼èÞh´ð¢{[ÞhzÏy~¯]ü£›ÞÒ˜‹s#½7ùŒì@®:‡•/X5'gºe¶S³“•.Xã2§ËæÚJÎ&Õ~éMuÿ$I’$I’$I’$I’$I’$I’$I’$I’$I’$I’$I’$éøKä\š ¤%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorMap-tightboundary.png0000644000175000017500000000444614030601040026312 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_½PLTEÿÿÿýÝt NÀøÿýÙP  dÓòÍ^3 ùýõüçŽ,üõÇ“““´óÿáŸS“Îæþï©*Qµïôýïˆ"jÓ÷þã'”éþ+—êóÙ¥ Xm 03 InÇ¡ÓrT¯mÕü PðZ-G[.n¸rw4¬•©]ÊúüÓf¡yÿ[ý ò¼Wÿÿïÿw¡ÿÿ[ÿÿíÖþÕb¤bKGDˆH pHYsÃÃÇo¨dIDATxÚí WÛ6…4 1&q „4@‹Wšð‘–B)[ÿÿÏšäØqÚ »ðZ»±tïÑ95¶düp_]pQPEQ%S«ýæ?[Õêt{è GîôÃÝèŧ³¡½A¨µ;ŒG?FûÁX<œ¼PÞÙ!<š¾E?œ§(:><‰6vdW4îž*ÀÓà]÷ýìÅ€zðÖÈ aç¬÷ÓéR€«ë8NÂÃn¯Õþ- ?œ…áùGÌÕáý~¸¸ˆvÚ—êÒ¯VFÁ\uôŽ®“p9Qã?%ê#u¶åe0Ôƒ?«=ï³!úçù¥ná|x3|‚£Ì[ý‹£yØk%oG­Ao¯ŸÕèÙîlOÙONsÀDíô²î*Ž:*TZÉádv­Âeº«JZN÷dCöGׇ#´…5¦³0;Ð~3ÿ0êü>ÃQæ€úß±ªÑä4ýª§€úNq™öèLw×€ªÃô*ë®Ï ôÎ`§ýÇž.ëÌÂtO:D÷½ÅåÂM¿¬c&íuÞ´“$åT€^ŸŸäê=Ù¹~ XÀ’Ô¡¶°8Íû*†q”›5:ìþ Ü&“´FÏÒvsÀ¬F窆ç Ú¸IŸ´×Þ®†¤Ÿ' „ÚÂÍѼ=ÁQwŠÞÑq˜ŽÕ{U£ËKòêN¡™÷“Pß)TwþãnØê'飨œîɆ¨ÌÔÍma„ÊÂh¾>ðî ¸íOp”ëçµÕXvýG×áò£¾S,Õ%¯ž×¢ëdq>È£¬û \|Ê;ÓU!Fjðç´8WCô Â÷#´…5êYXPOº õƒ¥Ì4”ý¸EeQ$OB™:ñ(šËîÆûøïr½&Ôß«0yý ÆÑpRµMRYèK £}d´K?ôâ pžÑq<¯PÇóÑññÑñ õÑq<¯PÇóÑññ±ê§ø ¯P¯PÇóÑñ)a¼3éÞ¨¯&=õͤ¥Q “îêÂ+Ôð -a,|‹¥ÆB cZø*Fo,tA R™8 ѳ6ÞBÄ •‰³= iáö[˜*Žƒ†6ã©Ý›ÚWS{x¦}3µ¥©-Lí匕³^¡œ…´Ðw )žôiMî ÷O¤ð µo!ž‘ÒÂR¡CFî ƒ]¡ö-Ä3ÒBZXªÇµþ4ʘG_«  ýeT/wðÆG“0Œz¬ßÂXŠ ñ¬Í ÏH ia©Ð!#wÐù ­zY^¡5Xhdôfâñj°Ð¸× ¤Û¤ÇñjßB<#-¤…¥B‡ŒÜA)ºBí[ˆg¤…´°Tè‘;È EW¨} ñŒ´– 2r¤è µo!ž‘znaÕè‘;Xù› ׃ôi­¿22o¼w›ÿ˜dd~ø²–µYX€á‹Í'ZH ËH_‡w/Ä“;Xiášñ g¡ÐB<#-¤…¥B‡ŒÜA)ºBí[ˆg¤…´°Tè‘;È EW¨} ñŒ´– 2r¤è µo!žQfaÕÿ©€ãÕ`¡‘Ñ «: CFî ƒ]¡ö-Ä3ÒBZX*tÈÈô>H+˜ŸŒï/l¼ŸW¼ªðݨôÿ]§ÄXl:‰G …xz^Õ CUxr·Ÿñ³°ñŒ´°ñŒ Ò¦32H›ÏH ÏÈ m:£0H+9ˆ7¶ŸLíÑÔîžiÆÕ¾›ÚzÍ€ØÚ"[Ÿ޶°È´B¤ RûÂùDÚ|FZØxFiÓ¤Íg¤…gd6Ñr |w¦™ïÎàñh¡ÐB¾þÔüןàjßB<#_È£;Vu@‡ŒÜA)ºBí[ˆg¤…´°Tè‘;È EW¨} ñŒ´– 2r¤è µo!ž‘ÒÂR¡CFî ƒ]¡ö-Ä3ÒBZX*tÈÈt>Hù› ×g!~Ž,4î-ÀðŒ\³Ihá#š‘k6I-Ä3ÒBZX*tÈÈd¢+Ô¾…xFZH K…¹ƒ Rt…Ú·ÏH ia©Ð!#wAŠ®Pûâi¡çr9f)g!zÒB×-t"H+À¤œ…Û= 7þ‡ùe‘ªZÜøƒƲ[µXËš…ž±Ø¼«ßÂ@Š÷ Ä“;XiášqaÕB|…Ú·ÏH ia©Ð!#wAŠ®Pûâi!-,:dä2HÑjßB<£ÌÂ,iö9X/Kolß›šqÝ‚‡gÚ7S[šÚ"oñÆvý‹¸ ߃Túõ“ž€Aú:¼¿‚´m¡ bÊÄYˆž…´°ñº ©Lœ…èYH o¡ rœÑßYè £ãx>0V¾ï€gt¼B}`tÏF§#ÆFÇ+ÔFÇñ|`t Namespace Members
 
  • getMarginValue() : QCP
  • isInvalidData() : QCP
  • setMarginValue() : QCP
qcustomplot-2.1.0+dfsg1/documentation/html/dir_17cee08e17148530a7aedf85f92ee362.html0000644000175000017500000000246114030601036026760 0ustar rusconirusconi src/items Directory Reference
items Directory Reference
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayoutInset.html0000644000175000017500000021713414030601040025403 0ustar rusconirusconi QCPLayoutInset Class Reference
Public Types | Public Functions
QCPLayoutInset Class Reference

A layout that places child elements aligned to the border or arbitrarily positioned. More...

Inheritance diagram for QCPLayoutInset:
Inheritance graph

Public Types

enum  InsetPlacement
 
- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Public Functions

 QCPLayoutInset ()
 
InsetPlacement insetPlacement (int index) const
 
Qt::Alignment insetAlignment (int index) const
 
QRectF insetRect (int index) const
 
void setInsetPlacement (int index, InsetPlacement placement)
 
void setInsetAlignment (int index, Qt::Alignment alignment)
 
void setInsetRect (int index, const QRectF &rect)
 
virtual void updateLayout ()
 
virtual int elementCount () const
 
virtual QCPLayoutElement * elementAt (int index) const
 
virtual QCPLayoutElement * takeAt (int index)
 
virtual bool take (QCPLayoutElement *element)
 
virtual void simplify ()
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
void addElement (QCPLayoutElement *element, Qt::Alignment alignment)
 
void addElement (QCPLayoutElement *element, const QRectF &rect)
 
- Public Functions inherited from QCPLayout
 QCPLayout ()
 
virtual void update (UpdatePhase phase)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
bool removeAt (int index)
 
bool remove (QCPLayoutElement *element)
 
void clear ()
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Additional Inherited Members

- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 
- Protected Functions inherited from QCPLayout
void sizeConstraintsChanged () const
 
void adoptElement (QCPLayoutElement *el)
 
void releaseElement (QCPLayoutElement *el)
 
QVector< int > getSectionSizes (QVector< int > maxSizes, QVector< int > minSizes, QVector< double > stretchFactors, int totalSize) const
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 
- Protected Static Functions inherited from QCPLayout
static QSize getFinalMinimumOuterSize (const QCPLayoutElement *el)
 
static QSize getFinalMaximumOuterSize (const QCPLayoutElement *el)
 

Detailed Description

A layout that places child elements aligned to the border or arbitrarily positioned.

Elements are placed either aligned to the border or at arbitrary position in the area of the layout. Which placement applies is controlled with the InsetPlacement (setInsetPlacement).

Elements are added via addElement(QCPLayoutElement *element, Qt::Alignment alignment) or addElement(QCPLayoutElement *element, const QRectF &rect). If the first method is used, the inset placement will default to ipBorderAligned and the element will be aligned according to the alignment parameter. The second method defaults to ipFree and allows placing elements at arbitrary position and size, defined by rect.

The alignment or rect can be set via setInsetAlignment or setInsetRect, respectively.

This is the layout that every QCPAxisRect has as QCPAxisRect::insetLayout.

Member Enumeration Documentation

§ InsetPlacement

enum QCPLayoutInset::InsetPlacement

Defines how the placement and sizing is handled for a certain element in a QCPLayoutInset.

Enumerator
ipFree 

The element may be positioned/sized arbitrarily, see setInsetRect.

ipBorderAligned 

The element is aligned to one of the layout sides, see setInsetAlignment.

Constructor & Destructor Documentation

§ QCPLayoutInset()

QCPLayoutInset::QCPLayoutInset ( )
explicit

Creates an instance of QCPLayoutInset and sets default values.

Member Function Documentation

§ insetPlacement()

QCPLayoutInset::InsetPlacement QCPLayoutInset::insetPlacement ( int  index) const

Returns the placement type of the element with the specified index.

§ insetAlignment()

Qt::Alignment QCPLayoutInset::insetAlignment ( int  index) const

Returns the alignment of the element with the specified index. The alignment only has a meaning, if the inset placement (setInsetPlacement) is ipBorderAligned.

§ insetRect()

QRectF QCPLayoutInset::insetRect ( int  index) const

Returns the rect of the element with the specified index. The rect only has a meaning, if the inset placement (setInsetPlacement) is ipFree.

§ setInsetPlacement()

void QCPLayoutInset::setInsetPlacement ( int  index,
QCPLayoutInset::InsetPlacement  placement 
)

Sets the inset placement type of the element with the specified index to placement.

See also
InsetPlacement

§ setInsetAlignment()

void QCPLayoutInset::setInsetAlignment ( int  index,
Qt::Alignment  alignment 
)

If the inset placement (setInsetPlacement) is ipBorderAligned, this function is used to set the alignment of the element with the specified index to alignment.

alignment is an or combination of the following alignment flags: Qt::AlignLeft, Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other alignment flags will be ignored.

§ setInsetRect()

void QCPLayoutInset::setInsetRect ( int  index,
const QRectF &  rect 
)

If the inset placement (setInsetPlacement) is ipFree, this function is used to set the position and size of the element with the specified index to rect.

rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right corner of the layout, with 35% width and height of the parent layout.

Note that the minimum and maximum sizes of the embedded element (QCPLayoutElement::setMinimumSize, QCPLayoutElement::setMaximumSize) are enforced.

§ updateLayout()

void QCPLayoutInset::updateLayout ( )
virtual

Subclasses reimplement this method to update the position and sizes of the child elements/cells via calling their QCPLayoutElement::setOuterRect. The default implementation does nothing.

The geometry used as a reference is the inner rect of this layout. Child elements should stay within that rect.

getSectionSizes may help with the reimplementation of this function.

See also
update

Reimplemented from QCPLayout.

§ elementCount()

int QCPLayoutInset::elementCount ( ) const
virtual

Returns the number of elements/cells in the layout.

See also
elements, elementAt

Implements QCPLayout.

§ elementAt()

QCPLayoutElement * QCPLayoutInset::elementAt ( int  index) const
virtual

Returns the element in the cell with the given index. If index is invalid, returns nullptr.

Note that even if index is valid, the respective cell may be empty in some layouts (e.g. QCPLayoutGrid), so this function may return nullptr in those cases. You may use this function to check whether a cell is empty or not.

See also
elements, elementCount, takeAt

Implements QCPLayout.

§ takeAt()

QCPLayoutElement * QCPLayoutInset::takeAt ( int  index)
virtual

Removes the element with the given index from the layout and returns it.

If the index is invalid or the cell with that index is empty, returns nullptr.

Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
elementAt, take

Implements QCPLayout.

§ take()

bool QCPLayoutInset::take ( QCPLayoutElement *  element)
virtual

Removes the specified element from the layout and returns true on success.

If the element isn't in this layout, returns false.

Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
takeAt

Implements QCPLayout.

§ simplify()

void QCPLayoutInset::simplify ( )
inlinevirtual

The QCPInsetLayout does not need simplification since it can never have empty cells due to its linear index structure. This method does nothing.

Reimplemented from QCPLayout.

§ selectTest()

double QCPLayoutInset::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

The inset layout is sensitive to events only at areas where its (visible) child elements are sensitive. If the selectTest method of any of the child elements returns a positive number for pos, this method returns a value corresponding to 0.99 times the parent plot's selection tolerance. The inset layout is not selectable itself by default. So if onlySelectable is true, -1.0 is returned.

See QCPLayerable::selectTest for a general explanation of this virtual method.

Reimplemented from QCPLayoutElement.

§ addElement() [1/2]

void QCPLayoutInset::addElement ( QCPLayoutElement *  element,
Qt::Alignment  alignment 
)

Adds the specified element to the layout as an inset aligned at the border (setInsetAlignment is initialized with ipBorderAligned). The alignment is set to alignment.

alignment is an or combination of the following alignment flags: Qt::AlignLeft, Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other alignment flags will be ignored.

See also
addElement(QCPLayoutElement *element, const QRectF &rect)

§ addElement() [2/2]

void QCPLayoutInset::addElement ( QCPLayoutElement *  element,
const QRectF &  rect 
)

Adds the specified element to the layout as an inset with free positioning/sizing (setInsetAlignment is initialized with ipFree). The position and size is set to rect.

rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right corner of the layout, with 35% width and height of the parent layout.

See also
addElement(QCPLayoutElement *element, Qt::Alignment alignment)
The documentation for this class was generated from the following files:
  • src/layout.h
  • src/layout.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractPlottable1D.html0000644000175000017500000022721514030601040026723 0ustar rusconirusconi QCPAbstractPlottable1D< DataType > Class Template Reference
Public Functions | Protected Functions
QCPAbstractPlottable1D< DataType > Class Template Reference

A template base class for plottables with one-dimensional data. More...

Inheritance diagram for QCPAbstractPlottable1D< DataType >:
Inheritance graph

Public Functions

 QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual QPointF dataPixelPosition (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const =0
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const =0
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual void draw (QCPPainter *painter)=0
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const =0
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

template<class DataType>
class QCPAbstractPlottable1D< DataType >

A template base class for plottables with one-dimensional data.

This template class derives from QCPAbstractPlottable and from the abstract interface QCPPlottableInterface1D. It serves as a base class for all one-dimensional data (i.e. data with one key dimension), such as QCPGraph and QCPCurve.

The template parameter DataType is the type of the data points of this plottable (e.g. QCPGraphData or QCPCurveData). The main purpose of this base class is to provide the member mDataContainer (a shared pointer to a QCPDataContainer<DataType>) and implement the according virtual methods of the QCPPlottableInterface1D, such that most subclassed plottables don't need to worry about this anymore.

Further, it provides a convenience method for retrieving selected/unselected data segments via getDataSegments. This is useful when subclasses implement their draw method and need to draw selected segments with a different pen/brush than unselected segments (also see QCPSelectionDecorator).

This class implements basic functionality of QCPAbstractPlottable::selectTest and QCPPlottableInterface1D::selectTestRect, assuming point-like data points, based on the 1D data interface. In spite of that, most plottable subclasses will want to reimplement those methods again, to provide a more accurate hit test based on their specific data visualization geometry.

Constructor & Destructor Documentation

§ QCPAbstractPlottable1D()

template<class DataType >
QCPAbstractPlottable1D< DataType >::QCPAbstractPlottable1D ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)

Forwards keyAxis and valueAxis to the QCPAbstractPlottable constructor and allocates the mDataContainer.

Member Function Documentation

§ dataCount()

template<class DataType >
int QCPAbstractPlottable1D< DataType >::dataCount ( ) const
virtual

Returns the number of data points of the plottable.

Implements QCPPlottableInterface1D.

§ dataMainKey()

template<class DataType >
double QCPAbstractPlottable1D< DataType >::dataMainKey ( int  index) const
virtual

Returns the main key of the data point at the given index.

What the main key is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataSortKey()

template<class DataType >
double QCPAbstractPlottable1D< DataType >::dataSortKey ( int  index) const
virtual

Returns the sort key of the data point at the given index.

What the sort key is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataMainValue()

template<class DataType >
double QCPAbstractPlottable1D< DataType >::dataMainValue ( int  index) const
virtual

Returns the main value of the data point at the given index.

What the main value is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataValueRange()

template<class DataType >
QCPRange QCPAbstractPlottable1D< DataType >::dataValueRange ( int  index) const
virtual

Returns the value range of the data point at the given index.

What the value range is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataPixelPosition()

template<class DataType >
QPointF QCPAbstractPlottable1D< DataType >::dataPixelPosition ( int  index) const
virtual

Returns the pixel position on the widget surface at which the data point at the given index appears.

Usually this corresponds to the point of dataMainKey/dataMainValue, in pixel coordinates. However, depending on the plottable, this might be a different apparent position than just a coord-to-pixel transform of those values. For example, QCPBars apparent data values can be shifted depending on their stacking, bar grouping or configured base value.

Implements QCPPlottableInterface1D.

Reimplemented in QCPBars.

§ sortKeyIsMainKey()

template<class DataType >
bool QCPAbstractPlottable1D< DataType >::sortKeyIsMainKey ( ) const
virtual

Returns whether the sort key (dataSortKey) is identical to the main key (dataMainKey).

What the sort and main keys are, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ selectTestRect()

template<class DataType >
QCPDataSelection QCPAbstractPlottable1D< DataType >::selectTestRect ( const QRectF &  rect,
bool  onlySelectable 
) const
virtual

Implements a rect-selection algorithm assuming the data (accessed via the 1D data interface) is point-like. Most subclasses will want to reimplement this method again, to provide a more accurate hit test based on the true data visualization geometry.

For general information about this virtual method, see the base class implementation.

Implements QCPPlottableInterface1D.

Reimplemented in QCPBars, QCPFinancial, and QCPStatisticalBox.

§ findBegin()

template<class DataType >
int QCPAbstractPlottable1D< DataType >::findBegin ( double  sortKey,
bool  expandedRange = true 
) const
virtual

Returns the index of the data point with a (sort-)key that is equal to, just below, or just above sortKey. If expandedRange is true, the data point just below sortKey will be considered, otherwise the one just above.

This can be used in conjunction with findEnd to iterate over data points within a given key range, including or excluding the bounding data points that are just beyond the specified range.

If expandedRange is true but there are no data points below sortKey, 0 is returned.

If the container is empty, returns 0 (in that case, findEnd will also return 0, so a loop using these methods will not iterate over the index 0).

See also
findEnd, QCPDataContainer::findBegin

Implements QCPPlottableInterface1D.

§ findEnd()

template<class DataType >
int QCPAbstractPlottable1D< DataType >::findEnd ( double  sortKey,
bool  expandedRange = true 
) const
virtual

Returns the index one after the data point with a (sort-)key that is equal to, just above, or just below sortKey. If expandedRange is true, the data point just above sortKey will be considered, otherwise the one just below.

This can be used in conjunction with findBegin to iterate over data points within a given key range, including the bounding data points that are just below and above the specified range.

If expandedRange is true but there are no data points above sortKey, the index just above the highest data point is returned.

If the container is empty, returns 0.

See also
findBegin, QCPDataContainer::findEnd

Implements QCPPlottableInterface1D.

§ selectTest()

template<class DataType >
double QCPAbstractPlottable1D< DataType >::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a point-selection algorithm assuming the data (accessed via the 1D data interface) is point-like. Most subclasses will want to reimplement this method again, to provide a more accurate hit test based on the true data visualization geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation.

Implements QCPAbstractPlottable.

Reimplemented in QCPBars, QCPFinancial, QCPGraph, QCPStatisticalBox, and QCPCurve.

§ interface1D()

template<class DataType>
QCPPlottableInterface1D * QCPAbstractPlottable1D< DataType >::interface1D ( )
inlinevirtual

Returns a QCPPlottableInterface1D pointer to this plottable, providing access to its 1D interface.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAbstractPlottable.

§ getDataSegments()

template<class DataType >
void QCPAbstractPlottable1D< DataType >::getDataSegments ( QList< QCPDataRange > &  selectedSegments,
QList< QCPDataRange > &  unselectedSegments 
) const
protected

Splits all data into selected and unselected segments and outputs them via selectedSegments and unselectedSegments, respectively.

This is useful when subclasses implement their draw method and need to draw selected segments with a different pen/brush than unselected segments (also see QCPSelectionDecorator).

See also
setSelection

§ drawPolyline()

template<class DataType >
void QCPAbstractPlottable1D< DataType >::drawPolyline ( QCPPainter *  painter,
const QVector< QPointF > &  lineData 
) const
protected

A helper method which draws a line with the passed painter, according to the pixel data in lineData. NaN points create gaps in the line, as expected from QCustomPlot's plottables (this is the main difference to QPainter's regular drawPolyline, which handles NaNs by lagging or crashing).

Further it uses a faster line drawing technique based on QCPPainter::drawLine rather than QPainter::drawPolyline if the configured QCustomPlot::setPlottingHints() and painter style allows.

The documentation for this class was generated from the following file:
  • src/plottable1d.h
qcustomplot-2.1.0+dfsg1/documentation/html/functions_o.html0000644000175000017500000000755414030601037024070 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- o -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractPaintBuffer__inherit__graph.png0000644000175000017500000000425214030601041032031 0ustar rusconirusconi‰PNG  IHDRk8LGgAMA† 1è–_0PLTEôôøÿÿÿ222………NNQiii*##Z6aa’³ÓÓÙèèëšššFßhtRNS²e‰ ÆbKGDÿ-Þ pHYsHHFÉk>”IDATxÚíÏoGljè¡Ü2d‰E}a#n¨)æÇ…Šµg½½„¨É.¾!UuD…Ôª!k¥= UqÒ*§F@+q ¥=p$*åFÚ“‡RTDh€JH•øúÞÌÚÞ5»Þ_³¦^v"9»3o¿ûÞgߌç9Âl#¯yÝöª=xÕ-#È$F`ïía$@…¶a$P669#Ȥ†€4ä:CÓA`†Âo™Nè´jÔçÚl TƒÒ¹NžUñ@ŸÓçÒA ~ª>q¢ºxP¯ÉFé +õŒj?C$?é P6fT}#2kUͨÐd…NÕ25àa›ÕšŠÇª^*³39à ½e:ì4£¦ê P“gÔ²QYPõS búêøjå@–­Y}˜³ûdf—´ªOȆVSg+¸hÆ Jᕯx fº5 ,:·rÝY)O@À8SÁ }ŸÉ @à1 Ïà°Æ 4:+ÆÛ+¡a0fÂ,˜]¬Cä@àT s\cà˜­±(/ðYpx!:Q5N¨|%4Jª #%H vÈŽYÐ%×¹ÂNj¥r F©g38üZF #Èd2CIÀëSß÷š_x~"ÜôFµÅÞöy“·ïm}Ÿ·[¬qƒó/]ÚF.ø•½ëÎ×ö³qNàÂà\0Uߺ£kÙaqãe‹TxÃûÅÞSl67íç{0MV ` §1¼–½+ßl^wØü‰.§”@~õ*D÷££owï¤/ÂLY^»¶™FÍËó_:;ÿi6¿uö“+£—¯§Ž@ñÖÊm\ {"»ÑóÖí#°)Þ\ù!eö¬.¯Ã¯;½ábÎ÷tåÙÚø`p3a ÚñŒ¯;û ¸îµzŒg¯³”ØðZÝóHàºûÌ„Û)!P¸µò«ÇÐ[HàŠ×…;Ö.¥‚@¾O:ÿ¾ñ¼tÏêÕ‘á'píÒ¦çào?AûÙûâ>é34n®|×w|÷…þ×o¬%¾AL”@áâ²Ï3ô#@ž¯^m /¼¿÷¾`&øQüÿ²–û€™°’èLHŒß‹ @ž¯]k ¨nÖ˜"@-•"ô±#h©”  Ÿr$d©”bðL`É•J ãkp‰•Jâ „Ê×’*•„÷îŠ@2¥’`…Óávpá„Ya^|؇’@¥’P}Ka1Ä—J" Ü\ù8ì%á /•Ä(ÛÇ& ºTF Zù‰€ØRIÑV¨h„–Jb+…ÅY* !}Ï•€ÀRIçщN@X©$€@àRX,Q¥Rlñ>ÓC@P©—@Ìb%!¥RLBQ*Å#à÷'¡Ä (•â(Äß—Ä'»TŠA ¿o*€@ÜR):û"*ub–JQ z3C V©‘@À? Š@œR)ûàdàÛRÄR)8ûà¤D.•Àößt¤yέûm›lÐo#:r. ¡ý‰rî&¥fP1‡ÓHÀ ¡[ÓlNR1’ÝfÿW&cqº' & 5c!Íîãؤ8ÝŒ@F #Ž€©˜J÷LÂÅ!š@ŽæìKœb“tÞ,u&ý.ªJ_Htº¤D$JçñhšL[×í*Ñy •þP eQTmARÊ,¤Ò ëŠYèQÐÐ’ìÞÌ‹@u›n9õ‰FÌ¥íDyªHÅzÇg–t[E?ûdR³þÌ“ú|N{4‰r Ú¡¢ÙÖ¶˜jg »¯Ò±ñ!BÝ7iÐs¥¨Hd ¸Ác.ÓyJ‘¨A*På.$H]ј>Ü´LGFé1/É) KPT {̲&Aî€à)þsÒBišT)šv_tÞÌ‹@u49L`XÖXdò1-rL¡Vì‡Ê,vJß—XÄ 9G™›åÇ“cû÷z˜"dIç)éàã~“å©Šr¨:ö‰I*-4ã9’Λy£Ž&7Þ…a0ÀȺN»°Ö“‚Äq®óTi;QƒáÁA¸é:qÏ—Ÿ©9JAn“ ±tgªÀ ¥–Dù:€’Ž›ù Žë@¶` 0²®Ón³€/Ú¿,H¦Ãç:5Å5–±¾ºyÊU—¶H'º->Û$$§`&á —tÜÌø«£É(›^ðƒ‘¹讄\T}la9°$3éAŽóì#N ÿ,è¬U–'eîã1ö”´Ç+ÞìÊrÏ…´%›“µØj}¾‘hT îRöXd2 zͶöé›*IÕZ8P%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemEllipse__inherit__graph.png0000644000175000017500000000212314030601041030347 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii222PPR™™™………ççè±±µÓÓÕ*P4nnxXëAtRNSªvå’bKGDˆH pHYsHHFÉk>=IDAThÞíØ1OÛ@p>B/Ái„hFa«#D·"KŒœí—˜2Q”¡#¡WaÁЕP¥.b©ºv¨j¨Øù •º3ô/1µÏ±¯C)÷"ñÝÏ~>Ÿ@üLjT=S«´»ã¾ìäö0äÜëÏSB4¡¯@ `Kƒ6›œÛëû~½d¿3´j§·I‰ju6ë8œ MJŽ?™mÒ6qáD#g°“ê7Ij§û÷Ÿ 6Ù.¿Ò‰ƒ'}âY:¤Ùž?¿Ô'ë”ØW%t„þǵßR­a° R¢Ís¿9ÊúqïÑ Ø)?ûÀü¾Åû_øld¿?<Æ>;.%©™6ú Xƒõ« öu0üʪOÓ6Óhû¶ä|z)ÿ7=䯸ÜH©Ù‹´‘fܧÖä¥x<Ë¿v¤üMp%寃o2¾?düT\ÈøÉ $üô¿$ü ú+ þ{q_C.~b?Åüeq_ùÉJâù oå•W^yå•W^ù"^œý|g@è d?·ó)Zúÿëi^Ï~üúÀÓø©&ðñìÇ4òûXöS]ß`YE ZPýœR€šÙÆ¡™(øõ±ì§d,…YÉkœðègñ€ßŸ…Aî¡e@ Úåú4Ëjƶ ýè§ß? ƒ6ðCý“s€Sôä£Ã~þ4Ñ[¸~{lýÂùÍÝùé;ûŸŸõØyñûców¡kº}?xþþú™nÚþ1­%ÖÝW˜wÿÊú¬ý£|Q/ûû·Û(Rs£üýɨûï -]TO~Ï2ˆfÓwõ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/dir_78a97038723513eb3e3a9e944a7f482f.html0000644000175000017500000000251414030601036026551 0ustar rusconirusconi src/layoutelements Directory Reference
layoutelements Directory Reference
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPColorMap__inherit__graph.png0000644000175000017500000000221014030601041027644 0ustar rusconirusconi‰PNG  IHDR•³ryCWgAMA† 1è–_0PLTEÿÿÿÿÿÿiii000NNP™™™………ççè³³¶ÓÓÕ*P4nngŠtRNSªvå’bKGDˆH pHYsHHFÉk>rIDAThÞíØÏKApÿ„NâS›Ø•ôÖUSÏ ;¸Õ“•€=æO¨ud<*Zh… öÒ“”^J¯=”®-Þý ½{è›ÝüØên3jqž&Ù3ÏY‚ß1b¬îYkd«0¯] yV±¡mA®åjï˱ְb„Pe«M¼ 6(¬Ê‰7²œ=^)øo\ZnÝØòIÑŠœqO„#Gï뫤 |@‡’ÐV²ÖÉ$£§ˆt×5Á|²Y|î~ÈIpèRòä€éYI¿`œ¬P¼P¯x•¨Yƒ=ÆÍñ_3Zu%Î}t”X뺽O¬ðM@»¸t,­=/Ùãü'WÉ*õÎŽq/­€‘™¬ûh•Àëõ¾¢dâíÿy ÊINéŸ{Ø0gå—µn£ú•gݯæÔìYÞ•Zž•[SßUîR³ÞFmcÖetn̺ˆ¾š²ÊQôÔ5Eg¦¬©(Šö YŸÑúeȺDëÜuÖ73Ö$R*HkZZ O‘ŠUú)ËŒ…¥rT­e-kYËZÖ²–µ¬õ[*©ê•¤­RÕì¤UZ®Ò6‡•s·-–=ƒ^¹‡fZéT•WzKÏhÓ¤·Ò©jÝÍ´Ø+¦f¥RÕòÊS™äáJ)°$T=²2Z'Љó’ëIëÀJ¥ªw.N_ȸ1 Uö{ëZÑ£\ε¤5ÂÕbeF&Ÿãl[7Tí÷+ŽDiVÒšµGòàï#ïr1I¨÷K^íZIkFï Ù$Å \±ÃÉZ7TÅ=®%–Üc®'­+•ª†d‚a_KØ^%¡ê ÄC÷~Æ!#iMŸÕ«©ª±so­;mªf&­h妪*ùj:iµùj¯l¾ªeÙ|U˲ùªµ¬e-kYËZÖ²–µn‡u¬¯Vr-GûŸY7ߚŭ•]ᨖËb°_ž–µÛœmŠÖ³> w›ÕÅ´ вâ_H`;ı؇øv@pØâu_Ѫ GÈ{q]8|®.BùÒ¨ñoáÂãwzö+¶jZ5ùçÀE âwš{ŒÇ+|·ÉEPU·°÷AÒ{9®.ö÷ˆNÍõ=öÏD˜Œû½ïZ^#Tî½/ýaçÝà3dÒR†¬õ/,ƒßCÃcÔ+ÕɵnVwÃÒnwn=ø §Á¨,ÑÂ=ü%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemBracket__inherit__graph.png0000644000175000017500000000214014030601041030324 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii111OOQ™™™………ççè±±µÓÓÕ*P4nn^Ù#tRNSªvå’bKGDˆH pHYsHHFÉk>JIDAThÞíÚ1OÛ@p>B/Ái„hFéVféVÉRFÎñKŽ2ŠÔŽ|„ŒŽD†v¨!ué„KÕµCUCÅÎg¨Ô¡ïîB0Å>»Ui¹³,žö»ó)1FrcÆã(Ì<â¾ØÙÃ5ïŒÜ¹}ÿ<%ÄÒú´°«´ÅÅ#{{'¬ü·ŽUîdò>)P«*®êÊ‹¡NI÷ƒÛ&- à“z9‚T¿B*Ô:DØþõÉzñ¥MšøËûŽE÷èí^Íß’% ñ‰U@‡è_NÖC­š#nH‰õ¸«üÊ0ë§<Û§°Q|z üŽ§úŸÿèÜþþðûì”4IÅõÑ—À»\¿ªfÿx»×_YùIÚfnÿÁj>Ÿ>ŒÿFqÿ°–2fOÒ*õ¸O“§úúmþ]´‘Ë_Dg¹üyô%/GÑ·<~*ŠNòøÉ(ŠvsøOèäðèÏrøsô_³û rý Ðû)áO³ûÒw1rÌŸýö1Þxã7ÞxãÏâõÙÏg}„>Cös• ï¬Ãþ=ÕdzŸ°zéiüŽÔÒøxöã:£ûXöS^ZYEZPýžR€ŠÛÆÒÌ Ã¸ò±ì§à,ʬä•NTô³°«ž/ `/d@ ÚÅê´ÈjÆ›búÑO¿-ãA5ý“c€Côä}S ý\úCy’àcÙÏ:)®bÿÅ^Hž÷£ìO­ž ƒ’|,ûad‚âú•pÝ<ª¢Ÿc§ã Â $3ûɵÿŒÿg|†ìg¡OÍ~ôùÊ€Lþ£-›üÇä?&ÿ1Þxã7Þxãïœ?ÈœÿT¥·3ÿùá(Ï3Žðþy–î=hð-8À‹0~@ëW&øíÖlÀ;kӜͰkž½ö†ñaƒ{<׳0fcnàÒÀ± 8³XHðuns_xõüÌysžì¿Yç¼#>ý@¸Æ÷çÀÂ:òù>ßÆgb×H´ý‹ù1qq(†÷e<|&ïøªpÓo ÖOÔ}>_c}ÏG¿æŠþ™W…ºæýIïâú5”ógXqåúmùXØLX?Î7ý?¿ÿŒ¿ƒ>ç÷ï^-ëèÝ•ÿ_ý‹>óâÉñè'Q'ˆËº¦%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_s.html0000644000175000017500000021746114030601037024074 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- s -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxis__inherit__graph.png0000644000175000017500000000146314030601041027045 0ustar rusconirusconi‰PNG  IHDRpk]ß gAMA† 1è–_0PLTEýýýÿÿÿ­­´iiiMMM™™™………èèéÒÒÕ111+""Zff—R¨S€tRNS«â¢bKGDÿ-Þ pHYsHHFÉk>IDATXÃí×1oÓ@àö'ÍU¤ˆ"Ô•%„ ¨[ÔXrË5÷܃LHµFv6ûª‡2!J‚%Šº 6dɬ Pw–î,ì Ü9ž"×Î`(õ“Å~÷åÎïž,{…8ÆÊÅ€[m븙AÏò9´_çÿ ©þ°bèÁÒ€€<¢6°!^pâ ¶;bVöônÒÍ —¤¹;ÓÓ‡ŒB&»„mtö à”“ûæ3JÚ[oÝ>dt›ËŒ¾GØÚC¯ί± G¯0ðÌ÷1Ñ3CÙR³ ¢ƒç„ï˜Òüe§¥Å™Ã' ‘{¤ý¦¥Ä«|©Û³‚íóí0`B[d¦Ë¢S#–‡5À•{ [ðlÕ­shð7Z®†¶¬cûgÄÝgeåwòÇŸJ’eðÇW7ØTê©ÜTêÔ ^UêÄ ¾Vê³ü©Ô7'ø[©ï.pCé˜:ÀMOà59À·~q€7 üàuœ”$kXÃÖ°†5¬á¿Å—öÎpñL¯®U?·Š¡ÀŠN`„˜@*!ÀplΈå`¸Ž‚~WÆ vº3Žp"dªG¡ QCPItemPixmap Class Reference
Public Functions | Public Members | Protected Types | Protected Functions
QCPItemPixmap Class Reference

An arbitrary pixmap. More...

Inheritance diagram for QCPItemPixmap:
Inheritance graph

Public Functions

 QCPItemPixmap (QCustomPlot *parentPlot)
 
QPixmap pixmap () const
 
bool scaled () const
 
Qt::AspectRatioMode aspectRatioMode () const
 
Qt::TransformationMode transformationMode () const
 
QPen pen () const
 
QPen selectedPen () const
 
void setPixmap (const QPixmap &pixmap)
 
void setScaled (bool scaled, Qt::AspectRatioMode aspectRatioMode=Qt::KeepAspectRatio, Qt::TransformationMode transformationMode=Qt::SmoothTransformation)
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const topLeft
 
QCPItemPosition *const bottomRight
 
QCPItemAnchor *const top
 
QCPItemAnchor *const topRight
 
QCPItemAnchor *const right
 
QCPItemAnchor *const bottom
 
QCPItemAnchor *const bottomLeft
 
QCPItemAnchor *const left
 

Protected Types

enum  AnchorIndex
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
void updateScaledPixmap (QRect finalRect=QRect(), bool flipHorz=false, bool flipVert=false)
 
QRect getFinalRect (bool *flippedHorz=nullptr, bool *flippedVert=nullptr) const
 
QPen mainPen () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

An arbitrary pixmap.

QCPItemPixmap.png
Pixmap example. Blue dotted circles are anchors, solid blue discs are positions.

It has two positions, topLeft and bottomRight, which define the rectangle the pixmap will be drawn in. Depending on the scale setting (setScaled), the pixmap will be either scaled to fit the rectangle or be drawn aligned to the topLeft position.

If scaling is enabled and topLeft is further to the bottom/right than bottomRight (as shown on the right side of the example image), the pixmap will be flipped in the respective orientations.

Constructor & Destructor Documentation

§ QCPItemPixmap()

QCPItemPixmap::QCPItemPixmap ( QCustomPlot *  parentPlot)
explicit

Creates a rectangle item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPixmap()

void QCPItemPixmap::setPixmap ( const QPixmap &  pixmap)

Sets the pixmap that will be displayed.

§ setScaled()

void QCPItemPixmap::setScaled ( bool  scaled,
Qt::AspectRatioMode  aspectRatioMode = Qt::KeepAspectRatio,
Qt::TransformationMode  transformationMode = Qt::SmoothTransformation 
)

Sets whether the pixmap will be scaled to fit the rectangle defined by the topLeft and bottomRight positions.

§ setPen()

void QCPItemPixmap::setPen ( const QPen &  pen)

Sets the pen that will be used to draw a border around the pixmap.

See also
setSelectedPen, setBrush

§ setSelectedPen()

void QCPItemPixmap::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw a border around the pixmap when selected

See also
setPen, setSelected

§ selectTest()

double QCPItemPixmap::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemPixmap::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ anchorPixelPosition()

QPointF QCPItemPixmap::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Returns the pixel position of the anchor with Id anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor).

For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor.

See also
createAnchor

Reimplemented from QCPAbstractItem.

§ updateScaledPixmap()

void QCPItemPixmap::updateScaledPixmap ( QRect  finalRect = QRect(),
bool  flipHorz = false,
bool  flipVert = false 
)
protected

Creates the buffered scaled image (mScaledPixmap) to fit the specified finalRect. The parameters flipHorz and flipVert control whether the resulting image shall be flipped horizontally or vertically. (This is used when topLeft is further to the bottom/right than bottomRight.)

This function only creates the scaled pixmap when the buffered pixmap has a different size than the expected result, so calling this function repeatedly, e.g. in the draw function, does not cause expensive rescaling every time.

If scaling is disabled, sets mScaledPixmap to a null QPixmap.

§ getFinalRect()

QRect QCPItemPixmap::getFinalRect ( bool *  flippedHorz = nullptr,
bool *  flippedVert = nullptr 
) const
protected

Returns the final (tight) rect the pixmap is drawn in, depending on the current item positions and scaling settings.

The output parameters flippedHorz and flippedVert return whether the pixmap should be drawn flipped horizontally or vertically in the returned rect. (The returned rect itself is always normalized, i.e. the top left corner of the rect is actually further to the top/left than the bottom right corner). This is the case when the item position topLeft is further to the bottom/right than bottomRight.

If scaling is disabled, returns a rect with size of the original pixmap and the top left corner aligned with the item position topLeft. The position bottomRight is ignored.

§ mainPen()

QPen QCPItemPixmap::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

The documentation for this class was generated from the following files:
  • src/items/item-pixmap.h
  • src/items/item-pixmap.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_e.html0000644000175000017500000001261314030601037024046 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- e -

qcustomplot-2.1.0+dfsg1/documentation/html/global_8h.html0000644000175000017500000002334514030601036023374 0ustar rusconirusconi src/global.h File Reference
Namespaces | Macros | Enumerations | Functions | Variables
global.h File Reference

Namespaces

 QCP
 

Macros

#define QCP_DEVICEPIXELRATIO_SUPPORTED
 
#define QCP_DEVICEPIXELRATIO_FLOAT
 
#define QCUSTOMPLOT_VERSION_STR   "2.1.0"
 
#define QCUSTOMPLOT_VERSION   0x020100
 
#define QCP_LIB_DECL
 

Enumerations

enum  QCP::ResolutionUnit
 
enum  QCP::ExportPen
 
enum  QCP::SignDomain
 
enum  QCP::MarginSide
 
enum  QCP::AntialiasedElement
 
enum  QCP::PlottingHint
 
enum  QCP::Interaction
 
enum  QCP::SelectionRectMode
 
enum  QCP::SelectionType
 

Functions

bool QCP::isInvalidData (double value)
 
bool QCP::isInvalidData (double value1, double value2)
 
void QCP::setMarginValue (QMargins &margins, QCP::MarginSide side, int value)
 
int QCP::getMarginValue (const QMargins &margins, QCP::MarginSide side)
 

Variables

const QMetaObject QCP::staticMetaObject
 
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPCurve__inherit__graph.png0000644000175000017500000000466114030601041027230 0ustar rusconirusconi‰PNG  IHDRPû±pgAMA† 1è–_0PLTEÿÿÿÒÒÔiiiQQQ««·………ççè///ÕÕä,!!Wii™­­ÊCCzôz©vbKGDˆH pHYsHHFÉk>¨IDATxÚíMlGÇÇö&qhܨ7.&$E¨+q¨—Á;ŽqNiëª=ô`Uí‰KDŒÄ%j •JX‚ÞràÖúMˆBO­äKî)ªzãBÏ\:ov6ÎîzösÖâý£„qÆûö—7Lø?– ¿fçë¨ÐjpP] hðCA³ªñOš Ð[%V'Œµµ,ƒ×tR=õ¡Wi¦Aµ o- P¦wHqy–­i-ª±ŠÖ]&47ßÈè¹KVÔ¾¢­2V^ؤ_†&¨vç&¡ùªeü"ò;1N×fŒòŽ*|½Kø•eÝzqCj§®}‘œ/ôÏmÐQúb2Y »¤³Læ^-óëöÐUº—ž”±1Ö%Z™ÌòiÄ»šÔžLz@ÉäÙŽOÛ^‡dkeÒꞇd ÔGŠ :Ú ,°Ô€n.yè­½zN)õÔå_THª·­š@NEÓÜPÍ ¥iÓÜQÍ ¥)Ó|¤šAJ_˜æ¯ª¤´kšT3H©gš#1í™\[ª)$4  ;ª)$4 TSHè€~¯šBBçt4Vû©Gª AAAAAG@Š Y‚"hÖ… šu!(‚f]Ù•pß¿ñC0GþÍà>y‰Ø!Ü÷Ãù,fP+v'‰›tv|±AÒ<¡ï¡Á|@µ8OQ`2 ÷ý„Þâ¦-[`ÔúcèFªlŽë{ú5;dTsžE[sœŽÉzõ ¨Ó}Ÿ¯¹ƒ[@«;•‚þYYg;ÐýA€nÖ‚:Ý÷W>Þƒ0¿ŒYæûÜ<åMr…ÐvFc`!÷säëö×åa‰8<ýÿ²¸ÏÓI®0xûy«ÂD©Û]³ :(©º€:Ü÷‹ùU°\7re~„ù>§Eóàņ âçÈ·Ú+äXâÉÞ=q½l]ÑiB¼ý¤ _ J­duØ€ ô®(ckÇ e0±wom¾÷hƒXîvøYýù ü8áé_á¯yœ?D4a`ÈYß„oõ»€Áô…û>Çøðrˆñ–u„ùÞ¾»ö@}ùƒCoß“6(8ûESxû©-Á[ì.žCïpß•É ëëPÑ`™ïaèÅ´C¿Ì?|ù“© Cßæ»ÖÐ o?€¶!Šå]|èy‡½æ2™î{ž%:0QZ¬2É,ó=ŸL¢)&éÒ.õu䤧>(ŸL“lR8ûíÉT “ ¢(t‰ÉT›Á5=¹¸ïƒÉ-áw7"…¡8ƒl#(‚"(‚† î¾æÈ'â`lO÷ý7¾ù³O¯Ó‘¿>$Ò‡¾‘"»ýgLóÁV#ùwÒæIpæîDŽ2ÓKÜ7û Øÿ‹äKò0QNrÎaþCŒ„MèEq’hòWÌ4ŒÈ»p’g‘Bä Dâô©Nò”Çø=iÐq~’ï"ƘNÅÙCéÀn/ Sÿóþå¿"E8üp*éä$Nc>™1KQ"ôvH/… ™âŸüªF™ 7îñÏäAlo-ô±9óI:BSáSþ¹û)ròüYȧ·7R›¢Bÿ„a2EE¸gBj¬ùv‡@ýmö_ö,p©HÔQÐ ”O”1>_º”öÍþÐô(8X h\U¸„"h* Î…*wœÒì×4  Î…j¡ö««Y͵Èþò?«ºŒj-VÊe¾H隨#äoy[ èæüq²¿üoÅ=šÿjR<Ò‡÷ÁJO¡ŽÎÛPš¯ k¼³ü¯º5n?Ò‡÷ÁJ/êy_q±¦ÔYþ÷â‰NzÕ*ûã}|¥u„Ê@ÉU1ôÎò?˜Lúu­ê¢ì¯ØY…•^ÔÂÐ/l¨µ&“³üÒSµ  µVöºXþE¡ºÉÔWè…W&EÐLFMÐÚ{q*APÉßyÿ¤üWãrÊÖ¿~úhj$CA ìeG5‚œv#<¥¤Ê¿bÑL⥔1 ª)U3H ª)Ûª!dt.r=fJzCc*•‡ºL¤RGƒÄƒ‡FaÚÏ<~¼ýø±j 9eÌê„ Š Š ªAAAAAt„ šu!èKzÕÅÚð›Ë÷ÚªA«’®ˆ²rPCJEP•í²ÛÆ%Ö4{_´³ z¡þfÝh½»h4N7.Ô—Žg´sÛèMÞh¬7xÛèð&Óê«g ô¤Q5t=ÝàmZ;9gÌ¿ÕÍ&(¿Gû ºÑZ¯wËèÞЋ6Ǭòfçkqy³Ê'SÓšLÐ^:Þ¹5Ï›—ØíóÇ3º—žVûPƒëóÍlçõÑHø#³2!(‚"èË:*»Ð$ŸI[Q ŠB¡öô?õ[+³H0£]%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssCircle.png0000644000175000017500000000047014030601041023112 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+jIDAT(ϵ‘±€0ç1igvÌyN‘†),TDŠ¨…Ðþ%ïC¡|ÆØËDAYQ ɺNVæãœQC (&ïH‰€:ÙÕƒYkÁ[;í¾|*“»¿P㘠%÷¦xÜÃ…Ýjùá³BlÑ%;%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/layoutsystem-addingplottitle.png0000644000175000017500000000403614030601040027313 0ustar rusconirusconi‰PNG  IHDR,Èe,ggAMA† 1è–_ÀPLTEÿÿÿÿÿè“, .IÖúþùÿÿÞr8ªòà¡S))0ÿ䈘Þð*éþÿnÌÆU OÂu’šš™„j- ²òþþõÕqssU]?3ƒy_‘¯mpƒ Oc°æ.úÍ^eÍ÷ÿó·M }âxàÿÓoÕúýoÖÞÖ§M6¥î WÄæþV°)gªƒê—,øòÇ'’è¦gV ííîçÎœl, ùÎm“““’кóKYŒbKGDˆH pHYsÃÃÇo¨d…IDATxÚí}[ªHÆIŒS&'27­]ó-Fog£Siûý¿ÕÎðæ˜(ÜãY¡Ëûwõ÷ÀÜ<Ï Ì!„B~3 zhߎLóX]Y;99Œ—ë¶Sýl­]Q-•kž:ð1¥—X’J™gÖÊA6LóÜZkV´vÏÌjþqÑ´7šuyquõ§¨ü_WW§võw;Û,÷JеòÆ×1ëÚ1z}³?ÒªµÂ´ŽÂظI6[DµéÄk—TÝOåJ&¶¶%¬=6‚ð¬D·Âw!9õîD¡‡a™òÕFz‰% ªT-1ËšÄi‰˜•¨î•rƒÈú,>ˆTãÜ…H³úñŽâ$L/±¬¤¡l›ž¼;QÇ¥4ülÖr›%Tã®´Üm/Ê­®‹ÒmYkë¢ë—Ò»À¬jGnôóŸ–ÜJã¶å zH/±¬4ðÏ☧†/ú0ëYÆH_DÉx°j–¬²8Žhø~¼¾öe,K³nÂe†>ż†(¨ù–Zb X¹uÑßtŒƒ#Y—üfÅ9cšŠYQ›6PR'¶¸DÊ?ÝË«Asvœ©ûÀ,×K-±¨•Ú.²šÓuåAÅÅúgÙ`ËÆ(4ëXè*fÝ›&‘µ\b X1Km³dµÔ^6+Z›¨Îã}W0ià;Ž1ÍOKæy`“»Ö¬jW^ÒK,+f-®†–ŒÑp,Ò`Ù¬hí²J5+ÀmË(½‘† z€qß\kVêÕ°Ìf-î³ÄJq´Þ¬h­ªêŸZ+fÝ(Ó»]nUgkÍ î³Fz‰dAioÛËÍ Y„B!„B!„}‚ŽË¦Sôa| †­{ËbH>êvyº·KÏ\v\n_Î~à9~eü,†ÝšÖS·_B³Š>q_¹¾§eÖ‡ŽHOUø®æ©?«†oÇѬ Qð®E7\fˆÖ~º ÚÓ1 Y€ˆf"¦!¯†€ˆiˆ˜†Œ,@D³‘V¿¯0²ÍDLBF â|¶¨gGß›2 3ñGýmÌ*ÃéÞÙ®¬†;¢Y9E½×îÓ0þíÃAb–Nô‡V—¯žj‡?i^Y·}°UdŸ;Û•Ž+¾ Å4ÜŒåyÞûíµüÂÈÊ1 uDLC>î"¦! b0²ÍDì°`d"šˆ˜„Œ,@Ä;x@Ä4`"šˆ˜†Œ,@Ä«a†¨>Z|ÉÊ4Ì`þóûe…ŸÐå=ÇŸý~ÙìnWï£hdk¦ar*n¸ÈîûÍÝ÷ÿ.xœi˜KįïsRë8—wÑ "Œ¬ ÑDζrÈî{XÄ F ¢Y€ˆIÀÈDü b0 ÍDLCF âÕ1 ˜†€ˆf"¦!ø ÑpÖ—Sy0 3Dó“®?s·è‘Þ7Ø#_d5Ü-z¤ËPƒîªÖÇ¡æçÙCœÏí³hZFV–hn?9Ñ"ÍÊÍ[Oooo#râxÁï:~º ÚïàÓ€iˆh b0²¯†€ˆiÀ4D4 1 ØÀ"¦! b0²ÍDü€‘•%²&ý›h‘feˆ¾UÆöVfí¿þ1²r‹†4+¿H1‹Ý÷YÝ÷Œ,@D³Ñ–fíŒ,-ÿŸˆ˜†LC@D³Ó€ < b"¦!# Ñ,@Ä F ¢Y€ˆIÀÈD4 i] õrWKUü®žíÅpÁ_³»ÛUÝ~ò+Û|P^x v¸«çê£1·?oa¦É Y_ø¡(LÜ©1l½ %ì¥YV£9MúwL’Y$µÍ"Ô[Ooñ„$‹š ÜC)å¹'?Êë»ùQÇìÊ:õDÏ>·Àã»2›Î¦ƒQž{r£¾¾›uÌ®ü"eê)Ô‡ÍjÝ[ÖFÖ=„úú.F src/plottables/plottable-graph.h File Reference
Data Structures | Typedefs | Functions
plottable-graph.h File Reference

Data Structures

class  QCPGraphData
 Holds the data of one single data point for QCPGraph. More...
 
class  QCPGraph
 A plottable representing a graph in a plot. More...
 

Typedefs

typedef QCPDataContainer< QCPGraphData > QCPGraphDataContainer
 

Functions

 Q_DECLARE_TYPEINFO (QCPGraphData, Q_PRIMITIVE_TYPE)
 

Typedef Documentation

§ QCPGraphDataContainer

QCPGraphDataContainer

Container for storing QCPGraphData points. The data is stored sorted by key.

This template instantiation is the container in which QCPGraph holds its data. For details about the generic container, see the documentation of the class template QCPDataContainer.

See also
QCPGraphData, QCPGraph::setData
qcustomplot-2.1.0+dfsg1/documentation/html/nav_h.png0000644000175000017500000000043514030601042022440 0ustar rusconirusconi‰PNG  IHDR Q¥ÊdgAMA† 1è–_$PLTEÿÿÿÚàíÜâïÞåïàçòâéòåéôçëôëíöíïöïòøòôø@¤yrbKGDˆH pHYsHHFÉk> IDAT×c```P`0`p``H`(`h`˜À°€a¸!0(V%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPErrorBars.png0000644000175000017500000000701714030601040023613 0ustar rusconirusconi‰PNG  IHDRÂú-ígAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨d AIDATxÚí/›«:ÆÆUÖï³_ ¦~ÅúuµGY·òÈØH$‰Ä!±•ÈJ>7iùß)!Sæ½½<{èîtà×yI ÿrrý·v¤¹"„èEÑ‹¢!D/Bˆ^„½!zBô"„èEÑ‹¢!D¯.BÆèeûk! !zM@ÈÆÿ EY0 !D…Œ½¨ ÑG!„裑¢U!ú(„}2Rô¢*D…¢BFŠ^T…è£BôQÈHÑ‹ª}”‘wBŽ\ Ýà÷‹2!räBKº$š`¤Ž–ÆýÍ·) !De5„$]¢*D…¢BFŠ^T…è£L˜Sá¬>©@÷‹­€é9d¤v‰Œ}Bˆ> )z½w:¥,Èe±(ïP1]Bh·¥;^T…&sY$ !4™Ë"QÈHÑ‹ªÐd.‹D!„&sY$J/ÂÏ«rœè¨eÐFz ©ïŸՋЉ€• K€µÞØa‰˜«ð«zŒB‡ËPÁÈUûÐ)ÓhÒI‚ ¢8sG#©B©ã¾]Œ±ï×ûDvÙ¼Ý×PÁÂÈ©2ª;‘¡ŸÄ^DÙÂâ4e9v#ð“Ä¿É)û ©ûWËÍM7j¸®qùÕâ€;ÌF8^kVa!YŒœ‰M¿ñ°Ù_PAh¤ w]%"Mfaœ7×ÞoKUxtÊ#Oîî_›kmAȻʯ^~ 9¿æ͵?÷[&[ðCÈ‘‹™‰ #uÃZrŸdYî]óÆÊ}FZÉ‹åpLÿÙIí7Ò£ÐA.fð±}É΋³,nÇ·ÆH•7éø·˜GÝ(öWá´ÔAxóY÷Km3Â\š†X^ÚŽ‚¡=]8Ϻý -RÏdÈà©:áchã•­¼ù¸ë:´Zþv{Æ~wW© †È¥n€hߢê|`Äcû‘‘›S±P”:Ý›ï§S£èÈÅžg6Ùsõftº‰è$®— UáÄ(­t³PôU!!ÒM=Â…„ØHïjw Šªpbàª}³“h0B81 4ð¢ÛI4“Ë„9 ½4Ì©0ùz1§‚£˜SAU§{Rv æB'Fy9‚mf'‘Z¤¤{ï$UáÄ(}ãHE'qòdg2R=¹(¨(ðôN"©-éfZ:‰J¢*œep@þÄN"©ž\¤0§¢º’¸l.d¤ ¦;»“¨$ªÂ‰QÔf6ï$b5Ryg×½ßìgõ\¥89mt'«‘Ê{ ï÷÷Ûc‘²iÌé$*ÉŽ*D…Gw'¿JQFu±)²(¿….jQÆt±éÛKÇ•ÄW¢*4Eµ“HFjoÅN"©ÍZh¸)U¡Á(*D2RË£ wÉH­—þá¦T…¦£ôt/B_r1ês ¡ù(/;‰Ó¦C’‘®¡žNâø[P®åæ¿rSBˆ&Ê«Nâ|„«tßÌ+cì ¬wÈß^°“HFŠ+ ÐI4‚¤OÏDªBtQºDBˆ0J»“HFŠQ­N"U!Î(N"!D% yqC³ñÏt##]IÝÛ\I칧 UáJQž¡(;‰©Ïà6„о(ÀS0³€ó˜Åb¨!I‡À™z²“ûÀ;T…öE9;OúÌù-byÆÛ÷žº× !D…Œ½¨ ÑG!„裑¢—‘9líÙÚ_6mÍ©@…Œµ\!G.FýU¡EQÎBG¹õW„Pc”/·Ð?“¹è5R¯é1çùÇxÅDíbaô1xú«ÐSÃgWý苲ç‚r!„š£ @8 E„調Ç‹ª°åoy(תoEAQ…ï‹Pêï$|u„ÜH§#|ˆŒTo.¢l¢ a_DFjXT…¹Þ*ýÌ¢Ù[´)„YX(ze.B³[$µ)#NáNB˜yP`f«6U…R‘Óežzf¶ˆæZƥάüÉb„²ØH¥¢‘ sº_óŽUa' ›ò0S¯By”þ‘‹×¿¨Ý¿ÈV„“„ á´ÛðÛ¤ä­<@¾ò–°)x0I|@}Ï쳫kïá³À{ø€ÂT…R BÁëY}™2‹0ª¬º…¤@–;Þ¿T4Ôýù«}þÖû`ÜäTèUæÕ·r­þìÖE8^ä;ÐÊá¯SïƒõÇ·¯0¨vìO•žß!ä©r|áB›3€PAUØDh‘ÖyžWQì©BŒT¡Yõ#Ôe¤h¹'±ˆ0¶H© …öåiôï÷­Âè\ˆ½%¶Þá?×uwrîÎ×”­›!3Fªáx™7ÒâæckT¡8öŽX|R> Âà³Ð‘>k4B³ª´¡í)ø°`;ª°:ñÒý½~„Û¨Â,©ÄêëÓØv Ü•­úîÎWCøO&]y¬<½#˜W"Oß³ÇHèCÕŒ”•ÇÊïw4R±½À>˜p±æÌ„M#mèݪ°FØèXÙˆðºH©áWéÓ§ÎÛD¨YéP S½EÚ‡ð*J±èn6#µ± \ÑmªõéõFUèŸN§G,¾ #ÕAÝ·°ᥔÇsÕKÂ枎Ë"¼äce ! ¡ÂЉ”C¾ê4v÷Vƒóiðó°ÂÆE„ºˆ`Âj^õþh„R_ÍÚ5_…‹ l\Dð ‹:ʦ‚#Ó~¹ó¶ô.."èDx*eáA ºéMD¨j¤'9¯KNì:.‡ô8_~OF˜z@øÐ7\…Þ¥·áË¡ü BhNEs4"@Y|ÐñJ FøUí®ÐïO/€æT´ÒæT4ÔœSv* 9M„ІìÎÀJ¡æ9æªTQ…U‹ôïaz‹´H›í¬Âµ‚7n©ƒ²µߤk_¤_=ä#ÂŒ7n‰jÏ°ãX¸4ÂïR8V+ÿTSLö¦g¥‘î¡{B™ìT@¸¯Î`½eNÚ»„pu„7èf~BñiâSýý3Aˆ¤ “:½ßê“Bˆ¡SµÖÞágyò[aozévòò$¤§ˆªÐ4ÂjD» #l‹Zˆ°£ù{Ó##Å€ªµö¦GFŠ!U!!$„k#ìMŒBªBBH×FØ›)„¸ª3ÆœVŒÈ$„Ö³za…°7=+´‘!ÄW…f*ÜdŸ­ýÄí/d[4± IÖŠ¢!D/Bˆ^„½!zBô"„èEÑ‹¢!D/Bˆ^„½!zBôúù®“€ÙV>`%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPainter.html0000644000175000017500000005672414030601036024540 0ustar rusconirusconi QCPPainter Class Reference
Public Types | Public Functions
QCPPainter Class Reference

QPainter subclass used internally. More...

Inherits QPainter.

Public Types

enum  PainterMode
 

Public Functions

 QCPPainter ()
 
 QCPPainter (QPaintDevice *device)
 
bool antialiasing () const
 
PainterModes modes () const
 
void setAntialiasing (bool enabled)
 
void setMode (PainterMode mode, bool enabled=true)
 
void setModes (PainterModes modes)
 
bool begin (QPaintDevice *device)
 
void setPen (const QPen &pen)
 
void setPen (const QColor &color)
 
void setPen (Qt::PenStyle penStyle)
 
void drawLine (const QLineF &line)
 
void drawLine (const QPointF &p1, const QPointF &p2)
 
void save ()
 
void restore ()
 
void makeNonCosmetic ()
 

Detailed Description

QPainter subclass used internally.

This QPainter subclass is used to provide some extended functionality e.g. for tweaking position consistency between antialiased and non-antialiased painting. Further it provides workarounds for QPainter quirks.

Warning
This class intentionally hides non-virtual functions of QPainter, e.g. setPen, save and restore. So while it is possible to pass a QCPPainter instance to a function that expects a QPainter pointer, some of the workarounds and tweaks will be unavailable to the function (because it will call the base class implementations of the functions actually hidden by QCPPainter).

Member Enumeration Documentation

§ PainterMode

enum QCPPainter::PainterMode

Defines special modes the painter can operate in. They disable or enable certain subsets of features/fixes/workarounds, depending on whether they are wanted on the respective output device.

Enumerator
pmDefault 

0x00 Default mode for painting on screen devices

pmVectorized 

0x01 Mode for vectorized painting (e.g. PDF export). For example, this prevents some antialiasing fixes.

pmNoCaching 

0x02 Mode for all sorts of exports (e.g. PNG, PDF,...). For example, this prevents using cached pixmap labels

pmNonCosmetic 

0x04 Turns pen widths 0 to 1, i.e. disables cosmetic pens. (A cosmetic pen is always drawn with width 1 pixel in the vector image/pdf viewer, independent of zoom.)

Constructor & Destructor Documentation

§ QCPPainter() [1/2]

QCPPainter::QCPPainter ( )

Creates a new QCPPainter instance and sets default values

§ QCPPainter() [2/2]

QCPPainter::QCPPainter ( QPaintDevice *  device)
explicit

Creates a new QCPPainter instance on the specified paint device and sets default values. Just like the analogous QPainter constructor, begins painting on device immediately.

Like begin, this method sets QPainter::NonCosmeticDefaultPen in Qt versions before Qt5.

Member Function Documentation

§ setAntialiasing()

void QCPPainter::setAntialiasing ( bool  enabled)

Sets whether painting uses antialiasing or not. Use this method instead of using setRenderHint with QPainter::Antialiasing directly, as it allows QCPPainter to regain pixel exactness between antialiased and non-antialiased painting (Since Qt < 5.0 uses slightly different coordinate systems for AA/Non-AA painting).

§ setMode()

void QCPPainter::setMode ( QCPPainter::PainterMode  mode,
bool  enabled = true 
)

This is an overloaded function.

Sets the mode of the painter. This controls whether the painter shall adjust its fixes/workarounds optimized for certain output devices.

§ setModes()

void QCPPainter::setModes ( PainterModes  modes)

Sets the mode of the painter. This controls whether the painter shall adjust its fixes/workarounds optimized for certain output devices.

§ begin()

bool QCPPainter::begin ( QPaintDevice *  device)

Sets the QPainter::NonCosmeticDefaultPen in Qt versions before Qt5 after beginning painting on device. This is necessary to get cosmetic pen consistency across Qt versions, because since Qt5, all pens are non-cosmetic by default, and in Qt4 this render hint must be set to get that behaviour.

The Constructor QCPPainter(QPaintDevice *device) which directly starts painting also sets the render hint as appropriate.

Note
this function hides the non-virtual base class implementation.

§ setPen() [1/3]

void QCPPainter::setPen ( const QPen &  pen)

Sets the pen of the painter and applies certain fixes to it, depending on the mode of this QCPPainter.

Note
this function hides the non-virtual base class implementation.

§ setPen() [2/3]

void QCPPainter::setPen ( const QColor &  color)

This is an overloaded function.

Sets the pen (by color) of the painter and applies certain fixes to it, depending on the mode of this QCPPainter.

Note
this function hides the non-virtual base class implementation.

§ setPen() [3/3]

void QCPPainter::setPen ( Qt::PenStyle  penStyle)

This is an overloaded function.

Sets the pen (by style) of the painter and applies certain fixes to it, depending on the mode of this QCPPainter.

Note
this function hides the non-virtual base class implementation.

§ drawLine()

void QCPPainter::drawLine ( const QLineF &  line)

This is an overloaded function.

Works around a Qt bug introduced with Qt 4.8 which makes drawing QLineF unpredictable when antialiasing is disabled. Thus when antialiasing is disabled, it rounds the line to integer coordinates and then passes it to the original drawLine.

Note
this function hides the non-virtual base class implementation.

§ save()

void QCPPainter::save ( )

Saves the painter (see QPainter::save). Since QCPPainter adds some new internal state to QPainter, the save/restore functions are reimplemented to also save/restore those members.

Note
this function hides the non-virtual base class implementation.
See also
restore

§ restore()

void QCPPainter::restore ( )

Restores the painter (see QPainter::restore). Since QCPPainter adds some new internal state to QPainter, the save/restore functions are reimplemented to also save/restore those members.

Note
this function hides the non-virtual base class implementation.
See also
save

§ makeNonCosmetic()

void QCPPainter::makeNonCosmetic ( )

Changes the pen width to 1 if it currently is 0. This function is called in the setPen overrides when the pmNonCosmetic mode is set.

The documentation for this class was generated from the following files:
  • src/painter.h
  • src/painter.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemEllipse.html0000644000175000017500000015251714030601040025342 0ustar rusconirusconi QCPItemEllipse Class Reference
Public Functions | Public Members | Protected Types | Protected Functions
QCPItemEllipse Class Reference

An ellipse. More...

Inheritance diagram for QCPItemEllipse:
Inheritance graph

Public Functions

 QCPItemEllipse (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
QBrush brush () const
 
QBrush selectedBrush () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setSelectedBrush (const QBrush &brush)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const topLeft
 
QCPItemPosition *const bottomRight
 
QCPItemAnchor *const topLeftRim
 
QCPItemAnchor *const top
 
QCPItemAnchor *const topRightRim
 
QCPItemAnchor *const right
 
QCPItemAnchor *const bottomRightRim
 
QCPItemAnchor *const bottom
 
QCPItemAnchor *const bottomLeftRim
 
QCPItemAnchor *const left
 
QCPItemAnchor *const center
 

Protected Types

enum  AnchorIndex
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
QPen mainPen () const
 
QBrush mainBrush () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

An ellipse.

QCPItemEllipse.png
Ellipse example. Blue dotted circles are anchors, solid blue discs are positions.

It has two positions, topLeft and bottomRight, which define the rect the ellipse will be drawn in.

Constructor & Destructor Documentation

§ QCPItemEllipse()

QCPItemEllipse::QCPItemEllipse ( QCustomPlot *  parentPlot)
explicit

Creates an ellipse item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemEllipse::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the line of the ellipse

See also
setSelectedPen, setBrush

§ setSelectedPen()

void QCPItemEllipse::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the line of the ellipse when selected

See also
setPen, setSelected

§ setBrush()

void QCPItemEllipse::setBrush ( const QBrush &  brush)

Sets the brush that will be used to fill the ellipse. To disable filling, set brush to Qt::NoBrush.

See also
setSelectedBrush, setPen

§ setSelectedBrush()

void QCPItemEllipse::setSelectedBrush ( const QBrush &  brush)

Sets the brush that will be used to fill the ellipse when selected. To disable filling, set brush to Qt::NoBrush.

See also
setBrush

§ selectTest()

double QCPItemEllipse::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemEllipse::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ anchorPixelPosition()

QPointF QCPItemEllipse::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Returns the pixel position of the anchor with Id anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor).

For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor.

See also
createAnchor

Reimplemented from QCPAbstractItem.

§ mainPen()

QPen QCPItemEllipse::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

§ mainBrush()

QBrush QCPItemEllipse::mainBrush ( ) const
protected

Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is.

The documentation for this class was generated from the following files:
  • src/items/item-ellipse.h
  • src/items/item-ellipse.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/selectiontype-multipledataranges.png0000644000175000017500000000344114030601041030116 0ustar rusconirusconi‰PNG  IHDR´n|F$HgAMA† 1è–_0PLTEÿÿÿZZ\dddëèê±±±wwwÏÏϵŽ¦ÿÑíÿŸØÿjÿ[Ø]ÿB¦š.i®¹äLbKGDˆH pHYsÃÃÇo¨dIDAThÞí™OOGÀ‡õ.E~Œí\ „´GÖBÜJ½,¸I®Þ âëzÏ'àT©Jœ Š|mbE=×n>÷DùUß›{w=ã}&ŠÈ'Ë6ã7¿yûfæ½7ƒ7r#7ò­ @ኯÂ×3*}õ±¿"úËǾ«¯}u¹N«¯ó±®ÃêëDÏ(V­2ƒÕ™½÷ñýeÈB;Ò Ùä¼ ŠyYæ(êl´¾XYáX½°9‹Õ2húF&z«6Z€¾`¡kPÉ!bK…@k2²…ã?¤‰a‹U¹·êmƒôŒèGžÒÃI‘O­Z‡ž?te]T‹æ±eI´Ê!>À=‡¦&[ìC|Ë¡9Ë¢@¶è­^ùØ…MPÒv•ë2eÅE­£9ì‘o¿2¢ñç==BWAMx–8.4„XÍ¡Ê‘ m# M•¸HWÔ´³ÑÄ¢C#X~Î3Y€\SøÚ€r‹åkò„EòKγ|º‹E¾XöqVŽËÙ34öZ]ØG~SXUß f?桳qÚ€“ã0ü!lê]ZÐNe£HÕ´®;PŒvø ©ö-š¨Y©¯çѬЀ.ºPŽv¸R`íôÜvˆDÔß[FoJ_¶¸*^À(P³vcÓª¨¸d\Ç/ûztþ¾¤ô¢V9èÝ|×’/ðiïÐÒÕov‡†õÔW…~ÂA¯‹º%!vJÛ´¼<–åïáÑMº#¾ÿÂH—¦¿‰ì²Ž=Z÷ý:ç1ÐõÅþ¿ÇBmË zÓ‡‡ª •MÎo, ‡=übh.îw ˜2!siU²ÑNåÓpø¾Ùdä’FíhüUYít²=bù—h%6ÎæÚn ½#3£ˆÝ φÃbC¹Ú(ÿ*‰Æ +§›\·´Ôôbmåç:Íõ$Úq/7Iº´ ¼ïãmíºê$Ñ/åKéúft@ :õ{Áò?Ÿ¤5S{”n_sš¦Œ7‰Îÿ×Í+I«¼›Z²Z¬Ô–ƒ©ET ’B¿¢ÄÍV‹ÝO¢ó¦ mZĵ‰Uü‰Ðç±µE‹I´*vÌõuÙœ2Zúiôƒ¤šrª¹>kiŸ(B§­Ö å¾ÑÓ;Ú=] ‡$¦Qùz#¥F‰}׈îj÷tai8øx’h:(ËÚøÙ#«í=hÑó®lkÐâÍÉíóDSS< ã JòO§í jø!…N>xal[(L¢MËÔs±—hZŸPˆÄ©Ñ&´ø;ÑTŸTˆ|Ò6‘õ¿¨žoã-æR©ä~ âÑ€~/ŽMÏ=¶zË}½è'Xõü¼ÐŒØ)Æ蕉Øv!­)ç¨SÌÅ]’SayŒC{L¸TÏ?ÎÆ;²U3zYcž¤lD/s±ã¦âîè+‹W4 èŸû£\l¥³¦Ñ åAìÏQ#L4Ò‹Ð ýzc«M“ò„†µSîX›š$–bÁ Æ» Jì‡A²íRœ¼NCÒü6Ü5éá°²™Z&º¤˜D> †t¡ØJ…fÊä%sÛè´øq?H­ôGÛÒãÓ°wÊBÛäÙ„Õ-Ó½…?Å­cZÝbT’-¬NK'ôÜDÑlgŸû0ÓüÎBËdF™’FèÞëáÛL-tH5™„ô¡:!‹½þpàeiÙ5ÙN¦NÎêCªˆÒ‹óT$kαï= -¢#–²Ëèñ.U°k;€gß©?^üÝjá‡L7ZÞxò3;`2x×c¡q¹Í]ÖÉÓ BÉ€‡Æ¢C¡ÎjØ‚ìÍHè^öº&± Q!¿¹8htÈ9+° ±E©‹ Æ쎵°Ç‹~ŽÛ¹uWþ¤È±rÙ(oNÄÙà„¦[¿¦°Ÿ¨ŸyI¼˜8b…î*qGæ ÍúŸ@”ÇjtYÅ%}÷Ø÷ñ·p×0­îP\þµUæùƒk5ùº}ð¸BùúC-”¨Tç]_Êéàœ¥·J©…w©=«4)µ¼«øYÑtsßͺع’ô/´üÚÝ/'¥eZ1û…bAFÅôMZ-\nè˜]¶’eß\MþöTO›åíR—%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_l.html0000644000175000017500000000631314030601037025070 0ustar rusconirusconi Data Fields - Functions
 

- l -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_t.html0000644000175000017500000000715614030601037025106 0ustar rusconirusconi Data Fields - Functions
 

- t -

qcustomplot-2.1.0+dfsg1/documentation/html/tab_h.png0000644000175000017500000000045314030601042022422 0ustar rusconirusconi‰PNG  IHDR$ºZM?gAMA† 1è–_'PLTEe{±uŠ»‚—“Àkµaw®[s«C\›HaŸMf¡Tl§4NÿÿÿA÷OïbKGD ³Qc pHYsHHFÉk>+IDAT×c```P`0’ è„ „ H° 6€á \„ Ù AÇ q„Á$%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_19.png0000644000175000017500000000116714030601042024504 0ustar rusconirusconi‰PNG  IHDR]#\PÎùgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>©IDATXÃí˜1rƒ0E¿3ˆ¸ÁUz€Cø N†¸u—&i|€4Iã¸ñ 0IDATHÇíα ±qÁ9¬Ü$'°V!E¸öRú 𙚴±Î½ý¼f.+ŽÄŠéÓ"%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPBarsData.html0000644000175000017500000003537714030601036024620 0ustar rusconirusconi QCPBarsData Class Reference
Public Functions | Public Members | Static Public Functions
QCPBarsData Class Reference

Holds the data of one single data point (one bar) for QCPBars. More...

Public Functions

 QCPBarsData ()
 
 QCPBarsData (double key, double value)
 
double sortKey () const
 
double mainKey () const
 
double mainValue () const
 
QCPRange valueRange () const
 

Public Members

double key
 
double value
 

Static Public Functions

static QCPBarsData fromSortKey (double sortKey)
 
static bool sortKeyIsMainKey ()
 

Detailed Description

Holds the data of one single data point (one bar) for QCPBars.

The stored data is:

  • key: coordinate on the key axis of this bar (this is the mainKey and the sortKey)
  • value: height coordinate on the value axis of this bar (this is the mainValue)

The container for storing multiple data points is QCPBarsDataContainer. It is a typedef for QCPDataContainer with QCPBarsData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods.

See also
QCPBarsDataContainer

Constructor & Destructor Documentation

§ QCPBarsData() [1/2]

QCPBarsData::QCPBarsData ( )

Constructs a bar data point with key and value set to zero.

§ QCPBarsData() [2/2]

QCPBarsData::QCPBarsData ( double  key,
double  value 
)

Constructs a bar data point with the specified key and value.

Member Function Documentation

§ sortKey()

double QCPBarsData::sortKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ fromSortKey()

static QCPBarsData QCPBarsData::fromSortKey ( double  sortKey)
inlinestatic

Returns a data point with the specified sortKey. All other members are set to zero.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ sortKeyIsMainKey()

static static bool QCPBarsData::sortKeyIsMainKey ( )
inlinestatic

Since the member key is both the data point key coordinate and the data ordering parameter, this method returns true.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainKey()

double QCPBarsData::mainKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainValue()

double QCPBarsData::mainValue ( ) const
inline

Returns the value member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ valueRange()

QCPRange QCPBarsData::valueRange ( ) const
inline

Returns a QCPRange with both lower and upper boundary set to value of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractItem__inherit__graph.png0000644000175000017500000001366214030601041030527 0ustar rusconirusconi‰PNG  IHDRУnÅY\gAMA† 1è–_0PLTEÿÿÿÿÿÿhhh®®ËNN`˜˜´………èèìÑÑÚ222""X7*aa“!N(CtRNSªvå’bKGDˆH pHYsHHFÉk>œIDATxÚí_ˆI~Çׄ{ÈÛÖŒZº–ÇÑaã¼ÌÎŽY¼dƒXâ‡àq®5.¯y©õ¬O±î1iA7·Øï½nþ0Ê®¥e7E@ßÛY‰´o©@)cbVJ×c%LfEE8¥M±îüêË/*Qw.(«)â 4— ôq•Î¹ÇS&Ð ã‡Ð\*г‹Ôl.Bs™@uúXQ†‹Ð\&Pz<ŸhpRÉJïDÛ¼dÒ€¦©C ³Ü48Ò€ùš’Éë• t9ïÏÓëüä²€R¯D/óˆ$½µåÏËðéA奄õò€Òjî,?A½< ”šËµâJJ©¹õE®¿ (¥ær–ëJ꯹&Ô!-¿õ5ëC¼8E‚:â?Æ´<á…—P h7þcÎ`J×¹©Ç‚vÏKÖdJ.^„ƒf:ñ+Xà3áE8hWŠ²¶Èà|U‰h»jm$ÁÂWÕ£0Pý™½µIï[Îðˆ‡$MþÎ&¦Ýã7o@,è­Ekƒ>²p£¹Ë÷÷„.WìÊ»>+eHÚ9E©}K¢þ+Þ?( ´3Š²¶Eù+,s•Ó µOQêu =PëSÃú¶ ËUóùeÔš1ct|®?ЂëÛ‚@;§h=ï{ïF3OýN¿ Jjº”¦(ÕØ¥GIP;Ðõ‡¹ifƒ«$¨èRš¢6óŠEIP Ð?Ýy–¢ÕUÔ>E}QQ’Ñ9@;«–Ã\ ]Í\š^.Pk¸È×1"hgz}É êN2€ZÃEÞÑ\=0ò³@ `Ìвì:0 LÏÁ<µrKä²8CPóõÙ϶@çAÚЪˆÊ,Ññr`a}aÝ0A× œ! ¨uGßÛ…xhxAÍsTƒ\@ÿLPül+$Ø"Oy&d-8_Õ´J„-Pâ% ¤5oºxì‹ô°K3ocD@óã§Þwƒâ Y@MÑǾ(tŠ¾·{Á ‡QcT°@!$ 8Cд٫¸ïCÜcG nPjaŸ”4ù„<ºD ™í•°¯©ýÓ.~tMèÅCC=Ðvxãù^n>¨J]ºÎ^å•5çE8;ÑÀW]PÑ»:Ñåž–V”„ ÎiÝ=º3)JÂG'š ¸uö©Õ J‡P#]ïñîÃéFóßúë šÄÍ­Ãp¯·QùûõæßT"üìðA,â+ÑÎËžzpûqë«|¤Ÿ>(ì^‰&zéY{­Ñ0E€>Îð¯Þ³¤_7žGÑ^ M|ë ÿzX`þGÿáð»CÅ’ÎNø— ½fùˈm8ÐÏváßrÈ ÂíÇͯª|~wè {•®Þæ^pH”ºµ©ªð¬ë^\qqY`. tíKì g«ÛW_åÓ m·¶¯ì — ŠË­ ŠÒö ÿWÜ<ëcÛ ‘ ­E0Ѭ€eÖ(×6Hè2mæ×Z[¬Š›~ÝzþwûðÓ"@[¯­—ôW͹ Z7A›è¿«Å}m=£6(êÔ,©@qÁ:ï¤m´VðÓý}hƒ„‚þºKµ››j öiŸÚ ‘ ;·­¶×J:Ê}‚Ú gûщÝ=K@ŸØ™³~¿Ú  O©¹_ÚyIÒ(ÁóåÚ´èD/–¨ ©Ç+̶ץ3Ôm]ÛèýF‹Zû|éÁ' “ï”®ÔÊ3ïôºÚ@ñDÀ³íuoAßsº¬kñ©Pú÷±í’¡Á¬V;‡Õg)lúêü  åOŠ¥èà˹+ç å9x •q `•u¢Í"„WPyÏÁ/à4õGüA̶×E¯Ç³cSD¸‹[[2A]Öµ(•´lr Øžໆöð àÂÞ'*´P¾R,C¥öIq¡1‡éÊ¥Ïs]ÐcdÃm¦ßRŽÑk¯ûï[2Otè nëZ ]«Ò¦-(Þ´ª®-…=oŽ‰0ªní¢Õ•ËÓå«ï ª{ur‰”]éâ ®ºh³tìê[G fî2°êÚëê…\ÅE‡Pu]Öµ&a hS€Ø‚¥ÃjŒl)¬þ:´Ó½”ËçË_4£òL±ˆÞ™A…Œ7¯Â+3 NЩô^((Ó^¿_<t€côìy¤þEë)8ÒjítD÷†7R?LÐ& òär¬bçµãxï_¡ìTˆ’¡cÇ™&{´JÃ}Ôø•=_+Ó¬2?¨ÿ¨±Ã·U.è™ßã58íE^fƒ&vón•†>äIË 9dª>iA×òÝ2!«’óÔµÏðl†Mzæ7[bè ™ß9ç‡ÍÙ"­ÝçÐAu\ˆÕ2ÂgáñšÑ4üù£x.{wÎþ½—áß@ ð³Ð¿‡| gW\+†V^œ8Ìø>(±§êºô4÷™´JÑÂÂბ#]§”=š—Gl•N`#V§÷M¨5••’¶þspQ±PâòãX±§/#œ”ó×%¾MN«¼°Éêïw„ƒ’Š–½ºÂ(š q‘ÃD¤Ç>F9Pb9á´…é±Q_ÀxÜòz±úQÔ4uZ7õtš†ùë¢×Ö–, ¦pÂåêá§i˜¿.z-(0½ÛÝ¥ák¡þº×ÁøqzÆ°îsKJB¯ël¨±Q˜¿.z}rÝ(Q‰šV®®„› †ùëÂsÀ”Ëjšwz¡õå_ôÊô×Mˆ€W&PËŽÕëõrš†úëÞ­N:…«n^P{Uëå¼;;¸7 ó×É©;0›†(SPlj(~ü³A+êùëvVÕ}+,™[ªu×’uEöä€kSAí“Ô¿ J†½Š˜’ öb²þumØqƒ’ öÚ£Gü«à]f5HJ‚ZkPמj3Ì<•5/¾ÇòÛL¬EÓÔµOÒ eåyÆZ ªùëšÉZN‚ºÌØ FH‰H¢bQ öIJY­à%9«¼PØ"ŽöIJ_Â{/ܼTÐβìôEÙÛ— Ú9IéK!s\ØZ0hª³v7}qëTƒïÊœâCŒåÊ9¯µ*´s’² ç»z®8P뚥[ôeŸù’ŠMt!zƒÒÏ8’Šµ¯I}ù\’8®q-ÔÖ>²zœV¹­Z.Ô±´ãF¿']æE*4Ý-Çä·ÌO­r:O‚v…rôk+áC*ô³.õÆJ«Me‘ EËñ §*ûsgš?TÔ9~½ùuÀo7¾ ݙ̠Ãz”σ>x»ñ¢¢2¨=è‰3h )Už‘’PД£WIO Ö÷"6IBAQ`X‘âÆ7ø>±Ô Ý(ÅaZìûgUUA] ²ã@+%.5ŸÝ$4í,Å$-´s)S?lõ)eíJwÅ‚‚åªóÅ®ÿýŠt™Ò]Á .­Hû½áBOâAÝ·^(EPWC+ÒØ€:;Z‘ÆÔ}}æ/Ò~Aéî³€z8õ]:(K¤ûæ qhì2šö¸†Ó#WP˜ÕW¤a"ÝýÉ”«; ®$è‘'nî]*(S¤›Ç¶X–0ø¶Þ,hÐ0°L°VÀú]i@î2ôF¼!"ÝäÜlÞiZƒw±™jΪºxë$vÛ•Ô9D†S{+Ô#Òÿ\û9‘²b `l6‹Ýv-Pâ»+hg´™2îëÒ‘.ÀÛ˜€‚(Úš·ö"¨W—â.Ò‘îøµA/- `Ru‰ñ® :ý©ýw’Ôá"­øAY"Ý18wè0´,€IcDŒwQ•%[w`V"P¯Äó²3†èO¤{Ó çËšôÜñN8'öipEfPàéÜt¨“cëâäÕêõ•x‚ún¼ltƒˆXúoí×c ê 쳋‰è„ïS§‹‰¨¿î¦m•~EºLé® þºÛiúé2¥»r€ú뮣=â“ä¥Hª2œµÉr€Rê.˜å«c•”Rwuß@Y@ir@÷õZL@iu´Ó÷nä¥ zôtR T§©R’[^Y@is·z÷tR ”ª{ìÕÓI%Pïø®™z1‹Q Ô3¾k¥Y^SšäeÈ°Ãü6Ôõ*-7]ç3ÑG"Ð[O¨ÙŒÙ¤ ƒ&Ò1>Ó_$¥†8q™þ"èËVã ‡é/2êÛÆ;¦JÈÊèJq:ÓŒ:õP*PöŒ¦è¤eÌ™%ég­hä šþr»E—,¨4W"ÕŸ½îtVbP¿Á‘3Á¾8g¦dÍ9[zÞ Nž»6’Ç=àxƒN˜ŽÅ 4h6^¬@Á&{”(^  öÔ-”%Ý…¶ðOS´ƒAYÒ] ¹Ÿ¥e÷0ë‘.Ý%Š¸ßG-{]éAÙ=Œ Ê’î"ГëÆ]P¥DÙ¯Ô+Ý%òÜ4¬*Êìa¼U×#Ý%òÜ7á!e@™ó½=pKwMyîõÉ –½® ‰ç•P–t×”çž_V¥1bN¶†ÞüuUeÌ÷ŽWdD½Hcš¡i Aéó½ãJãJ íc Jseˆ%(­Hûé*Jix¯ô'ÒÍ«êv5É šâªy”¬qSIš ò!‹(˜}}J€¦Ã×Õ¨sŽZ¼AGY½Ü ÉèûP¬q“ÕKšèm VõAÁ=^í‘ì  ÍÉ®^zЩ(¸ÇGl.?(sé¢Øò›+Úì1å"6W”‡Ø\ P"Òˆ‚ÓWôQtlú½¼ußVt0Ÿ]ÇM e@§ùÖTÞ4ª *Ö h¨X7. bÝó@쨋U»Ú’¡8h€Xwe—À»¬Úņ»1õ‹uçÁz5ÏWòµAĺèÿñët¾{ƪ  ÖEÿ¯ÕpÕþtJ}б®Þ¬»¸1ʪÚ«X7 }¥¨¼i:Êè ¾ºªæ³{\=ÐÈi·tp@¹˜i+þª”4\Ü'¯Ê%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPVector2D.html0000644000175000017500000011602014030601036024550 0ustar rusconirusconi QCPVector2D Class Reference
Public Functions | Friends | Related Non-Members
QCPVector2D Class Reference

Represents two doubles as a mathematical 2D vector. More...

Public Functions

 QCPVector2D ()
 
 QCPVector2D (double x, double y)
 
 QCPVector2D (const QPoint &point)
 
 QCPVector2D (const QPointF &point)
 
double x () const
 
double y () const
 
double & rx ()
 
double & ry ()
 
void setX (double x)
 
void setY (double y)
 
double length () const
 
double lengthSquared () const
 
double angle () const
 
QPoint toPoint () const
 
QPointF toPointF () const
 
bool isNull () const
 
void normalize ()
 
QCPVector2D normalized () const
 
QCPVector2D perpendicular () const
 
double dot (const QCPVector2D &vec) const
 
double distanceSquaredToLine (const QCPVector2D &start, const QCPVector2D &end) const
 
double distanceSquaredToLine (const QLineF &line) const
 
double distanceToStraightLine (const QCPVector2D &base, const QCPVector2D &direction) const
 
QCPVector2D & operator*= (double factor)
 
QCPVector2D & operator/= (double divisor)
 
QCPVector2D & operator+= (const QCPVector2D &vector)
 
QCPVector2D & operator-= (const QCPVector2D &vector)
 

Friends

const QCPVector2D operator* (double factor, const QCPVector2D &vec)
 
const QCPVector2D operator* (const QCPVector2D &vec, double factor)
 
const QCPVector2D operator/ (const QCPVector2D &vec, double divisor)
 
const QCPVector2D operator+ (const QCPVector2D &vec1, const QCPVector2D &vec2)
 
const QCPVector2D operator- (const QCPVector2D &vec1, const QCPVector2D &vec2)
 
const QCPVector2D operator- (const QCPVector2D &vec)
 

Related Non-Members

(Note that these are not member functions.)

QDebug operator<< (QDebug d, const QCPVector2D &vec)
 

Detailed Description

Represents two doubles as a mathematical 2D vector.

This class acts as a replacement for QVector2D with the advantage of double precision instead of single, and some convenience methods tailored for the QCustomPlot library.

Constructor & Destructor Documentation

§ QCPVector2D() [1/4]

QCPVector2D::QCPVector2D ( )

Creates a QCPVector2D object and initializes the x and y coordinates to 0.

§ QCPVector2D() [2/4]

QCPVector2D::QCPVector2D ( double  x,
double  y 
)

Creates a QCPVector2D object and initializes the x and y coordinates with the specified values.

§ QCPVector2D() [3/4]

QCPVector2D::QCPVector2D ( const QPoint &  point)

Creates a QCPVector2D object and initializes the x and y coordinates respective coordinates of the specified point.

§ QCPVector2D() [4/4]

QCPVector2D::QCPVector2D ( const QPointF &  point)

Creates a QCPVector2D object and initializes the x and y coordinates respective coordinates of the specified point.

Member Function Documentation

§ setX()

void QCPVector2D::setX ( double  x)
inline

Sets the x coordinate of this vector to x.

See also
setY

§ setY()

void QCPVector2D::setY ( double  y)
inline

Sets the y coordinate of this vector to y.

See also
setX

§ length()

double QCPVector2D::length ( ) const
inline

Returns the length of this vector.

See also
lengthSquared

§ lengthSquared()

double QCPVector2D::lengthSquared ( ) const
inline

Returns the squared length of this vector. In some situations, e.g. when just trying to find the shortest vector of a group, this is faster than calculating length, because it avoids calculation of a square root.

See also
length

§ angle()

double QCPVector2D::angle ( ) const
inline

Returns the angle of the vector in radians. The angle is measured between the positive x line and the vector, counter-clockwise in a mathematical coordinate system (y axis upwards positive). In screen/widget coordinates where the y axis is inverted, the angle appears clockwise.

§ toPoint()

QPoint QCPVector2D::toPoint ( ) const
inline

Returns a QPoint which has the x and y coordinates of this vector, truncating any floating point information.

See also
toPointF

§ toPointF()

QPointF QCPVector2D::toPointF ( ) const
inline

Returns a QPointF which has the x and y coordinates of this vector.

See also
toPoint

§ isNull()

bool QCPVector2D::isNull ( ) const
inline

Returns whether this vector is null. A vector is null if qIsNull returns true for both x and y coordinates, i.e. if both are binary equal to 0.

§ normalize()

void QCPVector2D::normalize ( )

Normalizes this vector. After this operation, the length of the vector is equal to 1.

If the vector has both entries set to zero, this method does nothing.

See also
normalized, length, lengthSquared

§ normalized()

QCPVector2D QCPVector2D::normalized ( ) const

Returns a normalized version of this vector. The length of the returned vector is equal to 1.

If the vector has both entries set to zero, this method returns the vector unmodified.

See also
normalize, length, lengthSquared

§ perpendicular()

QCPVector2D QCPVector2D::perpendicular ( ) const
inline

Returns a vector perpendicular to this vector, with the same length.

§ dot()

double QCPVector2D::dot ( const QCPVector2D &  vec) const
inline

Returns the dot/scalar product of this vector with the specified vector vec.

§ distanceSquaredToLine() [1/2]

double QCPVector2D::distanceSquaredToLine ( const QCPVector2D &  start,
const QCPVector2D &  end 
) const

This is an overloaded function.

Returns the squared shortest distance of this vector (interpreted as a point) to the finite line segment given by start and end.

See also
distanceToStraightLine

§ distanceSquaredToLine() [2/2]

double QCPVector2D::distanceSquaredToLine ( const QLineF &  line) const

This is an overloaded function.

Returns the squared shortest distance of this vector (interpreted as a point) to the finite line segment given by line.

See also
distanceToStraightLine

§ distanceToStraightLine()

double QCPVector2D::distanceToStraightLine ( const QCPVector2D &  base,
const QCPVector2D &  direction 
) const

Returns the shortest distance of this vector (interpreted as a point) to the infinite straight line given by a base point and a direction vector.

See also
distanceSquaredToLine

§ operator*=()

QCPVector2D & QCPVector2D::operator*= ( double  factor)

Scales this vector by the given factor, i.e. the x and y components are multiplied by factor.

§ operator/=()

QCPVector2D & QCPVector2D::operator/= ( double  divisor)

Scales this vector by the given divisor, i.e. the x and y components are divided by divisor.

§ operator+=()

QCPVector2D & QCPVector2D::operator+= ( const QCPVector2D &  vector)

Adds the given vector to this vector component-wise.

§ operator-=()

QCPVector2D & QCPVector2D::operator-= ( const QCPVector2D &  vector)

subtracts the given vector from this vector component-wise.

Friends And Related Function Documentation

§ operator<<()

QDebug operator<< ( QDebug  d,
const QCPVector2D &  vec 
)
related

Prints vec in a human readable format to the qDebug output.

The documentation for this class was generated from the following files:
  • src/vector2d.h
  • src/vector2d.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_0.png0000644000175000017500000000346314030601042024413 0ustar rusconirusconi‰PNG  IHDRxƒu‘ûgAMA† 1è–_0PLTEòò÷ÿÿÿ000 hhhNN[˜˜ŸèèêÒÒÕÖÖå$$Z 7*bb“5ˆ+tRNS³Ž:PbKGDÿ-Þ pHYsHHFÉk>IDATxÚíœAh#UÇ·ÈêIš·ä¥MzèÁÍBËRP!ÐYí­¯ÎkÓöbÄn¡)QX‘ «\ÖÖ†Ö½å`e½¬=ì­àEðb[KˆÅW(/Î+ >øùð Zqßñìa”óØÀ[«· iûÓÍ– ÛdÞQFXÖðÞ@Û÷>ø¼MÒŒ¨ ¸0Þ8¸y›r†ðp ,·X$³Ý$|~Š<õj-zøy’c8¼‘¿|c–H›"ÂãÈgÞµÈL ÝdÚŒ]!¯¯—b/s>Í9ð­Q‘6o5à˜,Z£\ŽüβcÑÃÿ—6b¦Òɪäl™H¾†ÁÆ Þ›°.üj^ÂOx™Øë2m–·á`Ú¾wQÂÇ%m¼R)ᇸ Ÿg˜óÖ´ØÈ-ÚxÐâÏÇkÂ’_ %ÞwØ>Oàø'ž{6ÎCX4ðN ½¼Ww'BØ@$ðh©Gõ‡ïï( e~ë¦süΚ¢`fá¿ÙsWÎ$ü}@ÿKe@sðƒ{Ϋ i>ûñ¾óݪê¨FàG À ¨k>‡è5‘µÃ+,ë¦á•–u³ðŠËºIxåeÝ<”õCÅeݼž²n^WYןõ`õ•umð·ä+–õƒ#èÊàwŸðEoY×?ê8¿é/ëzàSuÇ9Ö_ÖµÀg÷4³£® þ¶`×}GÒ¿+Ø“Hà·Cª_$»ÐÂ,­Fiã³eo…”¿¸ð¿4ka–™Q"µñ™-áC_¾¯ïÜÜ«IÈNð¥nƒukªà…­õ3üé |·ð´ë ³˜:ø6RÂÚuÔ _æ+ðÖYT Û xß9P¡hì‶Š¤Ø™Ú;i©M±ßÜQ|º¸ekòiÔadfÚÃgËþ-²áöëùLÝYiß»Ô=ŸNð´ Ð'YÑ æ3o@p£W¦¥¹ðëÈi-üú¥‰ ¿ QhJWá7#ÇÕTøM ¡µ~ƒtõ…ߨøPqá7üµ µ…ßø^Tþþ¿ºÂoÞ'¹yÉù9´ØÆ,|“äæZh±aø’ºX |žà’›XÁ÷ ¹ñ‰mb߃äÆ/ð‰|/’t¹L®Ãá¼-¤>ù©há{‘Ü Ëg¯¼‡Á¥>cWbß…äÏ&ÇkpPê³ó Zø^$7è’"-øA©OÔð=Hn„KubN£Ô'ê´éAr#\–ÈÛ¥>QOØ0’O)Û;ìy…÷,Oàøþxµb³ð*%7“¦áÕ[ŸÀŸ^¹pÍ ý ÏÝ&¿ƒu%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPFinancial.html0000644000175000017500000037331514030601040025013 0ustar rusconirusconi QCPFinancial Class Reference
Public Types | Public Functions | Static Public Functions | Protected Functions
QCPFinancial Class Reference

A plottable representing a financial stock chart. More...

Inheritance diagram for QCPFinancial:
Inheritance graph

Public Types

enum  WidthType
 
enum  ChartStyle
 

Public Functions

 QCPFinancial (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QSharedPointer< QCPFinancialDataContainer > data () const
 
ChartStyle chartStyle () const
 
double width () const
 
WidthType widthType () const
 
bool twoColored () const
 
QBrush brushPositive () const
 
QBrush brushNegative () const
 
QPen penPositive () const
 
QPen penNegative () const
 
void setData (QSharedPointer< QCPFinancialDataContainer > data)
 
void setData (const QVector< double > &keys, const QVector< double > &open, const QVector< double > &high, const QVector< double > &low, const QVector< double > &close, bool alreadySorted=false)
 
void setChartStyle (ChartStyle style)
 
void setWidth (double width)
 
void setWidthType (WidthType widthType)
 
void setTwoColored (bool twoColored)
 
void setBrushPositive (const QBrush &brush)
 
void setBrushNegative (const QBrush &brush)
 
void setPenPositive (const QPen &pen)
 
void setPenNegative (const QPen &pen)
 
void addData (const QVector< double > &keys, const QVector< double > &open, const QVector< double > &high, const QVector< double > &low, const QVector< double > &close, bool alreadySorted=false)
 
void addData (double key, double open, double high, double low, double close)
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
- Public Functions inherited from QCPAbstractPlottable1D< QCPFinancialData >
 QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual QPointF dataPixelPosition (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Static Public Functions

static QCPFinancialDataContainer timeSeriesToOhlc (const QVector< double > &time, const QVector< double > &value, double timeBinSize, double timeBinOffset=0)
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
void drawOhlcPlot (QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected)
 
void drawCandlestickPlot (QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected)
 
double getPixelWidth (double key, double keyPixel) const
 
double ohlcSelectTest (const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const
 
double candlestickSelectTest (const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const
 
void getVisibleDataBounds (QCPFinancialDataContainer::const_iterator &begin, QCPFinancialDataContainer::const_iterator &end) const
 
QRectF selectionHitBox (QCPFinancialDataContainer::const_iterator it) const
 
- Protected Functions inherited from QCPAbstractPlottable1D< QCPFinancialData >
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A plottable representing a financial stock chart.

QCPFinancial.png

This plottable represents time series data binned to certain intervals, mainly used for stock charts. The two common representations OHLC (Open-High-Low-Close) bars and Candlesticks can be set via setChartStyle.

The data is passed via setData as a set of open/high/low/close values at certain keys (typically times). This means the data must be already binned appropriately. If data is only available as a series of values (e.g. price against time), you can use the static convenience function timeSeriesToOhlc to generate binned OHLC-data which can then be passed to setData.

The width of the OHLC bars/candlesticks can be controlled with setWidth and setWidthType. A typical choice is to set the width type to wtPlotCoords (the default) and the width to (or slightly less than) one time bin interval width.

Changing the appearance

Charts can be either single- or two-colored (setTwoColored). If set to be single-colored, lines are drawn with the plottable's pen (setPen) and fills with the brush (setBrush).

If set to two-colored, positive changes of the value during an interval (close >= open) are represented with a different pen and brush than negative changes (close < open). These can be configured with setPenPositive, setPenNegative, setBrushPositive, and setBrushNegative. In two-colored mode, the normal plottable pen/brush is ignored. Upon selection however, the normal selected pen/brush (provided by the selectionDecorator) is used, irrespective of whether the chart is single- or two-colored.

Usage

Like all data representing objects in QCustomPlot, the QCPFinancial is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.)

Usually, you first create an instance:

QCPFinancial *newFinancial = new QCPFinancial(customPlot->xAxis, customPlot->yAxis);

which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.:

newFinancial->setName("Stock prices");
newFinancial->data()->set(QCPFinancial::timeSeriesToOhlc(time, price, 3600*24));
newFinancial->setChartStyle(QCPFinancial::csCandlestick);

Here we have used the static helper method timeSeriesToOhlc, to turn a time-price data series into a 24-hour binned open-high-low-close data series as QCPFinancial uses.

Member Enumeration Documentation

§ WidthType

enum QCPFinancial::WidthType

Defines the ways the width of the financial bar can be specified. Thus it defines what the number passed to setWidth actually means.

See also
setWidthType, setWidth
Enumerator
wtAbsolute 

width is in absolute pixels

wtAxisRectRatio 

width is given by a fraction of the axis rect size

wtPlotCoords 

width is in key coordinates and thus scales with the key axis range

§ ChartStyle

enum QCPFinancial::ChartStyle

Defines the possible representations of OHLC data in the plot.

See also
setChartStyle
Enumerator
csOhlc 

Open-High-Low-Close bar representation.

csCandlestick 

Candlestick representation.

Constructor & Destructor Documentation

§ QCPFinancial()

QCPFinancial::QCPFinancial ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs a financial chart which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

The created QCPFinancial is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPFinancial, so do not delete it manually but use QCustomPlot::removePlottable() instead.

Member Function Documentation

§ data()

QCPFinancialDataContainer * QCPFinancial::data ( ) const
inline

Returns a pointer to the internal data storage of type QCPFinancialDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular setData or addData methods, in certain situations.

§ setData() [1/2]

void QCPFinancial::setData ( QSharedPointer< QCPFinancialDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPFinancials may share the same data container safely. Modifying the data in the container will then affect all financials that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

financial2->setData(financial1->data()); // financial1 and financial2 now share data container

If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the financial's data container directly:

financial2->data()->set(*financial1->data()); // financial2 now has copy of financial1's data in its container
See also
addData, timeSeriesToOhlc

§ setData() [2/2]

void QCPFinancial::setData ( const QVector< double > &  keys,
const QVector< double > &  open,
const QVector< double > &  high,
const QVector< double > &  low,
const QVector< double > &  close,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data with the provided points in keys, open, high, low and close. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

See also
addData, timeSeriesToOhlc

§ setChartStyle()

void QCPFinancial::setChartStyle ( QCPFinancial::ChartStyle  style)

Sets which representation style shall be used to display the OHLC data.

§ setWidth()

void QCPFinancial::setWidth ( double  width)

Sets the width of the individual bars/candlesticks to width in plot key coordinates.

A typical choice is to set it to (or slightly less than) one bin interval width.

§ setWidthType()

void QCPFinancial::setWidthType ( QCPFinancial::WidthType  widthType)

Sets how the width of the financial bars is defined. See the documentation of WidthType for an explanation of the possible values for widthType.

The default value is wtPlotCoords.

See also
setWidth

§ setTwoColored()

void QCPFinancial::setTwoColored ( bool  twoColored)

Sets whether this chart shall contrast positive from negative trends per data point by using two separate colors to draw the respective bars/candlesticks.

If twoColored is false, the normal plottable's pen and brush are used (setPen, setBrush).

See also
setPenPositive, setPenNegative, setBrushPositive, setBrushNegative

§ setBrushPositive()

void QCPFinancial::setBrushPositive ( const QBrush &  brush)

If setTwoColored is set to true, this function controls the brush that is used to draw fills of data points with a positive trend (i.e. bars/candlesticks with close >= open).

If twoColored is false, the normal plottable's pen and brush are used (setPen, setBrush).

See also
setBrushNegative, setPenPositive, setPenNegative

§ setBrushNegative()

void QCPFinancial::setBrushNegative ( const QBrush &  brush)

If setTwoColored is set to true, this function controls the brush that is used to draw fills of data points with a negative trend (i.e. bars/candlesticks with close < open).

If twoColored is false, the normal plottable's pen and brush are used (setPen, setBrush).

See also
setBrushPositive, setPenNegative, setPenPositive

§ setPenPositive()

void QCPFinancial::setPenPositive ( const QPen &  pen)

If setTwoColored is set to true, this function controls the pen that is used to draw outlines of data points with a positive trend (i.e. bars/candlesticks with close >= open).

If twoColored is false, the normal plottable's pen and brush are used (setPen, setBrush).

See also
setPenNegative, setBrushPositive, setBrushNegative

§ setPenNegative()

void QCPFinancial::setPenNegative ( const QPen &  pen)

If setTwoColored is set to true, this function controls the pen that is used to draw outlines of data points with a negative trend (i.e. bars/candlesticks with close < open).

If twoColored is false, the normal plottable's pen and brush are used (setPen, setBrush).

See also
setPenPositive, setBrushNegative, setBrushPositive

§ addData() [1/2]

void QCPFinancial::addData ( const QVector< double > &  keys,
const QVector< double > &  open,
const QVector< double > &  high,
const QVector< double > &  low,
const QVector< double > &  close,
bool  alreadySorted = false 
)

This is an overloaded function.

Adds the provided points in keys, open, high, low and close to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

See also
timeSeriesToOhlc

§ addData() [2/2]

void QCPFinancial::addData ( double  key,
double  open,
double  high,
double  low,
double  close 
)

This is an overloaded function.

Adds the provided data point as key, open, high, low and close to the current data.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

See also
timeSeriesToOhlc

§ selectTestRect()

QCPDataSelection QCPFinancial::selectTestRect ( const QRectF &  rect,
bool  onlySelectable 
) const
virtual

Returns a data selection containing all the data points of this plottable which are contained (or hit by) rect. This is used mainly in the selection rect interaction for data selection (data selection mechanism).

If onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not selectable (i.e. if QCPAbstractPlottable::setSelectable is QCP::stNone).

Note
rect must be a normalized rect (positive or zero width and height). This is especially important when using the rect of QCPSelectionRect::accepted, which is not necessarily normalized. Use QRect::normalized() when passing a rect which might not be normalized.

Reimplemented from QCPAbstractPlottable1D< QCPFinancialData >.

§ selectTest()

double QCPFinancial::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a selectTest specific to this plottable's point geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation. QCPAbstractPlottable::selectTest

Reimplemented from QCPAbstractPlottable1D< QCPFinancialData >.

§ getKeyRange()

QCPRange QCPFinancial::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPFinancial::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ timeSeriesToOhlc()

QCPFinancialDataContainer QCPFinancial::timeSeriesToOhlc ( const QVector< double > &  time,
const QVector< double > &  value,
double  timeBinSize,
double  timeBinOffset = 0 
)
static

A convenience function that converts time series data (value against time) to OHLC binned data points. The return value can then be passed on to QCPFinancialDataContainer::set(const QCPFinancialDataContainer&).

The size of the bins can be controlled with timeBinSize in the same units as time is given. For example, if the unit of time is seconds and single OHLC/Candlesticks should span an hour each, set timeBinSize to 3600.

timeBinOffset allows to control precisely at what time coordinate a bin should start. The value passed as timeBinOffset doesn't need to be in the range encompassed by the time keys. It merely defines the mathematical offset/phase of the bins that will be used to process the data.

§ draw()

void QCPFinancial::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPFinancial::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

§ drawOhlcPlot()

void QCPFinancial::drawOhlcPlot ( QCPPainter *  painter,
const QCPFinancialDataContainer::const_iterator &  begin,
const QCPFinancialDataContainer::const_iterator &  end,
bool  isSelected 
)
protected

Draws the data from begin to end-1 as OHLC bars with the provided painter.

This method is a helper function for draw. It is used when the chart style is csOhlc.

§ drawCandlestickPlot()

void QCPFinancial::drawCandlestickPlot ( QCPPainter *  painter,
const QCPFinancialDataContainer::const_iterator &  begin,
const QCPFinancialDataContainer::const_iterator &  end,
bool  isSelected 
)
protected

Draws the data from begin to end-1 as Candlesticks with the provided painter.

This method is a helper function for draw. It is used when the chart style is csCandlestick.

§ getPixelWidth()

double QCPFinancial::getPixelWidth ( double  key,
double  keyPixel 
) const
protected

This function is used to determine the width of the bar at coordinate key, according to the specified width (setWidth) and width type (setWidthType). Provide the pixel position of key in keyPixel (because usually this was already calculated via QCPAxis::coordToPixel when this function is called).

It returns the number of pixels the bar extends to higher keys, relative to the key coordinate. So with a non-reversed horizontal axis, the return value is positive. With a reversed horizontal axis, the return value is negative. This is important so the open/close flags on the csOhlc bar are drawn to the correct side.

§ ohlcSelectTest()

double QCPFinancial::ohlcSelectTest ( const QPointF &  pos,
const QCPFinancialDataContainer::const_iterator &  begin,
const QCPFinancialDataContainer::const_iterator &  end,
QCPFinancialDataContainer::const_iterator &  closestDataPoint 
) const
protected

This method is a helper function for selectTest. It is used to test for selection when the chart style is csOhlc. It only tests against the data points between begin and end.

Like selectTest, this method returns the shortest distance of pos to the graphical representation of the plottable, and closestDataPoint will point to the respective data point.

§ candlestickSelectTest()

double QCPFinancial::candlestickSelectTest ( const QPointF &  pos,
const QCPFinancialDataContainer::const_iterator &  begin,
const QCPFinancialDataContainer::const_iterator &  end,
QCPFinancialDataContainer::const_iterator &  closestDataPoint 
) const
protected

This method is a helper function for selectTest. It is used to test for selection when the chart style is csCandlestick. It only tests against the data points between begin and end.

Like selectTest, this method returns the shortest distance of pos to the graphical representation of the plottable, and closestDataPoint will point to the respective data point.

§ getVisibleDataBounds()

void QCPFinancial::getVisibleDataBounds ( QCPFinancialDataContainer::const_iterator &  begin,
QCPFinancialDataContainer::const_iterator &  end 
) const
protected

called by the drawing methods to determine which data (key) range is visible at the current key axis range setting, so only that needs to be processed.

begin returns an iterator to the lowest data point that needs to be taken into account when plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, begin may still be just outside the visible range.

end returns the iterator just above the highest data point that needs to be taken into account. Same as before, end may also lie just outside of the visible range

if the plottable contains no data, both begin and end point to constEnd.

§ selectionHitBox()

QRectF QCPFinancial::selectionHitBox ( QCPFinancialDataContainer::const_iterator  it) const
protected

Returns the hit box in pixel coordinates that will be used for data selection with the selection rect (selectTestRect), of the data point given by it.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_z.html0000644000175000017500000000212614030601037025104 0ustar rusconirusconi Data Fields - Functions
 

- z -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorMap-interpolate.png0000644000175000017500000002305514030601040025752 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_ýPLTEÿÿÿÿÞsNÀøæÐa?±ìÿÿÿÿê°RÄ|_Îê‹ tÛÿÿïôý˜+&äÿÿüì¦25¦ðþùÕl ^Ì0/ WoÕûâ¢TP´îG[. ] )nÆöÿO©n¸rùÿÿW <”éýýç–üæŒ$æòê:¨ïþ +iÓÿÿÕlFµŸ±ß‹"%*–ê)ôÚn¹õÿÙöÿƒ2=úÔöÿü Gzývþrþlþjýcý[üWÿSúQÿMúIüEúAù<ú:ú6ø2ö-õ*ô&ô"ôòîíêêêå åâÝÚÕÒÍÉÅÁ½º¶²±­ª¥¢š–’ŽŠ…‚}zvqliea\WQMIF@5-! }þ‚þ6ö"òï Ý Ù¯ˆÿ†þ:ö%ò Õ“““Žþ!ïëæ Ñ’þ áÌ«–þœÿšþ)ò Ý Ù¢ÿ$ï Ö«ÿ¦ÿ®ÿéÿÔÿà²ÿã¹ÿµÿsú½ÿÅÿÁÿËÿÑÿÛÿãÿ ãþ ÛþËÿ ìÿ ÓÿÄÿìþåþîþóþ@ÿÿ-ÿÿ ÿÿ#ôþ)öþEý5ýþ2þþ+üý#üÿôÿ ôÿ8úÿüÿúÿôÿ=þÿ:ÿÿÿÿ ûþEþþIþþMþþUþþQþþ\þþcþþiÿÿªÿÿˆÿÿísÿÿmÿÿ|ÿÿƒÿÿŽÿÿ”ÿÿ£ÿÿœÿÿ´ÿÿ®ÿÿ»ÿÿÃÿÿÌÿÿÉÿÿ éÆÿ¶~.bKGDˆH pHYsÃÃÇo¨d"WIDATxÚíy˜•Å•Æ[+ 1q"®!.If”ÉhL¢F‚:˜Ì€˜4[„Dv‘Uâ‚Ü0ˆ¨ˆ6 ƒ¶6²/aQön@$GQÔp:“™gê,Uuª¾º}?ÄH߶Î?DîÕ§+¿~ßsªêTUYYŠ)R¤H‘ⳋýöÿ¾þöÕ¿x€úÒuöÿ„ƒ44?^ÙA_>8×ýïÕþoíûøFø•¯òOáWêPôµCñÿ<ìð#r Ðÿ^íÿVˆ½á‘GýJ à~û½qÃo|”RÇ{Üêøoêõ[¿ýEøëþ—2ýW'œx þéjÐX59âHñ=Ÿþ§ïÐ×…Ñ65ŸÔ•ø4FxüÁø <ì»Jýë÷ÊêÐ(q€=äß?ú¤“(;éä¿ßà”ì×ø‡ßü¾þëF'¬ÿúÄFÇ5>~;øȯüèTñ=ý€¯3B÷I‰½!ª>Ð_9íôùãFui”4À#´á ~ð3š}~Õöküp ý×_ûêÍ¿§?=ôLòÓN?K|¯Ì Ô_g„î“:{=Bc¤úýgœpâÙeeui”d3_0©#±×#„üþÊOnzæGÔ¡Qâ¬éLàÏ4lrìq'+õ³Øf¾ÞPA½v2×k?=\ýÇ·þó¬ƒÜ÷è¿Ðä;øËÙ aÃê±ÛOêFìý!¹°¡:áгËêØ( D]I×i„i€ŸßÖû~F˜"EŠ= …ѲĹ­!Î;？ëø…Žòò6mÚ¶m×®}ûö:üòüó;vìÔ©Ó¯~õë__pAçλtéÚµk·nݺwïѳgÏ /ìÕ뢋.êÝ»wŸ¾ýúõpñ%—þæ²Ë^qåUW]=èšk;xðuC®:lØ 7ÞtÓÍ· ~ëï~7bÄm·¼}Ô¨;Î9ç”;ïlÑâ®»š7kÖlôèãuÑ„ãn'¸È=Æ1­£Ñ>]¢Ñ;×FcD,FGãîX䣺‡×²¥#))–#Åv@±Ã/ â½À VTt;V3ì {ö†zPãÆ÷%„Èð¾+¯ºZ0Ê o~+@†ñ”Sˆas`X¢d„clÔK„÷? #Ãчè¤Ø N¸÷^â'VTŒ†Ý,Câ¸ñ“ú;†á7Ý|33qÛÈ@ˆ¤ÄÑ!ÄÇÿú ¬}ŒjòäÉ÷ߟáH™¢ØÆ2œÀ 5ĉ+|>Ô VC@8éვ²kax[–aQRôA&„ê‘G™Œáƒ­%ÄŽÁK+X‡–aÕ¸ñã'=*^ï—:D3Í@<>Ñ’LFª¦Nú†áx?r-bZ”RôZ3í Bt b•Ç½ô>ÁpÈÐ C“b?u‘T¨¦M›>}úTÒꑤfÅ6±B$3ˆMœ^:Öxi% œ1s椇Ã˯€¢fÐ5Q3t…é-ÀЙ©¢£(ý4K2!ÔÕö¬i>I¤èüÔ*"DÍÐQ3œ-bÏ ‰áÁŠÃ0ZÔ8!F! Š‚d#Uª´ÞܹóæÍ›¥ÃpœŽAŒd¨žC7íÈSÄ ¨éY©Θ9ÇêâåŽaPÔX3!ˆ?Íp<&©°LÍŸ?b´z$)>H1¢«j³ ±;™)2d/µBôúf*!Þ³RdŠÉ<ØXi±(F”ëï£qM,nŽÆ±ha£ÂE:æÏ÷AÎŒS…ŸRiӚݴ7¿ †Ù„È…éâÅ€pŽcˆÑLMBô…(ÜTCŒù)…™ÇHKa‘á-Y²Tƒœk@‚§“¡:)>þ¸'D³XÓéÞ ¨3ÕC>ê5Ä0"Úi$)6k&HŤBõ„Ž%K¤ä<”âT_ŠÌÐˈh¦AB3%†ârS˜å?š5S#Ä8DGÑq´$B]­-[¶\‡# (ç#Eë§,EÍ0*Dg¦\˜v#„†¡†8`-ÕD !:7iýT$E¢èƒÌc¤J•6Â"Ã[±l‚t’\bd?µ¥Ík¦¾åìÂÍòbBœ¤!öï? ع…èC´Rô’"…$™T¨VêXáqDAˆžAˆ¦¬Á·¶ÖL'x )!:†ã5Äþ´ìE¢"Jˆh§q?m!HÆ„P­ZƒX)HÊåLq®•"PÔ9qÌ]›êù 7¡¨2µ ¶.ºv¥b¥†X³‹qãÇï×/Ø~D•©qÓ¢õÓQÂOGK2‘–:²b)’ŒQ‹Ñù)—6“±®B„ý NˆF‡PÔà²7ê°&ˆUUãtŒïK[ˆh¦¢2Í@4ÕiÄO GGò®¤Bµc•$I#1%Þƒ“Dg¦¸hj×LÉK1!C=ÇÇSØîÓ^L{d¦FˆYˆQ?5 É¢Ãû\ \°`u@0"Ck§¢5Ó–­ìbLˆÄþ“Ý®¤ €ØW2ÄÊÔT5Nˆâðˆï`Œd2R,¸×¬Yƒ««-Ä•5FˆK–.²•ÍtÏL[3C7CtûOfÅTêP'DªKÉKC6Ó¸›º9cô8æQa©O*Š¨píÚ5.ª9V-\· ’ÅÃ7ÓÖ"!"à .!ŠUo«CØÊ· Ý^~ífê q”ãÈ “‘j„kc×ÚšeëIˆ¤Db3Ó6/u:t ix€¿ eÔ¦"„òœd¤„P2\c®«1Y‰´`SÀLyr! S르“‘.L¡£Æ1Äm`,j $ÄâÈ‘I…êIŽ 6 Äõëyùm颈™’ÛX†&x«Þ´èmtˆ2|Øî>]Î=5µ$D¢Á(@&„!Qä𲟠=35 qr1!d(tX5ƒÊm`m¦±„è ‘!Ed2R]­=¥h!"E(l`š¸(’…i’ß±S§ÐK{ˆŽšIÞ.pD¦‡û(BõÌ3›d8’l©<ÍX]M ™)5>ì—ö¨\ì3`[j2 QB´R$Œ>Éd¤!GÀÑB4\ ÷ši¾W˜ò‚i° Ì݉ C‚Ý0-5™„È]N)2GdR!ŸÌpd1†:À–†â a¦³B†´qѾýðRÒa•ÙȧnŒ‹#K5!D¢È=’ù&:ê/ÂgŸ}î¹ç6oÞüŒˆç Ä-[·Š«3f:-ԡض^Êm=h_4cpGÍ%™Ù…€((2G‡R³LFª¶mÛö,b|î¹?n6ñÌóÏozbûvb¨ãÅ_\ B” Qˆ!Ãò0ú:D/åfŒI“úõ§ÄÀLD)EÂè@Êd¤jÇŽ—^z (G@|^0|ùå—·oß¾SÇÓO3C‚è*ÓL>,玙EMÃÍ3 c<žÉ­{kˆ)2GfB¨‡·cb|é%«FÀÈ _¦Ø ƒÚé1tf*¶Æ|XÞÖ­µñÞSœÉç#ˆ´Pƒ5!üd }ˆ!Èd¤ê•W`h!F=.¡C†¸S'Åka #†~MósÁÐìr_[D‡áÅnÙt( J?…ê“L*T¯¾úÊ+„Qrˆ!B=Á¨öÂ’)2ë4åÖJ±Ãôµ¹²±mü$#ÃKí²72”nÊJŒPLuµýÚk¯:ŽŒ"D)DB¸Üj˜áRšäë9þbÍ[”4Áôð!êM\L5 !œdeh· 24-Æê3t5¤BõÞ{z ŒbVˆ–áîÇX°ÚläGfø™fšÈ&>ÝA[ê+Sç¦â A$RLÕûï¿ÿžÅè\õ)D3½†´™Ïý p#¥ÏprÈÐ?ôämâ Ò*Ö! ±¿…˜)M¯6Çd¤ºà~ÿ}Â(åhÊé2Üô7dØŽÜ>,¸JÓÆ+Kͦ…iˆêI§-œ©Ã/kDi*(2Æ|½3¥°ˆ ?øà Gƒ‘Ì4̈<¹ †[±§†rYê¢Dƒp|ÓÂÞÉÎ+m¦z1úð綬¹ê*Kòê<ë*,‚ð>`ŠF!DËÐx)÷ÔPCÍZ²tžÝ< û½=üμ‡ß½û[R‡ãl?M‘EYóh€±¨ÉÔ„ŇÑáŽÛ@†›ÝZ›A¸Ú"ôdèÏ,:ˆ#Oîi„½G˜T¨>üè#I‘!îæiþ«Àö.6o¦æ6ÓÙ&òÚTQÑxÏïh)™ÈWbtïÞ³§¹ Ú2„K†¢ u8ŠŒ1!T~…èY©\B–aáÛ§_ÔIÂÊš†¾ï»( 1&#ÕÕZ "Zi˜­ )n§l¸VÌ+ÜM!ÞkzwÛŠŽ— ¥uE1U¤ê¯:>dŠ¢°R!Ép“«hD=óÄÒ˜ Ýü^\ˆá_mdˆÍ4ÐÕÖ×Óáoìüð",uAøñÇ¢¡È:Ì0Ü&²!¥k¬©¶çÖægZNêï:!B)CBˆ‰ÞÌ‚ç‡E‘“‘j„Qˆží'²¢Á¹ášêjèJôN­*hî ÎYt³‘a•”aÿÌbb¼ÂaÔ“ ÕßþþwAÑ@Ô ß{3[ÒXr6ܾs'·–®«Y±>tÒ1‘‚&ܱ„¸Ü]™~R„§þÍAJVjK)Ãç ávFX½®¦†oSÈôBµmgN¬QQÚÙ¶èw÷Óao€8ʙť–¡õSN‹yŒÔýÏ¿Ecw,^ŽÆÜX´Íߎñ¿Ñ¸$—Ù(2¼SOAü ZÒÄdh®¬Y_ØI afj(Ò{]UxUÛ¸q},CojbÔó¨°Ôæ9"ÊEN̦C`øÊ+R†’!ô$:'fÛÙ²‡ S”Z„Z†—†–"{jî#¢õá!‡rjV‰op: f‡,Ã?ÆdXST†Ây…‡dØ« ŸÐ± ƒÙaa2RÕ¨Q âG^:t E6d„Û BÍP ¦†aG!¥=Â*B”4TÓ„5Åd¤!0”ÑN•J†±l¸Å!\ï² w|›ºÙ䶡!> ƒthZŠŒ1!TØÈQ´?üð£HIãgCìÒÇs!Bîf+ङ7-,à ù%`ÀÈ ƒ©Ea2RÐB”JtéЛá‡ÙŽ;ÅeèM ÍMñßÇIRIbL*„á5ýY"êPZ©)ib2„£2F´]ûØ[kÝìJ©f¨ã"fØ;V– Š¿É3¼ÏB¥á2'j!z ßå~¶(%„öÈI]?¢Y¡q2Üs„yŒTYˆ¥‰°Èðš6mz Ð!gDFø/Cã¤Ø‚Á5Ch ®Ž;)N ù௸SÈmÞW° »¿õÖ[ÌÆÄ ]YJ%Mˆ1©0!L볧“ éød°ÐÑ´Wý냂S¾5ëý‡)CÝw§|1ê/B™Åa{oFhîKÀóŸü ö>;k_ê*,2¼(Àø1m+Âè‘ëj½ÐRÞx!n-A„}ò#¬ 7^tŒÆgxusPqñLìî ˜áêê…piÉÝ;3ÑÝ;Sò—–ìs„µÞþda$òÕApû“öÑ=¾ý)ßÕAÞíÀuôö§4Â"ˌܔ¹üÉ^ൺúÞÁöi\à•T¨¢ Ýfé³—×èÕ˜;eñBÒ‚>j~¦7!Ös„J\*ë.$Í”2áÕOæ2Ë _fÙ*â£Þ}¤cM9ZBqâ'¾ô}™å>6ÒÀìŒnçÞVû­ÀKâ>¿Ø¹>Ý ¼Uè9¨¸œ»ÀýêÁ5ˆ[k¹›ûÜÂ"ÌÞÍÝË>í›î)Â(Àì=–|'°¼!KžòãWs׳ò÷±‘zj_ªˆ]Ì-.È7ïTè1™÷b¢Oàùäg7 ëÉ;ûX…R}â½ßE­ù¹˜-ˆp-¿4RËË[{òZ ì£AÿŘœ¯ÅÔs„ʽÚô¦xµ)  H6my’ü™ÐÒ7x;-|³ilæͦ™Ñ7›üGa³¯6å1Òz^‘ÆÞÜŠJ/V7/§ÑÓÚæå´ Ž©åk£v«žf^Ý“‰+ÅËiÁxI…êÍè†Q ‚ø%$‚‘›Z~)ÆÄ÷ {Š÷ ‰à€Á+Á̆ ¡òÄÇïˆîr‹j\Çdº(Ý”°–gÓÌÃèy/Áº'(gzOÁz+2ÙgD¯‘ψæ1ÒRGXdxB{LoWXˆ º·|ùØêUæá»ÂÖþ–o¥÷þä”Øc¾>ÀkÃ×|“ Uøó.󢶟y>¸Ñ{R_cæ•5/ŠI=•2öE퉵¼¨ýp‚Þ“Úßoë΋Úû¡ß.ï]{? F®[o¢Ũy×¾¶Fò½k/%h†O¢ç{×¾ÔžRò9{Ä÷z â[[Y‚Á“èÙGïÂç´-ÁJ£Añ¬½{þU¢0 §ñAäëÙÁ±9OÇb^4ò·Xtí‹AѸ>7Ø(¢B©=Æ÷Z\‚¸0ê¬Y!V·§/1— ‚^"d‚‹++iWjPô_´‚¼ë†@äA¸cG½F(ÅGø^ÕM!*%ˆ—8Ól‚Ï1­X%ØÚ¼kÀoÚs³EgÞ©÷J‡4( >êIДütä1ÒRGXdxB{LïÜ•ð Ñèø_âì._YW3MkmüŽ§ :WÈD¸¸’·é=]!jðtè&*§=ƒO[¨XŽ!‚›ï×:%‚‹‚†§ }Û–2°=1VŠ[eáA0¨C) 2AžŽ¡CB%ÄÇøvèr,È‚DpçVƒPœ/WF#§ íœÞ×àb»A+ÛRƒ‚d >ÍOG2R]­ x@O;h 4n%]¥mÔœ—]W‚l£œÍ!OƒŒ°í-a" Q PÒÃH©’Ú#|ÚBc܉P¿×¢îL¶g£ò…ëwª0sz/Žïç²ÝjŒðPá&†A$#UâC|ðz½«c¬uð踪¶Lž%ôçôååmÝ9¦à…Y•±‰°/!$e &ðÓ‘ŒTEñÅ$¸óé®ÍÂŒu¬!Aq†;-ºv+ŽP—2ࢱ,(ø ³Qì7´~ ,¢ÂmÛÞsbLÏlÚ´‰&óÛ­µy>РÝäèõ_î!J™ÜoHµ ÙèÀûHƒž-?Ç âFŠ„P=Ëðžq± bãFÞž§N5îtZíKÐM'Æd§¼O/»F!Ä-^êt.ê$èf‚‚Ÿ‡îÆ›(’‘*Ñ3ŸÂ}%ê°°m2¾ƒV™à(aDƒ‹uàþàL·Go$x…‘ èñóÑÝt3ER!ŸtìàSO:‚kÖ,Z úSz×rHëjâVhÜ®$‚3bÑDQ‚€–“»…bøðÜGDë/Â8=pÆ5«m›Œ ¿´9†æ7;UA8g.ªÙ½5QÈ‚ '@ϲøõÖd¤JXçS2ß"X]ô‘:¦‚Õ¥èb겘#7x3&$xÄït$#U\·DùmØÀü°ÅÂtuL­iQf¶k8‚˜çø›Kf>oM-:fáQ$„*ÄÇþ‰ÁøÖA¬\iz,j%Ø.pÑÙ^˨ӠGp  è$˜À‘ŒT ‚T¾~¿•+kjVd+Q °6 FZF¡Gð2žÎ 5‡€hŸ‚ÞŽÛ ’ •C'ñ1@ÔߺšÜÝåí]O‚Ávâø‹×2J.Ší†Vƒv‡>¨D¯³êÌÂÓ1räÈ<ØXi±(F—Xü>×ÄâæhÜ‹6ŠN*"9J€Ë—G¶lU€ ïÒW8 â4h7/‹¦A6QKДðFRÜ~ûíyŒT©ÒFXdx>?žAX€À¯fÙzï y/3Q^Ts'LðóàCVƒ BÜßEe‚³‰f†ôn¿}Ô¨QI…ŠæîkDT{×3¿%KÅš(™h+¯Ë"h³ð\”¯vê »ƒZ„bAæ¾Ì\ÂÔ1A(á=Œ„P­ V ò[Ä·M•Ì´maìU!˜MƒÆDã=x8Îsòi©#,+†0Ë ®ä cÏ Npœ%¨R›Œ#(dbtoC~>=Œ¤B‡põêÕÕvÆ4‰Z€sçz 2ÖDM¯ZЬæÍ&*Í%•ã°ÉDH{ƒ‘RÔd€ŽÁ;爄PWk«)VÙЃ‚yí'Xó`&™ º4è6—hw©ÂíMP¯Ý1Š;ô˜],(Á @©=€‡qWB¨$;„8}z0tä§ L·!¶v5m¿(^¬†;ô—š­¥£Êü$¼waä1ÒRGXdxNx b²ÝŠš«DÅËþãØñ»ØlðÒ…@œ=eL L#X€ÄσwWsˆ¤B%Ø-_Ž³xOÖ0ÚA `°¢fú}Ã„æ ¨k²0w‘XuYP,ì –Ÿ„×¼y3 ¡Z&Ø<]À,=ôñÇM¤­¥ð ŸÙ³ôòö ߃p N} ê*& 0tPä—¡1:©.¸ ;†³x pªè@œ F®ú¥=zKPôXPtuŒÎ‚,A,bÀÐA  ¯ÙhŒ|½3¥°ˆ »ùÈ S l‰Ïó%ˆs oY”oL¯4±Ç‚¶¹õ² • ˜qPäÀ}àž›Í‚á Lò¶íŲÇ´XH‚C$A!A˜uP‹ÏÁ£H*TVx OËoz°U+Zñ%HKj™‹Õ¢ &§¸ÃŸDÐ3QšH pнÜÇØhö±ˆÂêÒ;×FcD,FGãîXœ`£BÝÔ©ïá 8 €çe%ho ºdzÚ.$h»œ  2ÀQwD”ùyðŽi‘ÇHKa‘á)e„Gð4½É¡ƒ’¹Å© IÐîÏk >–¹•Kü?o{× MÔI0 °ãÈW‘–6Â"*´Âcx“á.ë N€ @O‚– {tÂíÐC£S¸Aeí@ç xù–º ‹ ôØ=ðÀ»G ø)—D¹Ž‘—º)tQz>kwÉP%*'שlô$Hü”pÐøš4¹ûnõ©!T¹ª|U.„*ÂÚǨœðÞ=8TWƒª_èjÌÏ‚voÐÞ•ÞCÙ'ì¨ÇbŠYR“ËÚ× QŽ 3Q,DÙCÑA•ï Yx ¡²ÂcxZ~-ƒþœTá’¶8Á“ K("oñRÏç}‚C”_ÈAç¡ì *Î/hB¨˜Bv­T+”ß¹Š¨p=»¼\ÀvíKP±½8¡x6¨ˆ &ˆ°ÿEkjŠ *žªaÃ0 *Ò bULPQ £˜Ÿb€Šé)ñGÑáy!T Îýé!4$CSÞ¡ü“tB5Bþ1Bùìì?ÞíÍ NåCÈÂCv­ÎUç¢üZ+.an ¶i£ ¶ï x&¡ØDìÏw„¸A¯.¤Çx5BÜ WÔb¡Xƒ ª°¹åE³AÅiPQ4ªX€ŠÕç3çð>K>r ,ù(>Æ)R¤H‘"EŠ)R¤H‘"EŠ)R¤H‘"EŠ)òÄÿ¯ѷ¦Ê=¤%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPBars.html0000644000175000017500000033617014030601040024014 0ustar rusconirusconi QCPBars Class Reference
Public Types | Public Functions | Protected Functions | Protected Static Functions
QCPBars Class Reference

A plottable representing a bar chart in a plot. More...

Inheritance diagram for QCPBars:
Inheritance graph

Public Types

enum  WidthType
 

Public Functions

 QCPBars (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
double width () const
 
WidthType widthType () const
 
QCPBarsGroup * barsGroup () const
 
double baseValue () const
 
double stackingGap () const
 
QCPBars * barBelow () const
 
QCPBars * barAbove () const
 
QSharedPointer< QCPBarsDataContainer > data () const
 
void setData (QSharedPointer< QCPBarsDataContainer > data)
 
void setData (const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void setWidth (double width)
 
void setWidthType (WidthType widthType)
 
void setBarsGroup (QCPBarsGroup *barsGroup)
 
void setBaseValue (double baseValue)
 
void setStackingGap (double pixels)
 
void addData (const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void addData (double key, double value)
 
void moveBelow (QCPBars *bars)
 
void moveAbove (QCPBars *bars)
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
virtual QPointF dataPixelPosition (int index) const
 
- Public Functions inherited from QCPAbstractPlottable1D< QCPBarsData >
 QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
void getVisibleDataBounds (QCPBarsDataContainer::const_iterator &begin, QCPBarsDataContainer::const_iterator &end) const
 
QRectF getBarRect (double key, double value) const
 
void getPixelWidth (double key, double &lower, double &upper) const
 
double getStackedBaseValue (double key, bool positive) const
 
- Protected Functions inherited from QCPAbstractPlottable1D< QCPBarsData >
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Protected Static Functions

static void connectBars (QCPBars *lower, QCPBars *upper)
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A plottable representing a bar chart in a plot.

QCPBars.png

To plot data, assign it with the setData or addData functions.

Changing the appearance

The appearance of the bars is determined by the pen and the brush (setPen, setBrush). The width of the individual bars can be controlled with setWidthType and setWidth.

Bar charts are stackable. This means, two QCPBars plottables can be placed on top of each other (see QCPBars::moveAbove). So when two bars are at the same key position, they will appear stacked.

If you would like to group multiple QCPBars plottables together so they appear side by side as shown below, use QCPBarsGroup.

QCPBarsGroup.png

Usage

Like all data representing objects in QCustomPlot, the QCPBars is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.)

Usually, you first create an instance:

QCPBars *newBars = new QCPBars(customPlot->xAxis, customPlot->yAxis);

which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.:

newBars->setName("Country population");
newBars->setData(xData, yData);

Member Enumeration Documentation

§ WidthType

enum QCPBars::WidthType

Defines the ways the width of the bar can be specified. Thus it defines what the number passed to setWidth actually means.

See also
setWidthType, setWidth
Enumerator
wtAbsolute 

Bar width is in absolute pixels.

wtAxisRectRatio 

Bar width is given by a fraction of the axis rect size.

wtPlotCoords 

Bar width is in key coordinates and thus scales with the key axis range.

Constructor & Destructor Documentation

§ QCPBars()

QCPBars::QCPBars ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs a bar chart which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

The created QCPBars is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPBars, so do not delete it manually but use QCustomPlot::removePlottable() instead.

Member Function Documentation

§ barBelow()

QCPBars * QCPBars::barBelow ( ) const
inline

Returns the bars plottable that is directly below this bars plottable. If there is no such plottable, returns nullptr.

See also
barAbove, moveBelow, moveAbove

§ barAbove()

QCPBars * QCPBars::barAbove ( ) const
inline

Returns the bars plottable that is directly above this bars plottable. If there is no such plottable, returns nullptr.

See also
barBelow, moveBelow, moveAbove

§ data()

QSharedPointer< QCPBarsDataContainer > QCPBars::data ( ) const
inline

Returns a shared pointer to the internal data storage of type QCPBarsDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular setData or addData methods.

§ setData() [1/2]

void QCPBars::setData ( QSharedPointer< QCPBarsDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPBars may share the same data container safely. Modifying the data in the container will then affect all bars that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

bars2->setData(bars1->data()); // bars1 and bars2 now share data container

If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the bar's data container directly:

bars2->data()->set(*bars1->data()); // bars2 now has copy of bars1's data in its container
See also
addData

§ setData() [2/2]

void QCPBars::setData ( const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data with the provided points in keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

See also
addData

§ setWidth()

void QCPBars::setWidth ( double  width)

Sets the width of the bars.

How the number passed as width is interpreted (e.g. screen pixels, plot coordinates,...), depends on the currently set width type, see setWidthType and WidthType.

§ setWidthType()

void QCPBars::setWidthType ( QCPBars::WidthType  widthType)

Sets how the width of the bars is defined. See the documentation of WidthType for an explanation of the possible values for widthType.

The default value is wtPlotCoords.

See also
setWidth

§ setBarsGroup()

void QCPBars::setBarsGroup ( QCPBarsGroup *  barsGroup)

Sets to which QCPBarsGroup this QCPBars instance belongs to. Alternatively, you can also use QCPBarsGroup::append.

To remove this QCPBars from any group, set barsGroup to nullptr.

§ setBaseValue()

void QCPBars::setBaseValue ( double  baseValue)

Sets the base value of this bars plottable.

The base value defines where on the value coordinate the bars start. How far the bars extend from the base value is given by their individual value data. For example, if the base value is set to 1, a bar with data value 2 will have its lowest point at value coordinate 1 and highest point at 3.

For stacked bars, only the base value of the bottom-most QCPBars has meaning.

The default base value is 0.

§ setStackingGap()

void QCPBars::setStackingGap ( double  pixels)

If this bars plottable is stacked on top of another bars plottable (moveAbove), this method allows specifying a distance in pixels, by which the drawn bar rectangles will be separated by the bars below it.

§ addData() [1/2]

void QCPBars::addData ( const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Adds the provided points in keys and values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ addData() [2/2]

void QCPBars::addData ( double  key,
double  value 
)

This is an overloaded function. Adds the provided data point as key and value to the current data.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ moveBelow()

void QCPBars::moveBelow ( QCPBars *  bars)

Moves this bars plottable below bars. In other words, the bars of this plottable will appear below the bars of bars. The move target bars must use the same key and value axis as this plottable.

Inserting into and removing from existing bar stacking is handled gracefully. If bars already has a bars object below itself, this bars object is inserted between the two. If this bars object is already between two other bars, the two other bars will be stacked on top of each other after the operation.

To remove this bars plottable from any stacking, set bars to nullptr.

See also
moveBelow, barAbove, barBelow

§ moveAbove()

void QCPBars::moveAbove ( QCPBars *  bars)

Moves this bars plottable above bars. In other words, the bars of this plottable will appear above the bars of bars. The move target bars must use the same key and value axis as this plottable.

Inserting into and removing from existing bar stacking is handled gracefully. If bars already has a bars object above itself, this bars object is inserted between the two. If this bars object is already between two other bars, the two other bars will be stacked on top of each other after the operation.

To remove this bars plottable from any stacking, set bars to nullptr.

See also
moveBelow, barBelow, barAbove

§ selectTestRect()

QCPDataSelection QCPBars::selectTestRect ( const QRectF &  rect,
bool  onlySelectable 
) const
virtual

Returns a data selection containing all the data points of this plottable which are contained (or hit by) rect. This is used mainly in the selection rect interaction for data selection (data selection mechanism).

If onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not selectable (i.e. if QCPAbstractPlottable::setSelectable is QCP::stNone).

Note
rect must be a normalized rect (positive or zero width and height). This is especially important when using the rect of QCPSelectionRect::accepted, which is not necessarily normalized. Use QRect::normalized() when passing a rect which might not be normalized.

Reimplemented from QCPAbstractPlottable1D< QCPBarsData >.

§ selectTest()

double QCPBars::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a selectTest specific to this plottable's point geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation. QCPAbstractPlottable::selectTest

Reimplemented from QCPAbstractPlottable1D< QCPBarsData >.

§ getKeyRange()

QCPRange QCPBars::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPBars::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ dataPixelPosition()

QPointF QCPBars::dataPixelPosition ( int  index) const
virtual

Returns the pixel position on the widget surface at which the data point at the given index appears.

Usually this corresponds to the point of dataMainKey/dataMainValue, in pixel coordinates. However, depending on the plottable, this might be a different apparent position than just a coord-to-pixel transform of those values. For example, QCPBars apparent data values can be shifted depending on their stacking, bar grouping or configured base value.

Reimplemented from QCPAbstractPlottable1D< QCPBarsData >.

§ draw()

void QCPBars::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPBars::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

§ getVisibleDataBounds()

void QCPBars::getVisibleDataBounds ( QCPBarsDataContainer::const_iterator &  begin,
QCPBarsDataContainer::const_iterator &  end 
) const
protected

called by draw to determine which data (key) range is visible at the current key axis range setting, so only that needs to be processed. It also takes into account the bar width.

begin returns an iterator to the lowest data point that needs to be taken into account when plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, lower may still be just outside the visible range.

end returns an iterator one higher than the highest visible data point. Same as before, end may also lie just outside of the visible range.

if the plottable contains no data, both begin and end point to constEnd.

§ getBarRect()

QRectF QCPBars::getBarRect ( double  key,
double  value 
) const
protected

Returns the rect in pixel coordinates of a single bar with the specified key and value. The rect is shifted according to the bar stacking (see moveAbove) and base value (see setBaseValue), and to have non-overlapping border lines with the bars stacked below.

§ getPixelWidth()

void QCPBars::getPixelWidth ( double  key,
double &  lower,
double &  upper 
) const
protected

This function is used to determine the width of the bar at coordinate key, according to the specified width (setWidth) and width type (setWidthType).

The output parameters lower and upper return the number of pixels the bar extends to lower and higher keys, relative to the key coordinate (so with a non-reversed horizontal axis, lower is negative and upper positive).

§ getStackedBaseValue()

double QCPBars::getStackedBaseValue ( double  key,
bool  positive 
) const
protected

This function is called to find at which value to start drawing the base of a bar at key, when it is stacked on top of another QCPBars (e.g. with moveAbove).

positive and negative bars are separated per stack (positive are stacked above baseValue upwards, negative are stacked below baseValue downwards). This can be indicated with positive. So if the bar for which we need the base value is negative, set positive to false.

§ connectBars()

void QCPBars::connectBars ( QCPBars *  lower,
QCPBars *  upper 
)
staticprotected

Connects below and above to each other via their mBarAbove/mBarBelow properties. The bar(s) currently above lower and below upper will become disconnected to lower/upper.

If lower is zero, upper will be disconnected at the bottom. If upper is zero, lower will be disconnected at the top.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/functions_vars.html0000644000175000017500000000331014030601037024567 0ustar rusconirusconi Data Fields - Variables
 
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPColorMapData.html0000644000175000017500000014462514030601036025442 0ustar rusconirusconi QCPColorMapData Class Reference
Public Functions | Protected Functions
QCPColorMapData Class Reference

Holds the two-dimensional data of a QCPColorMap plottable. More...

Public Functions

 QCPColorMapData (int keySize, int valueSize, const QCPRange &keyRange, const QCPRange &valueRange)
 
 QCPColorMapData (const QCPColorMapData &other)
 
QCPColorMapData & operator= (const QCPColorMapData &other)
 
int keySize () const
 
int valueSize () const
 
QCPRange keyRange () const
 
QCPRange valueRange () const
 
QCPRange dataBounds () const
 
double data (double key, double value)
 
double cell (int keyIndex, int valueIndex)
 
unsigned char alpha (int keyIndex, int valueIndex)
 
void setSize (int keySize, int valueSize)
 
void setKeySize (int keySize)
 
void setValueSize (int valueSize)
 
void setRange (const QCPRange &keyRange, const QCPRange &valueRange)
 
void setKeyRange (const QCPRange &keyRange)
 
void setValueRange (const QCPRange &valueRange)
 
void setData (double key, double value, double z)
 
void setCell (int keyIndex, int valueIndex, double z)
 
void setAlpha (int keyIndex, int valueIndex, unsigned char alpha)
 
void recalculateDataBounds ()
 
void clear ()
 
void clearAlpha ()
 
void fill (double z)
 
void fillAlpha (unsigned char alpha)
 
bool isEmpty () const
 
void coordToCell (double key, double value, int *keyIndex, int *valueIndex) const
 
void cellToCoord (int keyIndex, int valueIndex, double *key, double *value) const
 

Protected Functions

bool createAlpha (bool initializeOpaque=true)
 

Detailed Description

Holds the two-dimensional data of a QCPColorMap plottable.

This class is a data storage for QCPColorMap. It holds a two-dimensional array, which QCPColorMap then displays as a 2D image in the plot, where the array values are represented by a color, depending on the value.

The size of the array can be controlled via setSize (or setKeySize, setValueSize). Which plot coordinates these cells correspond to can be configured with setRange (or setKeyRange, setValueRange).

The data cells can be accessed in two ways: They can be directly addressed by an integer index with setCell. This is the fastest method. Alternatively, they can be addressed by their plot coordinate with setData. plot coordinate to cell index transformations and vice versa are provided by the functions coordToCell and cellToCoord.

A QCPColorMapData also holds an on-demand two-dimensional array of alpha values which (if allocated) has the same size as the data map. It can be accessed via setAlpha, fillAlpha and clearAlpha. The memory for the alpha map is only allocated if needed, i.e. on the first call of setAlpha. clearAlpha restores full opacity and frees the alpha map.

This class also buffers the minimum and maximum values that are in the data set, to provide QCPColorMap::rescaleDataRange with the necessary information quickly. Setting a cell to a value that is greater than the current maximum increases this maximum to the new value. However, setting the cell that currently holds the maximum value to a smaller value doesn't decrease the maximum again, because finding the true new maximum would require going through the entire data array, which might be time consuming. The same holds for the data minimum. This functionality is given by recalculateDataBounds, such that you can decide when it is sensible to find the true current minimum and maximum. The method QCPColorMap::rescaleDataRange offers a convenience parameter recalculateDataBounds which may be set to true to automatically call recalculateDataBounds internally.

Constructor & Destructor Documentation

§ QCPColorMapData() [1/2]

QCPColorMapData::QCPColorMapData ( int  keySize,
int  valueSize,
const QCPRange &  keyRange,
const QCPRange &  valueRange 
)

Constructs a new QCPColorMapData instance. The instance has keySize cells in the key direction and valueSize cells in the value direction. These cells will be displayed by the QCPColorMap at the coordinates keyRange and valueRange.

See also
setSize, setKeySize, setValueSize, setRange, setKeyRange, setValueRange

§ QCPColorMapData() [2/2]

QCPColorMapData::QCPColorMapData ( const QCPColorMapData &  other)

Constructs a new QCPColorMapData instance copying the data and range of other.

Member Function Documentation

§ operator=()

QCPColorMapData & QCPColorMapData::operator= ( const QCPColorMapData &  other)

Overwrites this color map data instance with the data stored in other. The alpha map state is transferred, too.

§ alpha()

unsigned char QCPColorMapData::alpha ( int  keyIndex,
int  valueIndex 
)

Returns the alpha map value of the cell with the indices keyIndex and valueIndex.

If this color map data doesn't have an alpha map (because setAlpha was never called after creation or after a call to clearAlpha), returns 255, which corresponds to full opacity.

See also
setAlpha

§ setSize()

void QCPColorMapData::setSize ( int  keySize,
int  valueSize 
)

Resizes the data array to have keySize cells in the key dimension and valueSize cells in the value dimension.

The current data is discarded and the map cells are set to 0, unless the map had already the requested size.

Setting at least one of keySize or valueSize to zero frees the internal data array and isEmpty returns true.

See also
setRange, setKeySize, setValueSize

§ setKeySize()

void QCPColorMapData::setKeySize ( int  keySize)

Resizes the data array to have keySize cells in the key dimension.

The current data is discarded and the map cells are set to 0, unless the map had already the requested size.

Setting keySize to zero frees the internal data array and isEmpty returns true.

See also
setKeyRange, setSize, setValueSize

§ setValueSize()

void QCPColorMapData::setValueSize ( int  valueSize)

Resizes the data array to have valueSize cells in the value dimension.

The current data is discarded and the map cells are set to 0, unless the map had already the requested size.

Setting valueSize to zero frees the internal data array and isEmpty returns true.

See also
setValueRange, setSize, setKeySize

§ setRange()

void QCPColorMapData::setRange ( const QCPRange &  keyRange,
const QCPRange &  valueRange 
)

Sets the coordinate ranges the data shall be distributed over. This defines the rectangular area covered by the color map in plot coordinates.

The outer cells will be centered on the range boundaries given to this function. For example, if the key size (setKeySize) is 3 and keyRange is set to QCPRange(2, 3) there will be cells centered on the key coordinates 2, 2.5 and 3.

See also
setSize

§ setKeyRange()

void QCPColorMapData::setKeyRange ( const QCPRange &  keyRange)

Sets the coordinate range the data shall be distributed over in the key dimension. Together with the value range, This defines the rectangular area covered by the color map in plot coordinates.

The outer cells will be centered on the range boundaries given to this function. For example, if the key size (setKeySize) is 3 and keyRange is set to QCPRange(2, 3) there will be cells centered on the key coordinates 2, 2.5 and 3.

See also
setRange, setValueRange, setSize

§ setValueRange()

void QCPColorMapData::setValueRange ( const QCPRange &  valueRange)

Sets the coordinate range the data shall be distributed over in the value dimension. Together with the key range, This defines the rectangular area covered by the color map in plot coordinates.

The outer cells will be centered on the range boundaries given to this function. For example, if the value size (setValueSize) is 3 and valueRange is set to QCPRange(2, 3) there will be cells centered on the value coordinates 2, 2.5 and 3.

See also
setRange, setKeyRange, setSize

§ setData()

void QCPColorMapData::setData ( double  key,
double  value,
double  z 
)

Sets the data of the cell, which lies at the plot coordinates given by key and value, to z.

Note
The QCPColorMap always displays the data at equal key/value intervals, even if the key or value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, you shouldn't use the QCPColorMapData::setData method as it uses a linear transformation to determine the cell index. Rather directly access the cell index with QCPColorMapData::setCell.
See also
setCell, setRange

§ setCell()

void QCPColorMapData::setCell ( int  keyIndex,
int  valueIndex,
double  z 
)

Sets the data of the cell with indices keyIndex and valueIndex to z. The indices enumerate the cells starting from zero, up to the map's size-1 in the respective dimension (see setSize).

In the standard plot configuration (horizontal key axis and vertical value axis, both not range-reversed), the cell with indices (0, 0) is in the bottom left corner and the cell with indices (keySize-1, valueSize-1) is in the top right corner of the color map.

See also
setData, setSize

§ setAlpha()

void QCPColorMapData::setAlpha ( int  keyIndex,
int  valueIndex,
unsigned char  alpha 
)

Sets the alpha of the color map cell given by keyIndex and valueIndex to alpha. A value of 0 for alpha results in a fully transparent cell, and a value of 255 results in a fully opaque cell.

If an alpha map doesn't exist yet for this color map data, it will be created here. If you wish to restore full opacity and free any allocated memory of the alpha map, call clearAlpha.

Note that the cell-wise alpha which can be configured here is independent of any alpha configured in the color map's gradient (QCPColorGradient). If a cell is affected both by the cell-wise and gradient alpha, the alpha values will be blended accordingly during rendering of the color map.

See also
fillAlpha, clearAlpha

§ recalculateDataBounds()

void QCPColorMapData::recalculateDataBounds ( )

Goes through the data and updates the buffered minimum and maximum data values.

Calling this method is only advised if you are about to call QCPColorMap::rescaleDataRange and can not guarantee that the cells holding the maximum or minimum data haven't been overwritten with a smaller or larger value respectively, since the buffered maximum/minimum values have been updated the last time. Why this is the case is explained in the class description (QCPColorMapData).

Note that the method QCPColorMap::rescaleDataRange provides a parameter recalculateDataBounds for convenience. Setting this to true will call this method for you, before doing the rescale.

§ clear()

void QCPColorMapData::clear ( )

Frees the internal data memory.

This is equivalent to calling setSize(0, 0).

§ clearAlpha()

void QCPColorMapData::clearAlpha ( )

Frees the internal alpha map. The color map will have full opacity again.

§ fill()

void QCPColorMapData::fill ( double  z)

Sets all cells to the value z.

§ fillAlpha()

void QCPColorMapData::fillAlpha ( unsigned char  alpha)

Sets the opacity of all color map cells to alpha. A value of 0 for alpha results in a fully transparent color map, and a value of 255 results in a fully opaque color map.

If you wish to restore opacity to 100% and free any used memory for the alpha map, rather use clearAlpha.

See also
setAlpha

§ isEmpty()

bool QCPColorMapData::isEmpty ( ) const
inline

Returns whether this instance carries no data. This is equivalent to having a size where at least one of the dimensions is 0 (see setSize).

§ coordToCell()

void QCPColorMapData::coordToCell ( double  key,
double  value,
int *  keyIndex,
int *  valueIndex 
) const

Transforms plot coordinates given by key and value to cell indices of this QCPColorMapData instance. The resulting cell indices are returned via the output parameters keyIndex and valueIndex.

The retrieved key/value cell indices can then be used for example with setCell.

If you are only interested in a key or value index, you may pass nullptr as valueIndex or keyIndex.

Note
The QCPColorMap always displays the data at equal key/value intervals, even if the key or value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, you shouldn't use the QCPColorMapData::coordToCell method as it uses a linear transformation to determine the cell index.
See also
cellToCoord, QCPAxis::coordToPixel

§ cellToCoord()

void QCPColorMapData::cellToCoord ( int  keyIndex,
int  valueIndex,
double *  key,
double *  value 
) const

Transforms cell indices given by keyIndex and valueIndex to cell indices of this QCPColorMapData instance. The resulting coordinates are returned via the output parameters key and value.

If you are only interested in a key or value coordinate, you may pass nullptr as key or value.

Note
The QCPColorMap always displays the data at equal key/value intervals, even if the key or value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, you shouldn't use the QCPColorMapData::cellToCoord method as it uses a linear transformation to determine the cell index.
See also
coordToCell, QCPAxis::pixelToCoord

§ createAlpha()

bool QCPColorMapData::createAlpha ( bool  initializeOpaque = true)
protected

Allocates the internal alpha map with the current data map key/value size and, if initializeOpaque is true, initializes all values to 255. If initializeOpaque is false, the values are not initialized at all. In this case, the alpha map should be initialized manually, e.g. with fillAlpha.

If an alpha map exists already, it is deleted first. If this color map is empty (has either key or value size zero, see isEmpty), the alpha map is cleared.

The return value indicates the existence of the alpha map after the call. So this method returns true if the data map isn't empty and an alpha map was successfully allocated.

The documentation for this class was generated from the following files:
  • src/plottables/plottable-colormap.h
  • src/plottables/plottable-colormap.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/namespacemembers_eval.html0000644000175000017500000001771314030601037026056 0ustar rusconirusconi Namespace Members
 

- a -

  • aeAll : QCP
  • aeAxes : QCP
  • aeFills : QCP
  • aeGrid : QCP
  • aeItems : QCP
  • aeLegend : QCP
  • aeLegendItems : QCP
  • aeNone : QCP
  • aeOther : QCP
  • aePlottables : QCP
  • aeScatters : QCP
  • aeSubGrid : QCP
  • aeZeroLine : QCP

- e -

  • epAllowCosmetic : QCP
  • epNoCosmetic : QCP

- i -

  • iMultiSelect : QCP
  • iNone : QCP
  • iRangeDrag : QCP
  • iRangeZoom : QCP
  • iSelectAxes : QCP
  • iSelectItems : QCP
  • iSelectLegend : QCP
  • iSelectOther : QCP
  • iSelectPlottables : QCP
  • iSelectPlottablesBeyondAxisRect : QCP

- m -

- p -

  • phCacheLabels : QCP
  • phFastPolylines : QCP
  • phImmediateRefresh : QCP
  • phNone : QCP

- r -

  • ruDotsPerCentimeter : QCP
  • ruDotsPerInch : QCP
  • ruDotsPerMeter : QCP

- s -

  • sdBoth : QCP
  • sdNegative : QCP
  • sdPositive : QCP
  • srmCustom : QCP
  • srmNone : QCP
  • srmSelect : QCP
  • srmZoom : QCP
  • stDataRange : QCP
  • stMultipleDataRanges : QCP
  • stNone : QCP
  • stSingleData : QCP
  • stWhole : QCP
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemLine__inherit__graph.png0000644000175000017500000000206414030601041027645 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii111PPR™™™………ççè±±µÓÓÕ*P4nnúí]ütRNSªvå’bKGDˆH pHYsHHFÉk>IDAThÞíØ1OÛ@p>B_‚#ÒьҭÌÒÙ#çø%¦L!µ#¡-®ŽT†v¨!ué„KÕµCUCÅÎg¨Ô¡ï| ˜4>l_‡ÒÞ‹„»ûÅçó ‰ÿhÕ½ ã©*‹…k)í«Âox§ðÊíÿÏ3Kékإܰ°'&öönÔ¬ø﫾UÊûPaVSÌ:H&c›ÁÁG·]ô!À¾ǸéסÁ¬#‚ƒûO16«ÏmèPgÁÇ‚å}v»—Ïo#‹`ÕB¤ŠøI£€Èr¬?yXÿ-³ZŽøBÖÃé×óìŸôá6…ÛÕLJÂïzrý‹ŸœÛßµi[ƒ4\Ÿ| ½áþ5çÇÛ»ùÊê²S¾ó‡z>»Œÿ“‹WÚßoeÔüiÖH;í3kúL=~›okùËø\Ë_Ä_u|=Ž¿ëø™8>ÕñÓqïiøÏäjøKòçþ‚ü·ò¾A\ýÔ~Fø³ò¾öC”Æó¨ñÆo¼ñÆo|¯Î~¾¨3 ò%²Ÿë HxÊ–ýïzVÔ§³Ÿ¨9ô,ýÌRøtöã:Å}*û©¯®‰¬¢‚] ™Œ~Ž‘š ±áöhhî*øö©ì§â,'YÉ œÈègiOÞ_„AÁ~p•ñØ«6gEV3ÙÛ0ˆ~ëaÐ}˜býp‚xD>t’ÑÏÐ%1>•ýlBuƒÖ_íGðdýÐú©iõe4Χ²Ÿ¦í_öÍc2ú9AÑœDó¿g?ZçÏø;ãKd?WùÌìGÿÈ Èä?Êa“ÿ˜üÇä?Æo¼ñÆoüßé æ?ÍoüÏÃõ¼PEÆõ®ð 8Ⳉ‡×óCžþ-Ó¿îÎ|ëé,çÂQŸçþÑ ÷x æ¿ £C›–ánÜŸZœ:”¾Ímî /ïÐeÁ[ð¤§+uäòƒçG £6}¤§+uä[?µé‡/.xºúêçßûç‰ýãÉäÅVxÓSG®÷—x—öoEzZwâ©C}~^ Wx7ϯñe½æßßýV±êø’u÷}Á}©¿"üó”cXç'%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemCurve.png0000644000175000017500000000352514030601041023616 0ustar rusconirusconi‰PNG  IHDRæ /µàøgAMA† 1è–_½PLTEÿÿÿ±±±ééð./ÿpqÿüËÇÿPPP ÑÑÑÖÖÿ‹‹þMMþ-..nnnööú®®ÿÿ ÿ™ ÿ aÿµóÿÈZÿ .ÿÜþÿ¡1ÿNÿèþÿ¸QÿþåÿÿÇöÿõ¹ÿœìÿbþ‡åÿ* ÿ^ÊÿrÚþ<«þI³ÿ÷Òÿ̶ÿ!`ÿé’ÿÿÌî®ÿá{ÿ 2Rÿ’-ÿÏiÿ+ÿcˆv¼MMgš¸ÿÒxUKbKGDˆH pHYsÃÃÇo¨d¿IDATxÚí Wâ:ÇCKiÓi*-+EÞ²¨ "ÞU÷Þûý?ÖNZ`yT­ Mó;¥‘É™¿I3騄$‰D"‘H$‰D"‘p¡ÂÛoCQ«HÓjì•n`ód{K³ÁÞâ-ã=ªše)Ž…*.6êät{GU,KUxËxO£¾­_`÷“3Öó©ï¡3NÕS)¥ úÉñP- ì5;à-ä8Àc#tõæ©7'U˜9µ(á­ä(¶å°ÑĺÙÔÝÐÀ8ÔO™½UÂfƒêi¼…¼ƒb9¾c™:Æ:IÒÔCZÿð¶˜ýù¯@µQÖÔ qØLÚ*Z>ªT <°?ó¨zÈqâW0¤›[Ó¥î‡nÔj Aè-.•ðƒB‹ŽéâPÜýß®P£ÉÛ‰äB‡¥Xt·úã2媵¯(ít{QûТè]{ÚhˆFÁõººéé%Jí&WúƒŸ‡WýÉÍ(¸íOîú“iŠ ¨~h×Ü¢Ù$ê¢{²nÜqäÃO µ›œ˜M(©uÇ Ãȇ×ì ¡ØZtÑU‡ÀGªÝÅãÝ d¢%½…ÑdMwq7è~ 2QZ7yÑEÝY£Òg?ï'WàUÔ…RŸíT;óŸÆížMø4e2¡)é„3™iÝäÅr°ø…bÇšFïFðj%ó¹ƒV2üË7츲k·-sÓÍJfZ7¹A~ æÌÁÖb÷![:þÊ|a“6"lÞ½açâñŽ]?™´?c™×û2‡'y–%36^Öà]-ºK»Û‡+OËx zÕ¾eWoüÞ¶c2—f¹–ÙÛLÚ´nò¢E©?EcÕt‘Œ »b®ÁËD‡6ÏØýûø¸e§°€Òi£¿2Y7‰Ì´n΀ñkòuÜ{›i„JÝpcätã¯/¿Ž¿O %ƒnÎr\§0Hb!uŠ…Ô)ŠÞ>ä£ÓåíB.˜XçíB.T ™ ;&.ÅoYþ‰¿²)"nIt†áíBV„¢‚Kñ+PT/É2äÊeH$L¹ë ·Ù( y{ eÙ%”åöÔeô Snn…¢$QE‘QE(ä3™PÈ”‰XȨ"2ª…Œ*b¡c™™  U„BF±QE(š%yÄv Þä1Êñˆ])Éf¨4Q¥›¡²D•²$nÝrl†NÜ’*²6ÅÌ„}V!¾†jÚ¦0°ùïÕTÕ#›K1S –GârŠŽ½j3•àhU&ÓQÕu‹Ñ³ªzL¦­9›&A3}*¥ò¶ *êþ)*Ñ<«æÙ;m"¦LÙÔÙit—@È^CyþRÐÝÐu1—Û„ÝõíQžÿp ¼]È1w·‡˜¢”…xZ´S«FZ*«Ö‹…¿Gc™)U#gÕ¼ Y9°Â•¦î4º?xEè™R?‘yX5˜¼¢«N\Ì(Ø“6«97ž@ËË¢ ÒÐx%ó°j$z€÷Â`“Ð01.ÖZôBi@;ì.\• }Ú•¹U5rƒ™Tt Œ‹µÅmÅåSdTœMæh=}]Y¨­ß2˜¢þp%¤¡çDæAÕÈ~¬2©It&;VqªüÃD§+™°ùê* ìW¼b‰“¨ËªFVb‘øw£O¦…-ÛlU$.^ÓðÂÛ³LÙªYÑã_àß,ÿg«_ëù¬QšÿQƒMcߦ¼}ùVˆJØ!BjõÜOÇù2¶Oµ9ÿsc¾†ª¥&ò™PÓ<ä«„·‰D"‘HΊÕy"­è~£—üÅùN™,½ù?|~åz(N†¤d;Ñ:?´L¹Š“iÙN”¤7ŸØP\ÅÉŽ´l'Z¥7ãÌ×Cq2#-Û¹‘É•ç¡8Ù‘–íDqzó~ˆX†“ç¡8’’íŒÕ_³oDÃs='#ÎýPœŒæPœìøíw©rJ@¾%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-log.png0000644000175000017500000000131514030601041024267 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨dÿIDATxÚíÜ;nÛ@З kH }¸†,@[Ñ"²¢té¼ Ú½—Y‘&PHŠ?²øžsN5" á^Ïp@HGÀ+tGÐáÝtx-tx°• (£¿a»Õñ-·|F·ùz·øº[½m‹íæS_Ý{&öw°šnÛâ¿]Mž°€2>ôÆ ¿bVÀ«5ÑFm4ƒ«§èâtt´]ê&§Ÿž™ÌæÓgïr½j–ògk³¶j*uYÕÆ9"~DÛ»vŽ6Ú’·}Ýä×é§f&³¥ô¹»L­š¥ü¹Ú¬¯š:]V5— ]o=E½íë&§Ÿž™ÌæÓgïr½j–ògk³¶jRvÙ{~ôËeôÔÿºgô›ª›|œ~zf2›OŸ½ËõªYÊŸ­ÍÚªIÙeï†õ5~ß3&›Õž™aúz]–ògn3•-e—½Ös|>&0+jÏÌ0}½.Kù3·™Ê–²Ë§ï{¹Œ¾õƯöÌÌ¥¯Òe[þ|m¦r§ì²÷ ë1"ÎqŽ§xŒˆ‡_#r=3µ Ó×êÒ¬äÏÜfœ­r—ýsMï·‚º¿µÕM>L_î„ÌBúü]þ%ïþÞ •Î.ÍýÝ+v6kªœHªÝÅ¿Å‚[ø?Ž  PËã8:Ä›/%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractPlottable.html0000644000175000017500000035653114030601040026542 0ustar rusconirusconi QCPAbstractPlottable Class Reference
Public Functions | Signals | Protected Functions
QCPAbstractPlottable Class Referenceabstract

The abstract base class for all data representing objects in a plot. More...

Inheritance diagram for QCPAbstractPlottable:
Inheritance graph

Public Functions

 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const =0
 
virtual QCPPlottableInterface1D * interface1D ()
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const =0
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const =0
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual QRect clipRect () const
 
virtual void draw (QCPPainter *painter)=0
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const =0
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

The abstract base class for all data representing objects in a plot.

It defines a very basic interface like name, pen, brush, visibility etc. Since this class is abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to create new ways of displaying data (see "Creating own plottables" below). Plottables that display one-dimensional data (i.e. data points have a single key dimension and one or multiple values at each key) are based off of the template subclass QCPAbstractPlottable1D, see details there.

All further specifics are in the subclasses, for example:

Creating own plottables

Subclassing directly from QCPAbstractPlottable is only recommended if you wish to display two-dimensional data like QCPColorMap, i.e. two logical key dimensions and one (or more) data dimensions. If you want to display data with only one logical key dimension, you should rather derive from QCPAbstractPlottable1D.

If subclassing QCPAbstractPlottable directly, these are the pure virtual functions you must implement:

See the documentation of those functions for what they need to do.

For drawing your plot, you can use the coordsToPixels functions to translate a point in plot coordinates to pixel coordinates. This function is quite convenient, because it takes the orientation of the key and value axes into account for you (x and y are swapped when the key axis is vertical and the value axis horizontal). If you are worried about performance (i.e. you need to translate many points in a loop like QCPGraph), you can directly use QCPAxis::coordToPixel. However, you must then take care about the orientation of the axis yourself.

Here are some important members you inherit from QCPAbstractPlottable:

QCustomPlot *mParentPlot A pointer to the parent QCustomPlot instance. The parent plot is inferred from the axes that are passed in the constructor.
QString mName The name of the plottable.
QPen mPen The generic pen of the plottable. You should use this pen for the most prominent data representing lines in the plottable (e.g QCPGraph uses this pen for its graph lines and scatters)
QBrush mBrush The generic brush of the plottable. You should use this brush for the most prominent fillable structures in the plottable (e.g. QCPGraph uses this brush to control filling under the graph)
QPointer<QCPAxis> mKeyAxis, mValueAxis The key and value axes this plottable is attached to. Call their QCPAxis::coordToPixel functions to translate coordinates to pixels in either the key or value dimension. Make sure to check whether the pointer is nullptr before using it. If one of the axes is null, don't draw the plottable.
QCPSelectionDecorator mSelectionDecorator The currently set selection decorator which specifies how selected data of the plottable shall be drawn and decorated. When drawing your data, you must consult this decorator for the appropriate pen/brush before drawing unselected/selected data segments. Finally, you should call its QCPSelectionDecorator::drawDecoration method at the end of your draw implementation.
QCP::SelectionType mSelectable In which composition, if at all, this plottable's data may be selected. Enforcing this setting on the data selection is done by QCPAbstractPlottable automatically.
QCPDataSelection mSelection Holds the current selection state of the plottable's data, i.e. the selected data ranges (QCPDataRange).

Constructor & Destructor Documentation

§ QCPAbstractPlottable()

QCPAbstractPlottable::QCPAbstractPlottable ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)

Constructs an abstract plottable which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and have perpendicular orientations. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

Since QCPAbstractPlottable is an abstract class that defines the basic interface to plottables, it can't be directly instantiated.

You probably want one of the subclasses like QCPGraph or QCPCurve instead.

Member Function Documentation

§ selected()

bool QCPAbstractPlottable::selected ( ) const
inline

Returns true if there are any data points of the plottable currently selected. Use selection to retrieve the current QCPDataSelection.

§ selection()

QCPDataSelection QCPAbstractPlottable::selection ( ) const
inline

Returns a QCPDataSelection encompassing all the data points that are currently selected on this plottable.

See also
selected, setSelection, setSelectable

§ selectionDecorator()

QCPSelectionDecorator * QCPAbstractPlottable::selectionDecorator ( ) const
inline

Provides access to the selection decorator of this plottable. The selection decorator controls how selected data ranges are drawn (e.g. their pen color and fill), see QCPSelectionDecorator for details.

If you wish to use an own QCPSelectionDecorator subclass, pass an instance of it to setSelectionDecorator.

§ setName()

void QCPAbstractPlottable::setName ( const QString &  name)

The name is the textual representation of this plottable as it is displayed in the legend (QCPLegend). It may contain any UTF-8 characters, including newlines.

§ setAntialiasedFill()

void QCPAbstractPlottable::setAntialiasedFill ( bool  enabled)

Sets whether fills of this plottable are drawn antialiased or not.

Note that this setting may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

§ setAntialiasedScatters()

void QCPAbstractPlottable::setAntialiasedScatters ( bool  enabled)

Sets whether the scatter symbols of this plottable are drawn antialiased or not.

Note that this setting may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

§ setPen()

void QCPAbstractPlottable::setPen ( const QPen &  pen)

The pen is used to draw basic lines that make up the plottable representation in the plot.

For example, the QCPGraph subclass draws its graph lines with this pen.

See also
setBrush

§ setBrush()

void QCPAbstractPlottable::setBrush ( const QBrush &  brush)

The brush is used to draw basic fills of the plottable representation in the plot. The Fill can be a color, gradient or texture, see the usage of QBrush.

For example, the QCPGraph subclass draws the fill under the graph with this brush, when it's not set to Qt::NoBrush.

See also
setPen

§ setKeyAxis()

void QCPAbstractPlottable::setKeyAxis ( QCPAxis *  axis)

The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's value axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis.

Normally, the key and value axes are set in the constructor of the plottable (or QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface).

See also
setValueAxis

§ setValueAxis()

void QCPAbstractPlottable::setValueAxis ( QCPAxis *  axis)

The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's key axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis.

Normally, the key and value axes are set in the constructor of the plottable (or QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface).

See also
setKeyAxis

§ setSelectable()

void QCPAbstractPlottable::setSelectable ( QCP::SelectionType  selectable)

Sets whether and to which granularity this plottable can be selected.

A selection can happen by clicking on the QCustomPlot surface (When QCustomPlot::setInteractions contains QCP::iSelectPlottables), by dragging a selection rect (When QCustomPlot::setSelectionRectMode is QCP::srmSelect), or programmatically by calling setSelection.

See also
setSelection, QCP::SelectionType

§ setSelection()

void QCPAbstractPlottable::setSelection ( QCPDataSelection  selection)

Sets which data ranges of this plottable are selected. Selected data ranges are drawn differently (e.g. color) in the plot. This can be controlled via the selection decorator (see selectionDecorator).

The entire selection mechanism for plottables is handled automatically when QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when you wish to change the selection state programmatically.

Using setSelectable you can further specify for each plottable whether and to which granularity it is selectable. If selection is not compatible with the current QCP::SelectionType set via setSelectable, the resulting selection will be adjusted accordingly (see QCPDataSelection::enforceType).

emits the selectionChanged signal when selected is different from the previous selection state.

See also
setSelectable, selectTest

§ setSelectionDecorator()

void QCPAbstractPlottable::setSelectionDecorator ( QCPSelectionDecorator *  decorator)

Use this method to set an own QCPSelectionDecorator (subclass) instance. This allows you to customize the visual representation of selected data ranges further than by using the default QCPSelectionDecorator.

The plottable takes ownership of the decorator.

The currently set decorator can be accessed via selectionDecorator.

§ selectTest()

virtual double QCPAbstractPlottable::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
pure virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Reimplemented from QCPLayerable.

Implemented in QCPBars, QCPFinancial, QCPColorMap, QCPErrorBars, QCPGraph, QCPStatisticalBox, QCPCurve, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ interface1D()

QCPPlottableInterface1D * QCPAbstractPlottable::interface1D ( )
inlinevirtual

If this plottable is a one-dimensional plottable, i.e. it implements the QCPPlottableInterface1D, returns the this pointer with that type. Otherwise (e.g. in the case of a QCPColorMap) returns zero.

You can use this method to gain read access to data coordinates while holding a pointer to the abstract base class only.

Reimplemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ getKeyRange()

QCPRange QCPAbstractPlottable::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
pure virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implemented in QCPBars, QCPErrorBars, QCPFinancial, QCPColorMap, QCPGraph, QCPStatisticalBox, and QCPCurve.

§ getValueRange()

QCPRange QCPAbstractPlottable::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
pure virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implemented in QCPBars, QCPErrorBars, QCPFinancial, QCPColorMap, QCPGraph, QCPStatisticalBox, and QCPCurve.

§ coordsToPixels() [1/2]

void QCPAbstractPlottable::coordsToPixels ( double  key,
double  value,
double &  x,
double &  y 
) const

Convenience function for transforming a key/value pair to pixels on the QCustomPlot surface, taking the orientations of the axes associated with this plottable into account (e.g. whether key represents x or y).

key and value are transformed to the coodinates in pixels and are written to x and y.

See also
pixelsToCoords, QCPAxis::coordToPixel

§ coordsToPixels() [2/2]

const QPointF QCPAbstractPlottable::coordsToPixels ( double  key,
double  value 
) const

This is an overloaded function.

Transforms the given key and value to pixel coordinates and returns them in a QPointF.

§ pixelsToCoords() [1/2]

void QCPAbstractPlottable::pixelsToCoords ( double  x,
double  y,
double &  key,
double &  value 
) const

Convenience function for transforming a x/y pixel pair on the QCustomPlot surface to plot coordinates, taking the orientations of the axes associated with this plottable into account (e.g. whether key represents x or y).

x and y are transformed to the plot coodinates and are written to key and value.

See also
coordsToPixels, QCPAxis::coordToPixel

§ pixelsToCoords() [2/2]

void QCPAbstractPlottable::pixelsToCoords ( const QPointF &  pixelPos,
double &  key,
double &  value 
) const

This is an overloaded function.

Returns the pixel input pixelPos as plot coordinates key and value.

§ rescaleAxes()

void QCPAbstractPlottable::rescaleAxes ( bool  onlyEnlarge = false) const

Rescales the key and value axes associated with this plottable to contain all displayed data, so the whole plottable is visible. If the scaling of an axis is logarithmic, rescaleAxes will make sure not to rescale to an illegal range i.e. a range containing different signs and/or zero. Instead it will stay in the current sign domain and ignore all parts of the plottable that lie outside of that domain.

onlyEnlarge makes sure the ranges are only expanded, never reduced. So it's possible to show multiple plottables in their entirety by multiple calls to rescaleAxes where the first call has onlyEnlarge set to false (the default), and all subsequent set to true.

See also
rescaleKeyAxis, rescaleValueAxis, QCustomPlot::rescaleAxes, QCPAxis::rescale

§ rescaleKeyAxis()

void QCPAbstractPlottable::rescaleKeyAxis ( bool  onlyEnlarge = false) const

Rescales the key axis of the plottable so the whole plottable is visible.

See rescaleAxes for detailed behaviour.

§ rescaleValueAxis()

void QCPAbstractPlottable::rescaleValueAxis ( bool  onlyEnlarge = false,
bool  inKeyRange = false 
) const

Rescales the value axis of the plottable so the whole plottable is visible. If inKeyRange is set to true, only the data points which are in the currently visible key axis range are considered.

Returns true if the axis was actually scaled. This might not be the case if this plottable has an invalid range, e.g. because it has no data points.

See rescaleAxes for detailed behaviour.

§ addToLegend() [1/2]

bool QCPAbstractPlottable::addToLegend ( QCPLegend *  legend)

This is an overloaded function.

Adds this plottable to the specified legend.

Creates a QCPPlottableLegendItem which is inserted into the legend. Returns true on success, i.e. when the legend exists and a legend item associated with this plottable isn't already in the legend.

If the plottable needs a more specialized representation in the legend, you can create a corresponding subclass of QCPPlottableLegendItem and add it to the legend manually instead of calling this method.

See also
removeFromLegend, QCPLegend::addItem

§ addToLegend() [2/2]

bool QCPAbstractPlottable::addToLegend ( )

This is an overloaded function.

Adds this plottable to the legend of the parent QCustomPlot (QCustomPlot::legend).

See also
removeFromLegend

§ removeFromLegend() [1/2]

bool QCPAbstractPlottable::removeFromLegend ( QCPLegend *  legend) const

This is an overloaded function.

Removes the plottable from the specifed legend. This means the QCPPlottableLegendItem that is associated with this plottable is removed.

Returns true on success, i.e. if the legend exists and a legend item associated with this plottable was found and removed.

See also
addToLegend, QCPLegend::removeItem

§ removeFromLegend() [2/2]

bool QCPAbstractPlottable::removeFromLegend ( ) const

This is an overloaded function.

Removes the plottable from the legend of the parent QCustomPlot.

See also
addToLegend

§ selectionChanged [1/2]

void QCPAbstractPlottable::selectionChanged ( bool  selected)
signal

This signal is emitted when the selection state of this plottable has changed, either by user interaction or by a direct call to setSelection. The parameter selected indicates whether there are any points selected or not.

See also
selectionChanged(const QCPDataSelection &selection)

§ selectionChanged [2/2]

void QCPAbstractPlottable::selectionChanged ( const QCPDataSelection &  selection)
signal

This signal is emitted when the selection state of this plottable has changed, either by user interaction or by a direct call to setSelection. The parameter selection holds the currently selected data ranges.

See also
selectionChanged(bool selected)

§ selectableChanged

void QCPAbstractPlottable::selectableChanged ( QCP::SelectionType  selectable)
signal

This signal is emitted when the selectability of this plottable has changed.

See also
setSelectable

§ clipRect()

QRect QCPAbstractPlottable::clipRect ( ) const
protectedvirtual

Returns the clipping rectangle of this layerable object. By default, this is the viewport of the parent QCustomPlot. Specific subclasses may reimplement this function to provide different clipping rects.

The returned clipping rect is set on the painter before the draw function of the respective object is called.

Reimplemented from QCPLayerable.

§ draw()

virtual void QCPAbstractPlottable::draw ( QCPPainter *  painter)
protectedpure virtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPLayerable.

Implemented in QCPBars, QCPColorMap, QCPFinancial, QCPErrorBars, QCPGraph, QCPStatisticalBox, and QCPCurve.

§ selectionCategory()

QCP::Interaction QCPAbstractPlottable::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ applyDefaultAntialiasingHint()

void QCPAbstractPlottable::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing plottable lines.

This is the antialiasing state the painter passed to the draw method is in by default.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

For general information about this virtual method, see the base class implementation.

See also
setAntialiased, applyFillAntialiasingHint, applyScattersAntialiasingHint

Implements QCPLayerable.

§ selectEvent()

void QCPAbstractPlottable::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPAbstractPlottable::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ drawLegendIcon()

void QCPAbstractPlottable::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedpure virtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implemented in QCPBars, QCPColorMap, QCPFinancial, QCPErrorBars, QCPGraph, QCPStatisticalBox, and QCPCurve.

§ applyFillAntialiasingHint()

void QCPAbstractPlottable::applyFillAntialiasingHint ( QCPPainter *  painter) const
protected

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing plottable fills.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

See also
setAntialiased, applyDefaultAntialiasingHint, applyScattersAntialiasingHint

§ applyScattersAntialiasingHint()

void QCPAbstractPlottable::applyScattersAntialiasingHint ( QCPPainter *  painter) const
protected

A convenience function to easily set the QPainter::Antialiased hint on the provided painter before drawing plottable scatter points.

This function takes into account the local setting of the antialiasing flag as well as the overrides set with QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

See also
setAntialiased, applyFillAntialiasingHint, applyDefaultAntialiasingHint
The documentation for this class was generated from the following files:
  • src/plottable.h
  • src/plottable.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPBars__inherit__graph.png0000644000175000017500000000464214030601041027032 0ustar rusconirusconi‰PNG  IHDRPû±pgAMA† 1è–_0PLTEÿÿÿÒÒÔiiiQQQ««·………ççè000ÕÕä,!!Wii™­­ÊCCz?BtbKGDˆH pHYsHHFÉk>™IDATxÚí?lWÇ_ìKâÐ$¸Q;±’´B]¬àŠH]ösgŠ¨+:XU;±D‘A,QRTºPK0fÈÖýOË…B§VÊ’=ÄÐ¥Yúû½;‡‹}w¾ÿï,~ß(áì—û݇÷îý^^øþ8ÆH$Rüš;X'•€V‚ƒÖÔ€?…@ 4{ |òl€6ÅË‹:¢¥e4¯ß®±ÊòGŒßâ™ÕÊp€¼ AE­Í +sb]krM”µî ãc z@·Ø6[EP«GÛZy¼´xƒk° MríÁ=Æs—*Љp't-!84Tðë6ƒž=zyCjË7Ym‰“/j_X E¦ôåd2A¯vY{…z½/ô;ÖПœSz˜žTˆqÑeZ‰ÍÁ4‚¦·&S- lê|_Ãg-·S²µ2iu×S²ê!%PmPXj@oœqÑ{?ºµ,+uÕõ_TøÔîŽj*Ʀj_š1Œ=Õ ¾4mOU3øÒ—†ñ«j_Ú7ŒÇª|i×0FbÚ3@[ª)|hA÷TSøÐ4‚>UMáC'ô{Õ>tAGcµŸ~ªš€@ ”@ ”@ ”@ ”@ tD šu(f]J YhÖ• Pîûw~æÈ¿Ü'ï#v÷ý0G¾ˆÔŒÂI⤚Ëq|± ”@íÒ\Ná}ßÃû‚y€j}q/‘~@mîûÉZ/Š-˜Æ4±b‚qóa ãUÄž×óôkVȨf¿Š¶n»œ@“õÚ ¨Ý}Ÿ«:ƒš@+WÛå|íó’<Ïr {ƒö ¿Qµ»ïo~¼‰aè !Lóý؇Cv“ñYqNh!÷rä׬¯ya™<=ýÿˆ"ºÏ˜¨±ö0zûá¨,F©[Ms$(«8€ÚÜ÷K¹5´\ëc%èi¾Ï=èõh½ØØ!^Ž|óx•CK<;ìÑÓwJf¶YÑÛÏø£T‹fÓéMl0A·=@…XŸÏ—ÐÄÞýé,ó½¼GufºÛñïêåÈï…ó¤§^Cœ<œ"q`Øy†oâ[½&dð}é¾0¼1Ñ4;@šï­»ëÔÓ‘ß?ôÖ=i¢³_Jo?— Eü«‰aƒëÐÛÜ÷ã%¶ˆÃúV4˜æ{z9måЯÀ‡§#¿o2õ@qè[ðqµk½ôö#h £HPh‚¡‡ zÛa2ÙÜ÷%Ú8Qš¢<%Ló=L&y('ëò.÷tä÷¥§(L¦)1%ýÖd*KÐ)Q›äd*ãÍà˜žÜ÷Áä”ð»›‘BöPœÁ ”@ ”@CƒwßsäDZ?¶«û~ÀoüìÑjwäo ‰ô¡g¤ÈnÿYÃx¼ÇHþ´y¹{‘£Ìî&î›ýmÿE òy’(';Ž×0þˆ!FÂ&ô‚¼H4ùkFFä}¼È¿‘BŒaˆÄ=èÓ1\ä9Äø=iÐ ¸Èwc̤â쎡t`7 Sÿ ãÑõ¿"E8þd:éä$/c<›5ŠQ"ìî±Ý*d B¯F™ wÂç^ò vw=ô¹cƳt ¥¦Ã§üËRädìÅ¿!OœÙÙLt&lŠ ý7 «)*Â=R¡RTRSÚ •¢N(¨à)춟q¥©»Áo·ýhkoXžÀ¡SED¾î‹=5 AG2Ľ“‚¥¨c!f_\ ”¢ž'¾ûpWNšØÙRä¶S”šzò¢Ž§°ùð’ï¥`‘?*Ÿ#úíCÅœ>çÈlªûgùÊ:)ï?å'E¥½ÿp–•úþ#$Fúûg KQ*öÎ’¢"ý^%Vy§(5ûgy¦(Å‹üy¥(Uûgy¤(eûg¹Nluûg͸ü§rÿá,—)£rÿá,ç¥vÿá,ǾËRjêiÌ!¯Ï¨ÚÄkjГm2- S‚ÿ×b¼¡ ”@SåÎß;¼8 qP{@»Üµñr÷â€Á€AíU %GP·â‡€AmU…•óèU΋º&xÝ2ûá[q€ƒ©ÊËìÏ]‹Òz[À–[ƒaÍµÚ ë‡,³ÿŠkq€C @‚ ¶*Mr˜(ã0_ºœ÷ÌþxèR0X h\U´„hJ öúQ~Ù`Í-P´ä@>ПCY‹z@ßäýôPHUua–EU`õ*›«=cõ¢*ÐÂRu½ï>°tâÒ^-š«ÿ¶, døcŸV—½¢%º0¿Éúès‹›ë½¹úoËB¹ÚƒnÀÏ„*A<І–v8”«EÊÕ^%háýÑúÀðÃÒήþ¸¨c¡\íqè/yEKÔœL}ôiáÒŽ«~M¦§fƒ›«½ÊÉÔSØ’BZ™”@3m4A«Ä©A}þÎû'å¿÷§lý맇¦Gâ1 Ë^öT#øÓ~䂧””BùW,šM¼”2&a5¥j_ÂjÊ–j?º¹3%½ˆ¡Î1ÊC]&S©£AòÁC£0ígvTSøSƬNJ J J ª”@ ”@ ”@ ”@ ”@GAJ Y¾ ƒÖ†ßÞ¹¨š”óåvPM‰ zg¸ºª) ”@Gôšh¸ßõŽ€ÏÌ‚6ßo^¼R?óv{£ÛÑá3³ Î5½}¿Óiw*´-.¶»:tqÖ@k ½}@Rý½=ß.Î,(@b6¾\XÌðÐw:: ㌇ÝÌõ(L¦ûr2!(ôh} AçßÕ³z˜žàïÑnA38™:…³#‘ðGfe"P%ÐWtTv¡y?O¤=­š’D"Ùô?pàΕâ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/namespacemembers.html0000644000175000017500000002257114030601037025045 0ustar rusconirusconi Namespace Members
Here is a list of all documented namespace members with links to the namespaces they belong to:

- a -

  • aeAll : QCP
  • aeAxes : QCP
  • aeFills : QCP
  • aeGrid : QCP
  • aeItems : QCP
  • aeLegend : QCP
  • aeLegendItems : QCP
  • aeNone : QCP
  • aeOther : QCP
  • aePlottables : QCP
  • aeScatters : QCP
  • aeSubGrid : QCP
  • aeZeroLine : QCP
  • AntialiasedElement : QCP

- e -

  • epAllowCosmetic : QCP
  • epNoCosmetic : QCP
  • ExportPen : QCP

- g -

  • getMarginValue() : QCP

- i -

  • iMultiSelect : QCP
  • iNone : QCP
  • Interaction : QCP
  • iRangeDrag : QCP
  • iRangeZoom : QCP
  • iSelectAxes : QCP
  • iSelectItems : QCP
  • iSelectLegend : QCP
  • iSelectOther : QCP
  • iSelectPlottables : QCP
  • iSelectPlottablesBeyondAxisRect : QCP
  • isInvalidData() : QCP

- m -

- p -

  • phCacheLabels : QCP
  • phFastPolylines : QCP
  • phImmediateRefresh : QCP
  • phNone : QCP
  • PlottingHint : QCP

- r -

  • ResolutionUnit : QCP
  • ruDotsPerCentimeter : QCP
  • ruDotsPerInch : QCP
  • ruDotsPerMeter : QCP

- s -

  • sdBoth : QCP
  • sdNegative : QCP
  • sdPositive : QCP
  • SelectionRectMode : QCP
  • SelectionType : QCP
  • setMarginValue() : QCP
  • SignDomain : QCP
  • srmCustom : QCP
  • srmNone : QCP
  • srmSelect : QCP
  • srmZoom : QCP
  • stDataRange : QCP
  • stMultipleDataRanges : QCP
  • stNone : QCP
  • stSingleData : QCP
  • stWhole : QCP
qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_24.png0000644000175000017500000000125314030601042024474 0ustar rusconirusconi‰PNG  IHDRk#9½<†gAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>ÝIDATXÃíY;nÂ@}D¬ûÐ@™"9¹@šTé¢`€"R¥ q„È]Š@‹")"§ @ihìŠмYov—OŒ ²ü(f<;3žÇzFk¹@âô0‚mËC—.ë¤ÔÉ©M¥g‚‚®”m-ÞWw¡÷—mFýo‘hÍ¥6W7œ[ºì‘œ²j¬•Y£ÏËŠ–OW“¡¯Ï[ƒ–· G§U¥`Uí§0²üeð-Im7z†ÍŒ‹F+ÒÈè[xÙàžQfãTvæ¬X2ì­VxŒÝZhµà¡}xhI˘¨¢šp'õ+ïèª3æPB(íY 7‰öÿCHÖµ!°ÉÒ¦C@_û4µ-#csW®?Úf\˜í½¢ª:!0i£í)ím&ýHñá)§•ÓÊ4rZY‚1à㼸¥ ŠÖsÒ•ÄÆ¥¦ò/&BN+K(b˜t ‡ÇõýENÔ‡ a%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPlottableLegendItem__inherit__graph.png0000644000175000017500000000301014030601041032013 0ustar rusconirusconi‰PNG  IHDR«ûçHyÝgAMA† 1è–_-PLTEÿÿÿÿÿÿ222iiiQQS˜˜˜………èèè²²µÓÓÕP+nnðQT²tRNSªvå’bKGDˆH pHYsHHFÉk>õIDATxÚíÜÏkÜFpÿ ãÝ1þJ‹#°oÝ8kJ{ÚØ‚Í-£Õ³›LmHþj¯@9Ú؇zXJrhOÆøRè¡€=ªBþ€þ}ofv£¥ÝÑZ*uxÏÍHÚ¥ ƒ¾«Ì‰:jnŽÙÿ]Ý(]J«í––>å³U²J9 »;Bøp a—ŒªXÿuÜi†?´äÒQ•l(šJvè×ڀ®—¿´wÅE)®á¸,»/V”¼BÏí¢ Å7o}ÑÕ±Î[Rl^¨™Y3¶>¨X¼¸¡IÿâVPš}?z Ãï•ÜnÑïQB>¿4ìþ=¦Ì°Ñ¹Z„ãÆW?ûÚ3ƒ°ñk«,;ºÀ°'{(Ñ+íÙð†SÖ)Ë á¯_ú\Ô½î28¨…-.f?NÊ— Ûß.¨Ûâ-¶°Òßw-Á.¦ÔÁ>Jÿ®ƒý1ý«öŸ4=«½MÓwÕ³Kiê~)¸³Ÿ ûgõì#d/wö7d/w/„4½ªœ½%ö]=ìAå,ƒû®Ì2Ë,³Ì2Ë,³Ì2Ël)vZàðµ{üeË…ñC–-ÿf¼2l˜‘U³°“)èéøV:°“9|T^žÍ ~†=ì(Í®´wEÏ c<ƒ©l~à°¾J¬Š‚‹àÂ6”ËÑæW7–¥£%û%þ؆[8 »4b¯h“5JM™È8á¹’½ÖÄjÔƒ˜ÈË8e~ æA­‰Ô¨1ï0ee‡ñ*y—÷b]‹Ù…!p(Š²laà05w¸?pîPŽåÜs]œ;Θe–Yf™e–Yf™eö±MÇ`jî`ëKÃ6z÷ >¨Ð²-÷³s)f§±ÊÍÈÙmœÍqg¸¿Ê 9†’wÖŽ³ÙÀ¡ÝªŒÍK/^Ò×ã›°#A™®›\Ãñ2x´^(ÞJâzÓóÂ<684[›úËüßÑuó‚Ó3s´›ª±îÑB®ûâɹ>ZÓÃþ$v-zõ`¾GCl_p°ƒ äÙYHó~‚²½39yÄ À~B¼íiK¿à`Y\»oËÚ^.› VEã3„Æ {öjÒ;4¸ FÂÞ°—Ëf‡H,*œ²œ*O™n›@³Ó1SÖ!†¦ ×Û^.{7p(*¼'Õ¬7/Þ/u°SŠÙËÞ;p/Ë.o»ÕÔÜÁÖsÎʲœ;pî ‹sÁ¹³Ì2Ë,³Ì2Ë,³Ì> vµâÜa££ÙŠ~з/‰ ’j+fv2g;Ñý¢ýrØÀ¥k1ì$¯bó™xŒÍ3’(žÄz‡Gk'ÁöqßK¢gQUlœDñíç'Q÷õ¡Ka‚gу.õéúx2~/¢EÖúÐN"Ó[…µ»l˜ ÕŕãímEæhL3Ч?öt—¸âi›ŽÖô°?ŽmØ×ì °nhÖvib×׬î…I4iìXZ6~ì›f¨·ÑoÍDïYÓËcõ”íà” Y:Õ.þ¶Í llÓÑž>õ©K bõ tm/]`C§ìNágÅN^|8;™²€=e§`{yl’´»®÷ÑV4ië¬7o ¯ê`§ýVf([Ó_Þiï9”®ÁÃÿO)ÿ×l-õ鿨ÖädMN%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_l.html0000644000175000017500000001454214030601037024060 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- l -

qcustomplot-2.1.0+dfsg1/documentation/html/functions.html0000644000175000017500000002454314030601037023547 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- a -

qcustomplot-2.1.0+dfsg1/documentation/html/selectiontype-whole.png0000644000175000017500000000365414030601041025355 0ustar rusconirusconi‰PNG  IHDR´n|F$HgAMA† 1è–_0PLTEÿÿÿZZ_ÿèöÿ+—ÿdÿ±àÿO¯ÿÑíÿ vÿ[ÿÑÿuÄÿ~ÿ;£ÿ‡ÿf¼Ñ=cbKGDˆH pHYsÃÃÇo¨d£IDAThÞí™_hÛEÀÏ´Ijº¤)(ð!Ђ Wf™ôa8¶,Ýu¶FìÆÄ ñÏDFú°¡HØ*4º­½®ùέ sºä¡C qPöR¨/C„"sløg}¨âDªßïeKr¿ÞåwÙº‡~ M~÷»ûÜ÷¾w÷ý~ïÊØš¬Éš<¬ÒܾËOøÁ)劾û¾ úÞû^ ­W}÷²šZ¯æ°VCëÕD×(-±M5h½çíаÿ~‘·Bû/X“9@m§¢•Ã/tY£}d Úm´¾°«­E¡ê[]Ñ-;kC³,ä˜:½5„=-ÆëXpC¿Ä!²‡&ÆZ‚s¿ýžnƒ\Úˆ~%-UÀIyìŸx*ö½5ºá+.ºXïp•af©\‘ëÉ[ Tÿ9üÓŠêŒ{†‡˜Ië þâÐ „†C\šÎU:y;c“b›@fÞˆÆ×Ø{½ä„»‰Cœ±ùzákŸ4¡=CU.ÒNù3îhb2v™z-Ö§MZgAtH|ì`rK òîh²ó “]ê¡EºÄF²Æøë¡Ä›x·…©CXÝÛÑÅü_.ö±ºÞEC5ÿàwQ46t3'§ÉÂÌË¡«ÖRÓÂ2z‘^Óºš‚±N¹Ãÿ[mµ@³Ùô,ÍŠ§ksÕÊУrSr‡Ë V;½þ@‰ÇÐg I=ÚÇUqJŽú² º/Ø.ýRÄMüqIÆn çßd·µÞbƒ^dR¨,ÃÑ~JK÷ m-ßsø.!Jô¿6è-¬+'Ûpb/-¯´®V]r¶³2ºÏ=Ä®¸€ßÓ4ýý¸s M­u…–Ádº>mÞ†Ë`­ÛhoFðk¥Ô—û »r'{3’‰k ‹Þ:ˆž^ÐT[ï4Ðœ;Ú·°E˜'ÊÈyFÈð+d²üSjí;uE×%qþâåAì‹ÀIMµeú–põ"ÞTW],ĵ^~^E{q•VW»1ËùDˆ‹JØ“ƒºš7Ut²‹ªùÙ4ùÉô{—*Ë­iMÍ!µþVðE3: ä5Ô²p(é}+á¬9¦>’#»0fF“ÒÂÑu8Ðs#¦.’Tnÿ¨ª5»™­šDe¥Aè6*¬TƒÀ¢ŠüDµŒhÿ |›pw8­TO”1MÑ ´ûV nC8úŸCiæNôAUÁ"šb*äMè%íˆ$Z±’Ôº{%Z5Z“YÍžw8ØÄ5cGƒôÌÑÓ ÛÓá "·TPŠ.æD,áÐÚ?3“Ft34iê’JQ{ÿ s Yã»Uœ¶g¶'ªã[P÷;ú¾#Uœ¶6,SË@F)ºf@ÛZk—%µô¨‰öÚ¡A…4ΘЕިJªä9‘0¼ %èkÌ“.•8,_ÖzŒÐ¡ÔÙò ÿl9°;T(£;W¸ÍÛ²Tå5ÙVÞ$-|΀ƔѵÆ=¦u\²åúi(öRnãDÓQa\£ž=HΈnÀÝ~ºøì㪋­Ð=6ô¬$Üâò¤a@·eKN Î-in.}Ž77¿XñX*<¾¢>„öS¿ ­Ëây‡ºõG•BïUÕQ:Ýš¹c9§Lõ°[ñyVM@Ï’Ÿ|>ojBº”ì…ŸMõ°[ÑïX&º ¨¢EÙGõØYM9\3Ũ s *S‡Û²ß½g,/ÝòÌ“…O~•Ÿõ¸7è'/cC¦‰+-ï:n1ÒNL3Vh_{1o¥M9åØ›ZAKŸÜj…ÆtD¢ãMRà¾å «ûÆ"ñ+&ò»®‚ЖUù ÝêÖƒ²+é¥äc•£BIBb<:iÁ¥Ü`ˆµnæâUIŽåÝ[¼–`S;-ê1ºõëgÞ¿åq lZàüp«;pº«üwø9Bç, ¬³«I7¬8+Ág/V åªPôµÔúÅ€ñÝK9;{°Cä´õ™a¹ v\&mí¾Hé~b‚’xnH.õòµ…W%y÷:³»Ô®Uú(´dí®âk”V¾‰Ò« Ô(Yr¿Þë¿Ü2´ó÷KÓ¡æaÖ#ã©{§èåC±éÞ!kò?³J†Çòýêi%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPScatterStyle.html0000644000175000017500000015607214030601036025561 0ustar rusconirusconi QCPScatterStyle Class Reference
Public Types | Public Functions
QCPScatterStyle Class Reference

Represents the visual appearance of scatter points. More...

Public Types

enum  ScatterProperty
 
enum  ScatterShape
 

Public Functions

 QCPScatterStyle ()
 
 QCPScatterStyle (ScatterShape shape, double size=6)
 
 QCPScatterStyle (ScatterShape shape, const QColor &color, double size)
 
 QCPScatterStyle (ScatterShape shape, const QColor &color, const QColor &fill, double size)
 
 QCPScatterStyle (ScatterShape shape, const QPen &pen, const QBrush &brush, double size)
 
 QCPScatterStyle (const QPixmap &pixmap)
 
 QCPScatterStyle (const QPainterPath &customPath, const QPen &pen, const QBrush &brush=Qt::NoBrush, double size=6)
 
double size () const
 
ScatterShape shape () const
 
QPen pen () const
 
QBrush brush () const
 
QPixmap pixmap () const
 
QPainterPath customPath () const
 
void setFromOther (const QCPScatterStyle &other, ScatterProperties properties)
 
void setSize (double size)
 
void setShape (ScatterShape shape)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setPixmap (const QPixmap &pixmap)
 
void setCustomPath (const QPainterPath &customPath)
 
bool isNone () const
 
bool isPenDefined () const
 
void undefinePen ()
 
void applyTo (QCPPainter *painter, const QPen &defaultPen) const
 
void drawShape (QCPPainter *painter, const QPointF &pos) const
 
void drawShape (QCPPainter *painter, double x, double y) const
 

Detailed Description

Represents the visual appearance of scatter points.

This class holds information about shape, color and size of scatter points. In plottables like QCPGraph it is used to store how scatter points shall be drawn. For example, QCPGraph::setScatterStyle takes a QCPScatterStyle instance.

A scatter style consists of a shape (setShape), a line color (setPen) and possibly a fill (setBrush), if the shape provides a fillable area. Further, the size of the shape can be controlled with setSize.

Specifying a scatter style

You can set all these configurations either by calling the respective functions on an instance:

QCPScatterStyle myScatter;
myScatter.setShape(QCPScatterStyle::ssCircle);
myScatter.setPen(QPen(Qt::blue));
myScatter.setBrush(Qt::white);
myScatter.setSize(5);
customPlot->graph(0)->setScatterStyle(myScatter);

Or you can use one of the various constructors that take different parameter combinations, making it easy to specify a scatter style in a single call, like so:

customPlot->graph(0)->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, Qt::blue, Qt::white, 5));

Leaving the color/pen up to the plottable

There are two constructors which leave the pen undefined: QCPScatterStyle() and QCPScatterStyle(ScatterShape shape, double size). If those constructors are used, a call to isPenDefined will return false. It leads to scatter points that inherit the pen from the plottable that uses the scatter style. Thus, if such a scatter style is passed to QCPGraph, the line color of the graph (QCPGraph::setPen) will be used by the scatter points. This makes it very convenient to set up typical scatter settings:

customPlot->graph(0)->setScatterStyle(QCPScatterStyle::ssPlus);

Notice that it wasn't even necessary to explicitly call a QCPScatterStyle constructor. This works because QCPScatterStyle provides a constructor that can transform a ScatterShape directly into a QCPScatterStyle instance (that's the QCPScatterStyle(ScatterShape shape, double size) constructor with a default for size). In those cases, C++ allows directly supplying a ScatterShape, where actually a QCPScatterStyle is expected.

Custom shapes and pixmaps

QCPScatterStyle supports drawing custom shapes and arbitrary pixmaps as scatter points.

For custom shapes, you can provide a QPainterPath with the desired shape to the setCustomPath function or call the constructor that takes a painter path. The scatter shape will automatically be set to ssCustom.

For pixmaps, you call setPixmap with the desired QPixmap. Alternatively you can use the constructor that takes a QPixmap. The scatter shape will automatically be set to ssPixmap. Note that setSize does not influence the appearance of the pixmap.

Member Enumeration Documentation

§ ScatterProperty

enum QCPScatterStyle::ScatterProperty

Represents the various properties of a scatter style instance. For example, this enum is used to specify which properties of QCPSelectionDecorator::setScatterStyle will be used when highlighting selected data points.

Specific scatter properties can be transferred between QCPScatterStyle instances via setFromOther.

Enumerator
spNone 

0x00 None

spPen 

0x01 The pen property, see setPen

spBrush 

0x02 The brush property, see setBrush

spSize 

0x04 The size property, see setSize

spShape 

0x08 The shape property, see setShape

spAll 

0xFF All properties

§ ScatterShape

enum QCPScatterStyle::ScatterShape

Defines the shape used for scatter points.

On plottables/items that draw scatters, the sizes of these visualizations (with exception of ssDot and ssPixmap) can be controlled with the setSize function. Scatters are drawn with the pen and brush specified with setPen and setBrush.

Enumerator
ssNone 

no scatter symbols are drawn (e.g. in QCPGraph, data only represented with lines)

ssDot 
ssDot.png

a single pixel (use ssDisc or ssCircle if you want a round shape with a certain radius)

ssCross 
ssCross.png

a cross

ssPlus 
ssPlus.png

a plus

ssCircle 
ssCircle.png

a circle

ssDisc 
ssDisc.png

a circle which is filled with the pen's color (not the brush as with ssCircle)

ssSquare 
ssSquare.png

a square

ssDiamond 
ssDiamond.png

a diamond

ssStar 
ssStar.png

a star with eight arms, i.e. a combination of cross and plus

ssTriangle 
ssTriangle.png

an equilateral triangle, standing on baseline

ssTriangleInverted 
ssTriangleInverted.png

an equilateral triangle, standing on corner

ssCrossSquare 
ssCrossSquare.png

a square with a cross inside

ssPlusSquare 
ssPlusSquare.png

a square with a plus inside

ssCrossCircle 
ssCrossCircle.png

a circle with a cross inside

ssPlusCircle 
ssPlusCircle.png

a circle with a plus inside

ssPeace 
ssPeace.png

a circle, with one vertical and two downward diagonal lines

ssPixmap 

a custom pixmap specified by setPixmap, centered on the data point coordinates

ssCustom 

custom painter operations are performed per scatter (As QPainterPath, see setCustomPath)

Constructor & Destructor Documentation

§ QCPScatterStyle() [1/7]

QCPScatterStyle::QCPScatterStyle ( )

Creates a new QCPScatterStyle instance with size set to 6. No shape, pen or brush is defined.

Since the pen is undefined (isPenDefined returns false), the scatter color will be inherited from the plottable that uses this scatter style.

§ QCPScatterStyle() [2/7]

QCPScatterStyle::QCPScatterStyle ( ScatterShape  shape,
double  size = 6 
)

Creates a new QCPScatterStyle instance with shape set to shape and size to size. No pen or brush is defined.

Since the pen is undefined (isPenDefined returns false), the scatter color will be inherited from the plottable that uses this scatter style.

§ QCPScatterStyle() [3/7]

QCPScatterStyle::QCPScatterStyle ( ScatterShape  shape,
const QColor &  color,
double  size 
)

Creates a new QCPScatterStyle instance with shape set to shape, the pen color set to color, and size to size. No brush is defined, i.e. the scatter point will not be filled.

§ QCPScatterStyle() [4/7]

QCPScatterStyle::QCPScatterStyle ( ScatterShape  shape,
const QColor &  color,
const QColor &  fill,
double  size 
)

Creates a new QCPScatterStyle instance with shape set to shape, the pen color set to color, the brush color to fill (with a solid pattern), and size to size.

§ QCPScatterStyle() [5/7]

QCPScatterStyle::QCPScatterStyle ( ScatterShape  shape,
const QPen &  pen,
const QBrush &  brush,
double  size 
)

Creates a new QCPScatterStyle instance with shape set to shape, the pen set to pen, the brush to brush, and size to size.

Warning
In some cases it might be tempting to directly use a pen style like Qt::NoPen as pen and a color like Qt::blue as brush. Notice however, that the corresponding call
QCPScatterStyle(QCPScatterShape::ssCircle, Qt::NoPen, Qt::blue, 5)
doesn't necessarily lead C++ to use this constructor in some cases, but might mistake Qt::NoPen for a QColor and use the QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) constructor instead (which will lead to an unexpected look of the scatter points). To prevent this, be more explicit with the parameter types. For example, use QBrush(Qt::blue) instead of just Qt::blue, to clearly point out to the compiler that this constructor is wanted.

§ QCPScatterStyle() [6/7]

QCPScatterStyle::QCPScatterStyle ( const QPixmap &  pixmap)

Creates a new QCPScatterStyle instance which will show the specified pixmap. The scatter shape is set to ssPixmap.

§ QCPScatterStyle() [7/7]

QCPScatterStyle::QCPScatterStyle ( const QPainterPath &  customPath,
const QPen &  pen,
const QBrush &  brush = Qt::NoBrush,
double  size = 6 
)

Creates a new QCPScatterStyle instance with a custom shape that is defined via customPath. The scatter shape is set to ssCustom.

The custom shape line will be drawn with pen and filled with brush. The size has a slightly different meaning than for built-in scatter points: The custom path will be drawn scaled by a factor of size/6.0. Since the default size is 6, the custom path will appear in its original size by default. To for example double the size of the path, set size to 12.

Member Function Documentation

§ setFromOther()

void QCPScatterStyle::setFromOther ( const QCPScatterStyle &  other,
ScatterProperties  properties 
)

Copies the specified properties from the other scatter style to this scatter style.

§ setSize()

void QCPScatterStyle::setSize ( double  size)

Sets the size (pixel diameter) of the drawn scatter points to size.

See also
setShape

§ setShape()

void QCPScatterStyle::setShape ( QCPScatterStyle::ScatterShape  shape)

Sets the shape to shape.

Note that the calls setPixmap and setCustomPath automatically set the shape to ssPixmap and ssCustom, respectively.

See also
setSize

§ setPen()

void QCPScatterStyle::setPen ( const QPen &  pen)

Sets the pen that will be used to draw scatter points to pen.

If the pen was previously undefined (see isPenDefined), the pen is considered defined after a call to this function, even if pen is Qt::NoPen. If you have defined a pen previously by calling this function and now wish to undefine the pen, call undefinePen.

See also
setBrush

§ setBrush()

void QCPScatterStyle::setBrush ( const QBrush &  brush)

Sets the brush that will be used to fill scatter points to brush. Note that not all scatter shapes have fillable areas. For example, ssPlus does not while ssCircle does.

See also
setPen

§ setPixmap()

void QCPScatterStyle::setPixmap ( const QPixmap &  pixmap)

Sets the pixmap that will be drawn as scatter point to pixmap.

Note that setSize does not influence the appearance of the pixmap.

The scatter shape is automatically set to ssPixmap.

§ setCustomPath()

void QCPScatterStyle::setCustomPath ( const QPainterPath &  customPath)

Sets the custom shape that will be drawn as scatter point to customPath.

The scatter shape is automatically set to ssCustom.

§ isNone()

bool QCPScatterStyle::isNone ( ) const
inline

Returns whether the scatter shape is ssNone.

See also
setShape

§ isPenDefined()

bool QCPScatterStyle::isPenDefined ( ) const
inline

Returns whether a pen has been defined for this scatter style.

The pen is undefined if a constructor is called that does not carry pen as parameter. Those are QCPScatterStyle() and QCPScatterStyle(ScatterShape shape, double size). If the pen is undefined, the pen of the respective plottable will be used for drawing scatters.

If a pen was defined for this scatter style instance, and you now wish to undefine the pen, call undefinePen.

See also
setPen

§ undefinePen()

void QCPScatterStyle::undefinePen ( )

Sets this scatter style to have an undefined pen (see isPenDefined for what an undefined pen implies).

A call to setPen will define a pen.

§ applyTo()

void QCPScatterStyle::applyTo ( QCPPainter *  painter,
const QPen &  defaultPen 
) const

Applies the pen and the brush of this scatter style to painter. If this scatter style has an undefined pen (isPenDefined), sets the pen of painter to defaultPen instead.

This function is used by plottables (or any class that wants to draw scatters) just before a number of scatters with this style shall be drawn with the painter.

See also
drawShape

§ drawShape() [1/2]

void QCPScatterStyle::drawShape ( QCPPainter *  painter,
const QPointF &  pos 
) const

Draws the scatter shape with painter at position pos.

This function does not modify the pen or the brush on the painter, as applyTo is meant to be called before scatter points are drawn with drawShape.

See also
applyTo

§ drawShape() [2/2]

void QCPScatterStyle::drawShape ( QCPPainter *  painter,
double  x,
double  y 
) const

This is an overloaded function. Draws the scatter shape with painter at position x and y.

The documentation for this class was generated from the following files:
  • src/scatterstyle.h
  • src/scatterstyle.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCustomPlot.html0000644000175000017500000113705514030601036025022 0ustar rusconirusconi QCustomPlot Class Reference
Public Types | Public Functions | Public Members | Signals | Protected Functions
QCustomPlot Class Reference

The central class of the library. This is the QWidget which displays the plot and interacts with the user. More...

Inherits QWidget.

Public Types

enum  LayerInsertMode
 
enum  RefreshPriority
 

Public Functions

 QCustomPlot (QWidget *parent=nullptr)
 
QRect viewport () const
 
double bufferDevicePixelRatio () const
 
QPixmap background () const
 
bool backgroundScaled () const
 
Qt::AspectRatioMode backgroundScaledMode () const
 
QCPLayoutGrid * plotLayout () const
 
QCP::AntialiasedElements antialiasedElements () const
 
QCP::AntialiasedElements notAntialiasedElements () const
 
bool autoAddPlottableToLegend () const
 
const QCP::Interactions interactions () const
 
int selectionTolerance () const
 
bool noAntialiasingOnDrag () const
 
QCP::PlottingHints plottingHints () const
 
Qt::KeyboardModifier multiSelectModifier () const
 
QCP::SelectionRectMode selectionRectMode () const
 
QCPSelectionRect * selectionRect () const
 
bool openGl () const
 
void setViewport (const QRect &rect)
 
void setBufferDevicePixelRatio (double ratio)
 
void setBackground (const QPixmap &pm)
 
void setBackground (const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding)
 
void setBackground (const QBrush &brush)
 
void setBackgroundScaled (bool scaled)
 
void setBackgroundScaledMode (Qt::AspectRatioMode mode)
 
void setAntialiasedElements (const QCP::AntialiasedElements &antialiasedElements)
 
void setAntialiasedElement (QCP::AntialiasedElement antialiasedElement, bool enabled=true)
 
void setNotAntialiasedElements (const QCP::AntialiasedElements &notAntialiasedElements)
 
void setNotAntialiasedElement (QCP::AntialiasedElement notAntialiasedElement, bool enabled=true)
 
void setAutoAddPlottableToLegend (bool on)
 
void setInteractions (const QCP::Interactions &interactions)
 
void setInteraction (const QCP::Interaction &interaction, bool enabled=true)
 
void setSelectionTolerance (int pixels)
 
void setNoAntialiasingOnDrag (bool enabled)
 
void setPlottingHints (const QCP::PlottingHints &hints)
 
void setPlottingHint (QCP::PlottingHint hint, bool enabled=true)
 
void setMultiSelectModifier (Qt::KeyboardModifier modifier)
 
void setSelectionRectMode (QCP::SelectionRectMode mode)
 
void setSelectionRect (QCPSelectionRect *selectionRect)
 
void setOpenGl (bool enabled, int multisampling=16)
 
QCPAbstractPlottable * plottable (int index)
 
QCPAbstractPlottable * plottable ()
 
bool removePlottable (QCPAbstractPlottable *plottable)
 
bool removePlottable (int index)
 
int clearPlottables ()
 
int plottableCount () const
 
QList< QCPAbstractPlottable * > selectedPlottables () const
 
template<class PlottableType >
PlottableType * plottableAt (const QPointF &pos, bool onlySelectable=false, int *dataIndex=nullptr) const
 
QCPAbstractPlottable * plottableAt (const QPointF &pos, bool onlySelectable=false, int *dataIndex=nullptr) const
 
bool hasPlottable (QCPAbstractPlottable *plottable) const
 
QCPGraph * graph (int index) const
 
QCPGraph * graph () const
 
QCPGraph * addGraph (QCPAxis *keyAxis=nullptr, QCPAxis *valueAxis=nullptr)
 
bool removeGraph (QCPGraph *graph)
 
bool removeGraph (int index)
 
int clearGraphs ()
 
int graphCount () const
 
QList< QCPGraph * > selectedGraphs () const
 
QCPAbstractItem * item (int index) const
 
QCPAbstractItem * item () const
 
bool removeItem (QCPAbstractItem *item)
 
bool removeItem (int index)
 
int clearItems ()
 
int itemCount () const
 
QList< QCPAbstractItem * > selectedItems () const
 
template<class ItemType >
ItemType * itemAt (const QPointF &pos, bool onlySelectable=false) const
 
QCPAbstractItem * itemAt (const QPointF &pos, bool onlySelectable=false) const
 
bool hasItem (QCPAbstractItem *item) const
 
QCPLayer * layer (const QString &name) const
 
QCPLayer * layer (int index) const
 
QCPLayer * currentLayer () const
 
bool setCurrentLayer (const QString &name)
 
bool setCurrentLayer (QCPLayer *layer)
 
int layerCount () const
 
bool addLayer (const QString &name, QCPLayer *otherLayer=nullptr, LayerInsertMode insertMode=limAbove)
 
bool removeLayer (QCPLayer *layer)
 
bool moveLayer (QCPLayer *layer, QCPLayer *otherLayer, LayerInsertMode insertMode=limAbove)
 
int axisRectCount () const
 
QCPAxisRect * axisRect (int index=0) const
 
QList< QCPAxisRect * > axisRects () const
 
QCPLayoutElement * layoutElementAt (const QPointF &pos) const
 
QCPAxisRect * axisRectAt (const QPointF &pos) const
 
Q_SLOT void rescaleAxes (bool onlyVisiblePlottables=false)
 
QList< QCPAxis * > selectedAxes () const
 
QList< QCPLegend * > selectedLegends () const
 
Q_SLOT void deselectAll ()
 
bool savePdf (const QString &fileName, int width=0, int height=0, QCP::ExportPen exportPen=QCP::epAllowCosmetic, const QString &pdfCreator=QString(), const QString &pdfTitle=QString())
 
bool savePng (const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch)
 
bool saveJpg (const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch)
 
bool saveBmp (const QString &fileName, int width=0, int height=0, double scale=1.0, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch)
 
bool saveRastered (const QString &fileName, int width, int height, double scale, const char *format, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch)
 
QPixmap toPixmap (int width=0, int height=0, double scale=1.0)
 
void toPainter (QCPPainter *painter, int width=0, int height=0)
 
Q_SLOT void replot (QCustomPlot::RefreshPriority refreshPriority=QCustomPlot::rpRefreshHint)
 
double replotTime (bool average=false) const
 

Public Members

QCPAxis * xAxis
 
QCPAxis * yAxis
 
QCPAxis * xAxis2
 
QCPAxis * yAxis2
 
QCPLegend * legend
 

Signals

void mouseDoubleClick (QMouseEvent *event)
 
void mousePress (QMouseEvent *event)
 
void mouseMove (QMouseEvent *event)
 
void mouseRelease (QMouseEvent *event)
 
void mouseWheel (QWheelEvent *event)
 
void plottableClick (QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event)
 
void plottableDoubleClick (QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event)
 
void itemClick (QCPAbstractItem *item, QMouseEvent *event)
 
void itemDoubleClick (QCPAbstractItem *item, QMouseEvent *event)
 
void axisClick (QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event)
 
void axisDoubleClick (QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event)
 
void legendClick (QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event)
 
void legendDoubleClick (QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event)
 
void selectionChangedByUser ()
 
void beforeReplot ()
 
void afterLayout ()
 
void afterReplot ()
 

Protected Functions

virtual QSize minimumSizeHint () const
 
virtual QSize sizeHint () const
 
virtual void paintEvent (QPaintEvent *event)
 
virtual void resizeEvent (QResizeEvent *event)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event)
 
virtual void mousePressEvent (QMouseEvent *event)
 
virtual void mouseMoveEvent (QMouseEvent *event)
 
virtual void mouseReleaseEvent (QMouseEvent *event)
 
virtual void wheelEvent (QWheelEvent *event)
 
virtual void draw (QCPPainter *painter)
 
virtual void updateLayout ()
 
virtual void axisRemoved (QCPAxis *axis)
 
virtual void legendRemoved (QCPLegend *legend)
 
virtual Q_SLOT void processRectSelection (QRect rect, QMouseEvent *event)
 
virtual Q_SLOT void processRectZoom (QRect rect, QMouseEvent *event)
 
virtual Q_SLOT void processPointSelection (QMouseEvent *event)
 
bool registerPlottable (QCPAbstractPlottable *plottable)
 
bool registerGraph (QCPGraph *graph)
 
bool registerItem (QCPAbstractItem *item)
 
void updateLayerIndices () const
 
QCPLayerable * layerableAt (const QPointF &pos, bool onlySelectable, QVariant *selectionDetails=nullptr) const
 
QList< QCPLayerable * > layerableListAt (const QPointF &pos, bool onlySelectable, QList< QVariant > *selectionDetails=nullptr) const
 
void drawBackground (QCPPainter *painter)
 
void setupPaintBuffers ()
 
QCPAbstractPaintBuffer * createPaintBuffer ()
 
bool hasInvalidatedPaintBuffers ()
 
bool setupOpenGl ()
 
void freeOpenGl ()
 

Detailed Description

The central class of the library. This is the QWidget which displays the plot and interacts with the user.

For tutorials on how to use QCustomPlot, see the website
http://www.qcustomplot.com/

Member Enumeration Documentation

§ LayerInsertMode

enum QCustomPlot::LayerInsertMode

Defines how a layer should be inserted relative to an other layer.

See also
addLayer, moveLayer
Enumerator
limBelow 

Layer is inserted below other layer.

limAbove 

Layer is inserted above other layer.

§ RefreshPriority

enum QCustomPlot::RefreshPriority

Defines with what timing the QCustomPlot surface is refreshed after a replot.

See also
replot
Enumerator
rpImmediateRefresh 

Replots immediately and repaints the widget immediately by calling QWidget::repaint() after the replot.

rpQueuedRefresh 

Replots immediately, but queues the widget repaint, by calling QWidget::update() after the replot. This way multiple redundant widget repaints can be avoided.

rpRefreshHint 

Whether to use immediate or queued refresh depends on whether the plotting hint QCP::phImmediateRefresh is set, see setPlottingHints.

rpQueuedReplot 

Queues the entire replot for the next event loop iteration. This way multiple redundant replots can be avoided. The actual replot is then done with rpRefreshHint priority.

Constructor & Destructor Documentation

§ QCustomPlot()

QCustomPlot::QCustomPlot ( QWidget *  parent = nullptr)
explicit

Constructs a QCustomPlot and sets reasonable default values.

Member Function Documentation

§ plotLayout()

QCPLayoutGrid * QCustomPlot::plotLayout ( ) const
inline

Returns the top level layout of this QCustomPlot instance. It is a QCPLayoutGrid, initially containing just one cell with the main QCPAxisRect inside.

§ selectionRect()

QCPSelectionRect * QCustomPlot::selectionRect ( ) const
inline

Allows access to the currently used QCPSelectionRect instance (or subclass thereof), that is used to handle and draw selection rect interactions (see setSelectionRectMode).

See also
setSelectionRect

§ setViewport()

void QCustomPlot::setViewport ( const QRect &  rect)

Sets the viewport of this QCustomPlot. Usually users of QCustomPlot don't need to change the viewport manually.

The viewport is the area in which the plot is drawn. All mechanisms, e.g. margin calculation take the viewport to be the outer border of the plot. The viewport normally is the rect() of the QCustomPlot widget, i.e. a rect with top left (0, 0) and size of the QCustomPlot widget.

Don't confuse the viewport with the axis rect (QCustomPlot::axisRect). An axis rect is typically an area enclosed by four axes, where the graphs/plottables are drawn in. The viewport is larger and contains also the axes themselves, their tick numbers, their labels, or even additional axis rects, color scales and other layout elements.

This function is used to allow arbitrary size exports with toPixmap, savePng, savePdf, etc. by temporarily changing the viewport size.

§ setBufferDevicePixelRatio()

void QCustomPlot::setBufferDevicePixelRatio ( double  ratio)

Sets the device pixel ratio used by the paint buffers of this QCustomPlot instance.

Normally, this doesn't need to be set manually, because it is initialized with the regular QWidget::devicePixelRatio which is configured by Qt to fit the display device (e.g. 1 for normal displays, 2 for High-DPI displays).

Device pixel ratios are supported by Qt only for Qt versions since 5.4. If this method is called when QCustomPlot is being used with older Qt versions, outputs an according qDebug message and leaves the internal buffer device pixel ratio at 1.0.

§ setBackground() [1/3]

void QCustomPlot::setBackground ( const QPixmap &  pm)

Sets pm as the viewport background pixmap (see setViewport). The pixmap is always drawn below all other objects in the plot.

For cases where the provided pixmap doesn't have the same size as the viewport, scaling can be enabled with setBackgroundScaled and the scaling mode (whether and how the aspect ratio is preserved) can be set with setBackgroundScaledMode. To set all these options in one call, consider using the overloaded version of this function.

If a background brush was set with setBackground(const QBrush &brush), the viewport will first be filled with that brush, before drawing the background pixmap. This can be useful for background pixmaps with translucent areas.

See also
setBackgroundScaled, setBackgroundScaledMode

§ setBackground() [2/3]

void QCustomPlot::setBackground ( const QPixmap &  pm,
bool  scaled,
Qt::AspectRatioMode  mode = Qt::KeepAspectRatioByExpanding 
)

This is an overloaded function.

Allows setting the background pixmap of the viewport, whether it shall be scaled and how it shall be scaled in one call.

See also
setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode

§ setBackground() [3/3]

void QCustomPlot::setBackground ( const QBrush &  brush)

Sets the background brush of the viewport (see setViewport).

Before drawing everything else, the background is filled with brush. If a background pixmap was set with setBackground(const QPixmap &pm), this brush will be used to fill the viewport before the background pixmap is drawn. This can be useful for background pixmaps with translucent areas.

Set brush to Qt::NoBrush or Qt::Transparent to leave background transparent. This can be useful for exporting to image formats which support transparency, e.g. savePng.

See also
setBackgroundScaled, setBackgroundScaledMode

§ setBackgroundScaled()

void QCustomPlot::setBackgroundScaled ( bool  scaled)

Sets whether the viewport background pixmap shall be scaled to fit the viewport. If scaled is set to true, control whether and how the aspect ratio of the original pixmap is preserved with setBackgroundScaledMode.

Note that the scaled version of the original pixmap is buffered, so there is no performance penalty on replots. (Except when the viewport dimensions are changed continuously.)

See also
setBackground, setBackgroundScaledMode

§ setBackgroundScaledMode()

void QCustomPlot::setBackgroundScaledMode ( Qt::AspectRatioMode  mode)

If scaling of the viewport background pixmap is enabled (setBackgroundScaled), use this function to define whether and how the aspect ratio of the original pixmap is preserved.

See also
setBackground, setBackgroundScaled

§ setAntialiasedElements()

void QCustomPlot::setAntialiasedElements ( const QCP::AntialiasedElements &  antialiasedElements)

Sets which elements are forcibly drawn antialiased as an or combination of QCP::AntialiasedElement.

This overrides the antialiasing settings for whole element groups, normally controlled with the setAntialiasing function on the individual elements. If an element is neither specified in setAntialiasedElements nor in setNotAntialiasedElements, the antialiasing setting on each individual element instance is used.

For example, if antialiasedElements contains QCP::aePlottables, all plottables will be drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set to.

if an element in antialiasedElements is already set in setNotAntialiasedElements, it is removed from there.

See also
setNotAntialiasedElements

§ setAntialiasedElement()

void QCustomPlot::setAntialiasedElement ( QCP::AntialiasedElement  antialiasedElement,
bool  enabled = true 
)

Sets whether the specified antialiasedElement is forcibly drawn antialiased.

See setAntialiasedElements for details.

See also
setNotAntialiasedElement

§ setNotAntialiasedElements()

void QCustomPlot::setNotAntialiasedElements ( const QCP::AntialiasedElements &  notAntialiasedElements)

Sets which elements are forcibly drawn not antialiased as an or combination of QCP::AntialiasedElement.

This overrides the antialiasing settings for whole element groups, normally controlled with the setAntialiasing function on the individual elements. If an element is neither specified in setAntialiasedElements nor in setNotAntialiasedElements, the antialiasing setting on each individual element instance is used.

For example, if notAntialiasedElements contains QCP::aePlottables, no plottables will be drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set to.

if an element in notAntialiasedElements is already set in setAntialiasedElements, it is removed from there.

See also
setAntialiasedElements

§ setNotAntialiasedElement()

void QCustomPlot::setNotAntialiasedElement ( QCP::AntialiasedElement  notAntialiasedElement,
bool  enabled = true 
)

Sets whether the specified notAntialiasedElement is forcibly drawn not antialiased.

See setNotAntialiasedElements for details.

See also
setAntialiasedElement

§ setAutoAddPlottableToLegend()

void QCustomPlot::setAutoAddPlottableToLegend ( bool  on)

If set to true, adding a plottable (e.g. a graph) to the QCustomPlot automatically also adds the plottable to the legend (QCustomPlot::legend).

See also
addGraph, QCPLegend::addItem

§ setInteractions()

void QCustomPlot::setInteractions ( const QCP::Interactions &  interactions)

Sets the possible interactions of this QCustomPlot as an or-combination of QCP::Interaction enums. There are the following types of interactions:

Axis range manipulation is controlled via QCP::iRangeDrag and QCP::iRangeZoom. When the respective interaction is enabled, the user may drag axes ranges and zoom with the mouse wheel. For details how to control which axes the user may drag/zoom and in what orientations, see QCPAxisRect::setRangeDrag, QCPAxisRect::setRangeZoom, QCPAxisRect::setRangeDragAxes, QCPAxisRect::setRangeZoomAxes.

Plottable data selection is controlled by QCP::iSelectPlottables. If QCP::iSelectPlottables is set, the user may select plottables (graphs, curves, bars,...) and their data by clicking on them or in their vicinity (setSelectionTolerance). Whether the user can actually select a plottable and its data can further be restricted with the QCPAbstractPlottable::setSelectable method on the specific plottable. For details, see the special page about the data selection mechanism. To retrieve a list of all currently selected plottables, call selectedPlottables. If you're only interested in QCPGraphs, you may use the convenience function selectedGraphs.

Item selection is controlled by QCP::iSelectItems. If QCP::iSelectItems is set, the user may select items (QCPItemLine, QCPItemText,...) by clicking on them or in their vicinity. To find out whether a specific item is selected, call QCPAbstractItem::selected(). To retrieve a list of all currently selected items, call selectedItems.

Axis selection is controlled with QCP::iSelectAxes. If QCP::iSelectAxes is set, the user may select parts of the axes by clicking on them. What parts exactly (e.g. Axis base line, tick labels, axis label) are selectable can be controlled via QCPAxis::setSelectableParts for each axis. To retrieve a list of all axes that currently contain selected parts, call selectedAxes. Which parts of an axis are selected, can be retrieved with QCPAxis::selectedParts().

Legend selection is controlled with QCP::iSelectLegend. If this is set, the user may select the legend itself or individual items by clicking on them. What parts exactly are selectable can be controlled via QCPLegend::setSelectableParts. To find out whether the legend or any of its child items are selected, check the value of QCPLegend::selectedParts. To find out which child items are selected, call QCPLegend::selectedItems.

All other selectable elements The selection of all other selectable objects (e.g. QCPTextElement, or your own layerable subclasses) is controlled with QCP::iSelectOther. If set, the user may select those objects by clicking on them. To find out which are currently selected, you need to check their selected state explicitly.

If the selection state has changed by user interaction, the selectionChangedByUser signal is emitted. Each selectable object additionally emits an individual selectionChanged signal whenever their selection state has changed, i.e. not only by user interaction.

To allow multiple objects to be selected by holding the selection modifier (setMultiSelectModifier), set the flag QCP::iMultiSelect.

Note
In addition to the selection mechanism presented here, QCustomPlot always emits corresponding signals, when an object is clicked or double clicked. see plottableClick and plottableDoubleClick for example.
See also
setInteraction, setSelectionTolerance

§ setInteraction()

void QCustomPlot::setInteraction ( const QCP::Interaction &  interaction,
bool  enabled = true 
)

Sets the single interaction of this QCustomPlot to enabled.

For details about the interaction system, see setInteractions.

See also
setInteractions

§ setSelectionTolerance()

void QCustomPlot::setSelectionTolerance ( int  pixels)

Sets the tolerance that is used to decide whether a click selects an object (e.g. a plottable) or not.

If the user clicks in the vicinity of the line of e.g. a QCPGraph, it's only regarded as a potential selection when the minimum distance between the click position and the graph line is smaller than pixels. Objects that are defined by an area (e.g. QCPBars) only react to clicks directly inside the area and ignore this selection tolerance. In other words, it only has meaning for parts of objects that are too thin to exactly hit with a click and thus need such a tolerance.

See also
setInteractions, QCPLayerable::selectTest

§ setNoAntialiasingOnDrag()

void QCustomPlot::setNoAntialiasingOnDrag ( bool  enabled)

Sets whether antialiasing is disabled for this QCustomPlot while the user is dragging axes ranges. If many objects, especially plottables, are drawn antialiased, this greatly improves performance during dragging. Thus it creates a more responsive user experience. As soon as the user stops dragging, the last replot is done with normal antialiasing, to restore high image quality.

See also
setAntialiasedElements, setNotAntialiasedElements

§ setPlottingHints()

void QCustomPlot::setPlottingHints ( const QCP::PlottingHints &  hints)

Sets the plotting hints for this QCustomPlot instance as an or combination of QCP::PlottingHint.

See also
setPlottingHint

§ setPlottingHint()

void QCustomPlot::setPlottingHint ( QCP::PlottingHint  hint,
bool  enabled = true 
)

Sets the specified plotting hint to enabled.

See also
setPlottingHints

§ setMultiSelectModifier()

void QCustomPlot::setMultiSelectModifier ( Qt::KeyboardModifier  modifier)

Sets the keyboard modifier that will be recognized as multi-select-modifier.

If QCP::iMultiSelect is specified in setInteractions, the user may select multiple objects (or data points) by clicking on them one after the other while holding down modifier.

By default the multi-select-modifier is set to Qt::ControlModifier.

See also
setInteractions

§ setSelectionRectMode()

void QCustomPlot::setSelectionRectMode ( QCP::SelectionRectMode  mode)

Sets how QCustomPlot processes mouse click-and-drag interactions by the user.

If mode is QCP::srmNone, the mouse drag is forwarded to the underlying objects. For example, QCPAxisRect may process a mouse drag by dragging axis ranges, see QCPAxisRect::setRangeDrag. If mode is not QCP::srmNone, the current selection rect (selectionRect) becomes activated and allows e.g. rect zooming and data point selection.

If you wish to provide your user both with axis range dragging and data selection/range zooming, use this method to switch between the modes just before the interaction is processed, e.g. in reaction to the mousePress or mouseMove signals. For example you could check whether the user is holding a certain keyboard modifier, and then decide which mode shall be set.

If a selection rect interaction is currently active, and mode is set to QCP::srmNone, the interaction is canceled (QCPSelectionRect::cancel). Switching between any of the other modes will keep the selection rect active. Upon completion of the interaction, the behaviour is as defined by the currently set mode, not the mode that was set when the interaction started.

See also
setInteractions, setSelectionRect, QCPSelectionRect

§ setSelectionRect()

void QCustomPlot::setSelectionRect ( QCPSelectionRect *  selectionRect)

Sets the QCPSelectionRect instance that QCustomPlot will use if mode is not QCP::srmNone and the user performs a click-and-drag interaction. QCustomPlot takes ownership of the passed selectionRect. It can be accessed later via selectionRect.

This method is useful if you wish to replace the default QCPSelectionRect instance with an instance of a QCPSelectionRect subclass, to introduce custom behaviour of the selection rect.

See also
setSelectionRectMode

§ setOpenGl()

void QCustomPlot::setOpenGl ( bool  enabled,
int  multisampling = 16 
)
Warning
This is still an experimental feature and its performance depends on the system that it runs on. Having multiple QCustomPlot widgets in one application with enabled OpenGL rendering might cause context conflicts on some systems.

This method allows to enable OpenGL plot rendering, for increased plotting performance of graphically demanding plots (thick lines, translucent fills, etc.).

If enabled is set to true, QCustomPlot will try to initialize OpenGL and, if successful, continue plotting with hardware acceleration. The parameter multisampling controls how many samples will be used per pixel, it essentially controls the antialiasing quality. If multisampling is set too high for the current graphics hardware, the maximum allowed value will be used.

You can test whether switching to OpenGL rendering was successful by checking whether the according getter QCustomPlot::openGl() returns true. If the OpenGL initialization fails, rendering continues with the regular software rasterizer, and an according qDebug output is generated.

If switching to OpenGL was successful, this method disables label caching (setPlottingHint(QCP::phCacheLabels, false)) and turns on QCustomPlot's antialiasing override for all elements (setAntialiasedElements(QCP::aeAll)), leading to a higher quality output. The antialiasing override allows for pixel-grid aligned drawing in the OpenGL paint device. As stated before, in OpenGL rendering the actual antialiasing of the plot is controlled with multisampling. If enabled is set to false, the antialiasing/label caching settings are restored to what they were before OpenGL was enabled, if they weren't altered in the meantime.

Note
OpenGL support is only enabled if QCustomPlot is compiled with the macro QCUSTOMPLOT_USE_OPENGL defined. This define must be set before including the QCustomPlot header both during compilation of the QCustomPlot library as well as when compiling your application. It is best to just include the line DEFINES += QCUSTOMPLOT_USE_OPENGL in the respective qmake project files.
If you are using a Qt version before 5.0, you must also add the module "opengl" to your QT variable in the qmake project files. For Qt versions 5.0 and higher, QCustomPlot switches to a newer OpenGL interface which is already in the "gui" module.

§ plottable() [1/2]

QCPAbstractPlottable * QCustomPlot::plottable ( int  index)

Returns the plottable with index. If the index is invalid, returns nullptr.

There is an overloaded version of this function with no parameter which returns the last added plottable, see QCustomPlot::plottable()

See also
plottableCount

§ plottable() [2/2]

QCPAbstractPlottable * QCustomPlot::plottable ( )

This is an overloaded function.

Returns the last plottable that was added to the plot. If there are no plottables in the plot, returns nullptr.

See also
plottableCount

§ removePlottable() [1/2]

bool QCustomPlot::removePlottable ( QCPAbstractPlottable *  plottable)

Removes the specified plottable from the plot and deletes it. If necessary, the corresponding legend item is also removed from the default legend (QCustomPlot::legend).

Returns true on success.

See also
clearPlottables

§ removePlottable() [2/2]

bool QCustomPlot::removePlottable ( int  index)

This is an overloaded function.

Removes and deletes the plottable by its index.

§ clearPlottables()

int QCustomPlot::clearPlottables ( )

Removes all plottables from the plot and deletes them. Corresponding legend items are also removed from the default legend (QCustomPlot::legend).

Returns the number of plottables removed.

See also
removePlottable

§ plottableCount()

int QCustomPlot::plottableCount ( ) const

Returns the number of currently existing plottables in the plot

See also
plottable

§ selectedPlottables()

QList< QCPAbstractPlottable * > QCustomPlot::selectedPlottables ( ) const

Returns a list of the selected plottables. If no plottables are currently selected, the list is empty.

There is a convenience function if you're only interested in selected graphs, see selectedGraphs.

See also
setInteractions, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelection

§ plottableAt() [1/2]

template<class PlottableType >
PlottableType * QCustomPlot::plottableAt ( const QPointF &  pos,
bool  onlySelectable = false,
int *  dataIndex = nullptr 
) const

Returns the plottable at the pixel position pos. The plottable type (a QCPAbstractPlottable subclass) that shall be taken into consideration can be specified via the template parameter.

Plottables that only consist of single lines (like graphs) have a tolerance band around them, see setSelectionTolerance. If multiple plottables come into consideration, the one closest to pos is returned.

If onlySelectable is true, only plottables that are selectable (QCPAbstractPlottable::setSelectable) are considered.

if dataIndex is non-null, it is set to the index of the plottable's data point that is closest to pos.

If there is no plottable of the specified type at pos, returns nullptr.

See also
itemAt, layoutElementAt

§ plottableAt() [2/2]

QCPAbstractPlottable * QCustomPlot::plottableAt ( const QPointF &  pos,
bool  onlySelectable = false,
int *  dataIndex = nullptr 
) const

Returns any plottable at the pixel position pos. Since it can capture all plottables, the return type is the abstract base class of all plottables, QCPAbstractPlottable.

For details, and if you wish to specify a certain plottable type (e.g. QCPGraph), see the template method plottableAt<PlottableType>()

See also
plottableAt<PlottableType>(), itemAt, layoutElementAt

§ hasPlottable()

bool QCustomPlot::hasPlottable ( QCPAbstractPlottable *  plottable) const

Returns whether this QCustomPlot instance contains the plottable.

§ graph() [1/2]

QCPGraph * QCustomPlot::graph ( int  index) const

Returns the graph with index. If the index is invalid, returns nullptr.

There is an overloaded version of this function with no parameter which returns the last created graph, see QCustomPlot::graph()

See also
graphCount, addGraph

§ graph() [2/2]

QCPGraph * QCustomPlot::graph ( ) const

This is an overloaded function.

Returns the last graph, that was created with addGraph. If there are no graphs in the plot, returns nullptr.

See also
graphCount, addGraph

§ addGraph()

QCPGraph * QCustomPlot::addGraph ( QCPAxis *  keyAxis = nullptr,
QCPAxis *  valueAxis = nullptr 
)

Creates a new graph inside the plot. If keyAxis and valueAxis are left unspecified (0), the bottom (xAxis) is used as key and the left (yAxis) is used as value axis. If specified, keyAxis and valueAxis must reside in this QCustomPlot.

keyAxis will be used as key axis (typically "x") and valueAxis as value axis (typically "y") for the graph.

Returns a pointer to the newly created graph, or nullptr if adding the graph failed.

See also
graph, graphCount, removeGraph, clearGraphs

§ removeGraph() [1/2]

bool QCustomPlot::removeGraph ( QCPGraph *  graph)

Removes the specified graph from the plot and deletes it. If necessary, the corresponding legend item is also removed from the default legend (QCustomPlot::legend). If any other graphs in the plot have a channel fill set towards the removed graph, the channel fill property of those graphs is reset to nullptr (no channel fill).

Returns true on success.

See also
clearGraphs

§ removeGraph() [2/2]

bool QCustomPlot::removeGraph ( int  index)

This is an overloaded function.

Removes and deletes the graph by its index.

§ clearGraphs()

int QCustomPlot::clearGraphs ( )

Removes all graphs from the plot and deletes them. Corresponding legend items are also removed from the default legend (QCustomPlot::legend).

Returns the number of graphs removed.

See also
removeGraph

§ graphCount()

int QCustomPlot::graphCount ( ) const

Returns the number of currently existing graphs in the plot

See also
graph, addGraph

§ selectedGraphs()

QList< QCPGraph * > QCustomPlot::selectedGraphs ( ) const

Returns a list of the selected graphs. If no graphs are currently selected, the list is empty.

If you are not only interested in selected graphs but other plottables like QCPCurve, QCPBars, etc., use selectedPlottables.

See also
setInteractions, selectedPlottables, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelection

§ item() [1/2]

QCPAbstractItem * QCustomPlot::item ( int  index) const

Returns the item with index. If the index is invalid, returns nullptr.

There is an overloaded version of this function with no parameter which returns the last added item, see QCustomPlot::item()

See also
itemCount

§ item() [2/2]

QCPAbstractItem * QCustomPlot::item ( ) const

This is an overloaded function.

Returns the last item that was added to this plot. If there are no items in the plot, returns nullptr.

See also
itemCount

§ removeItem() [1/2]

bool QCustomPlot::removeItem ( QCPAbstractItem *  item)

Removes the specified item from the plot and deletes it.

Returns true on success.

See also
clearItems

§ removeItem() [2/2]

bool QCustomPlot::removeItem ( int  index)

This is an overloaded function.

Removes and deletes the item by its index.

§ clearItems()

int QCustomPlot::clearItems ( )

Removes all items from the plot and deletes them.

Returns the number of items removed.

See also
removeItem

§ itemCount()

int QCustomPlot::itemCount ( ) const

Returns the number of currently existing items in the plot

See also
item

§ selectedItems()

QList< QCPAbstractItem * > QCustomPlot::selectedItems ( ) const

Returns a list of the selected items. If no items are currently selected, the list is empty.

See also
setInteractions, QCPAbstractItem::setSelectable, QCPAbstractItem::setSelected

§ itemAt() [1/2]

template<class ItemType >
ItemType * QCustomPlot::itemAt ( const QPointF &  pos,
bool  onlySelectable = false 
) const

Returns the item at the pixel position pos. The item type (a QCPAbstractItem subclass) that shall be taken into consideration can be specified via the template parameter. Items that only consist of single lines (e.g. QCPItemLine or QCPItemCurve) have a tolerance band around them, see setSelectionTolerance. If multiple items come into consideration, the one closest to pos is returned.

If onlySelectable is true, only items that are selectable (QCPAbstractItem::setSelectable) are considered.

If there is no item at pos, returns nullptr.

See also
plottableAt, layoutElementAt

§ itemAt() [2/2]

QCPAbstractItem * QCustomPlot::itemAt ( const QPointF &  pos,
bool  onlySelectable = false 
) const

Returns the item at the pixel position pos. Since it can capture all items, the return type is the abstract base class of all items, QCPAbstractItem.

For details, and if you wish to specify a certain item type (e.g. QCPItemLine), see the template method itemAt<ItemType>()

See also
itemAt<ItemType>(), plottableAt, layoutElementAt

§ hasItem()

bool QCustomPlot::hasItem ( QCPAbstractItem *  item) const

Returns whether this QCustomPlot contains the item.

See also
item

§ layer() [1/2]

QCPLayer * QCustomPlot::layer ( const QString &  name) const

Returns the layer with the specified name. If there is no layer with the specified name, nullptr is returned.

Layer names are case-sensitive.

See also
addLayer, moveLayer, removeLayer

§ layer() [2/2]

QCPLayer * QCustomPlot::layer ( int  index) const

This is an overloaded function.

Returns the layer by index. If the index is invalid, nullptr is returned.

See also
addLayer, moveLayer, removeLayer

§ currentLayer()

QCPLayer * QCustomPlot::currentLayer ( ) const

Returns the layer that is set as current layer (see setCurrentLayer).

§ setCurrentLayer() [1/2]

bool QCustomPlot::setCurrentLayer ( const QString &  name)

Sets the layer with the specified name to be the current layer. All layerables (QCPLayerable), e.g. plottables and items, are created on the current layer.

Returns true on success, i.e. if there is a layer with the specified name in the QCustomPlot.

Layer names are case-sensitive.

See also
addLayer, moveLayer, removeLayer, QCPLayerable::setLayer

§ setCurrentLayer() [2/2]

bool QCustomPlot::setCurrentLayer ( QCPLayer *  layer)

This is an overloaded function.

Sets the provided layer to be the current layer.

Returns true on success, i.e. when layer is a valid layer in the QCustomPlot.

See also
addLayer, moveLayer, removeLayer

§ layerCount()

int QCustomPlot::layerCount ( ) const

Returns the number of currently existing layers in the plot

See also
layer, addLayer

§ addLayer()

bool QCustomPlot::addLayer ( const QString &  name,
QCPLayer *  otherLayer = nullptr,
QCustomPlot::LayerInsertMode  insertMode = limAbove 
)

Adds a new layer to this QCustomPlot instance. The new layer will have the name name, which must be unique. Depending on insertMode, it is positioned either below or above otherLayer.

Returns true on success, i.e. if there is no other layer named name and otherLayer is a valid layer inside this QCustomPlot.

If otherLayer is 0, the highest layer in the QCustomPlot will be used.

For an explanation of what layers are in QCustomPlot, see the documentation of QCPLayer.

See also
layer, moveLayer, removeLayer

§ removeLayer()

bool QCustomPlot::removeLayer ( QCPLayer *  layer)

Removes the specified layer and returns true on success.

All layerables (e.g. plottables and items) on the removed layer will be moved to the layer below layer. If layer is the bottom layer, the layerables are moved to the layer above. In both cases, the total rendering order of all layerables in the QCustomPlot is preserved.

If layer is the current layer (setCurrentLayer), the layer below (or above, if bottom layer) becomes the new current layer.

It is not possible to remove the last layer of the plot.

See also
layer, addLayer, moveLayer

§ moveLayer()

bool QCustomPlot::moveLayer ( QCPLayer *  layer,
QCPLayer *  otherLayer,
QCustomPlot::LayerInsertMode  insertMode = limAbove 
)

Moves the specified layer either above or below otherLayer. Whether it's placed above or below is controlled with insertMode.

Returns true on success, i.e. when both layer and otherLayer are valid layers in the QCustomPlot.

See also
layer, addLayer, moveLayer

§ axisRectCount()

int QCustomPlot::axisRectCount ( ) const

Returns the number of axis rects in the plot.

All axis rects can be accessed via QCustomPlot::axisRect().

Initially, only one axis rect exists in the plot.

See also
axisRect, axisRects

§ axisRect()

QCPAxisRect * QCustomPlot::axisRect ( int  index = 0) const

Returns the axis rect with index.

Initially, only one axis rect (with index 0) exists in the plot. If multiple axis rects were added, all of them may be accessed with this function in a linear fashion (even when they are nested in a layout hierarchy or inside other axis rects via QCPAxisRect::insetLayout).

The order of the axis rects is given by the fill order of the QCPLayout that is holding them. For example, if the axis rects are in the top level grid layout (accessible via QCustomPlot::plotLayout), they are ordered from left to right, top to bottom, if the layout's default setFillOrder of foColumnsFirst wasn't changed.

If you want to access axis rects by their row and column index, use the layout interface. For example, use QCPLayoutGrid::element of the top level grid layout, and qobject_cast the returned layout element to QCPAxisRect. (See also The Layout System.)

See also
axisRectCount, axisRects, QCPLayoutGrid::setFillOrder

§ axisRects()

QList< QCPAxisRect * > QCustomPlot::axisRects ( ) const

Returns all axis rects in the plot.

The order of the axis rects is given by the fill order of the QCPLayout that is holding them. For example, if the axis rects are in the top level grid layout (accessible via QCustomPlot::plotLayout), they are ordered from left to right, top to bottom, if the layout's default setFillOrder of foColumnsFirst wasn't changed.

See also
axisRectCount, axisRect, QCPLayoutGrid::setFillOrder

§ layoutElementAt()

QCPLayoutElement * QCustomPlot::layoutElementAt ( const QPointF &  pos) const

Returns the layout element at pixel position pos. If there is no element at that position, returns nullptr.

Only visible elements are used. If QCPLayoutElement::setVisible on the element itself or on any of its parent elements is set to false, it will not be considered.

See also
itemAt, plottableAt

§ axisRectAt()

QCPAxisRect * QCustomPlot::axisRectAt ( const QPointF &  pos) const

Returns the layout element of type QCPAxisRect at pixel position pos. This method ignores other layout elements even if they are visually in front of the axis rect (e.g. a QCPLegend). If there is no axis rect at that position, returns nullptr.

Only visible axis rects are used. If QCPLayoutElement::setVisible on the axis rect itself or on any of its parent elements is set to false, it will not be considered.

See also
layoutElementAt

§ rescaleAxes()

void QCustomPlot::rescaleAxes ( bool  onlyVisiblePlottables = false)

Rescales the axes such that all plottables (like graphs) in the plot are fully visible.

if onlyVisiblePlottables is set to true, only the plottables that have their visibility set to true (QCPLayerable::setVisible), will be used to rescale the axes.

See also
QCPAbstractPlottable::rescaleAxes, QCPAxis::rescale

§ selectedAxes()

QList< QCPAxis * > QCustomPlot::selectedAxes ( ) const

Returns the axes that currently have selected parts, i.e. whose selection state is not QCPAxis::spNone.

See also
selectedPlottables, selectedLegends, setInteractions, QCPAxis::setSelectedParts, QCPAxis::setSelectableParts

§ selectedLegends()

QList< QCPLegend * > QCustomPlot::selectedLegends ( ) const

Returns the legends that currently have selected parts, i.e. whose selection state is not QCPLegend::spNone.

See also
selectedPlottables, selectedAxes, setInteractions, QCPLegend::setSelectedParts, QCPLegend::setSelectableParts, QCPLegend::selectedItems

§ deselectAll()

void QCustomPlot::deselectAll ( )

Deselects all layerables (plottables, items, axes, legends,...) of the QCustomPlot.

Since calling this function is not a user interaction, this does not emit the selectionChangedByUser signal. The individual selectionChanged signals are emitted though, if the objects were previously selected.

See also
setInteractions, selectedPlottables, selectedItems, selectedAxes, selectedLegends

§ savePdf()

bool QCustomPlot::savePdf ( const QString &  fileName,
int  width = 0,
int  height = 0,
QCP::ExportPen  exportPen = QCP::epAllowCosmetic,
const QString &  pdfCreator = QString(),
const QString &  pdfTitle = QString() 
)

Saves a PDF with the vectorized plot to the file fileName. The axis ratio as well as the scale of texts and lines will be derived from the specified width and height. This means, the output will look like the normal on-screen output of a QCustomPlot widget with the corresponding pixel width and height. If either width or height is zero, the exported image will have the same dimensions as the QCustomPlot widget currently has.

Setting exportPen to QCP::epNoCosmetic allows to disable the use of cosmetic pens when drawing to the PDF file. Cosmetic pens are pens with numerical width 0, which are always drawn as a one pixel wide line, no matter what zoom factor is set in the PDF-Viewer. For more information about cosmetic pens, see the QPainter and QPen documentation.

The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with deselectAll before calling this function.

Returns true on success.

Warning
  • If you plan on editing the exported PDF file with a vector graphics editor like Inkscape, it is advised to set exportPen to QCP::epNoCosmetic to avoid losing those cosmetic lines (which might be quite many, because cosmetic pens are the default for e.g. axes and tick marks).
  • If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave width or height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights.
pdfCreator and pdfTitle may be used to set the according metadata fields in the resulting PDF file.
Note
On Android systems, this method does nothing and issues an according qDebug warning message. This is also the case if for other reasons the define flag QT_NO_PRINTER is set.
See also
savePng, saveBmp, saveJpg, saveRastered

§ savePng()

bool QCustomPlot::savePng ( const QString &  fileName,
int  width = 0,
int  height = 0,
double  scale = 1.0,
int  quality = -1,
int  resolution = 96,
QCP::ResolutionUnit  resolutionUnit = QCP::ruDotsPerInch 
)

Saves a PNG image file to fileName on disc. The output plot will have the dimensions width and height in pixels, multiplied by scale. If either width or height is zero, the current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. are not scaled up when larger widths/heights are used. If you want that effect, use the scale parameter.

For example, if you set both width and height to 100 and scale to 2, you will end up with an image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full 200*200 pixel resolution.

If you use a high scaling factor, it is recommended to enable antialiasing for all elements by temporarily setting QCustomPlot::setAntialiasedElements to QCP::aeAll as this allows QCustomPlot to place objects with sub-pixel accuracy.

image compression can be controlled with the quality parameter which must be between 0 and 100 or -1 to use the default setting.

The resolution will be written to the image file header and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units resolution is given, by setting resolutionUnit. The resolution is converted to the format's expected resolution unit internally.

Returns true on success. If this function fails, most likely the PNG format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats().

The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with deselectAll before calling this function.

If you want the PNG to have a transparent background, call setBackground(const QBrush &brush) with no brush (Qt::NoBrush) or a transparent color (Qt::transparent), before saving.

Warning
If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave width or height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights.
See also
savePdf, saveBmp, saveJpg, saveRastered

§ saveJpg()

bool QCustomPlot::saveJpg ( const QString &  fileName,
int  width = 0,
int  height = 0,
double  scale = 1.0,
int  quality = -1,
int  resolution = 96,
QCP::ResolutionUnit  resolutionUnit = QCP::ruDotsPerInch 
)

Saves a JPEG image file to fileName on disc. The output plot will have the dimensions width and height in pixels, multiplied by scale. If either width or height is zero, the current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. are not scaled up when larger widths/heights are used. If you want that effect, use the scale parameter.

For example, if you set both width and height to 100 and scale to 2, you will end up with an image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full 200*200 pixel resolution.

If you use a high scaling factor, it is recommended to enable antialiasing for all elements by temporarily setting QCustomPlot::setAntialiasedElements to QCP::aeAll as this allows QCustomPlot to place objects with sub-pixel accuracy.

image compression can be controlled with the quality parameter which must be between 0 and 100 or -1 to use the default setting.

The resolution will be written to the image file header and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units resolution is given, by setting resolutionUnit. The resolution is converted to the format's expected resolution unit internally.

Returns true on success. If this function fails, most likely the JPEG format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats().

The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with deselectAll before calling this function.

Warning
If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave width or height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights.
See also
savePdf, savePng, saveBmp, saveRastered

§ saveBmp()

bool QCustomPlot::saveBmp ( const QString &  fileName,
int  width = 0,
int  height = 0,
double  scale = 1.0,
int  resolution = 96,
QCP::ResolutionUnit  resolutionUnit = QCP::ruDotsPerInch 
)

Saves a BMP image file to fileName on disc. The output plot will have the dimensions width and height in pixels, multiplied by scale. If either width or height is zero, the current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. are not scaled up when larger widths/heights are used. If you want that effect, use the scale parameter.

For example, if you set both width and height to 100 and scale to 2, you will end up with an image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full 200*200 pixel resolution.

If you use a high scaling factor, it is recommended to enable antialiasing for all elements by temporarily setting QCustomPlot::setAntialiasedElements to QCP::aeAll as this allows QCustomPlot to place objects with sub-pixel accuracy.

The resolution will be written to the image file header and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units resolution is given, by setting resolutionUnit. The resolution is converted to the format's expected resolution unit internally.

Returns true on success. If this function fails, most likely the BMP format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats().

The objects of the plot will appear in the current selection state. If you don't want any selected objects to be painted in their selected look, deselect everything with deselectAll before calling this function.

Warning
If calling this function inside the constructor of the parent of the QCustomPlot widget (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide explicit non-zero widths and heights. If you leave width or height as 0 (default), this function uses the current width and height of the QCustomPlot widget. However, in Qt, these aren't defined yet inside the constructor, so you would get an image that has strange widths/heights.
See also
savePdf, savePng, saveJpg, saveRastered

§ saveRastered()

bool QCustomPlot::saveRastered ( const QString &  fileName,
int  width,
int  height,
double  scale,
const char *  format,
int  quality = -1,
int  resolution = 96,
QCP::ResolutionUnit  resolutionUnit = QCP::ruDotsPerInch 
)

Saves the plot to a rastered image file fileName in the image format format. The plot is sized to width and height in pixels and scaled with scale. (width 100 and scale 2.0 lead to a full resolution file with width 200.) If the format supports compression, quality may be between 0 and 100 to control it.

Returns true on success. If this function fails, most likely the given format isn't supported by the system, see Qt docs about QImageWriter::supportedImageFormats().

The resolution will be written to the image file header (if the file format supports this) and has no direct consequence for the quality or the pixel size. However, if opening the image with a tool which respects the metadata, it will be able to scale the image to match either a given size in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in which units resolution is given, by setting resolutionUnit. The resolution is converted to the format's expected resolution unit internally.

See also
saveBmp, saveJpg, savePng, savePdf

§ toPixmap()

QPixmap QCustomPlot::toPixmap ( int  width = 0,
int  height = 0,
double  scale = 1.0 
)

Renders the plot to a pixmap and returns it.

The plot is sized to width and height in pixels and scaled with scale. (width 100 and scale 2.0 lead to a full resolution pixmap with width 200.)

See also
toPainter, saveRastered, saveBmp, savePng, saveJpg, savePdf

§ toPainter()

void QCustomPlot::toPainter ( QCPPainter *  painter,
int  width = 0,
int  height = 0 
)

Renders the plot using the passed painter.

The plot is sized to width and height in pixels. If the painter's scale is not 1.0, the resulting plot will appear scaled accordingly.

Note
If you are restricted to using a QPainter (instead of QCPPainter), create a temporary QPicture and open a QCPPainter on it. Then call toPainter with this QCPPainter. After ending the paint operation on the picture, draw it with the QPainter. This will reproduce the painter actions the QCPPainter took, with a QPainter.
See also
toPixmap

§ replot()

void QCustomPlot::replot ( QCustomPlot::RefreshPriority  refreshPriority = QCustomPlot::rpRefreshHint)

Causes a complete replot into the internal paint buffer(s). Finally, the widget surface is refreshed with the new buffer contents. This is the method that must be called to make changes to the plot, e.g. on the axis ranges or data points of graphs, visible.

The parameter refreshPriority can be used to fine-tune the timing of the replot. For example if your application calls replot very quickly in succession (e.g. multiple independent functions change some aspects of the plot and each wants to make sure the change gets replotted), it is advisable to set refreshPriority to QCustomPlot::rpQueuedReplot. This way, the actual replotting is deferred to the next event loop iteration. Multiple successive calls of replot with this priority will only cause a single replot, avoiding redundant replots and improving performance.

Under a few circumstances, QCustomPlot causes a replot by itself. Those are resize events of the QCustomPlot widget and user interactions (object selection and range dragging/zooming).

Before the replot happens, the signal beforeReplot is emitted. After the replot, afterReplot is emitted. It is safe to mutually connect the replot slot with any of those two signals on two QCustomPlots to make them replot synchronously, it won't cause an infinite recursion.

If a layer is in mode QCPLayer::lmBuffered (QCPLayer::setMode), it is also possible to replot only that specific layer via QCPLayer::replot. See the documentation there for details.

See also
replotTime

§ replotTime()

double QCustomPlot::replotTime ( bool  average = false) const

Returns the time in milliseconds that the last replot took. If average is set to true, an exponential moving average over the last couple of replots is returned.

See also
replot

§ mouseDoubleClick

void QCustomPlot::mouseDoubleClick ( QMouseEvent *  event)
signal

This signal is emitted when the QCustomPlot receives a mouse double click event.

§ mousePress

void QCustomPlot::mousePress ( QMouseEvent *  event)
signal

This signal is emitted when the QCustomPlot receives a mouse press event.

It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot connected to this signal can still influence the behaviour e.g. with QCPAxisRect::setRangeDrag or QCPAxisRect::setRangeDragAxes.

§ mouseMove

void QCustomPlot::mouseMove ( QMouseEvent *  event)
signal

This signal is emitted when the QCustomPlot receives a mouse move event.

It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot connected to this signal can still influence the behaviour e.g. with QCPAxisRect::setRangeDrag or QCPAxisRect::setRangeDragAxes.

Warning
It is discouraged to change the drag-axes with QCPAxisRect::setRangeDragAxes here, because the dragging starting point was saved the moment the mouse was pressed. Thus it only has a meaning for the range drag axes that were set at that moment. If you want to change the drag axes, consider doing this in the mousePress signal instead.

§ mouseRelease

void QCustomPlot::mouseRelease ( QMouseEvent *  event)
signal

This signal is emitted when the QCustomPlot receives a mouse release event.

It is emitted before QCustomPlot handles any other mechanisms like object selection. So a slot connected to this signal can still influence the behaviour e.g. with setInteractions or QCPAbstractPlottable::setSelectable.

§ mouseWheel

void QCustomPlot::mouseWheel ( QWheelEvent *  event)
signal

This signal is emitted when the QCustomPlot receives a mouse wheel event.

It is emitted before QCustomPlot handles any other mechanisms like range zooming. So a slot connected to this signal can still influence the behaviour e.g. with QCPAxisRect::setRangeZoom, QCPAxisRect::setRangeZoomAxes or QCPAxisRect::setRangeZoomFactor.

§ plottableClick

void QCustomPlot::plottableClick ( QCPAbstractPlottable *  plottable,
int  dataIndex,
QMouseEvent *  event 
)
signal

This signal is emitted when a plottable is clicked.

event is the mouse event that caused the click and plottable is the plottable that received the click. The parameter dataIndex indicates the data point that was closest to the click position.

See also
plottableDoubleClick

§ plottableDoubleClick

void QCustomPlot::plottableDoubleClick ( QCPAbstractPlottable *  plottable,
int  dataIndex,
QMouseEvent *  event 
)
signal

This signal is emitted when a plottable is double clicked.

event is the mouse event that caused the click and plottable is the plottable that received the click. The parameter dataIndex indicates the data point that was closest to the click position.

See also
plottableClick

§ itemClick

void QCustomPlot::itemClick ( QCPAbstractItem *  item,
QMouseEvent *  event 
)
signal

This signal is emitted when an item is clicked.

event is the mouse event that caused the click and item is the item that received the click.

See also
itemDoubleClick

§ itemDoubleClick

void QCustomPlot::itemDoubleClick ( QCPAbstractItem *  item,
QMouseEvent *  event 
)
signal

This signal is emitted when an item is double clicked.

event is the mouse event that caused the click and item is the item that received the click.

See also
itemClick

§ axisClick

void QCustomPlot::axisClick ( QCPAxis *  axis,
QCPAxis::SelectablePart  part,
QMouseEvent *  event 
)
signal

This signal is emitted when an axis is clicked.

event is the mouse event that caused the click, axis is the axis that received the click and part indicates the part of the axis that was clicked.

See also
axisDoubleClick

§ axisDoubleClick

void QCustomPlot::axisDoubleClick ( QCPAxis *  axis,
QCPAxis::SelectablePart  part,
QMouseEvent *  event 
)
signal

This signal is emitted when an axis is double clicked.

event is the mouse event that caused the click, axis is the axis that received the click and part indicates the part of the axis that was clicked.

See also
axisClick

§ legendClick

void QCustomPlot::legendClick ( QCPLegend *  legend,
QCPAbstractLegendItem *  item,
QMouseEvent *  event 
)
signal

This signal is emitted when a legend (item) is clicked.

event is the mouse event that caused the click, legend is the legend that received the click and item is the legend item that received the click. If only the legend and no item is clicked, item is nullptr. This happens for a click inside the legend padding or the space between two items.

See also
legendDoubleClick

§ legendDoubleClick

void QCustomPlot::legendDoubleClick ( QCPLegend *  legend,
QCPAbstractLegendItem *  item,
QMouseEvent *  event 
)
signal

This signal is emitted when a legend (item) is double clicked.

event is the mouse event that caused the click, legend is the legend that received the click and item is the legend item that received the click. If only the legend and no item is clicked, item is nullptr. This happens for a click inside the legend padding or the space between two items.

See also
legendClick

§ selectionChangedByUser

void QCustomPlot::selectionChangedByUser ( )
signal

This signal is emitted after the user has changed the selection in the QCustomPlot, e.g. by clicking. It is not emitted when the selection state of an object has changed programmatically by a direct call to setSelected()/setSelection() on an object or by calling deselectAll.

In addition to this signal, selectable objects also provide individual signals, for example QCPAxis::selectionChanged or QCPAbstractPlottable::selectionChanged. Note that those signals are emitted even if the selection state is changed programmatically.

See the documentation of setInteractions for details about the selection mechanism.

See also
selectedPlottables, selectedGraphs, selectedItems, selectedAxes, selectedLegends

§ beforeReplot

void QCustomPlot::beforeReplot ( )
signal

This signal is emitted immediately before a replot takes place (caused by a call to the slot replot).

It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them replot synchronously, it won't cause an infinite recursion.

See also
replot, afterReplot, afterLayout

§ afterLayout

void QCustomPlot::afterLayout ( )
signal

This signal is emitted immediately after the layout step has been completed, which occurs right before drawing the plot. This is typically during a call to replot, and in such cases this signal is emitted in between the signals beforeReplot and afterReplot. Unlike those signals however, this signal is also emitted during off-screen painting, such as when calling toPixmap or savePdf.

The layout step queries all layouts and layout elements in the plot for their proposed size and arranges the objects accordingly as preparation for the subsequent drawing step. Through this signal, you have the opportunity to update certain things in your plot that depend crucially on the exact dimensions/positioning of layout elements such as axes and axis rects.

Warning
However, changing any parameters of this QCustomPlot instance which would normally affect the layouting (e.g. axis range order of magnitudes, tick label sizes, etc.) will not issue a second run of the layout step. It will propagate directly to the draw step and may cause graphical inconsistencies such as overlapping objects, if sizes or positions have changed.
See also
updateLayout, beforeReplot, afterReplot

§ afterReplot

void QCustomPlot::afterReplot ( )
signal

This signal is emitted immediately after a replot has taken place (caused by a call to the slot replot).

It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them replot synchronously, it won't cause an infinite recursion.

See also
replot, beforeReplot, afterLayout

§ minimumSizeHint()

QSize QCustomPlot::minimumSizeHint ( ) const
protectedvirtual

Returns a minimum size hint that corresponds to the minimum size of the top level layout (plotLayout). To prevent QCustomPlot from being collapsed to size/width zero, set a minimum size (setMinimumSize) either on the whole QCustomPlot or on any layout elements inside the plot. This is especially important, when placed in a QLayout where other components try to take in as much space as possible (e.g. QMdiArea).

§ sizeHint()

QSize QCustomPlot::sizeHint ( ) const
protectedvirtual

Returns a size hint that is the same as minimumSizeHint.

§ paintEvent()

void QCustomPlot::paintEvent ( QPaintEvent *  event)
protectedvirtual

Event handler for when the QCustomPlot widget needs repainting. This does not cause a replot, but draws the internal buffer on the widget surface.

§ resizeEvent()

void QCustomPlot::resizeEvent ( QResizeEvent *  event)
protectedvirtual

Event handler for a resize of the QCustomPlot widget. The viewport (which becomes the outer rect of mPlotLayout) is resized appropriately. Finally a replot is performed.

§ mouseDoubleClickEvent()

void QCustomPlot::mouseDoubleClickEvent ( QMouseEvent *  event)
protectedvirtual

Event handler for when a double click occurs. Emits the mouseDoubleClick signal, then determines the layerable under the cursor and forwards the event to it. Finally, emits the specialized signals when certain objecs are clicked (e.g. plottableDoubleClick, axisDoubleClick, etc.).

See also
mousePressEvent, mouseReleaseEvent

§ mousePressEvent()

void QCustomPlot::mousePressEvent ( QMouseEvent *  event)
protectedvirtual

Event handler for when a mouse button is pressed. Emits the mousePress signal.

If the current setSelectionRectMode is not QCP::srmNone, passes the event to the selection rect. Otherwise determines the layerable under the cursor and forwards the event to it.

See also
mouseMoveEvent, mouseReleaseEvent

§ mouseMoveEvent()

void QCustomPlot::mouseMoveEvent ( QMouseEvent *  event)
protectedvirtual

Event handler for when the cursor is moved. Emits the mouseMove signal.

If the selection rect (setSelectionRect) is currently active, the event is forwarded to it in order to update the rect geometry.

Otherwise, if a layout element has mouse capture focus (a mousePressEvent happened on top of the layout element before), the mouseMoveEvent is forwarded to that element.

See also
mousePressEvent, mouseReleaseEvent

§ mouseReleaseEvent()

void QCustomPlot::mouseReleaseEvent ( QMouseEvent *  event)
protectedvirtual

Event handler for when a mouse button is released. Emits the mouseRelease signal.

If the mouse was moved less than a certain threshold in any direction since the mousePressEvent, it is considered a click which causes the selection mechanism (if activated via setInteractions) to possibly change selection states accordingly. Further, specialized mouse click signals are emitted (e.g. plottableClick, axisClick, etc.)

If a layerable is the mouse capturer (a mousePressEvent happened on top of the layerable before), the mouseReleaseEvent is forwarded to that element.

See also
mousePressEvent, mouseMoveEvent

§ wheelEvent()

void QCustomPlot::wheelEvent ( QWheelEvent *  event)
protectedvirtual

Event handler for mouse wheel events. First, the mouseWheel signal is emitted. Then determines the affected layerable and forwards the event to it.

§ draw()

void QCustomPlot::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the entire plot, including background pixmap, with the specified painter. It does not make use of the paint buffers like replot, so this is the function typically used by saving/exporting methods such as savePdf or toPainter.

Note that it does not fill the background with the background brush (as the user may specify with setBackground(const QBrush &brush)), this is up to the respective functions calling this method.

§ updateLayout()

void QCustomPlot::updateLayout ( )
protectedvirtual

Performs the layout update steps defined by QCPLayoutElement::UpdatePhase, by calling QCPLayoutElement::update on the main plot layout.

Here, the layout elements calculate their positions and margins, and prepare for the following draw call.

§ axisRemoved()

void QCustomPlot::axisRemoved ( QCPAxis *  axis)
protectedvirtual

This method is used by QCPAxisRect::removeAxis to report removed axes to the QCustomPlot so it may clear its QCustomPlot::xAxis, yAxis, xAxis2 and yAxis2 members accordingly.

§ legendRemoved()

void QCustomPlot::legendRemoved ( QCPLegend *  legend)
protectedvirtual

This method is used by the QCPLegend destructor to report legend removal to the QCustomPlot so it may clear its QCustomPlot::legend member accordingly.

§ processRectSelection()

void QCustomPlot::processRectSelection ( QRect  rect,
QMouseEvent *  event 
)
protectedvirtual

This slot is connected to the selection rect's QCPSelectionRect::accepted signal when setSelectionRectMode is set to QCP::srmSelect.

First, it determines which axis rect was the origin of the selection rect judging by the starting point of the selection. Then it goes through the plottables (QCPAbstractPlottable1D to be precise) associated with that axis rect and finds the data points that are in rect. It does this by querying their QCPAbstractPlottable1D::selectTestRect method.

Then, the actual selection is done by calling the plottables' QCPAbstractPlottable::selectEvent, placing the found selected data points in the details parameter as QVariant(QCPDataSelection). All plottables that weren't touched by rect receive a QCPAbstractPlottable::deselectEvent.

See also
processRectZoom

§ processRectZoom()

void QCustomPlot::processRectZoom ( QRect  rect,
QMouseEvent *  event 
)
protectedvirtual

This slot is connected to the selection rect's QCPSelectionRect::accepted signal when setSelectionRectMode is set to QCP::srmZoom.

It determines which axis rect was the origin of the selection rect judging by the starting point of the selection, and then zooms the axes defined via QCPAxisRect::setRangeZoomAxes to the provided rect (see QCPAxisRect::zoom).

See also
processRectSelection

§ processPointSelection()

void QCustomPlot::processPointSelection ( QMouseEvent *  event)
protectedvirtual

This method is called when a simple left mouse click was detected on the QCustomPlot surface.

It first determines the layerable that was hit by the click, and then calls its QCPLayerable::selectEvent. All other layerables receive a QCPLayerable::deselectEvent (unless the multi-select modifier was pressed, see setMultiSelectModifier).

In this method the hit layerable is determined a second time using layerableAt (after the one in mousePressEvent), because we want onlySelectable set to true this time. This implies that the mouse event grabber (mMouseEventLayerable) may be a different one from the clicked layerable determined here. For example, if a non-selectable layerable is in front of a selectable layerable at the click position, the front layerable will receive mouse events but the selectable one in the back will receive the QCPLayerable::selectEvent.

See also
processRectSelection, QCPLayerable::selectTest

§ registerPlottable()

bool QCustomPlot::registerPlottable ( QCPAbstractPlottable *  plottable)
protected

Registers the specified plottable with this QCustomPlot and, if setAutoAddPlottableToLegend is enabled, adds it to the legend (QCustomPlot::legend). QCustomPlot takes ownership of the plottable.

Returns true on success, i.e. when plottable isn't already in this plot and the parent plot of plottable is this QCustomPlot.

This method is called automatically in the QCPAbstractPlottable base class constructor.

§ registerGraph()

bool QCustomPlot::registerGraph ( QCPGraph *  graph)
protected

In order to maintain the simplified graph interface of QCustomPlot, this method is called by the QCPGraph constructor to register itself with this QCustomPlot's internal graph list. Returns true on success, i.e. if graph is valid and wasn't already registered with this QCustomPlot.

This graph specific registration happens in addition to the call to registerPlottable by the QCPAbstractPlottable base class.

§ registerItem()

bool QCustomPlot::registerItem ( QCPAbstractItem *  item)
protected

Registers the specified item with this QCustomPlot. QCustomPlot takes ownership of the item.

Returns true on success, i.e. when item wasn't already in the plot and the parent plot of item is this QCustomPlot.

This method is called automatically in the QCPAbstractItem base class constructor.

§ updateLayerIndices()

void QCustomPlot::updateLayerIndices ( ) const
protected

Assigns all layers their index (QCPLayer::mIndex) in the mLayers list. This method is thus called after every operation that changes the layer indices, like layer removal, layer creation, layer moving.

§ layerableAt()

QCPLayerable * QCustomPlot::layerableAt ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  selectionDetails = nullptr 
) const
protected

Returns the top-most layerable at pixel position pos. If onlySelectable is set to true, only those layerables that are selectable will be considered. (Layerable subclasses communicate their selectability via the QCPLayerable::selectTest method, by returning -1.)

selectionDetails is an output parameter that contains selection specifics of the affected layerable. This is useful if the respective layerable shall be given a subsequent QCPLayerable::selectEvent (like in mouseReleaseEvent). selectionDetails usually contains information about which part of the layerable was hit, in multi-part layerables (e.g. QCPAxis::SelectablePart). If the layerable is a plottable, selectionDetails contains a QCPDataSelection instance with the single data point which is closest to pos.

See also
layerableListAt, layoutElementAt, axisRectAt

§ layerableListAt()

QList< QCPLayerable * > QCustomPlot::layerableListAt ( const QPointF &  pos,
bool  onlySelectable,
QList< QVariant > *  selectionDetails = nullptr 
) const
protected

Returns the layerables at pixel position pos. If onlySelectable is set to true, only those layerables that are selectable will be considered. (Layerable subclasses communicate their selectability via the QCPLayerable::selectTest method, by returning -1.)

The returned list is sorted by the layerable/drawing order such that the layerable that appears on top in the plot is at index 0 of the returned list. If you only need to know the top layerable, rather use layerableAt.

selectionDetails is an output parameter that contains selection specifics of the affected layerable. This is useful if the respective layerable shall be given a subsequent QCPLayerable::selectEvent (like in mouseReleaseEvent). selectionDetails usually contains information about which part of the layerable was hit, in multi-part layerables (e.g. QCPAxis::SelectablePart). If the layerable is a plottable, selectionDetails contains a QCPDataSelection instance with the single data point which is closest to pos.

See also
layerableAt, layoutElementAt, axisRectAt

§ drawBackground()

void QCustomPlot::drawBackground ( QCPPainter *  painter)
protected

Draws the viewport background pixmap of the plot.

If a pixmap was provided via setBackground, this function buffers the scaled version depending on setBackgroundScaled and setBackgroundScaledMode and then draws it inside the viewport with the provided painter. The scaled version is buffered in mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when the axis rect has changed in a way that requires a rescale of the background pixmap (this is dependent on the setBackgroundScaledMode), or when a differend axis background pixmap was set.

Note that this function does not draw a fill with the background brush (setBackground(const QBrush &brush)) beneath the pixmap.

See also
setBackground, setBackgroundScaled, setBackgroundScaledMode

§ setupPaintBuffers()

void QCustomPlot::setupPaintBuffers ( )
protected

Goes through the layers and makes sure this QCustomPlot instance holds the correct number of paint buffers and that they have the correct configuration (size, pixel ratio, etc.). Allocations, reallocations and deletions of paint buffers are performed as necessary. It also associates the paint buffers with the layers, so they draw themselves into the right buffer when QCPLayer::drawToPaintBuffer is called. This means it associates adjacent QCPLayer::lmLogical layers to a mutual paint buffer and creates dedicated paint buffers for layers in QCPLayer::lmBuffered mode.

This method uses createPaintBuffer to create new paint buffers.

After this method, the paint buffers are empty (filled with Qt::transparent) and invalidated (so an attempt to replot only a single buffered layer causes a full replot).

This method is called in every replot call, prior to actually drawing the layers (into their associated paint buffer). If the paint buffers don't need changing/reallocating, this method basically leaves them alone and thus finishes very fast.

§ createPaintBuffer()

QCPAbstractPaintBuffer * QCustomPlot::createPaintBuffer ( )
protected

This method is used by setupPaintBuffers when it needs to create new paint buffers.

Depending on the current setting of setOpenGl, and the current Qt version, different backends (subclasses of QCPAbstractPaintBuffer) are created, initialized with the proper size and device pixel ratio, and returned.

§ hasInvalidatedPaintBuffers()

bool QCustomPlot::hasInvalidatedPaintBuffers ( )
protected

This method returns whether any of the paint buffers held by this QCustomPlot instance are invalidated.

If any buffer is invalidated, a partial replot (QCPLayer::replot) is not allowed and always causes a full replot (QCustomPlot::replot) of all layers. This is the case when for example the layer order has changed, new layers were added or removed, layer modes were changed (QCPLayer::setMode), or layerables were added or removed.

See also
QCPAbstractPaintBuffer::setInvalidated

§ setupOpenGl()

bool QCustomPlot::setupOpenGl ( )
protected

When setOpenGl is set to true, this method is used to initialize OpenGL (create a context, surface, paint device).

Returns true on success.

If this method is successful, all paint buffers should be deleted and then reallocated by calling setupPaintBuffers, so the OpenGL-based paint buffer subclasses (QCPPaintBufferGlPbuffer, QCPPaintBufferGlFbo) are used for subsequent replots.

See also
freeOpenGl

§ freeOpenGl()

void QCustomPlot::freeOpenGl ( )
protected

When setOpenGl is set to false, this method is used to deinitialize OpenGL (releases the context and frees resources).

After OpenGL is disabled, all paint buffers should be deleted and then reallocated by calling setupPaintBuffers, so the standard software rendering paint buffer subclass (QCPPaintBufferPixmap) is used for subsequent replots.

See also
setupOpenGl

Field Documentation

§ xAxis

QCPAxis * QCustomPlot::xAxis

A pointer to the primary x Axis (bottom) of the main axis rect of the plot.

QCustomPlot offers convenient pointers to the axes (xAxis, yAxis, xAxis2, yAxis2) and the legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use the layout system to add multiple axis rects or multiple axes to one side, use the QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become nullptr.

If an axis convenience pointer is currently nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the legend convenience pointer will be reset if a legend is added after the main legend was removed before.

§ yAxis

QCPAxis * QCustomPlot::yAxis

A pointer to the primary y Axis (left) of the main axis rect of the plot.

QCustomPlot offers convenient pointers to the axes (xAxis, yAxis, xAxis2, yAxis2) and the legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use the layout system to add multiple axis rects or multiple axes to one side, use the QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become nullptr.

If an axis convenience pointer is currently nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the legend convenience pointer will be reset if a legend is added after the main legend was removed before.

§ xAxis2

QCPAxis * QCustomPlot::xAxis2

A pointer to the secondary x Axis (top) of the main axis rect of the plot. Secondary axes are invisible by default. Use QCPAxis::setVisible to change this (or use QCPAxisRect::setupFullAxesBox).

QCustomPlot offers convenient pointers to the axes (xAxis, yAxis, xAxis2, yAxis2) and the legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use the layout system to add multiple axis rects or multiple axes to one side, use the QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become nullptr.

If an axis convenience pointer is currently nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the legend convenience pointer will be reset if a legend is added after the main legend was removed before.

§ yAxis2

QCPAxis * QCustomPlot::yAxis2

A pointer to the secondary y Axis (right) of the main axis rect of the plot. Secondary axes are invisible by default. Use QCPAxis::setVisible to change this (or use QCPAxisRect::setupFullAxesBox).

QCustomPlot offers convenient pointers to the axes (xAxis, yAxis, xAxis2, yAxis2) and the legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use the layout system to add multiple axis rects or multiple axes to one side, use the QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointers become nullptr.

If an axis convenience pointer is currently nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the legend convenience pointer will be reset if a legend is added after the main legend was removed before.

§ legend

QCPLegend * QCustomPlot::legend

A pointer to the default legend of the main axis rect. The legend is invisible by default. Use QCPLegend::setVisible to change this.

QCustomPlot offers convenient pointers to the axes (xAxis, yAxis, xAxis2, yAxis2) and the legend. They make it very easy working with plots that only have a single axis rect and at most one axis at each axis rect side. If you use the layout system to add multiple legends to the plot, use the layout system interface to access the new legend. For example, legends can be placed inside an axis rect's inset layout, and must then also be accessed via the inset layout. If the default legend is removed due to manipulation of the layout system (e.g. by removing the main axis rect), the corresponding pointer becomes nullptr.

If an axis convenience pointer is currently nullptr and a new axis rect or a corresponding axis is added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the according new axes. Similarly the legend convenience pointer will be reset if a legend is added after the main legend was removed before.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/ssCrossSquare.png0000644000175000017500000000055614030601041024170 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+ IDAT(Ï‘»1 DŸ: ÄN/½kÀ ˜&¨€*.q8&Ä)k º8ÿøÝ I³«•v$?±bë\Yn ³åT ,G"÷LoP\¹‚Иæî@ Ð!H}ƒÁÑ–=úýð#ºÐ­<#;Ì÷˜}pH» ®v))Â\ SJ‘4ŠÈ9ET™¢ç¾üû¬EÁ-¤¥{d%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorScale.png0000644000175000017500000000562714030601040023745 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_ýPLTEÿÿÿÿÿõÆk# ;“âþÿíØÉÖòÿÿí+ #‰æÿÄr)}âÿÿùÚ= #d¼òöÆgI­òÿÿþÚ”< ÿåŠ"V­çôÖ6 IºôÿÿøÐy+ \ºóýÿÿþæ¨d\’кLé’#+˜ëÿþÙrF¸öÿï­M`Ìúÿö¾Ôe  _Ðýÿÿï¦6„åúöúÿøÂUÄøÆT  oÞÿÿÿôµCwàÿÿê“.Úúÿÿï¨ÿþÊë—(šíÿB³ôÿÿ³ÿé–)Y´ëøÞ=ÿÿœâšET«êÿÿˆÿÿv“““ÿÿiÿÿZÿÿLÿÿ>ÿÿ3ÿÿ,ÿÿ#ÿÿÿÿÿÿ ÿüÿëÿàÿØÿÎÿÄÿ¸ÿ«ÿŸÿ—ÿÿƒÿtÿiÿa J§îÿÿÿ]öÖ¸ÊíýÿS&3íÿ¼U J·ÿJå˜:³ïÿÿCöÌp+*|Úý‡  ÿ<ÿ4ÿ,ÿ$ûôìçãÚÖÑ Ì È Ä  ¼ ´ ¯­!ª%¥)¡-öºU 1333˜:—=“AˆB|Ao@g?\>Q=H<<;2:*9#875 3 310-)%!ýÜŠ7 Å\ZÄùò«>‰$9¤ï€5ê>«òÉdýâ—%%%000===JJJ[[[lll•••«««ÆÆÆàààöÂZ OÂøÿÿÿí¼p4ÿöÂX-'G}±ØïíÈF·ôÿIWÀØz»J_Êúÿcöÿàï³N˜+VÿÿàcÂ|ÊÊÊÊʱ`?˜ÈÚïøÒzÜëíííî7ƒ-QbKGDˆH pHYsÃÃÇo¨dÁIDATxÚíœwtTEÆ_ED]x)*R¢ˆŠØ{PÁ†{ï°€XA±`ï½÷Þ± (EÄÞ;vÅÞ°rÜr sïì¾·3/ïÛåûü“={¾Ì›ßÌìÝÝ—„B!„B)Ê•7nÒ4íQš-Ò|Ñi‚Ä¢l±Å—‚LËVá’­k¨h³TÚc"qhÛnéöY…:vZfÙå:Áò]ºvëžö H*WX±GVáJ=WVYµWÍ#«õ^=íA‘x¬Q£p͵ÖÖYw½ X?èÓ{ƒœÏIâDöf6Ühã`“M7 ªú–—7Ù<·ÂÈ¿Åx*crOt:¹Í)yþÐÕ–hŒªðT‰è;SÛýiäi£ È'^‰ ÐÞý©òôÑcÎh;¿°Ö=VŒªðL‰ŸîOi_mIƨ Çš8tâ—MÉb)gÆJRîþ„µî±bT…g™8t‚ºÚ’Œ‰¦0+Ñc>ñŠªðlÞÍ MaVb¡ù¼8•[Ï‘ð …%šB¤À1ªÂs%TS$ ‰Uá8“ÔoÆZ÷H1–rfœ„)lŒªð< RXT…çK¸ ac¢)ä› àUáþg(–rƧB?ÅZ÷X1ªÂ %T£*¼HŠ–h YÎǨ /–ðÓÐK9s‰„),ªÂK%™9Ã} Ÿ~öy—/¾t ©kwŒ0o3Ó”Müj¦ŸößÂ- ®Ý1ÂX¼ÎLÂT|ýÍ·^Z6ë»ïÝêÚ#ŒÅçÌ$LŸ&ýèg ?ý<Í-`~»ãôÇâuf’£ê—01ý×ο¹ ´&&P1ø÷îŽòÖîØÃX‚ŒûÌ4 }zÔ~TûGS× ‘»9· ÷ÕîØÇXüÍLÒdšÍžýç_ÿãšóïÀ!ÿÍ™ã¸ô=µ;ö2o3Ó x8.ÊfÕ.Y×3ÐK»cOcñ43„B! ÿ“PþBèM˜%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPDataSelection.html0000644000175000017500000016025614030601036025651 0ustar rusconirusconi QCPDataSelection Class Reference
Public Functions | Friends | Related Non-Members
QCPDataSelection Class Reference

Describes a data set by holding multiple QCPDataRange instances. More...

Public Functions

 QCPDataSelection ()
 
 QCPDataSelection (const QCPDataRange &range)
 
bool operator== (const QCPDataSelection &other) const
 
bool operator!= (const QCPDataSelection &other) const
 
QCPDataSelection & operator+= (const QCPDataSelection &other)
 
QCPDataSelection & operator+= (const QCPDataRange &other)
 
QCPDataSelection & operator-= (const QCPDataSelection &other)
 
QCPDataSelection & operator-= (const QCPDataRange &other)
 
int dataRangeCount () const
 
int dataPointCount () const
 
QCPDataRange dataRange (int index=0) const
 
QList< QCPDataRange > dataRanges () const
 
QCPDataRange span () const
 
void addDataRange (const QCPDataRange &dataRange, bool simplify=true)
 
void clear ()
 
bool isEmpty () const
 
void simplify ()
 
void enforceType (QCP::SelectionType type)
 
bool contains (const QCPDataSelection &other) const
 
QCPDataSelection intersection (const QCPDataRange &other) const
 
QCPDataSelection intersection (const QCPDataSelection &other) const
 
QCPDataSelection inverse (const QCPDataRange &outerRange) const
 

Friends

const QCPDataSelection operator+ (const QCPDataSelection &a, const QCPDataSelection &b)
 
const QCPDataSelection operator+ (const QCPDataRange &a, const QCPDataSelection &b)
 
const QCPDataSelection operator+ (const QCPDataSelection &a, const QCPDataRange &b)
 
const QCPDataSelection operator+ (const QCPDataRange &a, const QCPDataRange &b)
 
const QCPDataSelection operator- (const QCPDataSelection &a, const QCPDataSelection &b)
 
const QCPDataSelection operator- (const QCPDataRange &a, const QCPDataSelection &b)
 
const QCPDataSelection operator- (const QCPDataSelection &a, const QCPDataRange &b)
 
const QCPDataSelection operator- (const QCPDataRange &a, const QCPDataRange &b)
 

Related Non-Members

(Note that these are not member functions.)

QDebug operator<< (QDebug d, const QCPDataSelection &selection)
 

Detailed Description

Describes a data set by holding multiple QCPDataRange instances.

QCPDataSelection manages multiple instances of QCPDataRange in order to represent any (possibly disjoint) set of data selection.

The data selection can be modified with addition and subtraction operators which take QCPDataSelection and QCPDataRange instances, as well as methods such as addDataRange and clear. Read access is provided by dataRange, dataRanges, dataRangeCount, etc.

The method simplify is used to join directly adjacent or even overlapping QCPDataRange instances. QCPDataSelection automatically simplifies when using the addition/subtraction operators. The only case when simplify is left to the user, is when calling addDataRange, with the parameter simplify explicitly set to false. This is useful if many data ranges will be added to the selection successively and the overhead for simplifying after each iteration shall be avoided. In this case, you should make sure to call simplify after completing the operation.

Use enforceType to bring the data selection into a state complying with the constraints for selections defined in QCP::SelectionType.

QCustomPlot's data selection mechanism is based on QCPDataSelection and QCPDataRange.

Iterating over a data selection

As an example, the following code snippet calculates the average value of a graph's data selection:

QCPDataSelection selection = graph->selection();
double sum = 0;
foreach (QCPDataRange dataRange, selection.dataRanges())
{
QCPGraphDataContainer::const_iterator begin = graph->data()->at(dataRange.begin()); // get range begin iterator from index
QCPGraphDataContainer::const_iterator end = graph->data()->at(dataRange.end()); // get range end iterator from index
for (QCPGraphDataContainer::const_iterator it=begin; it!=end; ++it)
{
// iterator "it" will go through all selected data points, as an example, we calculate the value average
sum += it->value;
}
}
double average = sum/selection.dataPointCount();

Constructor & Destructor Documentation

§ QCPDataSelection() [1/2]

QCPDataSelection::QCPDataSelection ( )
explicit

Creates an empty QCPDataSelection.

§ QCPDataSelection() [2/2]

QCPDataSelection::QCPDataSelection ( const QCPDataRange &  range)
explicit

Creates a QCPDataSelection containing the provided range.

Member Function Documentation

§ operator==()

bool QCPDataSelection::operator== ( const QCPDataSelection &  other) const

Returns true if this selection is identical (contains the same data ranges with the same begin and end indices) to other.

Note that both data selections must be in simplified state (the usual state of the selection, see simplify) for this operator to return correct results.

§ operator+=() [1/2]

QCPDataSelection & QCPDataSelection::operator+= ( const QCPDataSelection &  other)

Adds the data selection of other to this data selection, and then simplifies this data selection (see simplify).

§ operator+=() [2/2]

QCPDataSelection & QCPDataSelection::operator+= ( const QCPDataRange &  other)

Adds the data range other to this data selection, and then simplifies this data selection (see simplify).

§ operator-=() [1/2]

QCPDataSelection & QCPDataSelection::operator-= ( const QCPDataSelection &  other)

Removes all data point indices that are described by other from this data selection.

§ operator-=() [2/2]

QCPDataSelection & QCPDataSelection::operator-= ( const QCPDataRange &  other)

Removes all data point indices that are described by other from this data selection.

§ dataRangeCount()

int QCPDataSelection::dataRangeCount ( ) const
inline

Returns the number of ranges that make up the data selection. The ranges can be accessed by dataRange via their index.

See also
dataRange, dataPointCount

§ dataPointCount()

int QCPDataSelection::dataPointCount ( ) const

Returns the total number of data points contained in all data ranges that make up this data selection.

§ dataRange()

QCPDataRange QCPDataSelection::dataRange ( int  index = 0) const

Returns the data range with the specified index.

If the data selection is simplified (the usual state of the selection, see simplify), the ranges are sorted by ascending data point index.

See also
dataRangeCount

§ dataRanges()

QList< QCPDataRange > QCPDataSelection::dataRanges ( ) const
inline

Returns all data ranges that make up the data selection. If the data selection is simplified (the usual state of the selection, see simplify), the ranges are sorted by ascending data point index.

See also
dataRange

§ span()

QCPDataRange QCPDataSelection::span ( ) const

Returns a QCPDataRange which spans the entire data selection, including possible intermediate segments which are not part of the original data selection.

§ addDataRange()

void QCPDataSelection::addDataRange ( const QCPDataRange &  dataRange,
bool  simplify = true 
)

Adds the given dataRange to this data selection. This is equivalent to the += operator but allows disabling immediate simplification by setting simplify to false. This can improve performance if adding a very large amount of data ranges successively. In this case, make sure to call simplify manually, after the operation.

§ clear()

void QCPDataSelection::clear ( )

Removes all data ranges. The data selection then contains no data points.

isEmpty

§ isEmpty()

bool QCPDataSelection::isEmpty ( ) const
inline

Returns true if there are no data ranges, and thus no data points, in this QCPDataSelection instance.

See also
dataRangeCount

§ simplify()

void QCPDataSelection::simplify ( )

Sorts all data ranges by range begin index in ascending order, and then joins directly adjacent or overlapping ranges. This can reduce the number of individual data ranges in the selection, and prevents possible double-counting when iterating over the data points held by the data ranges.

This method is automatically called when using the addition/subtraction operators. The only case when simplify is left to the user, is when calling addDataRange, with the parameter simplify explicitly set to false.

§ enforceType()

void QCPDataSelection::enforceType ( QCP::SelectionType  type)

Makes sure this data selection conforms to the specified type selection type. Before the type is enforced, simplify is called.

Depending on type, enforcing means adding new data points that were previously not part of the selection, or removing data points from the selection. If the current selection already conforms to type, the data selection is not changed.

See also
QCP::SelectionType

§ contains()

bool QCPDataSelection::contains ( const QCPDataSelection &  other) const

Returns true if the data selection other is contained entirely in this data selection, i.e. all data point indices that are in other are also in this data selection.

See also
QCPDataRange::contains

§ intersection() [1/2]

QCPDataSelection QCPDataSelection::intersection ( const QCPDataRange &  other) const

Returns a data selection containing the points which are both in this data selection and in the data range other.

A common use case is to limit an unknown data selection to the valid range of a data container, using QCPDataContainer::dataRange as other. One can then safely iterate over the returned data selection without exceeding the data container's bounds.

§ intersection() [2/2]

QCPDataSelection QCPDataSelection::intersection ( const QCPDataSelection &  other) const

Returns a data selection containing the points which are both in this data selection and in the data selection other.

§ inverse()

QCPDataSelection QCPDataSelection::inverse ( const QCPDataRange &  outerRange) const

Returns a data selection which is the exact inverse of this data selection, with outerRange defining the base range on which to invert. If outerRange is smaller than the span of this data selection, it is expanded accordingly.

For example, this method can be used to retrieve all unselected segments by setting outerRange to the full data range of the plottable, and calling this method on a data selection holding the selected segments.

Friends And Related Function Documentation

§ operator+ [1/4]

const QCPDataSelection operator+ ( const QCPDataSelection &  a,
const QCPDataSelection &  b 
)
friend

Return a QCPDataSelection with the data points in a joined with the data points in b. The resulting data selection is already simplified (see QCPDataSelection::simplify).

§ operator+ [2/4]

const QCPDataSelection operator+ ( const QCPDataRange &  a,
const QCPDataSelection &  b 
)
friend

Return a QCPDataSelection with the data points in a joined with the data points in b. The resulting data selection is already simplified (see QCPDataSelection::simplify).

§ operator+ [3/4]

const QCPDataSelection operator+ ( const QCPDataSelection &  a,
const QCPDataRange &  b 
)
friend

Return a QCPDataSelection with the data points in a joined with the data points in b. The resulting data selection is already simplified (see QCPDataSelection::simplify).

§ operator+ [4/4]

const QCPDataSelection operator+ ( const QCPDataRange &  a,
const QCPDataRange &  b 
)
friend

Return a QCPDataSelection with the data points in a joined with the data points in b. The resulting data selection is already simplified (see QCPDataSelection::simplify).

§ operator- [1/4]

const QCPDataSelection operator- ( const QCPDataSelection &  a,
const QCPDataSelection &  b 
)
friend

Return a QCPDataSelection with the data points which are in a but not in b.

§ operator- [2/4]

const QCPDataSelection operator- ( const QCPDataRange &  a,
const QCPDataSelection &  b 
)
friend

Return a QCPDataSelection with the data points which are in a but not in b.

§ operator- [3/4]

const QCPDataSelection operator- ( const QCPDataSelection &  a,
const QCPDataRange &  b 
)
friend

Return a QCPDataSelection with the data points which are in a but not in b.

§ operator- [4/4]

const QCPDataSelection operator- ( const QCPDataRange &  a,
const QCPDataRange &  b 
)
friend

Return a QCPDataSelection with the data points which are in a but not in b.

§ operator<<()

QDebug operator<< ( QDebug  d,
const QCPDataSelection &  selection 
)
related

Prints selection in a human readable format to the qDebug output.

The documentation for this class was generated from the following files:
  • src/selection.h
  • src/selection.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarGrid__inherit__graph.png0000644000175000017500000000153014030601041030017 0ustar rusconirusconi‰PNG  IHDRpk]ß gAMA† 1è–_0PLTEýýýÿÿÿÒÒÕiiiMMM™™™………èè骪³444+""Zff—RkÍJòtRNS«â¢bKGDÿ-Þ pHYsHHFÉk>BIDATXÃí×1kAàä'L¼ bä<ÒÙ\≠͑[ØC›ÍÍ»¬¹JÈB,í-wŽ‘«Ä( ÚÙÚÅ…³5‚(£’Þ&½½…ïÍ®ewdÆ€÷ÁíÜÎÛogæí°ÜÍ1Ϙû?`{Õ9V Ü¡È¡û‰8ôx¶É¢…îF l±e¶N°QòÞbçÊNÄq›œøË}¹X`¾Æ^=a" ã2ÑÁ6U³ >xÄÄÝ OÄ^[Öâäð~Æä[½ØÁ“øI1Õ•vÉãHŠÇA`2Æ;¬eÁÔ8*Š#Ê6À¹[¿<‚‡ó~;‡NbËÕЂsäp§_7_Weö7ù½7–¤ ~zï›Z?ð‚KZyÁóZzÁ§Z¿õ‚Ÿµþà¿jýÑ.hŒ–\"xä/üâ/|åŸ|çqZ’5¬a kXÃÖð„á~ÅŸöë‰ktÿ…\À±rŒìÁ¸¢çg8l3˜I)€íã0¡”’0ÙJ¶'£þU™f*¾ƒ“q?±Œ8VÓXÎèÆŠÓ8—áèC ^jT0,ƒB¥± æ#ÊË]º¢†!õR£†kV˜¯Q†8ðûe(M£DjŸªYŠòöJj* gfŠS@šªÜ¢ùšâ,ŸêÇ‘CSœ)˜…f8{‚åÅQªþõ-WÃ?€Þo¹´ïáoÞäÖø— ka¾Ç7ÅQ-ÚcÊ*]%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarAxisAngular.html0000644000175000017500000062016214030601040026336 0ustar rusconirusconi QCPPolarAxisAngular Class Reference
Public Types | Public Functions | Signals | Protected Functions
QCPPolarAxisAngular Class Reference

The main container for polar plots, representing the angular axis as a circle. More...

Inheritance diagram for QCPPolarAxisAngular:
Inheritance graph

Public Types

enum  SelectablePart
 
enum  LabelMode
 
- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Public Functions

 QCPPolarAxisAngular (QCustomPlot *parentPlot)
 
QPixmap background () const
 
QBrush backgroundBrush () const
 
bool backgroundScaled () const
 
Qt::AspectRatioMode backgroundScaledMode () const
 
bool rangeDrag () const
 
bool rangeZoom () const
 
double rangeZoomFactor () const
 
const QCPRange range () const
 
bool rangeReversed () const
 
double angle () const
 
QSharedPointer< QCPAxisTicker > ticker () const
 
bool ticks () const
 
bool tickLabels () const
 
int tickLabelPadding () const
 
QFont tickLabelFont () const
 
QColor tickLabelColor () const
 
double tickLabelRotation () const
 
LabelMode tickLabelMode () const
 
QString numberFormat () const
 
int numberPrecision () const
 
QVector< double > tickVector () const
 
QVector< QString > tickVectorLabels () const
 
int tickLengthIn () const
 
int tickLengthOut () const
 
bool subTicks () const
 
int subTickLengthIn () const
 
int subTickLengthOut () const
 
QPen basePen () const
 
QPen tickPen () const
 
QPen subTickPen () const
 
QFont labelFont () const
 
QColor labelColor () const
 
QString label () const
 
int labelPadding () const
 
SelectableParts selectedParts () const
 
SelectableParts selectableParts () const
 
QFont selectedTickLabelFont () const
 
QFont selectedLabelFont () const
 
QColor selectedTickLabelColor () const
 
QColor selectedLabelColor () const
 
QPen selectedBasePen () const
 
QPen selectedTickPen () const
 
QPen selectedSubTickPen () const
 
QCPPolarGrid * grid () const
 
void setBackground (const QPixmap &pm)
 
void setBackground (const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding)
 
void setBackground (const QBrush &brush)
 
void setBackgroundScaled (bool scaled)
 
void setBackgroundScaledMode (Qt::AspectRatioMode mode)
 
void setRangeDrag (bool enabled)
 
void setRangeZoom (bool enabled)
 
void setRangeZoomFactor (double factor)
 
Q_SLOT void setRange (const QCPRange &range)
 
void setRange (double lower, double upper)
 
void setRange (double position, double size, Qt::AlignmentFlag alignment)
 
void setRangeLower (double lower)
 
void setRangeUpper (double upper)
 
void setRangeReversed (bool reversed)
 
void setAngle (double degrees)
 
void setTicker (QSharedPointer< QCPAxisTicker > ticker)
 
void setTicks (bool show)
 
void setTickLabels (bool show)
 
void setTickLabelPadding (int padding)
 
void setTickLabelFont (const QFont &font)
 
void setTickLabelColor (const QColor &color)
 
void setTickLabelRotation (double degrees)
 
void setTickLabelMode (LabelMode mode)
 
void setNumberFormat (const QString &formatCode)
 
void setNumberPrecision (int precision)
 
void setTickLength (int inside, int outside=0)
 
void setTickLengthIn (int inside)
 
void setTickLengthOut (int outside)
 
void setSubTicks (bool show)
 
void setSubTickLength (int inside, int outside=0)
 
void setSubTickLengthIn (int inside)
 
void setSubTickLengthOut (int outside)
 
void setBasePen (const QPen &pen)
 
void setTickPen (const QPen &pen)
 
void setSubTickPen (const QPen &pen)
 
void setLabelFont (const QFont &font)
 
void setLabelColor (const QColor &color)
 
void setLabel (const QString &str)
 
void setLabelPadding (int padding)
 
void setLabelPosition (Qt::AlignmentFlag position)
 
void setSelectedTickLabelFont (const QFont &font)
 
void setSelectedLabelFont (const QFont &font)
 
void setSelectedTickLabelColor (const QColor &color)
 
void setSelectedLabelColor (const QColor &color)
 
void setSelectedBasePen (const QPen &pen)
 
void setSelectedTickPen (const QPen &pen)
 
void setSelectedSubTickPen (const QPen &pen)
 
Q_SLOT void setSelectableParts (const QCPPolarAxisAngular::SelectableParts &selectableParts)
 
Q_SLOT void setSelectedParts (const QCPPolarAxisAngular::SelectableParts &selectedParts)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=0) const
 
virtual void update (UpdatePhase phase)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
bool removeGraph (QCPPolarGraph *graph)
 
int radialAxisCount () const
 
QCPPolarAxisRadial * radialAxis (int index=0) const
 
QList< QCPPolarAxisRadial * > radialAxes () const
 
QCPPolarAxisRadial * addRadialAxis (QCPPolarAxisRadial *axis=0)
 
bool removeRadialAxis (QCPPolarAxisRadial *axis)
 
QCPLayoutInset * insetLayout () const
 
QRegion exactClipRegion () const
 
void moveRange (double diff)
 
void scaleRange (double factor)
 
void scaleRange (double factor, double center)
 
void rescale (bool onlyVisiblePlottables=false)
 
double coordToAngleRad (double coord) const
 
double angleRadToCoord (double angleRad) const
 
void pixelToCoord (QPointF pixelPos, double &angleCoord, double &radiusCoord) const
 
QPointF coordToPixel (double angleCoord, double radiusCoord) const
 
SelectablePart getPartAt (const QPointF &pos) const
 
int left () const
 
int right () const
 
int top () const
 
int bottom () const
 
int width () const
 
int height () const
 
QSize size () const
 
QPoint topLeft () const
 
QPoint topRight () const
 
QPoint bottomLeft () const
 
QPoint bottomRight () const
 
QPointF center () const
 
double radius () const
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void rangeChanged (const QCPRange &newRange)
 
void rangeChanged (const QCPRange &newRange, const QCPRange &oldRange)
 
void selectionChanged (const QCPPolarAxisAngular::SelectableParts &parts)
 
void selectableChanged (const QCPPolarAxisAngular::SelectableParts &parts)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual QCP::Interaction selectionCategory () const
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void wheelEvent (QWheelEvent *event)
 
bool registerPolarGraph (QCPPolarGraph *graph)
 
void drawBackground (QCPPainter *painter, const QPointF &center, double radius)
 
void setupTickVectors ()
 
QPen getBasePen () const
 
QPen getTickPen () const
 
QPen getSubTickPen () const
 
QFont getTickLabelFont () const
 
QFont getLabelFont () const
 
QColor getTickLabelColor () const
 
QColor getLabelColor () const
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

The main container for polar plots, representing the angular axis as a circle.

Warning
In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future.

Member Enumeration Documentation

§ SelectablePart

enum QCPPolarAxisAngular::SelectablePart

Defines the selectable parts of an axis.

See also
setSelectableParts, setSelectedParts
Enumerator
spNone 

None of the selectable parts.

spAxis 

The axis backbone and tick marks.

spTickLabels 

Tick labels (numbers) of this axis (as a whole, not individually)

spAxisLabel 

The axis label.

§ LabelMode

enum QCPPolarAxisAngular::LabelMode

TODO

Constructor & Destructor Documentation

§ QCPPolarAxisAngular()

QCPPolarAxisAngular::QCPPolarAxisAngular ( QCustomPlot *  parentPlot)
explicit

Creates a QCPPolarAxis instance and sets default values. An axis is added for each of the four sides, the top and right axes are set invisible initially.

Member Function Documentation

§ setBackground() [1/3]

void QCPPolarAxisAngular::setBackground ( const QPixmap &  pm)

Sets pm as the axis background pixmap. The axis background pixmap will be drawn inside the axis rect. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else.

For cases where the provided pixmap doesn't have the same size as the axis rect, scaling can be enabled with setBackgroundScaled and the scaling mode (i.e. whether and how the aspect ratio is preserved) can be set with setBackgroundScaledMode. To set all these options in one call, consider using the overloaded version of this function.

Below the pixmap, the axis rect may be optionally filled with a brush, if specified with setBackground(const QBrush &brush).

See also
setBackgroundScaled, setBackgroundScaledMode, setBackground(const QBrush &brush)

§ setBackground() [2/3]

void QCPPolarAxisAngular::setBackground ( const QPixmap &  pm,
bool  scaled,
Qt::AspectRatioMode  mode = Qt::KeepAspectRatioByExpanding 
)

This is an overloaded function.

Allows setting the background pixmap of the axis rect, whether it shall be scaled and how it shall be scaled in one call.

See also
setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode

§ setBackground() [3/3]

void QCPPolarAxisAngular::setBackground ( const QBrush &  brush)

This is an overloaded function.

Sets brush as the background brush. The axis rect background will be filled with this brush. Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds are usually drawn below everything else.

The brush will be drawn before (under) any background pixmap, which may be specified with setBackground(const QPixmap &pm).

To disable drawing of a background brush, set brush to Qt::NoBrush.

See also
setBackground(const QPixmap &pm)

§ setBackgroundScaled()

void QCPPolarAxisAngular::setBackgroundScaled ( bool  scaled)

Sets whether the axis background pixmap shall be scaled to fit the axis rect or not. If scaled is set to true, you may control whether and how the aspect ratio of the original pixmap is preserved with setBackgroundScaledMode.

Note that the scaled version of the original pixmap is buffered, so there is no performance penalty on replots. (Except when the axis rect dimensions are changed continuously.)

See also
setBackground, setBackgroundScaledMode

§ setBackgroundScaledMode()

void QCPPolarAxisAngular::setBackgroundScaledMode ( Qt::AspectRatioMode  mode)

If scaling of the axis background pixmap is enabled (setBackgroundScaled), use this function to define whether and how the aspect ratio of the original pixmap passed to setBackground is preserved.

See also
setBackground, setBackgroundScaled

§ setRange() [1/3]

void QCPPolarAxisAngular::setRange ( const QCPRange &  range)

Sets the range of the axis.

This slot may be connected with the rangeChanged signal of another axis so this axis is always synchronized with the other axis range, when it changes.

To invert the direction of an axis, use setRangeReversed.

§ setRange() [2/3]

void QCPPolarAxisAngular::setRange ( double  lower,
double  upper 
)

This is an overloaded function.

Sets the lower and upper bound of the axis range.

To invert the direction of an axis, use setRangeReversed.

There is also a slot to set a range, see setRange(const QCPRange &range).

§ setRange() [3/3]

void QCPPolarAxisAngular::setRange ( double  position,
double  size,
Qt::AlignmentFlag  alignment 
)

This is an overloaded function.

Sets the range of the axis.

The position coordinate indicates together with the alignment parameter, where the new range will be positioned. size defines the size of the new axis range. alignment may be Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, or center of the range to be aligned with position. Any other values of alignment will default to Qt::AlignCenter.

§ setRangeLower()

void QCPPolarAxisAngular::setRangeLower ( double  lower)

Sets the lower bound of the axis range. The upper bound is not changed.

See also
setRange

§ setRangeUpper()

void QCPPolarAxisAngular::setRangeUpper ( double  upper)

Sets the upper bound of the axis range. The lower bound is not changed.

See also
setRange

§ setRangeReversed()

void QCPPolarAxisAngular::setRangeReversed ( bool  reversed)

Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal axes increase left to right, on vertical axes bottom to top. When reversed is set to true, the direction of increasing values is inverted.

Note that the range and data interface stays the same for reversed axes, e.g. the lower part of the setRange interface will still reference the mathematically smaller number than the upper part.

§ setTicker()

void QCPPolarAxisAngular::setTicker ( QSharedPointer< QCPAxisTicker >  ticker)

The axis ticker is responsible for generating the tick positions and tick labels. See the documentation of QCPAxisTicker for details on how to work with axis tickers.

You can change the tick positioning/labeling behaviour of this axis by setting a different QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis ticker, access it via ticker.

Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis ticker simply by passing the same shared pointer to multiple axes.

See also
ticker

§ setTicks()

void QCPPolarAxisAngular::setTicks ( bool  show)

Sets whether tick marks are displayed.

Note that setting show to false does not imply that tick labels are invisible, too. To achieve that, see setTickLabels.

See also
setSubTicks

§ setTickLabels()

void QCPPolarAxisAngular::setTickLabels ( bool  show)

Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks.

§ setTickLabelPadding()

void QCPPolarAxisAngular::setTickLabelPadding ( int  padding)

Sets the distance between the axis base line (including any outward ticks) and the tick labels.

See also
setLabelPadding, setPadding

§ setTickLabelFont()

void QCPPolarAxisAngular::setTickLabelFont ( const QFont &  font)

Sets the font of the tick labels.

See also
setTickLabels, setTickLabelColor

§ setTickLabelColor()

void QCPPolarAxisAngular::setTickLabelColor ( const QColor &  color)

Sets the color of the tick labels.

See also
setTickLabels, setTickLabelFont

§ setTickLabelRotation()

void QCPPolarAxisAngular::setTickLabelRotation ( double  degrees)

Sets the rotation of the tick labels. If degrees is zero, the labels are drawn normally. Else, the tick labels are drawn rotated by degrees clockwise. The specified angle is bound to values from -90 to 90 degrees.

If degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For other angles, the label is drawn with an offset such that it seems to point toward or away from the tick mark.

§ setNumberFormat()

void QCPPolarAxisAngular::setNumberFormat ( const QString &  formatCode)

Sets the number format for the numbers in tick labels. This formatCode is an extended version of the format code used e.g. by QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" section in the detailed description of the QString class.

formatCode is a string of one, two or three characters. The first character is identical to the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, whichever is shorter.

The second and third characters are optional and specific to QCustomPlot:
If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. "5.5e9", which might be visually unappealing in a plot. So when the second char of formatCode is set to 'b' (for "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. If instead a cross should be shown (as is usual in the USA), the third char of formatCode can be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the cross and 183 (0xB7) for the dot.

Examples for formatCode:

  • g normal format code behaviour. If number is small, fixed format is used, if number is large, normal scientific format is used
  • gb If number is small, fixed format is used, if number is large, scientific format is used with beautifully typeset decimal powers and a dot as multiplication sign
  • ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as multiplication sign
  • fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal powers. Format code will be reduced to 'f'.
  • hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format code will not be changed.

§ setNumberPrecision()

void QCPPolarAxisAngular::setNumberPrecision ( int  precision)

Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) for details. The effect of precisions are most notably for number Formats starting with 'e', see setNumberFormat

§ setTickLength()

void QCPPolarAxisAngular::setTickLength ( int  inside,
int  outside = 0 
)

Sets the length of the ticks in pixels. inside is the length the ticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setSubTickLength, setTickLengthIn, setTickLengthOut

§ setTickLengthIn()

void QCPPolarAxisAngular::setTickLengthIn ( int  inside)

Sets the length of the inward ticks in pixels. inside is the length the ticks will reach inside the plot.

See also
setTickLengthOut, setTickLength, setSubTickLength

§ setTickLengthOut()

void QCPPolarAxisAngular::setTickLengthOut ( int  outside)

Sets the length of the outward ticks in pixels. outside is the length the ticks will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setTickLengthIn, setTickLength, setSubTickLength

§ setSubTicks()

void QCPPolarAxisAngular::setSubTicks ( bool  show)

Sets whether sub tick marks are displayed.

Sub ticks are only potentially visible if (major) ticks are also visible (see setTicks)

See also
setTicks

§ setSubTickLength()

void QCPPolarAxisAngular::setSubTickLength ( int  inside,
int  outside = 0 
)

Sets the length of the subticks in pixels. inside is the length the subticks will reach inside the plot and outside is the length they will reach outside the plot. If outside is greater than zero, the tick labels and axis label will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setTickLength, setSubTickLengthIn, setSubTickLengthOut

§ setSubTickLengthIn()

void QCPPolarAxisAngular::setSubTickLengthIn ( int  inside)

Sets the length of the inward subticks in pixels. inside is the length the subticks will reach inside the plot.

See also
setSubTickLengthOut, setSubTickLength, setTickLength

§ setSubTickLengthOut()

void QCPPolarAxisAngular::setSubTickLengthOut ( int  outside)

Sets the length of the outward subticks in pixels. outside is the length the subticks will reach outside the plot. If outside is greater than zero, the tick labels will increase their distance to the axis accordingly, so they won't collide with the ticks.

See also
setSubTickLengthIn, setSubTickLength, setTickLength

§ setBasePen()

void QCPPolarAxisAngular::setBasePen ( const QPen &  pen)

Sets the pen, the axis base line is drawn with.

See also
setTickPen, setSubTickPen

§ setTickPen()

void QCPPolarAxisAngular::setTickPen ( const QPen &  pen)

Sets the pen, tick marks will be drawn with.

See also
setTickLength, setBasePen

§ setSubTickPen()

void QCPPolarAxisAngular::setSubTickPen ( const QPen &  pen)

Sets the pen, subtick marks will be drawn with.

See also
setSubTickCount, setSubTickLength, setBasePen

§ setLabelFont()

void QCPPolarAxisAngular::setLabelFont ( const QFont &  font)

Sets the font of the axis label.

See also
setLabelColor

§ setLabelColor()

void QCPPolarAxisAngular::setLabelColor ( const QColor &  color)

Sets the color of the axis label.

See also
setLabelFont

§ setLabel()

void QCPPolarAxisAngular::setLabel ( const QString &  str)

Sets the text of the axis label that will be shown below/above or next to the axis, depending on its orientation. To disable axis labels, pass an empty string as str.

§ setLabelPadding()

void QCPPolarAxisAngular::setLabelPadding ( int  padding)

Sets the distance between the tick labels and the axis label.

See also
setTickLabelPadding, setPadding

§ setSelectedTickLabelFont()

void QCPPolarAxisAngular::setSelectedTickLabelFont ( const QFont &  font)

Sets the font that is used for tick labels when they are selected.

See also
setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedLabelFont()

void QCPPolarAxisAngular::setSelectedLabelFont ( const QFont &  font)

Sets the font that is used for the axis label when it is selected.

See also
setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedTickLabelColor()

void QCPPolarAxisAngular::setSelectedTickLabelColor ( const QColor &  color)

Sets the color that is used for tick labels when they are selected.

See also
setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedLabelColor()

void QCPPolarAxisAngular::setSelectedLabelColor ( const QColor &  color)

Sets the color that is used for the axis label when it is selected.

See also
setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedBasePen()

void QCPPolarAxisAngular::setSelectedBasePen ( const QPen &  pen)

Sets the pen that is used to draw the axis base line when selected.

See also
setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedTickPen()

void QCPPolarAxisAngular::setSelectedTickPen ( const QPen &  pen)

Sets the pen that is used to draw the (major) ticks when selected.

See also
setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectedSubTickPen()

void QCPPolarAxisAngular::setSelectedSubTickPen ( const QPen &  pen)

Sets the pen that is used to draw the subticks when selected.

See also
setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions

§ setSelectableParts()

void QCPPolarAxisAngular::setSelectableParts ( const QCPPolarAxisAngular::SelectableParts &  selectableParts)

Sets whether the user can (de-)select the parts in selectable by clicking on the QCustomPlot surface. (When QCustomPlot::setInteractions contains iSelectAxes.)

However, even when selectable is set to a value not allowing the selection of a specific part, it is still possible to set the selection of this part manually, by calling setSelectedParts directly.

See also
SelectablePart, setSelectedParts

§ setSelectedParts()

void QCPPolarAxisAngular::setSelectedParts ( const QCPPolarAxisAngular::SelectableParts &  selectedParts)

Sets the selected state of the respective axis parts described by SelectablePart. When a part is selected, it uses a different pen/font.

The entire selection mechanism for axes is handled automatically when QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you wish to change the selection state manually.

This function can change the selection state of a part, independent of the setSelectableParts setting.

emits the selectionChanged signal when selected is different from the previous selection state.

See also
SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor

§ selectTest()

double QCPPolarAxisAngular::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = 0 
) const
virtual

Layout elements are sensitive to events inside their outer rect. If pos is within the outer rect, this method returns a value corresponding to 0.99 times the parent plot's selection tolerance. However, layout elements are not selectable by default. So if onlySelectable is true, -1.0 is returned.

See QCPLayerable::selectTest for a general explanation of this virtual method.

QCPLayoutElement subclasses may reimplement this method to provide more specific selection test behaviour.

Reimplemented from QCPLayoutElement.

§ update()

void QCPPolarAxisAngular::update ( UpdatePhase  phase)
virtual

This method is called automatically upon replot and doesn't need to be called by users of QCPPolarAxisAngular.

Calls the base class implementation to update the margins (see QCPLayoutElement::update), and finally passes the rect to the inset layout (insetLayout) and calls its QCPInsetLayout::update function.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayoutElement.

§ elements()

QList< QCPLayoutElement * > QCPPolarAxisAngular::elements ( bool  recursive) const
virtual

Returns a list of all child elements in this layout element. If recursive is true, all sub-child elements are included in the list, too.

Warning
There may be nullptr entries in the returned list. For example, QCPLayoutGrid may have empty cells which yield nullptr at the respective index.

Reimplemented from QCPLayoutElement.

§ radialAxisCount()

int QCPPolarAxisAngular::radialAxisCount ( ) const

Returns the number of axes on the axis rect side specified with type.

See also
axis

§ radialAxis()

QCPPolarAxisRadial * QCPPolarAxisAngular::radialAxis ( int  index = 0) const

Returns the axis with the given index on the axis rect side specified with type.

See also
axisCount, axes

§ radialAxes()

QList< QCPPolarAxisRadial * > QCPPolarAxisAngular::radialAxes ( ) const

Returns all axes on the axis rect sides specified with types.

types may be a single QCPAxis::AxisType or an or-combination, to get the axes of multiple sides.

See also
axis

§ addRadialAxis()

QCPPolarAxisRadial * QCPPolarAxisAngular::addRadialAxis ( QCPPolarAxisRadial *  axis = 0)

Adds a new axis to the axis rect side specified with type, and returns it. If axis is 0, a new QCPAxis instance is created internally. QCustomPlot owns the returned axis, so if you want to remove an axis, use removeAxis instead of deleting it manually.

You may inject QCPAxis instances (or subclasses of QCPAxis) by setting axis to an axis that was previously created outside QCustomPlot. It is important to note that QCustomPlot takes ownership of the axis, so you may not delete it afterwards. Further, the axis must have been created with this axis rect as parent and with the same axis type as specified in type. If this is not the case, a debug output is generated, the axis is not added, and the method returns 0.

This method can not be used to move axis between axis rects. The same axis instance must not be added multiple times to the same or different axis rects.

If an axis rect side already contains one or more axes, the lower and upper endings of the new axis (QCPAxis::setLowerEnding, QCPAxis::setUpperEnding) are set to QCPLineEnding::esHalfBar.

See also
addAxes, setupFullAxesBox

§ removeRadialAxis()

bool QCPPolarAxisAngular::removeRadialAxis ( QCPPolarAxisRadial *  radialAxis)

Removes the specified axis from the axis rect and deletes it.

Returns true on success, i.e. if axis was a valid axis in this axis rect.

See also
addAxis

§ insetLayout()

QCPLayoutInset * QCPPolarAxisAngular::insetLayout ( ) const
inline

Returns the inset layout of this axis rect. It can be used to place other layout elements (or even layouts with multiple other elements) inside/on top of an axis rect.

See also
QCPLayoutInset

§ moveRange()

void QCPPolarAxisAngular::moveRange ( double  diff)

If the scale type (setScaleType) is stLinear, diff is added to the lower and upper bounds of the range. The range is simply moved by diff.

If the scale type is stLogarithmic, the range bounds are multiplied by diff. This corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff).

§ scaleRange() [1/2]

void QCPPolarAxisAngular::scaleRange ( double  factor)

Scales the range of this axis by factor around the center of the current axis range. For example, if factor is 2.0, then the axis range will double its size, and the point at the axis range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around the center will have moved symmetrically closer).

If you wish to scale around a different coordinate than the current axis range center, use the overload scaleRange(double factor, double center).

§ scaleRange() [2/2]

void QCPPolarAxisAngular::scaleRange ( double  factor,
double  center 
)

This is an overloaded function.

Scales the range of this axis by factor around the coordinate center. For example, if factor is 2.0, center is 1.0, then the axis range will double its size, and the point at coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates around 1.0 will have moved symmetrically closer to 1.0).

See also
scaleRange(double factor)

§ rescale()

void QCPPolarAxisAngular::rescale ( bool  onlyVisiblePlottables = false)

Changes the axis range such that all plottables associated with this axis are fully visible in that dimension.

See also
QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes

§ pixelToCoord()

void QCPPolarAxisAngular::pixelToCoord ( QPointF  pixelPos,
double &  angleCoord,
double &  radiusCoord 
) const

Transforms value, in pixel coordinates of the QCustomPlot widget, to axis coordinates.

§ coordToPixel()

QPointF QCPPolarAxisAngular::coordToPixel ( double  angleCoord,
double  radiusCoord 
) const

Transforms value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget.

§ getPartAt()

QCPPolarAxisAngular::SelectablePart QCPPolarAxisAngular::getPartAt ( const QPointF &  pos) const

Returns the part of the axis that is hit by pos (in pixels). The return value of this function is independent of the user-selectable parts defined with setSelectableParts. Further, this function does not change the current selection state of the axis.

If the axis is not visible (setVisible), this function always returns spNone.

See also
setSelectedParts, setSelectableParts, QCustomPlot::setInteractions

§ left()

int QCPPolarAxisAngular::left ( ) const
inline

Returns the pixel position of the left border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ right()

int QCPPolarAxisAngular::right ( ) const
inline

Returns the pixel position of the right border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ top()

int QCPPolarAxisAngular::top ( ) const
inline

Returns the pixel position of the top border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ bottom()

int QCPPolarAxisAngular::bottom ( ) const
inline

Returns the pixel position of the bottom border of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ width()

int QCPPolarAxisAngular::width ( ) const
inline

Returns the pixel width of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ height()

int QCPPolarAxisAngular::height ( ) const
inline

Returns the pixel height of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ size()

QSize QCPPolarAxisAngular::size ( ) const
inline

Returns the pixel size of this axis rect. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ topLeft()

QPoint QCPPolarAxisAngular::topLeft ( ) const
inline

Returns the top left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ topRight()

QPoint QCPPolarAxisAngular::topRight ( ) const
inline

Returns the top right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ bottomLeft()

QPoint QCPPolarAxisAngular::bottomLeft ( ) const
inline

Returns the bottom left corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ bottomRight()

QPoint QCPPolarAxisAngular::bottomRight ( ) const
inline

Returns the bottom right corner of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ center()

QPoint QCPPolarAxisAngular::center ( ) const
inline

Returns the center of this axis rect in pixels. Margins are not taken into account here, so the returned value is with respect to the inner rect.

§ applyDefaultAntialiasingHint()

void QCPPolarAxisAngular::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Reimplemented from QCPLayoutElement.

§ draw()

void QCPPolarAxisAngular::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Reimplemented from QCPLayoutElement.

§ selectionCategory()

QCP::Interaction QCPPolarAxisAngular::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ mousePressEvent()

void QCPPolarAxisAngular::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
protectedvirtual

Event handler for when a mouse button is pressed on the axis rect. If the left mouse button is pressed, the range dragging interaction is initialized (the actual range manipulation happens in the mouseMoveEvent).

The mDragging flag is set to true and some anchor points are set that are needed to determine the distance the mouse was dragged in the mouse move/release events later.

See also
mouseMoveEvent, mouseReleaseEvent

Reimplemented from QCPLayerable.

§ mouseMoveEvent()

void QCPPolarAxisAngular::mouseMoveEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

Event handler for when the mouse is moved on the axis rect. If range dragging was activated in a preceding mousePressEvent, the range is moved accordingly.

See also
mousePressEvent, mouseReleaseEvent

Reimplemented from QCPLayerable.

§ mouseReleaseEvent()

void QCPPolarAxisAngular::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
protectedvirtual

This event gets called when the user releases the mouse button, after this layerable has become the mouse grabber by accepting the preceding mousePressEvent.

The current pixel position of the cursor on the QCustomPlot widget is accessible via event->pos(). The parameter startPos indicates the position where the initial mousePressEvent occurred, that started the mouse interaction.

The default implementation does nothing.

See also
mousePressEvent, mouseMoveEvent, mouseDoubleClickEvent, wheelEvent

Reimplemented from QCPLayerable.

§ wheelEvent()

void QCPPolarAxisAngular::wheelEvent ( QWheelEvent *  event)
protectedvirtual

Event handler for mouse wheel events. If rangeZoom is Qt::Horizontal, Qt::Vertical or both, the ranges of the axes defined as rangeZoomHorzAxis and rangeZoomVertAxis are scaled. The center of the scaling operation is the current cursor position inside the axis rect. The scaling factor is dependent on the mouse wheel delta (which direction the wheel was rotated) to provide a natural zooming feel. The Strength of the zoom can be controlled via setRangeZoomFactor.

Note, that event->delta() is usually +/-120 for single rotation steps. However, if the mouse wheel is turned rapidly, many steps may bunch up to one event, so the event->delta() may then be multiples of 120. This is taken into account here, by calculating wheelSteps and using it as exponent of the range zoom factor. This takes care of the wheel direction automatically, by inverting the factor, when the wheel step is negative (f^-1 = 1/f).

Reimplemented from QCPLayerable.

§ drawBackground()

void QCPPolarAxisAngular::drawBackground ( QCPPainter *  painter,
const QPointF &  center,
double  radius 
)
protected

Draws the background of this axis rect. It may consist of a background fill (a QBrush) and a pixmap.

If a brush was given via setBackground(const QBrush &brush), this function first draws an according filling inside the axis rect with the provided painter.

Then, if a pixmap was provided via setBackground, this function buffers the scaled version depending on setBackgroundScaled and setBackgroundScaledMode and then draws it inside the axis rect with the provided painter. The scaled version is buffered in mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when the axis rect has changed in a way that requires a rescale of the background pixmap (this is dependent on the setBackgroundScaledMode), or when a differend axis background pixmap was set.

See also
setBackground, setBackgroundScaled, setBackgroundScaledMode

§ setupTickVectors()

void QCPPolarAxisAngular::setupTickVectors ( )
protected

Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling QCPAxisTicker::generate on the currently installed ticker.

If a change in the label text/count is detected, the cached axis margin is invalidated to make sure the next margin calculation recalculates the label sizes and returns an up-to-date value.

§ getBasePen()

QPen QCPPolarAxisAngular::getBasePen ( ) const
protected

Returns the pen that is used to draw the axis base line. Depending on the selection state, this is either mSelectedBasePen or mBasePen.

§ getTickPen()

QPen QCPPolarAxisAngular::getTickPen ( ) const
protected

Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this is either mSelectedTickPen or mTickPen.

§ getSubTickPen()

QPen QCPPolarAxisAngular::getSubTickPen ( ) const
protected

Returns the pen that is used to draw the subticks. Depending on the selection state, this is either mSelectedSubTickPen or mSubTickPen.

§ getTickLabelFont()

QFont QCPPolarAxisAngular::getTickLabelFont ( ) const
protected

Returns the font that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelFont or mTickLabelFont.

§ getLabelFont()

QFont QCPPolarAxisAngular::getLabelFont ( ) const
protected

Returns the font that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelFont or mLabelFont.

§ getTickLabelColor()

QColor QCPPolarAxisAngular::getTickLabelColor ( ) const
protected

Returns the color that is used to draw the tick labels. Depending on the selection state, this is either mSelectedTickLabelColor or mTickLabelColor.

§ getLabelColor()

QColor QCPPolarAxisAngular::getLabelColor ( ) const
protected

Returns the color that is used to draw the axis label. Depending on the selection state, this is either mSelectedLabelColor or mLabelColor.

The documentation for this class was generated from the following files:
  • src/polar/layoutelement-angularaxis.h
  • src/polar/layoutelement-angularaxis.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarGraph.html0000644000175000017500000030622114030601040025156 0ustar rusconirusconi QCPPolarGraph Class Reference
Public Types | Public Functions | Signals | Protected Functions
QCPPolarGraph Class Reference

A radial graph used to display data in polar plots. More...

Inheritance diagram for QCPPolarGraph:
Inheritance graph

Public Types

enum  LineStyle
 

Public Functions

 QCPPolarGraph (QCPPolarAxisAngular *keyAxis, QCPPolarAxisRadial *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
bool periodic () const
 
QCPPolarAxisAngular * keyAxis () const
 
QCPPolarAxisRadial * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QSharedPointer< QCPGraphDataContainer > data () const
 
LineStyle lineStyle () const
 
QCPScatterStyle scatterStyle () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setPeriodic (bool enabled)
 
void setKeyAxis (QCPPolarAxisAngular *axis)
 
void setValueAxis (QCPPolarAxisRadial *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setData (QSharedPointer< QCPGraphDataContainer > data)
 
void setData (const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void setLineStyle (LineStyle ls)
 
void setScatterStyle (const QCPScatterStyle &style)
 
void addData (const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void addData (double key, double value)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=0) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual QRect clipRect () const
 
virtual void draw (QCPPainter *painter)
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void drawLinePlot (QCPPainter *painter, const QVector< QPointF > &lines) const
 
virtual void drawFill (QCPPainter *painter, QVector< QPointF > *lines) const
 
virtual void drawScatterPlot (QCPPainter *painter, const QVector< QPointF > &scatters, const QCPScatterStyle &style) const
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
double pointDistance (const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const
 
virtual int dataCount () const
 
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
void getVisibleDataBounds (QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const
 
void getLines (QVector< QPointF > *lines, const QCPDataRange &dataRange) const
 
void getScatters (QVector< QPointF > *scatters, const QCPDataRange &dataRange) const
 
void getOptimizedLineData (QVector< QCPGraphData > *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const
 
void getOptimizedScatterData (QVector< QCPGraphData > *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const
 
QVector< QPointF > dataToLines (const QVector< QCPGraphData > &data) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

A radial graph used to display data in polar plots.

Warning
In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future.

Member Enumeration Documentation

§ LineStyle

enum QCPPolarGraph::LineStyle

Defines how the graph's line is represented visually in the plot. The line is drawn with the current pen of the graph (setPen).

See also
setLineStyle
Enumerator
lsNone 

data points are not connected with any lines (e.g. data only represented with symbols according to the scatter style, see setScatterStyle)

lsLine 

data points are connected by a straight line

Constructor & Destructor Documentation

§ QCPPolarGraph()

QCPPolarGraph::QCPPolarGraph ( QCPPolarAxisAngular *  keyAxis,
QCPPolarAxisRadial *  valueAxis 
)

Constructs a graph which uses keyAxis as its angular and valueAxis as its radial axis. keyAxis and valueAxis must reside in the same QCustomPlot, and the radial axis must be associated with the angular axis. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

The created QCPPolarGraph is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPPolarGraph, so do not delete it manually but use QCPPolarAxisAngular::removeGraph() instead.

To directly create a QCPPolarGraph inside a plot, you shoud use the QCPPolarAxisAngular::addGraph method.

Member Function Documentation

§ setName()

void QCPPolarGraph::setName ( const QString &  name)

The name is the textual representation of this plottable as it is displayed in the legend (QCPLegend). It may contain any UTF-8 characters, including newlines.

§ setAntialiasedFill()

void QCPPolarGraph::setAntialiasedFill ( bool  enabled)

Sets whether fills of this plottable are drawn antialiased or not.

Note that this setting may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

§ setAntialiasedScatters()

void QCPPolarGraph::setAntialiasedScatters ( bool  enabled)

Sets whether the scatter symbols of this plottable are drawn antialiased or not.

Note that this setting may be overridden by QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements.

§ setPen()

void QCPPolarGraph::setPen ( const QPen &  pen)

The pen is used to draw basic lines that make up the plottable representation in the plot.

For example, the QCPGraph subclass draws its graph lines with this pen.

See also
setBrush

§ setBrush()

void QCPPolarGraph::setBrush ( const QBrush &  brush)

The brush is used to draw basic fills of the plottable representation in the plot. The Fill can be a color, gradient or texture, see the usage of QBrush.

For example, the QCPGraph subclass draws the fill under the graph with this brush, when it's not set to Qt::NoBrush.

See also
setPen

§ setKeyAxis()

void QCPPolarGraph::setKeyAxis ( QCPPolarAxisAngular *  axis)

The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's value axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis.

Normally, the key and value axes are set in the constructor of the plottable (or QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface).

See also
setValueAxis

§ setValueAxis()

void QCPPolarGraph::setValueAxis ( QCPPolarAxisRadial *  axis)

The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal to the plottable's key axis. This function performs no checks to make sure this is the case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the y-axis (QCustomPlot::yAxis) as value axis.

Normally, the key and value axes are set in the constructor of the plottable (or QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface).

See also
setKeyAxis

§ setSelectable()

void QCPPolarGraph::setSelectable ( QCP::SelectionType  selectable)

Sets whether and to which granularity this plottable can be selected.

A selection can happen by clicking on the QCustomPlot surface (When QCustomPlot::setInteractions contains QCP::iSelectPlottables), by dragging a selection rect (When QCustomPlot::setSelectionRectMode is QCP::srmSelect), or programmatically by calling setSelection.

See also
setSelection, QCP::SelectionType

§ setSelection()

void QCPPolarGraph::setSelection ( QCPDataSelection  selection)

Sets which data ranges of this plottable are selected. Selected data ranges are drawn differently (e.g. color) in the plot. This can be controlled via the selection decorator (see selectionDecorator).

The entire selection mechanism for plottables is handled automatically when QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when you wish to change the selection state programmatically.

Using setSelectable you can further specify for each plottable whether and to which granularity it is selectable. If selection is not compatible with the current QCP::SelectionType set via setSelectable, the resulting selection will be adjusted accordingly (see QCPDataSelection::enforceType).

emits the selectionChanged signal when selected is different from the previous selection state.

See also
setSelectable, selectTest

§ setData() [1/2]

void QCPPolarGraph::setData ( QSharedPointer< QCPGraphDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPPolarGraphs may share the same data container safely. Modifying the data in the container will then affect all graphs that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the graph's data container directly:

See also
addData

§ setData() [2/2]

void QCPPolarGraph::setData ( const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data with the provided points in keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

See also
addData

§ setLineStyle()

void QCPPolarGraph::setLineStyle ( LineStyle  ls)

Sets how the single data points are connected in the plot. For scatter-only plots, set ls to lsNone and setScatterStyle to the desired scatter style.

See also
setScatterStyle

§ setScatterStyle()

void QCPPolarGraph::setScatterStyle ( const QCPScatterStyle &  style)

Sets the visual appearance of single data points in the plot. If set to QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only-plots with appropriate line style).

See also
QCPScatterStyle, setLineStyle

§ coordsToPixels()

void QCPPolarGraph::coordsToPixels ( double  key,
double  value,
double &  x,
double &  y 
) const

Use this method to set an own QCPSelectionDecorator (subclass) instance. This allows you to customize the visual representation of selected data ranges further than by using the default QCPSelectionDecorator.

The plottable takes ownership of the decorator.

The currently set decorator can be accessed via selectionDecorator.

§ selectTest()

double QCPPolarGraph::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = 0 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Reimplemented from QCPLayerable.

§ clipRect()

QRect QCPPolarGraph::clipRect ( ) const
protectedvirtual

Returns the clipping rectangle of this layerable object. By default, this is the viewport of the parent QCustomPlot. Specific subclasses may reimplement this function to provide different clipping rects.

The returned clipping rect is set on the painter before the draw function of the respective object is called.

Reimplemented from QCPLayerable.

§ draw()

void QCPPolarGraph::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPLayerable.

§ selectionCategory()

QCP::Interaction QCPPolarGraph::selectionCategory ( ) const
protectedvirtual

Returns the selection category this layerable shall belong to. The selection category is used in conjunction with QCustomPlot::setInteractions to control which objects are selectable and which aren't.

Subclasses that don't fit any of the normal QCP::Interaction values can use QCP::iSelectOther. This is what the default implementation returns.

See also
QCustomPlot::setInteractions

Reimplemented from QCPLayerable.

§ applyDefaultAntialiasingHint()

void QCPPolarGraph::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Implements QCPLayerable.

§ selectEvent()

void QCPPolarGraph::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPPolarGraph::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ drawLinePlot()

void QCPPolarGraph::drawLinePlot ( QCPPainter *  painter,
const QVector< QPointF > &  lines 
) const
protectedvirtual

Draws lines between the points in lines, given in pixel coordinates.

See also
drawScatterPlot, drawImpulsePlot, QCPAbstractPlottable1D::drawPolyline

§ drawFill()

void QCPPolarGraph::drawFill ( QCPPainter *  painter,
QVector< QPointF > *  lines 
) const
protectedvirtual

Draws the fill of the graph using the specified painter, with the currently set brush.

Depending on whether a normal fill or a channel fill (setChannelFillGraph) is needed, getFillPolygon or getChannelFillPolygon are used to find the according fill polygons.

In order to handle NaN Data points correctly (the fill needs to be split into disjoint areas), this method first determines a list of non-NaN segments with getNonNanSegments, on which to operate. In the channel fill case, getOverlappingSegments is used to consolidate the non-NaN segments of the two involved graphs, before passing the overlapping pairs to getChannelFillPolygon.

Pass the points of this graph's line as lines, in pixel coordinates.

See also
drawLinePlot, drawImpulsePlot, drawScatterPlot

§ drawScatterPlot()

void QCPPolarGraph::drawScatterPlot ( QCPPainter *  painter,
const QVector< QPointF > &  scatters,
const QCPScatterStyle &  style 
) const
protectedvirtual

Draws scatter symbols at every point passed in scatters, given in pixel coordinates. The scatters will be drawn with painter and have the appearance as specified in style.

See also
drawLinePlot, drawImpulsePlot

§ getLines()

void QCPPolarGraph::getLines ( QVector< QPointF > *  lines,
const QCPDataRange &  dataRange 
) const
protected

This method retrieves an optimized set of data points via getOptimizedLineData, an branches out to the line style specific functions such as dataToLines, dataToStepLeftLines, etc. according to the line style of the graph.

lines will be filled with points in pixel coordinates, that can be drawn with the according draw functions like drawLinePlot and drawImpulsePlot. The points returned in lines aren't necessarily the original data points. For example, step line styles require additional points to form the steps when drawn. If the line style of the graph is lsNone, the lines vector will be empty.

dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in dataRange, e.g. when extending ranges coming from getDataSegments.

See also
getScatters

§ dataToLines()

QVector< QPointF > QCPPolarGraph::dataToLines ( const QVector< QCPGraphData > &  data) const
protected

Takes raw data points in plot coordinates as data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style lsLine.

The source of data is usually getOptimizedLineData, and this method is called in getLines if the line style is set accordingly.

See also
dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot
The documentation for this class was generated from the following files:
  • src/polar/polargraph.h
  • src/polar/polargraph.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/globals_type.html0000644000175000017500000000341214030601037024213 0ustar rusconirusconi Globals
 
qcustomplot-2.1.0+dfsg1/documentation/html/dir_4749ca9c363ee6e69b445a1c06361cef.html0000644000175000017500000000245614030601036026764 0ustar rusconirusconi src/axis Directory Reference
axis Directory Reference
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPGrid__inherit__graph.png0000644000175000017500000000144714030601041027030 0ustar rusconirusconi‰PNG  IHDRpk]ß gAMA† 1è–_0PLTEýýýÿÿÿÒÒÕiiiMMM™™™………èè骪³444+""Zff—RkÍJòtRNS«â¢bKGDÿ-Þ pHYsHHFÉk>IDATXÃí×1O1`ø ¦1"ª J#6–©è5W%‹‘_pÉT©'ÁØ1FFLUiUk7zRX[$2 ö.ì]º3ð|91DÇÝÙj¥Bý¤K|çûbûùét!Ž1òÀêœuÌÆ0°‡|íçù8!Ń¥ÃÞ’tÀ{jKâ 'Aû€°ÏÌ Ò6¸é.Ǹ$åÕ*2 ­6V_I2M– LF”´1^{±Ã(–É£G‡„=Y2à`%¼{€aG`>§ Ž YSDÛŸe~ Oøn+™ÉÀ­ˆÈ2÷¼†'b/™êl5e;Âd; ‡ˆÐ©bZ°«Ë’äð´xúfh >ŽºUíü‰’óЂu àNóžX:¾¯§ý$ß8ÉèÌ‚?ÏÝ`YëNpRëk'øLë+'¸¯õ©ü¥õ…¼ÑúÒŽiŒŠœ4ðÚNøÛÎøÝ~5ðÌb\etz衇z衇ÿiùcøÊb*,òjœ »*7¢Ç e>ÜüŽ /¡£6úxI‚á»pm³Ó\½H…ß^‹Â#vÕ¶}sk ÌY¢õ|ÈUOÈ‘8¯„œ·¸F®À´ñl¦jÚˆTAˆÉéÇÉ1mLN ‹Lõn;â6¬X(9JÕ[ÿBÉyè Ÿr½fn´R¡]<$˜Ÿ‘ô¸¥¤+‘+A%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPSelectionRect.html0000644000175000017500000014124614030601040025666 0ustar rusconirusconi QCPSelectionRect Class Reference
Public Functions | Signals | Protected Functions
QCPSelectionRect Class Reference

Provides rect/rubber-band data selection and range zoom interaction. More...

Inheritance diagram for QCPSelectionRect:
Inheritance graph

Public Functions

 QCPSelectionRect (QCustomPlot *parentPlot)
 
QRect rect () const
 
QCPRange range (const QCPAxis *axis) const
 
QPen pen () const
 
QBrush brush () const
 
bool isActive () const
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
Q_SLOT void cancel ()
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
bool realVisibility () const
 

Signals

void started (QMouseEvent *event)
 
void changed (const QRect &rect, QMouseEvent *event)
 
void canceled (const QRect &rect, QInputEvent *event)
 
void accepted (const QRect &rect, QMouseEvent *event)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void startSelection (QMouseEvent *event)
 
virtual void moveSelection (QMouseEvent *event)
 
virtual void endSelection (QMouseEvent *event)
 
virtual void keyPressEvent (QKeyEvent *event)
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

Provides rect/rubber-band data selection and range zoom interaction.

QCPSelectionRect is used by QCustomPlot when the QCustomPlot::setSelectionRectMode is not QCP::srmNone. When the user drags the mouse across the plot, the current selection rect instance (QCustomPlot::setSelectionRect) is forwarded these events and makes sure an according rect shape is drawn. At the begin, during, and after completion of the interaction, it emits the corresponding signals started, changed, canceled, and accepted.

The QCustomPlot instance connects own slots to the current selection rect instance, in order to react to an accepted selection rect interaction accordingly.

isActive can be used to check whether the selection rect is currently active. An ongoing selection interaction can be cancelled programmatically via calling cancel at any time.

The appearance of the selection rect can be controlled via setPen and setBrush.

If you wish to provide custom behaviour, e.g. a different visual representation of the selection rect (QCPSelectionRect::draw), you can subclass QCPSelectionRect and pass an instance of your subclass to QCustomPlot::setSelectionRect.

Constructor & Destructor Documentation

§ QCPSelectionRect()

QCPSelectionRect::QCPSelectionRect ( QCustomPlot *  parentPlot)
explicit

Creates a new QCPSelectionRect instance. To make QCustomPlot use the selection rect instance, pass it to QCustomPlot::setSelectionRect. parentPlot should be set to the same QCustomPlot widget.

Member Function Documentation

§ range()

QCPRange QCPSelectionRect::range ( const QCPAxis *  axis) const

A convenience function which returns the coordinate range of the provided axis, that this selection rect currently encompasses.

§ isActive()

bool QCPSelectionRect::isActive ( ) const
inline

Returns true if there is currently a selection going on, i.e. the user has started dragging a selection rect, but hasn't released the mouse button yet.

See also
cancel

§ setPen()

void QCPSelectionRect::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the selection rect outline.

See also
setBrush

§ setBrush()

void QCPSelectionRect::setBrush ( const QBrush &  brush)

Sets the brush that will be used to fill the selection rect. By default the selection rect is not filled, i.e. brush is Qt::NoBrush.

See also
setPen

§ cancel()

void QCPSelectionRect::cancel ( )

If there is currently a selection interaction going on (isActive), the interaction is canceled. The selection rect will emit the canceled signal.

§ started

void QCPSelectionRect::started ( QMouseEvent *  event)
signal

This signal is emitted when a selection rect interaction was initiated, i.e. the user just started dragging the selection rect with the mouse.

§ changed

void QCPSelectionRect::changed ( const QRect &  rect,
QMouseEvent *  event 
)
signal

This signal is emitted while the selection rect interaction is ongoing and the rect has changed its size due to the user moving the mouse.

Note that rect may have a negative width or height, if the selection is being dragged to the upper or left side of the selection rect origin.

§ canceled

void QCPSelectionRect::canceled ( const QRect &  rect,
QInputEvent *  event 
)
signal

This signal is emitted when the selection interaction was cancelled. Note that event is nullptr if the selection interaction was cancelled programmatically, by a call to cancel.

The user may cancel the selection interaction by pressing the escape key. In this case, event holds the respective input event.

Note that rect may have a negative width or height, if the selection is being dragged to the upper or left side of the selection rect origin.

§ accepted

void QCPSelectionRect::accepted ( const QRect &  rect,
QMouseEvent *  event 
)
signal

This signal is emitted when the selection interaction was completed by the user releasing the mouse button.

Note that rect may have a negative width or height, if the selection is being dragged to the upper or left side of the selection rect origin.

§ startSelection()

void QCPSelectionRect::startSelection ( QMouseEvent *  event)
protectedvirtual

This method is called by QCustomPlot to indicate that a selection rect interaction was initiated. The default implementation sets the selection rect to active, initializes the selection rect geometry and emits the started signal.

§ moveSelection()

void QCPSelectionRect::moveSelection ( QMouseEvent *  event)
protectedvirtual

This method is called by QCustomPlot to indicate that an ongoing selection rect interaction needs to update its geometry. The default implementation updates the rect and emits the changed signal.

§ endSelection()

void QCPSelectionRect::endSelection ( QMouseEvent *  event)
protectedvirtual

This method is called by QCustomPlot to indicate that an ongoing selection rect interaction has finished by the user releasing the mouse button. The default implementation deactivates the selection rect and emits the accepted signal.

§ keyPressEvent()

void QCPSelectionRect::keyPressEvent ( QKeyEvent *  event)
protectedvirtual

This method is called by QCustomPlot when a key has been pressed by the user while the selection rect interaction is active. The default implementation allows to cancel the interaction by hitting the escape key.

§ applyDefaultAntialiasingHint()

void QCPSelectionRect::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Implements QCPLayerable.

§ draw()

void QCPSelectionRect::draw ( QCPPainter *  painter)
protectedvirtual

If the selection rect is active (isActive), draws the selection rect defined by mRect.

For general information about this virtual method, see the base class implementation.

Implements QCPLayerable.

The documentation for this class was generated from the following files:
  • src/selectionrect.h
  • src/selectionrect.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/files.html0000644000175000017500000001044614030601037022636 0ustar rusconirusconi File List
File List
Here is a list of all documented files with brief descriptions:
[detail level 123]
 ▼ src
 ▼ plottables
 plottable-bars.h
 plottable-curve.h
 plottable-errorbar.h
 plottable-financial.h
 plottable-graph.h
 plottable-statisticalbox.h
 core.cpp
 datacontainer.h
 global.h
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerLog.html0000644000175000017500000005636214030601040025637 0ustar rusconirusconi QCPAxisTickerLog Class Reference
Public Functions | Protected Functions
QCPAxisTickerLog Class Reference

Specialized axis ticker suited for logarithmic axes. More...

Inheritance diagram for QCPAxisTickerLog:
Inheritance graph

Public Functions

 QCPAxisTickerLog ()
 
double logBase () const
 
int subTickCount () const
 
void setLogBase (double base)
 
void setSubTickCount (int subTicks)
 
- Public Functions inherited from QCPAxisTicker
 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Protected Functions

virtual int getSubTickCount (double tickStep)
 
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
- Protected Functions inherited from QCPAxisTicker
virtual double getTickStep (const QCPRange &range)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Additional Inherited Members

- Public Types inherited from QCPAxisTicker
enum  TickStepStrategy
 

Detailed Description

Specialized axis ticker suited for logarithmic axes.

axisticker-log.png

This QCPAxisTicker subclass generates ticks with unequal tick intervals suited for logarithmic axis scales. The ticks are placed at powers of the specified log base (setLogBase).

Especially in the case of a log base equal to 10 (the default), it might be desirable to have tick labels in the form of powers of ten without mantissa display. To achieve this, set the number precision (QCPAxis::setNumberPrecision) to zero and the number format (QCPAxis::setNumberFormat) to scientific (exponential) display with beautifully typeset decimal powers, so a format string of "eb". This will result in the following axis tick labels:

axisticker-log-powers.png

The ticker can be created and assigned to an axis like this:

QSharedPointer<QCPAxisTickerLog> logTicker(new QCPAxisTickerLog);
customPlot->xAxis->setTicker(logTicker);
// don't forget to also set the scale type accordingly, otherwise you'll have
// logarithmically spaced ticks on a linear axis:
customPlot->xAxis->setScaleType(QCPAxis::stLogarithmic);

Note that the nature of logarithmic ticks imply that there exists a smallest possible tick step, corresponding to one multiplication by the log base. If the user zooms in further than that, no new ticks would appear, leading to very sparse or even no axis ticks on the axis. To prevent this situation, this ticker falls back to regular tick generation if the axis range would be covered by too few logarithmically placed ticks.

Constructor & Destructor Documentation

§ QCPAxisTickerLog()

QCPAxisTickerLog::QCPAxisTickerLog ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ setLogBase()

void QCPAxisTickerLog::setLogBase ( double  base)

Sets the logarithm base used for tick coordinate generation. The ticks will be placed at integer powers of base.

§ setSubTickCount()

void QCPAxisTickerLog::setSubTickCount ( int  subTicks)

Sets the number of sub ticks in a tick interval. Within each interval, the sub ticks are spaced linearly to provide a better visual guide, so the sub tick density increases toward the higher tick.

Note that subTicks is the number of sub ticks (not sub intervals) in one tick interval. So in the case of logarithm base 10 an intuitive sub tick spacing would be achieved with eight sub ticks (the default). This means e.g. between the ticks 10 and 100 there will be eight ticks, namely at 20, 30, 40, 50, 60, 70, 80 and 90.

§ getSubTickCount()

int QCPAxisTickerLog::getSubTickCount ( double  tickStep)
protectedvirtual

Returns the sub tick count specified in setSubTickCount. For QCPAxisTickerLog, there is no automatic sub tick count calculation necessary.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ createTickVector()

QVector< double > QCPAxisTickerLog::createTickVector ( double  tickStep,
const QCPRange &  range 
)
protectedvirtual

Creates ticks with a spacing given by the logarithm base and an increasing integer power in the provided range. The step in which the power increases tick by tick is chosen in order to keep the total number of ticks as close as possible to the tick count (setTickCount).

The parameter tickStep is ignored for the normal logarithmic ticker generation. Only when zoomed in very far such that not enough logarithmically placed ticks would be visible, this function falls back to the regular QCPAxisTicker::createTickVector, which then uses tickStep.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

The documentation for this class was generated from the following files:
  • src/axis/axistickerlog.h
  • src/axis/axistickerlog.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/inherits.html0000644000175000017500000004265614030601042023365 0ustar rusconirusconi Class Hierarchy
Class Hierarchy

Switch to list view

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPlottableInterface1D.html0000644000175000017500000010357414030601040027061 0ustar rusconirusconi QCPPlottableInterface1D Class Reference
Public Functions
QCPPlottableInterface1D Class Referenceabstract

Defines an abstract interface for one-dimensional plottables. More...

Inheritance diagram for QCPPlottableInterface1D:
Inheritance graph

Public Functions

virtual int dataCount () const =0
 
virtual double dataMainKey (int index) const =0
 
virtual double dataSortKey (int index) const =0
 
virtual double dataMainValue (int index) const =0
 
virtual QCPRange dataValueRange (int index) const =0
 
virtual QPointF dataPixelPosition (int index) const =0
 
virtual bool sortKeyIsMainKey () const =0
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const =0
 
virtual int findBegin (double sortKey, bool expandedRange=true) const =0
 
virtual int findEnd (double sortKey, bool expandedRange=true) const =0
 

Detailed Description

Defines an abstract interface for one-dimensional plottables.

This class contains only pure virtual methods which define a common interface to the data of one-dimensional plottables.

For example, it is implemented by the template class QCPAbstractPlottable1D (the preferred base class for one-dimensional plottables). So if you use that template class as base class of your one-dimensional plottable, you won't have to care about implementing the 1d interface yourself.

If your plottable doesn't derive from QCPAbstractPlottable1D but still wants to provide a 1d interface (e.g. like QCPErrorBars does), you should inherit from both QCPAbstractPlottable and QCPPlottableInterface1D and accordingly reimplement the pure virtual methods of the 1d interface, matching your data container. Also, reimplement QCPAbstractPlottable::interface1D to return the this pointer.

If you have a QCPAbstractPlottable pointer, you can check whether it implements this interface by calling QCPAbstractPlottable::interface1D and testing it for a non-zero return value. If it indeed implements this interface, you may use it to access the plottable's data without needing to know the exact type of the plottable or its data point type.

Member Function Documentation

§ dataCount()

int QCPPlottableInterface1D::dataCount ( ) const
pure virtual

Returns the number of data points of the plottable.

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ dataMainKey()

double QCPPlottableInterface1D::dataMainKey ( int  index) const
pure virtual

Returns the main key of the data point at the given index.

What the main key is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ dataSortKey()

double QCPPlottableInterface1D::dataSortKey ( int  index) const
pure virtual

Returns the sort key of the data point at the given index.

What the sort key is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ dataMainValue()

double QCPPlottableInterface1D::dataMainValue ( int  index) const
pure virtual

Returns the main value of the data point at the given index.

What the main value is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ dataValueRange()

QCPRange QCPPlottableInterface1D::dataValueRange ( int  index) const
pure virtual

Returns the value range of the data point at the given index.

What the value range is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ dataPixelPosition()

QPointF QCPPlottableInterface1D::dataPixelPosition ( int  index) const
pure virtual

Returns the pixel position on the widget surface at which the data point at the given index appears.

Usually this corresponds to the point of dataMainKey/dataMainValue, in pixel coordinates. However, depending on the plottable, this might be a different apparent position than just a coord-to-pixel transform of those values. For example, QCPBars apparent data values can be shifted depending on their stacking, bar grouping or configured base value.

Implemented in QCPBars, QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ sortKeyIsMainKey()

bool QCPPlottableInterface1D::sortKeyIsMainKey ( ) const
pure virtual

Returns whether the sort key (dataSortKey) is identical to the main key (dataMainKey).

What the sort and main keys are, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ selectTestRect()

QCPDataSelection QCPPlottableInterface1D::selectTestRect ( const QRectF &  rect,
bool  onlySelectable 
) const
pure virtual

Returns a data selection containing all the data points of this plottable which are contained (or hit by) rect. This is used mainly in the selection rect interaction for data selection (data selection mechanism).

If onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not selectable (i.e. if QCPAbstractPlottable::setSelectable is QCP::stNone).

Note
rect must be a normalized rect (positive or zero width and height). This is especially important when using the rect of QCPSelectionRect::accepted, which is not necessarily normalized. Use QRect::normalized() when passing a rect which might not be normalized.

Implemented in QCPBars, QCPFinancial, QCPErrorBars, QCPStatisticalBox, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ findBegin()

int QCPPlottableInterface1D::findBegin ( double  sortKey,
bool  expandedRange = true 
) const
pure virtual

Returns the index of the data point with a (sort-)key that is equal to, just below, or just above sortKey. If expandedRange is true, the data point just below sortKey will be considered, otherwise the one just above.

This can be used in conjunction with findEnd to iterate over data points within a given key range, including or excluding the bounding data points that are just beyond the specified range.

If expandedRange is true but there are no data points below sortKey, 0 is returned.

If the container is empty, returns 0 (in that case, findEnd will also return 0, so a loop using these methods will not iterate over the index 0).

See also
findEnd, QCPDataContainer::findBegin

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

§ findEnd()

int QCPPlottableInterface1D::findEnd ( double  sortKey,
bool  expandedRange = true 
) const
pure virtual

Returns the index one after the data point with a (sort-)key that is equal to, just above, or just below sortKey. If expandedRange is true, the data point just above sortKey will be considered, otherwise the one just below.

This can be used in conjunction with findBegin to iterate over data points within a given key range, including the bounding data points that are just below and above the specified range.

If expandedRange is true but there are no data points above sortKey, the index just above the highest data point is returned.

If the container is empty, returns 0.

See also
findBegin, QCPDataContainer::findEnd

Implemented in QCPErrorBars, QCPAbstractPlottable1D< DataType >, QCPAbstractPlottable1D< QCPFinancialData >, QCPAbstractPlottable1D< QCPStatisticalBoxData >, QCPAbstractPlottable1D< QCPGraphData >, QCPAbstractPlottable1D< QCPBarsData >, and QCPAbstractPlottable1D< QCPCurveData >.

The documentation for this class was generated from the following file:
  • src/plottable1d.h
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarAxisAngular__inherit__graph.png0000644000175000017500000000226514030601041031356 0ustar rusconirusconi‰PNG  IHDR•³ryCWgAMA† 1è–_0PLTEÿÿÿÿÿÿiii222NNN™™™………ççé°°´ÓÓÕ+PnnEE|q‘Ê+tRNSªvå’bKGDˆH pHYsHHFÉk>ŸIDAThÞíÛ1OÛ@p>B/`Dˆ MÀ•»5¤©"u£²”n=Ûϸe‚ÊR:òœ:F ­º n턪.U×UM%v–î|ˆÞùœ>K€t)8öù—»—C(Á *­Ìhkj«Ò*\ÏdÖ¬[Ø©Õ,¼.S[y…2”­ øll°Áo¼‘eî‘zÅùØ4ªá-U°Qçw%7‚…ÑÑ×öòƒ<86Ð7ØQ²6Q ' Içµ€ônö½‰\v’ ï°i ç¸˜%úe&èµÀ.Tø#»ŠÔ¬Ë5&Íq>`£Ñä8FÆ“#amí½°‚C¼;³/>skÏklýh*YóÃ=ÁŽÙZB#ÕÚ³æÁö¾®d!dï_ÝÕ§HRÅ÷=l•gÉK[wÑ‚â%³’z|*»bÉ,i-Å*£Ô¬OñNiÖE|Všuÿ.˪Æñß²¬å8>-ËZŠãx¿$ë'³þ•d]0ë¬$ëœYʱjŒRy#U¬en)¼‘*ÖÃ-V*[U[ÚÒ–¶´¥-miK[÷ÞÊ V©Ä¬Âš"X͈YS«©´Ry™ÚÊ,¬l]¬ˆ'†–!³® Va|¨he«_à-{‚«ÖÞ@¬B]ÔÓàdÒÊV_½äVºF³zÞAz€¥óÊVO¾§Ÿß°¯ô+¬ñJ°Ê¬êÈ:á—ðè ¿÷h ßÂJz?>Ô§»n·ŸôžôhÈ-Öûäš±WÛ–ú._™ØÇSÿ ±™K±2J[·m•ø{(/\U,ë~ü˲Êé<¯Gÿo¨Y¦“qhy%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemPosition.html0000644000175000017500000015324514030601040025550 0ustar rusconirusconi QCPItemPosition Class Reference
Public Types | Public Functions | Protected Functions
QCPItemPosition Class Reference

Manages the position of an item. More...

Inheritance diagram for QCPItemPosition:
Inheritance graph

Public Types

enum  PositionType
 

Public Functions

 QCPItemPosition (QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name)
 
PositionType type () const
 
PositionType typeX () const
 
PositionType typeY () const
 
QCPItemAnchor * parentAnchor () const
 
QCPItemAnchor * parentAnchorX () const
 
QCPItemAnchor * parentAnchorY () const
 
double key () const
 
double value () const
 
QPointF coords () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCPAxisRect * axisRect () const
 
virtual QPointF pixelPosition () const
 
void setType (PositionType type)
 
void setTypeX (PositionType type)
 
void setTypeY (PositionType type)
 
bool setParentAnchor (QCPItemAnchor *parentAnchor, bool keepPixelPosition=false)
 
bool setParentAnchorX (QCPItemAnchor *parentAnchor, bool keepPixelPosition=false)
 
bool setParentAnchorY (QCPItemAnchor *parentAnchor, bool keepPixelPosition=false)
 
void setCoords (double key, double value)
 
void setCoords (const QPointF &pos)
 
void setAxes (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
void setAxisRect (QCPAxisRect *axisRect)
 
void setPixelPosition (const QPointF &pixelPosition)
 
- Public Functions inherited from QCPItemAnchor
 QCPItemAnchor (QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId=-1)
 
QString name () const
 

Protected Functions

virtual QCPItemPosition * toQCPItemPosition ()
 
- Protected Functions inherited from QCPItemAnchor
void addChildX (QCPItemPosition *pos)
 
void removeChildX (QCPItemPosition *pos)
 
void addChildY (QCPItemPosition *pos)
 
void removeChildY (QCPItemPosition *pos)
 

Detailed Description

Manages the position of an item.

Every item has at least one public QCPItemPosition member pointer which provides ways to position the item on the QCustomPlot surface. Some items have multiple positions, for example QCPItemRect has two: topLeft and bottomRight.

QCPItemPosition has a type (PositionType) that can be set with setType. This type defines how coordinates passed to setCoords are to be interpreted, e.g. as absolute pixel coordinates, as plot coordinates of certain axes (QCPItemPosition::setAxes), as fractions of the axis rect (QCPItemPosition::setAxisRect), etc. For more advanced plots it is also possible to assign different types per X/Y coordinate of the position (see setTypeX, setTypeY). This way an item could be positioned for example at a fixed pixel distance from the top in the Y direction, while following a plot coordinate in the X direction.

A QCPItemPosition may have a parent QCPItemAnchor, see setParentAnchor. This way you can tie multiple items together. If the QCPItemPosition has a parent, its coordinates (setCoords) are considered to be absolute pixels in the reference frame of the parent anchor, where (0, 0) means directly ontop of the parent anchor. For example, You could attach the start position of a QCPItemLine to the bottom anchor of a QCPItemText to make the starting point of the line always be centered under the text label, no matter where the text is moved to. For more advanced plots, it is possible to assign different parent anchors per X/Y coordinate of the position, see setParentAnchorX, setParentAnchorY. This way an item could follow another item in the X direction but stay at a fixed position in the Y direction. Or even follow item A in X, and item B in Y.

Note that every QCPItemPosition inherits from QCPItemAnchor and thus can itself be used as parent anchor for other positions.

To set the apparent pixel position on the QCustomPlot surface directly, use setPixelPosition. This works no matter what type this QCPItemPosition is or what parent-child situation it is in, as setPixelPosition transforms the coordinates appropriately, to make the position appear at the specified pixel values.

Member Enumeration Documentation

§ PositionType

enum QCPItemPosition::PositionType

Defines the ways an item position can be specified. Thus it defines what the numbers passed to setCoords actually mean.

See also
setType
Enumerator
ptAbsolute 

Static positioning in pixels, starting from the top left corner of the viewport/widget.

ptViewportRatio 

Static positioning given by a fraction of the viewport size. For example, if you call setCoords(0, 0), the position will be at the top left corner of the viewport/widget. setCoords(1, 1) will be at the bottom right corner, setCoords(0.5, 0) will be horizontally centered and vertically at the top of the viewport/widget, etc.

ptAxisRectRatio 

Static positioning given by a fraction of the axis rect size (see setAxisRect). For example, if you call setCoords(0, 0), the position will be at the top left corner of the axis rect. setCoords(1, 1) will be at the bottom right corner, setCoords(0.5, 0) will be horizontally centered and vertically at the top of the axis rect, etc. You can also go beyond the axis rect by providing negative coordinates or coordinates larger than 1.

ptPlotCoords 

Dynamic positioning at a plot coordinate defined by two axes (see setAxes).

Constructor & Destructor Documentation

§ QCPItemPosition()

QCPItemPosition::QCPItemPosition ( QCustomPlot *  parentPlot,
QCPAbstractItem *  parentItem,
const QString &  name 
)

Creates a new QCPItemPosition. You shouldn't create QCPItemPosition instances directly, even if you want to make a new item subclass. Use QCPAbstractItem::createPosition instead, as explained in the subclassing section of the QCPAbstractItem documentation.

Member Function Documentation

§ type()

QCPItemPosition::PositionType * QCPItemPosition::type ( ) const
inline

Returns the current position type.

If different types were set for X and Y (setTypeX, setTypeY), this method returns the type of the X coordinate. In that case rather use typeX() and typeY().

See also
setType

§ parentAnchor()

QCPItemAnchor * QCPItemPosition::parentAnchor ( ) const
inline

Returns the current parent anchor.

If different parent anchors were set for X and Y (setParentAnchorX, setParentAnchorY), this method returns the parent anchor of the Y coordinate. In that case rather use parentAnchorX() and parentAnchorY().

See also
setParentAnchor

§ pixelPosition()

QPointF QCPItemPosition::pixelPosition ( ) const
virtual

Returns the final absolute pixel position of the QCPItemPosition on the QCustomPlot surface. It includes all effects of type (setType) and possible parent anchors (setParentAnchor).

See also
setPixelPosition

Reimplemented from QCPItemAnchor.

§ setType()

void QCPItemPosition::setType ( QCPItemPosition::PositionType  type)

Sets the type of the position. The type defines how the coordinates passed to setCoords should be handled and how the QCPItemPosition should behave in the plot.

The possible values for type can be separated in two main categories:

  • The position is regarded as a point in plot coordinates. This corresponds to ptPlotCoords and requires two axes that define the plot coordinate system. They can be specified with setAxes. By default, the QCustomPlot's x- and yAxis are used.

Note that the position type ptPlotCoords is only available (and sensible) when the position has no parent anchor (setParentAnchor).

If the type is changed, the apparent pixel position on the plot is preserved. This means the coordinates as retrieved with coords() and set with setCoords may change in the process.

This method sets the type for both X and Y directions. It is also possible to set different types for X and Y, see setTypeX, setTypeY.

§ setTypeX()

void QCPItemPosition::setTypeX ( QCPItemPosition::PositionType  type)

This method sets the position type of the X coordinate to type.

For a detailed description of what a position type is, see the documentation of setType.

See also
setType, setTypeY

§ setTypeY()

void QCPItemPosition::setTypeY ( QCPItemPosition::PositionType  type)

This method sets the position type of the Y coordinate to type.

For a detailed description of what a position type is, see the documentation of setType.

See also
setType, setTypeX

§ setParentAnchor()

bool QCPItemPosition::setParentAnchor ( QCPItemAnchor *  parentAnchor,
bool  keepPixelPosition = false 
)

Sets the parent of this QCPItemPosition to parentAnchor. This means the position will now follow any position changes of the anchor. The local coordinate system of positions with a parent anchor always is absolute pixels, with (0, 0) being exactly on top of the parent anchor. (Hence the type shouldn't be set to ptPlotCoords for positions with parent anchors.)

if keepPixelPosition is true, the current pixel position of the QCPItemPosition is preserved during reparenting. If it's set to false, the coordinates are set to (0, 0), i.e. the position will be exactly on top of the parent anchor.

To remove this QCPItemPosition from any parent anchor, set parentAnchor to nullptr.

If the QCPItemPosition previously had no parent and the type is ptPlotCoords, the type is set to ptAbsolute, to keep the position in a valid state.

This method sets the parent anchor for both X and Y directions. It is also possible to set different parents for X and Y, see setParentAnchorX, setParentAnchorY.

§ setParentAnchorX()

bool QCPItemPosition::setParentAnchorX ( QCPItemAnchor *  parentAnchor,
bool  keepPixelPosition = false 
)

This method sets the parent anchor of the X coordinate to parentAnchor.

For a detailed description of what a parent anchor is, see the documentation of setParentAnchor.

See also
setParentAnchor, setParentAnchorY

§ setParentAnchorY()

bool QCPItemPosition::setParentAnchorY ( QCPItemAnchor *  parentAnchor,
bool  keepPixelPosition = false 
)

This method sets the parent anchor of the Y coordinate to parentAnchor.

For a detailed description of what a parent anchor is, see the documentation of setParentAnchor.

See also
setParentAnchor, setParentAnchorX

§ setCoords() [1/2]

void QCPItemPosition::setCoords ( double  key,
double  value 
)

Sets the coordinates of this QCPItemPosition. What the coordinates mean, is defined by the type (setType, setTypeX, setTypeY).

For example, if the type is ptAbsolute, key and value mean the x and y pixel position on the QCustomPlot surface. In that case the origin (0, 0) is in the top left corner of the QCustomPlot viewport. If the type is ptPlotCoords, key and value mean a point in the plot coordinate system defined by the axes set by setAxes. By default those are the QCustomPlot's xAxis and yAxis. See the documentation of setType for other available coordinate types and their meaning.

If different types were configured for X and Y (setTypeX, setTypeY), key and value must also be provided in the different coordinate systems. Here, the X type refers to key, and the Y type refers to value.

See also
setPixelPosition

§ setCoords() [2/2]

void QCPItemPosition::setCoords ( const QPointF &  pos)

This is an overloaded function.

Sets the coordinates as a QPointF pos where pos.x has the meaning of key and pos.y the meaning of value of the setCoords(double key, double value) method.

§ setAxes()

void QCPItemPosition::setAxes ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)

When setType is ptPlotCoords, this function may be used to specify the axes the coordinates set with setCoords relate to. By default they are set to the initial xAxis and yAxis of the QCustomPlot.

§ setAxisRect()

void QCPItemPosition::setAxisRect ( QCPAxisRect *  axisRect)

When setType is ptAxisRectRatio, this function may be used to specify the axis rect the coordinates set with setCoords relate to. By default this is set to the main axis rect of the QCustomPlot.

§ setPixelPosition()

void QCPItemPosition::setPixelPosition ( const QPointF &  pixelPosition)

Sets the apparent pixel position. This works no matter what type (setType) this QCPItemPosition is or what parent-child situation it is in, as coordinates are transformed appropriately, to make the position finally appear at the specified pixel values.

Only if the type is ptAbsolute and no parent anchor is set, this function's effect is identical to that of setCoords.

See also
pixelPosition, setCoords

§ toQCPItemPosition()

virtual QCPItemPosition* QCPItemPosition::toQCPItemPosition ( )
inlineprotectedvirtual

Returns nullptr if this instance is merely a QCPItemAnchor, and a valid pointer of type QCPItemPosition* if it actually is a QCPItemPosition (which is a subclass of QCPItemAnchor).

This safe downcast functionality could also be achieved with a dynamic_cast. However, QCustomPlot avoids dynamic_cast to work with projects that don't have RTTI support enabled (e.g. -fno-rtti flag with gcc compiler).

Reimplemented from QCPItemAnchor.

The documentation for this class was generated from the following files:
  • src/item.h
  • src/item.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/RelationOverview.png0000644000175000017500000006051114030601040024650 0ustar rusconirusconi‰PNG  IHDR$°o¼QJgAMA† 1è–_LPLTEÿÿÿùùùõõõòòòîîîòôøOf«)}d \`*yWl¦æææêêê'z/†˜ÊØÞëáááÝÝÝÙÙÙÕÕÕÑÑÑÍÍÍÈÈÈÅÅÅÁÁÁ½½½¹¹¹¶¶¶±±±®®®˜¨Ue’ m3€?W¡5ˆªªª¦¨«Ob™ qª¸Ú¥¥¥&r’—¡¢¢¢™™™žžž999)))MMM ‚‚‚UUUrrr===ŠŠŠAAA&&&!!!iii666FFFIIIZZZuuunnn222aaaeee}}}QQQ’’’...^^^†††–––zzz’•ž lµÀÜWe i-E‘%m.@vÒÖಽÙmy“(q fŽ’ÄÈÒ*@‰j e%8s‰Š(vVk¤ôöú…—ÈÖÜ飭Zk˜3œ¡«Xi—4†©«®M`—L_•¨·Ø“˜£®ºÕTb‰*B"iÔØâ(?ˆ¦±ÌitŽ%kªµÑkvÊÎØ(?†gcÌÐÚ;c-]s¯5ƒRfž#l-?tÎÒÜ'oÂÆÐ'<ƒ%7qöøý]o p 6…->s†ˆ‹ÀÄÎhd…†ŠPh­Ÿ¤¯(|¡¦±_pŸ«­±@X£­¯³—œ¦ƒ…ˆÖÚå+# @ J/ V,|[p«•š¤ X0zWh•GZŽ kVd‹oz•‹[lšÈÌÖ-{<¯bKGDˆH pHYsHHFÉk>^$IDATxÚí½‰ë\zßGRôrß–œ±¹ óÆ…3ÅÌCŠ)^Q¤Q%‘”LÞyãyDZ=Ž×Œ—8v긎“Ɖ—ÖuÛÝĎ㺭»$]Ò}ï?Ösb!¸¥{~Ÿ«+RÀÀóÅÙŸ'‘`bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbŠOI¦•Šû1Ūd*u”fZª£Ãä#Ö·}ûw|ç;¦eúäßø73ÙtŠQò±êÛ¾ðÅïún\›H™:2ø4Íz”ñ(¨¼[KÅ •<âTöˆ’0'ÑQ%H’GrEù·¾ôé_*䲌’Ußóo›„lCÇ"üX¬AÇ2 ‚°‚´ X(AR‰¾÷Ó¿\Ê3J>R%¿üïÐBäh^:–Át¥MéXXD¬WXÈ‹Š ?óÒ4UýÒW„R.Šûv1Å¡ä;o»}^B–Kèภ+SëÓ±ya¡.‘æÖW?‘ùb†A· Ê#-:xê‹‘í̲"dËjTÁEÇ’úÔÒBc­¦ÅJ4´ UM½Ó*\.Íê[1kHjhÁ‘ÀwÄOÚlÐ(_Q„lÔçÖnplÝþÞ²è˜ÑaCR—ËyIÜÚ’ãÆ‚#ÁüŸ‚”<ÂmÔsÜüجËj£VùêfÇÒ‚d H–• Xõ:¤¦…,ƒ$fÁ ]K$ä&@³˜H´t@§æGé@#íl’ü½[Z¥¢‘WQ@R}% ÷ØCp·¡I4teÿߺ#$+;· ¸ ¼µIÚ&éS׆„þ'Î >ßEDÕ¹õJ!!!2§ü-Hó8Ö†F É ¬Þ­SOïvxŽ»%`)'”€êÖ2HhuëW·$Ér¥ŸÑ› $¥ŸÄò½BbŽ³7 ?âGMhrö8É”Œ“èp/µÄ8Õ„2¡C2ñ7Ü—ABîcÒp'<1H–é¹·aè܈ç{#‡Äq·ëYH/`H¦ø¯ú)ä‚|Þ¯c<®`® x$³.`I:‡YYÕ0Éë†$ÞB»Äݱ¢‡«l€.¿î‰ò¯’Ä(¼(#ñ)®s‚$Ä`K‚H]—‘ƒœ(ÿÚ!YgšßÁëp!ù8'ÊWã†$l‡è]íËòèôZ ùX'Ê¿zHß@ÓýuB²z¢üˆñ6 áÞ@£„A ñ:Äñ¥›Çìaa^“˜¾7:HÞT¨” Ù<¾QÀæ1{X˜×$¦ï¥¤£‡„;HvéÞ;$›Ç—²åÛJ%÷7è$ƒ½t^ÚNbMôíž%Oƒ¹ Ìß%ò¿w ƒdW%±R;vÙ9ríl¹<ûtW ?ß<-K9”¨ T¢÷0·ù›v01HJ‡mþa[`¯+¬oÆo™èÛÄ„dç§ÓßùŸ•$‡¥Ã6ÿ°­ °wiIbOôéã¶k'§,n“ÐYò¬MrX:lóÛº{d°³¿êì<쉾 Ãh9ÌrÊ’ ¯ÚdCÖ»uX:ló!ðeø§ÖÁ]É`í¿fžXZϲ'ú&îPÒÙÀÎ)K7,OÆI Q£¢8…=:Äaß!©¡ ¿Â\k:Xϱ¸íØA)óNw?Òà=j>·e ôL­‹´=}ðà*1Ñ«Îw¹[…`¯ pXhÕ™$bÝ`÷ã¼jS{µÍv".ò A´"]̸X(’'þv÷üjÑ*qo÷ãÄ)Üj)n#¶×ãAWwoÚº=‰T‰_y’êÉë®àFÕ0n–X‡à,ëâ¢$bwÚ¿Ó}ë _üéŸI9÷Õ¹§ÎÍ,¸ï¥çF:·Ð“ìÉuó~öç>ý…\87MTI\:Ÿ züo.m7K?Í›×÷æòïxî¸S쌔â|þ9ëÒëYW Ã:Ùc])¶ì$ؾëgÖyR,JÓô¤˜{Jes?)~þo†çtDßó øÎúÏÄÇÇü­tn¢'Óc­+Ó/~ú·Jád¨å’&ÎÙÀ´'¡Õ\« |UþçËE”{ª>JLê²N,åö1Ûq'ûIáD^]MG)ø9T€Î]‹Àlaßûé¿Ëå³aÍÑûò/Ñ*¤—¹Óð>ÜfÏß'[GáýI ÷m¼ÌºØR&zÜɈ/1Ÿë:,È»·¨àðÐœC;]hÙ¾’ïÈI9·Õ÷гOcžzžÏS|8FkÚßþD å¦a7´o@z/þ’b{š½—r[³,…Ú¤*•|¹¤Ûº=Ét'wEÓ{‚Y’˜rA-3°ìð=)¾úIxˆéY-j…µA|,ëºìöÞ¸wu‰ ᦥ&$ûÒÜ_·õÖòƒª1~7ô^þy4SyNjJ9—ÚÕºR”ÖÅIXOŠu.‚|°ÓÉa8½µï’Gé@HüÎ澕sHË! ç¦Í¹a`efñ (ÏÕdß%7€ºáTåóG[[Wô[Ç…o],“P±;ÊsìÝT)çÃyR¤Þ¹j[AýYYsõe_EÞgõ»y—Ú ’Ì.,¸k»au$‡`p Ä÷{Þ“Â ÉŽµ­}@yQ¾$G»@®u±Cû“â]xa$þ~¹mj[C’_I¢¨ïn‰mœ C2‚%ÖMÌL¤Z ’CyŽ…ÉÚµ­òZµ-ÅguDs‹Ïm›ü4@§ºªêÛ=6üÅðØŽnÜtW‘Æ€O]¬S”/$O *bëZØ ý&§ƒ^ðí@_ÓÃSGøz/Š#²ëIeh8PóÐ…c݉ašwm2$ù0!ñ>)`¿x@€È™×]k5•ivØMk[¡Câºý¦* ùü)œŠüÅ p:(–nßc`àðÜpå"HÁõ]ÔŠtmH’ÕužRK é7qðœÉœ¢ž»kænùâ à+Š ÂîñÜp»bpm\EOŒŠt•FwæÔ<ªŽuÝži]·çµî@ q$Ä£!äÅu±H=ªVâ` H€Þ¥÷~ìœX€â‡D‹’tz¾¶Õñ&Åân*Ó>GNEíêË Y\Ûª†IÊÉ*äò5”¯AÝ|Fu/‹Å †äÕ»¡qoz⸖úúPïøÁÂ#‰fq+Šcü¸¿¬Ôȵö³D_Œ¦}c¢Œà àùÁóšëZ(—ÉTQ¦ UÓ?º—ù¼€!!aû—Ø V©4Á=)ôëÈ×”I„ ýÏ°AÇ-ë½çJ¥ ã¤2jb‹Æ¦yOt§²ýª |¼GM3®´6[:Hæj[Ø£„è×zj} I©¤tu$KÚí’pÏz©„N„Ç.wÚä¸[è«årã\UÎ_G÷õQ_NØ;ô‡J­ß¬@[4­ö Ó<ùz€/q÷xZ;FªŠŸÎµ.Ò4ø0FÖ¨­Ç Ij$ÍsìWçMêZ´¶…!)I`CBžVMÇå}]jã:«$Š@ y,T*ƒ{«ºEüŒ”$~*<ï’œ¤aHª¨XBõ$¸$á $¤Æü(kí¾Øƺ£r¯OjÍ6†ÄèÖ¶B…Ä[ß[¬BMMFÊt´X<Æu-ý=W…ÇIØv8¯à§T÷™ç¯‘h?¦@l÷Ì’°û\‘ð ’¤^C–Û]ü˜ªöYUAGoIlT7¯g‰ÄŽà[ÜnÇ¥³ˆý®|]÷w‚x»¢|»g>D»Ï¢(“]Ûn··»Ø7ª ÉÄ<üŸ]ÛÜnÇ¥ÉH»½M*\S8THŠÝJCÔµlH\% ºñÃoã;ô` c:Õ3HÌ’&V­û­nuõ .÷É‘»}e IW[€· Á2F6$ÄÇ4' Wú×ô$I#ÀvO‚k[ABì…6ùÚÈgBòÑ øTêŸs/¸á¦ø6ÜèpÏóÆ Ï7ºØz­K× F&$ÆiEº@øCY¶BÄ)Ý®ªÞ`PNõ¹úîH غ#ƒ £zBô’J€)î_tl] •J/Ø Ž3^8QMƒx˜šW×8Å DmÃívè`ÓZbþOQ¦=yG=Á¶©O ]ëšeö@ØnûÔµLHˆGM9WuK~"ß>PKžU"ád¨ŸQHЭ¢¼ß$ó}[÷*†—$œU’ÐÇ É­NDUWR+æÝ!v˵­°!qÝüÀÎÑKLHŽ{ô´©E=î·¦¸ç±ý[Sžo^aûõÆD/"n¯SÁ¸"Ý·±'yFUÍÓœ«j£mþønÀbH–ÉäÑCLÿ8ëÑKjÆûêžqe¼øÜ#Íö¤€«s\ó[§7Æ<àA6!‘(Þ÷©m¸ÝNÊ8©×Çq‰¢èݧºzo¨Ý&i¼÷I»¦nëW»Ý,I€¸–Ù·Vç… É)ç˜I‰ô]–$¦ŸQHHF扒ùÚ–Yq<”H›Ä„ÖhåUµRÇ–ßéÍJMÌv;÷mE IcPÑÍ|þLŸpÊÉe¡9$7`Œ›#¥Ò£Îð^¾‚*g¼¯à ?cž×ï°ýð(.áYÔê¤k] <¾-YÖÛcõ¶ßRÐn_áŸë i4µÙÌdÎõNQçšCrEG¤9R¸0 ¸­\#­dÜ W_ÕÇáZa¹ b Äë eÜ tDqpe–r'£[ítÑCÒ"—ù ûÇ6y††jÀÃôZ¤Ý®·'õ»æ‡Ã€d~”·I …s\él^A‚®UAż×ïš‚S’¨bejCb¶I$rPIâ¿E‘A2ëÍžÐÞ­§R©7•íÝ*» ¡ÜËuý¥‚Û$ÔÛÁ"HªQBÂá2£Q$MB\ýèJ¨“`œY‰ð‚@“z?è-Ü&7Û…k\µ¹×oÄ'7|I›×\(2~âk2âr…qŒkýüÓÚRˆ5òØ8j˜‡*¹¤Æ™9X€„k­¥ÒÔÁm\ƒ†/í þÊKý…'¾1$Ø :f)7©Œñc¶9ÆÏ!bù¯zŽ·Ö‡*MÿuKÚí(:?’dÒ»õ­Yï–¸GÒ+¤ëøü»¤MÒÉC¬cHžH0œ´$Þ6Éþ!!ã$ðBÎÂ'±!!n𧗒!HI¾ÄÛœø!Ñ"†Ä¾ýË}Ï\ ¶®}¼p:Fa=ë6œØdÝ!Ab^âQ®qx?Íà˜@r d˜ˆônÉ"yˆá¿âÇ0éÝ’.ð;ýŤêéÝŠ|;÷«'7÷VŽ$†‰ï)ÕAÅ=Ï Z I&3&C%ñLì«$þ‹0¸\ý;ë†ô‹’€y[5ÐVMn¬¢Ñª‘ÄÈ!ÙÿüÁ„?±o ëâ…dÁEÀ­ìUAEµžcûdõäF\®œÜXÝ ${\ÍS­Ö7…d¯Ö0$«/ÀYXOŠP!IB²õR’€&Iˆ¤ÓëO ¯Ò¿.$dÝáA²ïçXøÌLXKI"ƒ$ÆJÿÄ·Ö(vHåI%$›.%Y5¹1tHb_ͳ’C±î ‰÷9=$«—’ˆÁIPm+zHöºšßúFÄa]¬Ä“"HÖ®mm°ºšüµ° åüw`I€¨B‘Tëõê´É^­SVZw`ìûIñµ0!ùì—=¸îçì4–…IY§¶õï}=$H%^]”G>”X¯v:óñ_B³Nú0®÷Vîôƒò3.$H>ÿR‡ ¡¶µh¸½^ý;?RH¡ÜHÍ{Ã#ú…… 7tî0“—ï0ÏEõÈÝ»XëLFó‘Ä’™]¬óš·³u2—‹%8v§£ÃxŽQ§ éI‘üÕÏþîßsÝR_»ÝWe¤ö7–þõß8lï¿ÿ÷¿ù#áDL¦ »ç6˜´w>¤3ª©¢?<`8Ö… ˺x"8þêg?úkñ?Çêÿ;]8Í[ûý76‹k›mþ›?ñ#µÂœ¦2%Q©×¦£];íM4ÖUi>Ðl*S”êŽÖí.j]9OXùdú·6u§ý;Átº°ÂœÒ[+WkµéÚ‚õ7%ªÕªj8³ñ-È•Iq®› vÚ›HUe±\˜{T‡bÝîZ`Ýž”ÊbwÒ6q§Ý=l‘Ó…0;‘<ÊùŠì+º– Öß”H‘%!¤Ô ÉT:Wä\%ò6‚Ýv'âËÅ|v>ù¶®°«u!ˆ/—‚¬‹D°;Áª?mèaAÂNbêrZù"çΧ´B°þ¦Dår)´|*˜’lÎ]¿ÝB°ÓÞTù\`*)z<³£u!hu‘h’uÜ ,ÏŸ¶÷°@¯ Ïéfž—ñ¤aZ.X{K"ÜtËdÃË(ãË%µ…`ç„|éô¢Lc»[†B̃¶Jó¬áN0ïC°äÝ6 ×éèim–3bλcZVØ=³kt)ªCQ˜sp ðþ P'‘›ÍbŠ¸j %ú!Y©ÙŸT9T?ºDÐ.XÞr pq ¨e9d•ùò  —¡/ÓÎNzØ!¦ †ÝÁÌ=‚nî”üè‰jeóÝ^¢{–H< Ì›bæØùDoáOôÄ•Q)ôöîùSò£[WìæoƒçKúòÜÙé Ü¢W~ ¯Üü½ ‰4ý1ßæP¢‚R‰Þƒù!—HdONú‰Dó$”D‚Cs»A¢&*¢/];½[Á)„wHXù§7pö*p~j4îæà!²³]ŸäI¤¶|ÂŒ15·{$é„Ík§W{‹ àU__5´àHö XpðW{b’ËËÑM!YÀ¿Gú¸í|èþ¤~Ž $î,nqI"zö‰ýœ·±æà 9n,8Ìÿi×ïú˜åöò»t¥I^FËùÐýÉBø“+C=Òús»ëǺ‘ý=àùÙ&qíû-ÚÖ€h!ñt’$$üÔ©ùQºÐH;›$´3øÜHtu¼8E¹Yh“çÝ#úr¶S4æ¿i¹¼ü–"¯ïPÒùÐó ¢\×øíÝÜ'æ½¹rߣ´yœöw‹R—ÎçœÌt!ÛÁq>—_Î>µ>:ê>ÏU ûFx;Ip‘zæG—vÿ‡µ‰ÝsR‚”»ãeyω§»eowàíêä9¤ÁBdžThÌ;5`挮¿;~9ûÔúˆ"ZH¼$ t-Ø!\0kÈÙÄî¹in×s Ù]yćt¤¸!AšùËçd3r¦ÿÌœÏñËÙ§öGäÑ·I\Ý'µ& [ë#§ÿÃÓ Ò¼Ù®ç„A²³NB;ÔäTÒ³_¾G­ãŒ®¿»üÒõ©ÇÛ¢;' Ö­õ53ÈíMÌN:â»MÏ ƒäð_Ib}»YݲœÑÛa:óKçSÓň·í»“¤¯ÙÆÜ“ºÞ½³‰Õ ÒÒ›÷œäíïJDzü kŸÒð‡[ìIg¸±Ú˜w2Ó…,gt‘àòKקô¿ËAämë?»“äD7?JwgýîNÆqbóž“a#Oß~0bZmñfX•…`_!Ýñ:GÛƒR÷®æŒºíŒ.\~éú”þ—îEÝ»µ¹P}å&óvf^ 6á,nóßš`ƒ¿Ã2º™[¤ÎóqŸS$äÐ`'~`Ðö·m¯XËÀ3”`YY²«ì?»ŽåH„^oÑB͸Ïs7½bH¬Ä‚ý¸M{ÍZ6@ž¡„YeÄü“=Xå*Iìc¹4BàCÜç¹›^ $A¢åŒâ6ãµkÑw(aÖMdþɬòU·rÞ9xÌçJ¼n½fH.È Ðã¶âUkÙoˆËp0ÿdV¹ ±åM+LZÓ{’ëëWtº­Ú}?¿ ¥È ÆmÅ«Ö²ïP‚‹†[×`•»ºåŒ‹ÍtN!Ù_³Ýõõ¤ÓmSï~ƒ$.ñ `ƒ$»hÙo(Áp°þdOóuA2›VìRž&óÞãù¾Üf÷5þü:Ä4v?ÊǬeÞ¡{ÀÁú“=Í×]ÀØ“‡Ý"9ïWwð‡!»cÎêw£U?ל_»;.hNú®™ùv7ÿ˜˜û+V“>ܘWµ½µíŽ9W¿›{ÎïìÏAsÒË»“?Z:(HHtÔ&j 6Úœ*ü$LK¤Ãã~¾Èî˜sõ»yæüZš“.í~3¿õíßñ‡‰ý7Þã·ÿ£ßÙg,«7 ÝB"½@f?q•f“~7Ï YX1'=`÷١㾶¾õ…/þôw§¬˜af\¶l6ëÄ4·Bš»£™Û‰12cØQBHæVÞéçÿæ§ÿ(—=bó½Ö.Úw‹Ð—7vÏw”Zã©fw̹úÝܸæŽÎIÚÝÖÁ@ò=¿¤ˆ8xddX*%\™eÄàm6Üé$<%~ñÓß-dâ‰ÓþÚ”ä E§VÉdWþvÇœ«ßÍ ‰ýçEsÒƒv·u0|ù—0$3>Ü„øòç R%;U ,H·ò¥¯ÅPã¿u%ëZ!m–îÎsÝ}‚sòçÀò¥÷ñ§ÁZœ/NÑFõ5bÛs®~77$öŸÍIÚÝÖ¡@’|GËu|õ/°‘äò“'yÚÓ>¨ P,½ìA©bò¤‰1/1ä#ù ¾ú‰^¶‹·,QMÚ‘³ÙìÚt”J%/Aâ„U‰}GêX 3ªüÆ:HR|FðÈ]À8—ÃC¹Þ§ãå†N €½Üw]¸æeyŽ3{Ò»ºS†µ×¥iÎ~ròÊ$0;Þâ‚#(7œ/óU}b~’D×ÿHò™¸ï…ļÍ+|Λ¹\óʼ $»‚H ¡óâ¹ò3‚¾T.Ã3À)þ¹À—½ÿüÜ'õ«cýV’\Ž>Ë ïŒÞ«jµ ЯiÙÃβ-Ä”=ê5)91[í®îO1ˆ€XU«‚Ë÷c «b¦«tÚç)$/FÜwƒ$Âxg$¤à;¡¢\©3HÌ’¤T¢%É¥1Uš= I[9‡¶zŽ+Z2ŒF `HŒŽÖÐ%©¡?ÕÚ£UïêªÚÕ[-½‡!1ZfrÔw£ªX`¬’É\+Ô<Õk%ëÖ&u9¬œ‰›) p–ÍØã$ÍÅ÷#mC|/ŠËAÉ‚„´Ij$øâ£1ÇiC¢òÐ ñÄEýC2ªT4Ü\G·ô²ÃXQê ª¤4¹C’Ú ’ k”«œ›½LaH¼ñ+óTsó½ñ¡ä©žLC˾»¡pííw’æB9’$§‚§$¡÷†ÄíÁ,J4#œh\‰â•!!—Cš ¹ê¨«j 0$Õ$uÉå;¸•lºã$KòT$!æ©ž„—Ç}CI¦¿íq’æB96IÎß&qC‚¦æ-p ©™ç1%H’«$± ™•$ƒdµx26Q«ä“.H2»@²  Y’ª ‰$duåÞ&i.—É.¸ ˜ÐÞ-ÞêÝšA‚kZܱÑZÍ2ï@rß$W¿y?ƒ¤¡·h›Ä‚¤g·IÌ Î Y.ÕÃÓøI2ò&ÉáCr{0KûH2¸ øHnÅ#'ñ@rL{·ŽñßOÝ GrñÐ µpï@Rï[½[$_c,ÐQ®ÄKZǤdÊC’ß’lØn’i’ìi’ær%ÓŸýàѬ¯qpéê‡÷´ }CSÎÕ÷<Ÿæ[‚î ^ÿþ¯³†»Wé|Iµig\S+åâ” 2’)$yÜ„m—ðyÂý4¯’'ìMAƒ¹v{$è½(ŽhÅ¥RkÕ¶ÐÃA@’8;”¥}É£Ï?'˜O, ä¹Ù(þ!Üõ Qç!©Wÿñï4ÖL”Îs‚\vFu G!c^‘<©kÉG´á~䌒ô›jeðœËÂP¾hæo…Ò Në´Û+ ˆ´’Ü£FwHªP›1+$E\-‰ûF™JýþgŸÿ²gNc$\$žùZ ±9Á×û‡þà›?Y#}%1$Ù'*ÕÑdTWD®à+Sq›¤J‡—S“”I á{RG¹:ÔÍêV÷’ òº—ôîÜ‘Š{‹“¡ÌqÄ×›¤ßž¯á:±PFª÷žÍÛdœTjmFGª‘„½÷ï<+ÊWŠ–:‚¡p¦É.h!Ys¢~„ØÒ%{”ÊþÇÿä76^òî››ïò›ø“ÓêÇ9-%™-”+JÃQÅp,pºìdjE˜ó@Ò<Á¯"äÚ÷V“D_Û}ü‹BÒ8—¥+dŽb§*º×ä®ÁŸ’;]†ü ÓLH SGÏ£jÏ. [»‚fç”)zîÔz†úƒÛú n>^ ´èJ’÷uš›/ì‹æþ¥s\E­OGiÜÙl{ªi­*ó…©I’ÌËøâŽ:Óª,”V8›8KWB!±›$ `HTÈ¡© ¯ê eàêp\ï„{Ô¹^—õ2ðÝg ÉUSºÏ¢(Ó&ɘ´Û{]\äk #YžÂXÒîâr¿ê9ÒTµ…!é5¢‚dã›Mí¯ Ù•s–·S*›çDÙ=†´†F“úf;©ŠÄ3ÃTùT¦ÈKjmÜ©iŽÜz#ÖÎuñBRÀÕ­#œ É¢5á:eDn> \’œöÊ莃)†d ¼þ€!é6Á8Å dÖŠq»ÝØ©Û•å]–OuÅú“ÚíâªñP×4ã$"H’u­˜¶—÷¹GKs¹ÜüÜ͹Î;ßÚ%ï¶$k£j.‰%1%¥2ïš$ºZÒdRÛd{*A(s…·ÍHŠöäÖÆãš&ñ¥­+–6$Ô–ËÐKLHŽ{Ô…Ž{Ô‡ôç©X:pœª_ö¤n›‡:¾¡èZ`$Š÷mÓp»T³ñ88—åFÿô¨›-ÈÁþ¯ÛÖ4xr Q¥ËûæV¿Î:·óîI›‹{U ÍþÖ°<’#ò°d*ɹf–®!ÜÄì”6Úƒ(ŸÏDTÆ­£Ü¬'—–[Áᙻ傤ÑÕf3—;Ó;%yx\héÅlžRG‚;¾z ÷Ø•tháVICž6P‡óʸï1$Q\ÏÚízo¤|èw$ô(ËÆ5ùQôöX{ßl©èCb\aHn#‚¤–s-ïóMýw:/ Ÿ‡£27Ü£ªÕ)¹ü‘ø˜oñÂJeȨ—h¿®¹WúíÅ ÃvOn1³ÓÙ:µœ¥/=”Ú \å*œãŠU·R€:…Ĭ$•N cýûS»‰ÿ#O›5ž¿Ð_@Ãm³I2ÀíöIe<Àu³kI‚‘,C‡ü(ò§+U…1†Z¸M´8tHÈÜæ”kå:«_ý“Ðæ& øÁtärtݧÅÐ(Óqáhbo¼ ¥óNOn9¬®:wk¤pG^H°3õLÜr b z-h¼}§ÙáCâ É9µ,ç„æâ'ø"‹ø«WÞÅáÔú‰V)Ÿ”Ò¥íL(Xï†øþ^œ>(æ»üÓÍÍÓAŒ“†¯$æ°{r Ù¯X½4Syâö¦\®ƒ «f7ʃnø³Ã…„NÛ ¢°ùÜyÑ°õ¤&Æ Cμ—v Ça"ñRIf:滋rêh܉ÛÄpµQOîvÂM~QµænUó>HVO€Q vcظÊÇ H|Œ,€D †Ä2ÛÓúŸðOŒ&ëÚ ‰ͳùè%nÃQŠÂQw¦ZTpy¹>îÔT±DçnJ¶;ż*‘L$Š’µçvø*ëÍ¢ë_’TgZHLRR§b¾&ŧ›G+ˆeéýÍp8ŒÛÆÏôäšÃ¤'7¢kž.”%mŠ¬XÏ>:wKLRwJ§×ŸÌí‰$þx/ëO”’2Áa’HdT³Á:¤ÿ Véñ §éaÜ6n'³'·¶SOîJ‘9µÎ¨*óEw»FÅ%4õG$ñ¬J¬î’å“çk[0Íï€ÏòC„¢1qÞ‰V!iCò"&sOømÜLö„õQm÷žÜeJfJ‚RëŠPšÿ–4)¡©LHb_• $³Éÿ>%sòNü)UaíÚÖ‰aZb($T^H¤ÇÓ +`¾ðxú  ã6o=™=¹ö„õ('•eqã: Êâ¾Á=wk${]•ˆ!©‡ ‰uVtò#Ÿ?…S‘¿YÿÜ ”Nk׶ȴbz·ç‹ív¨¼>EÛ“ëÑQ¾\¡ ©\Xák®¹[£œ’%R–‡Ô$©ãHx f´P>—«¡| ê&õdÖJ½{z*$#§þTV@àù«drÿH¬“`n•òÙ{Y6ž @wŠb\«t¦ÿƒ$$Ñ ëfOîâ ëá)S’êq7<6­À¥å(½ºI²ºÝ¾ãPb½ÚéÔB )4ƒ¤y‚O¨ùö³uBúû¢Òî—ô;z.sE>G<:ð|U?7¬Ñ'nÔ<ÇŽ¤7ZštiÈÝ&.»}Òn']‘"‚ä{~†ù?ò¤Á›b°fYàò_üôwóѬ‰ñ+?®IÅgðHânû'p!X‘}5¡ýK–„ðR/Ì !“ÿÍ|þLïpÊÉe¡9¤N5R§‚ ¡~ ÏØ¡tx½W“žúã º ë_”ñ=4dkgÐQŒ+Uowªwͧˆ!±“øx’Äø'ú;“4çóø®ó‹šUß/ýT¹°èËùQ¼dF»ž$¦$_ä\‘áãQ¹´FŸu5ƒ„Nþ/b¿¢“ÿ¥Ô¨o™õ&î×µ.õüíí&v«)J!ᦧح®ðg÷ú© CúÜnRÍ™þ³–T4$ß™ÙùHæž r4…O.7KáC³ø¸ ™ÑA61ÆÞ¦¡DƒÔìÔ›¦ä«ŸÈü" ÅÍÈÎI‚®„˺–ìÅ£\.bÉ?ƒ$G&ÿ¯n¯è£Å“w‹ 2:¥)|F™ÌÊÕ~>ù¼ÜЭ©qüË"$AJMè0IdKI¢‡Ä,IH Å©n‘°!±úʀπÄÐZ’Ð3µRQqsýÎtêjªF³ø3€½¤^(jQ}=1H‚ä†$Š¥$ÕÈ!qÚ$×ù@HPÍš/0‰]’à3BpI²?H$kñ—µÌ%Í ‰Ñ†ÃÓHB­mE ‰;…O¹ÞÏÜŒñ˜)|83Ï•»M2ø ÚÜúÚ$ä öI-·û1v+I‚´>$¾Áé j[õH!ÉÚ)|rtœÄÉ1@ÉLáscC"Ì ÁÆ«¤wK•¤+¼Å …ä@õfñ¡ì#‰û)W—C°áð”åmH"“bBRëD‰“ħy¹²¾¸v£*¶$>n+ˆË!ØpxJ) Y½»(LJiË0)ž&I˜Sû%ÓN•¤ðY|eº , ¿ñÇÑçqw;h\A\Á†ÃS*7R ^HVÖ¶ˆ“­x «NœÚx2®Gw+yäJâ³a£jÓ$>?üÍ?¡‹A÷I\A\Á†ÃS2]Œx@§3žj¸ªúœŽTæŸÿúŸnž‘g ý‹?ü³Q].G¼®Ã׳K—C°áð”<¢Qb6Ì„³™jZ$±€“é|Y®ÖFãè5šÖÉžhçn¹4® .‡`Êd©(vlÈ(¤™¡ Â‡$•%ë÷´zôªª²X k Ï"¹4® .‡`ÊfÂáݎ–ÈG”'y”)pØt)jU*B¹˜KG< øÆ(Á†CÉ„“/8Ë.ÂV±˜(Ó¦$›ËGf¸û ùl:êUî‡à ‡`ÃA*™L9©·CÉY oÚˆÈDÒøD¿Äýôl8T%7Ê¿»iîÝHÁZî9‡Í¯èžb-²m«#moÃÛÉsÄ´mèh«XG âýѺ[Û@Œˆ,9ÓÔ·¾ðÅïúîdj>Ò‘7Ô‘7ÖQÁ¬Âû30Ü‘ÙañçsñŽþè?#‘–|øLð„ u‡ ¶Âg†“ïØ2ä?ÿ/öt‰éÕËtät4[ØæuÍâÜ Î—òIO¼#Eþ _¼£ÿò’> æMðà`„Ï ^XeÇõéï沌¦õD9Žææ͸ñp=¸#å þ‚ÃåÓžDCâ¹à³` >J‹‹Ž¹òkÎÅ4"î‹Ïô:d:ò»gpÔèùX¸Ae‡»àðÇŠÖ4õ«ŸHî ^\€¤@pÛÀÍá!Tï|1Éf†ü×^#˜˜Ë t”ˆ¶º!Ô=EðUiüOí€xG¥Y¼#+Y`dMB(#¾°îA¥‡âšªzŒ`bZ¢$4Vžk1XÞ šgÅIöMP&+¬Ë"†d~†²o–µFW[kÞÕ'Þ‘ŸÒ€&z@ö_ kžoÚÕ¿ @Ó°QOez#J½³ÆfG4hÞx¶¬xê¨X3݆ÄòÏ!iBÁ I6wÒ¼ ~H*ý²²lDä‹ ˜Þˆf¸‚æ9*HÐ< ÎŒ™gDÔŠŠFL¡m²¬vž³Ê7_0H˜Ö– Öà2pºÔ’a¼å-æ 'xµúµÅ¸j[HÃ_¯¡BUgÐ’D€z Dþ ‰"êÐø–'ò¸/VhI‚hG[­Ù–å†þTk[Ñ’$L;(åÄ•Ìd44/0°äN¸³^%á%ç ™k’G P¶ !mŽÇ ®l y¾yyÙ3ƒÀ^Žˆ´XëŽ6IáÒ ÝR+$L»*eÆ•Ì.ív ™Ÿø» ¶äüx» ’oüžw01³$BÑU’P'\ùÚàùS Éí×II"MhbL*\ãÓü¸Í`0­­Ô_ Œ+¹º$Ù’* /ùõ?›ªîi)Á˜m’A¡Ø¼2-óû5‚:OºÙ($Ø‚S Õ­J4 ML+pI¢PHT ÓNJfÿÚ¯üØ–‹g·ÒÿÄ3&±–½Ì$vàA|€V¡8qÚŸArÙ'œö//H›ä‰@2x’OÉP átp,ÝëÔÛi“´¦¤MrË aÚMf\É鸳7G5ïTùÔQ$Òiõ@Š²kœÄ„]H.>´{·®É€ŠÉ ’dÒÑv"ËjàÞJNÁ aÚE©L‘—µzmªªîõN !Á\.˜¸µÉ4ùà& ƒ„i}%0%¢³0)rɒȹVÎ.ƒ¤êšsRÄÍæ¤0H˜6¦$_tV‹G.®TpÇ`pA²·iò ¦ •$ ç™wF,ü=O4Ÿå¬ž&/lû‘/,ÜÆì¼r—æc0½Cum‹AÂôŠD 1Ç÷Ù$!ù‰$L¯DÉÏ~p1$Q5Iê$?1ƒ„é•(ùùçÁ—ÏÛaå.äÌA0½%ÿ%™<¶×•»4?ñŸMUž…bzJýÖ®5yì_ý·«¶øïþû &j‘ç'fb GÉT¦$ªµÑª)_ ®ÚäÝm0LK,b6Óë™bYQWLõÑíêYa]ÔYY…‹:?1SH"ù”9AZ:ß«fµuæ…õuuÝ d—g Ók¦$W(-›îUGma­yaÂ`°Õ2&¦W2u´tòXŽ×ÆéÝõæe²G,i"ÓkÒÒÉcwp±þÌ°:ßbÓ«Ö5šn²yÝÄm1Ó^•ê"~³=t·ÑLL{Tf0ÈlºO:q›ÍÄ´7qzo‹nÚ[¤Äm8ÓžTGç[í÷‚¸¸MgbÚ‹nánË=ÏÑÆ•4&¦W¨TÛz߆‘ŽÛ|&¦¨µy·–GÍ&›sÂôƵM·–[)£÷)01EªíºµÜÊèÇqŸS„ªÃÙÎÇàÐ0îÓ`bŠL·pÂQ´æQ îóebÚT'hÊqjk½3H˜^™R]$†t¨(ëlÆ az]Ê Œð/`¡w8A k‰„Üh1[: Só£t ‘v6I#h[ölÎÄ´íÞ­åÑ*®ÞšbæXO$P+›ïöðû‹´Ð3?º4xÞ¸t6¹2*…~Ãü,`s&¦èF·–GÏk”K¤¸ÉZu®ÂÞ-Ø!5‘г ™:É!gWßæLL‘+œn-ú«‡ÞÁú¯f”¥øwì5)€«Zip61³ššŸlÎÄ´a6=@XÝZn¥+«B6è¦,˜ÞZ†ÎJ{WŸBÀæLL›C¾½– Än-·2Æý:gEŒ½KWšøw_=²½þž´IîM® õHë[»ÍoÎÄ´%$ë Ôn-·8tµÆYY¬èÿ~@ ·ÌÒ]€nÚÙ$IRýZø6gbZÖY ÇïÏu\Oæ„Yi'ÿα³™~æêEu)än-·Äu‡Þ™˜v×’ÎRèæNÉî†Äyiw¥z{Q…Þ­å–ÆV½3íMK:K¡HÓŸ`HpX5Àþ^TªºµÜê€÷¥cúX´¬³Ôù ‚ÄéJu÷¢ÚŠ¢[Ë£‹Hú˜˜æµ¤³Ô I—‹K’9w¨[Ë£“HcC\6‰&[¿ÂD´¤³Ô‰~œ¡ŸZpÐßžØm§•*²n-î¾dq_,ÿØ·aʉùèÏ‚é𵤳Ô‰¦:1!¹r÷n¥çzQ‰"ìÖò¨7Øàk6ƒäŠv^´¯÷qLoV‹ý-Òn-·RM³øRC©¾ú‰*³,‹)ÓL¦3ÚOj§&ãTñÝõ{û=ßúð• .§Ó4í]Uâ2›¹] Ûe#¿iÞˆÇ<#A-€DõZJô®.—s ¦™($ó­uZ!shOËíwïjJ9w´‘]©wVA2߇_¿ Ô6—ækX.B4­únª yVßbš‰>±!YPC"Cb?›7v»äÑ;«8ß™ëhó–$« ‘!Ñ\ŒªbAÂ4~b§ÒWôÕù}x[#â¼û$Ú»‘&lævÉôzø „¤²$UI¥¸aŠé-Ë IPAɆµ­ýAاXÛZ IAÂäRêÓn_XÛ*mYÛ ’à&ɵ­•M “O&$Áµ­è…8!yqÅqdã`D\!§¶óµ-_“$H± Ä6òâ¤P ÆÔJ%X0í\T€§I aòɉÿaÝ—Ê´J¥ÜH£>†¤\Öº:öÀ;„îÄõ›$a@2†Gþ:ù<¶Š¯õ1$Å¢ÜÐ)$+›$@Re0ù…!I§ƒk[Ís\9k–JÍsÓ1$¼Øû÷Ï}Q4nÄʃA<ðœ-®mU·ƒÄÓ$i^aÛΛù|óÊ´CR¬€ Éx€ËUçE¨WzmI€@Rè`H$‰¤\ÑoeùÛ{ŒÍl4k*]ÚÈ aZ¨% *†¤ŽJ%TŸABK ¦SÅ[$I¨E µÓ\\ÛÚ’Ym ©Ø4åóH›Aâ*IÐ…(·ûåö3Ï?|ØNõ† ZX% †Ä˜h ]–áZ›4åY Ú¬$aZ!’¹¦1”1$ûAÛ7“²¼¶Uÿþ¯o ±+’%qRBi’kÙw&·RŸîdAðNµ­üS•ß4Z ±+Ž&Iý<ÒX´&—’¿úÙ¯üZÖ”nymk.lc$–ïa·û¡?øæOnwë÷?ûüײÛ7Iµ‡4¸·`n’HtÍ—½¾äPtaRî³7ÏÚ1Ì͇Ên±˜^½fÏÒ›B²`ÞÔ[ëÞÎŽö&¢½“´¾Ñ—ŠRˆF ÃÎÏ9gm¿µ/†ùo¤Û;\,¦W¯Ù“ï.]iâß}õȾï÷¤š}ïlre¨GZŸ~DŸ¤úf_r0:£ÉKý8ã>kû­}1¬’Á0Z»\,¦×.û¦Þ’ Œø÷Ýr‰4®UuÓÎ&Ék¼ÍýˆVY7û’ƒ~oú¯¦:qÎÚ~k_ ’;”Üåb1}œ¢U–ôÚ›$‰>6~´Áö'Ïq[Ìôu p¿þÖÉh“ªb"‘G|Ü3½Fá*Ëžs`$tn`<œÄm/ÓÁjé´¦~sƒéXàú?&{=B~ÃÉ^qß ¦CT2•:J/Qëý²OÓG©”˳öÉ*{=Ê߯½©y6ätâ¾#L‡¥o}ûw|çÖ«À±>ù©ßÍeÒΑ¨!ÙØÞÿuÃÓùë™,› ÏäÖ·¾ðÅŸþóÁle¶B’x"‘¸cxBôHÒÏþܧÿ[)ï¬6´ ‰jz iï¬$ÉÎRWçf¡Tœ *s¡\ATD10dØÏÿïŸþB.Í(arô=¿L¥íœ„N4!·‹YîåØ8 C÷‹Ÿþ¼³ÊÕ‚$ªéÄ^ŠHÖÇGÞ²®TòÅ«[†ËKQ¿÷Ó¿UʳàLŽ¾üK©” ÷ƒØ[€ðŽsYÝY̪/}EŠv˜ ’¨¦~ù—È"E"6 ¾0\Náa•¼¯ô˜ßR_ð­/}¥Â±•íL3%ß™ cg¥ˆƒ7ˆ·±w=’2ÍÔY,·L9:©Ãè¸C ºJDZ޴Jɪ¡x! {z j‹bòA„¼¸6³‹RÛ¹eq½=q&Á—Œ«.sÆÏczÃJ¾Ãµ­ìË0¶s>cHJ%¥«—ËP.k ݉<ɸ6s+/$aOL¨=ŒáAx„N±ˆmk}š§Zµl†DZ ÍAÂo‰•é +õŽ<˜›WØáΛù|óʬ´`H8 ðÓ»™‚0à§s­RcýV–µ>À3v-­ Ðœjï:$Ào$aOœ‡¤yŽk[çÍB¡ynÖµH2w™ÚN žôA”©Å˜‚¦&Ip‰Ïä½¢Øg2 k”0Y"iÓY¤`‡SQ>´$øiL!QII‚­ÝÇ\²Èr×èttìZÏú‡ñ !™ª^H¢³×Õ$¡µ-¤bH4T( ê ËvÉ¥1Öš=A죑AÒ¸ë“Z³-É`´ª ]Áååd¢û!±(ÙLŽLH €Ý­ù„÷:q= ©ÍcH@S”:v-³gjÿ¸ÚífI‚!Aš‰Õ·eBbZ(ˆ ‹…œ= YÁ@]UÉ™ì–Ö‘é-ËÌJݼÊ9m’"…Är4ìf#PtU—ê.HpIBŸ¿è‰:Ö>!ñwn™m’n“\™cˆ^HÐÈl·ÏJ’ŽÙn·!±K’ÝÒ:2½e™Œà‘„Ö¬wˆ¤L ág eÜvŸA¢ôŒÎÄ m’»ÚÅ VH:ð(`Û Ò»5íû!¹4Z•§8k“\êOÊíÀÄn“0H˜É„$óˆȘœ=Öà‚DxA þüÒ„D&Tû]ìZÕ{¼ýU¬äˆí¤–hÛnCBÄ Çø¯§¢¨`‹¤wë’ŒÉ3Hªv?“Ö‘AÂä‘ ö¶ÁeÞžÔèšôäLçð’¨êš¥y‹W’àÁe`jGfÇ[äJ”ƒó:2H˜¼r ©‚â‚Äåf3HÚ–Þ¶Ó ~mßø¦5pË{%$íiGoŽ·‡E›é-ËÉJíd¤žŸú;?'å Y³ ’ïÿ?磳÷¯@271> ‘ö%@_­,J£í†äÿú&Ë&ÊäRòó_qCbvûk[Ëç¤T«ßø½qÝ7-%*¥>ÿ<‰«ž¸0‘öÂI)þ,ÚçjlÄÉQò_~öwiVê¼—Ÿ¹3<;µy—oýßðÍ?™j•b6E)¡D6;0ù«Ÿýè¯Ùs€½“ä óK¬ÊKH|IÜç²hÿƒ¿ÿÍÿ‡¥Üer)yôû?ú»¬Þ¥i§Gu…Ç•øÛcsJV±YÜÏdú·~}C{7LQý›?ñ#52UžAÂd‹$¶•µZmºƒjUE$¹ÙS€>$ 5„A”ö¹º‰¹°éÙÔU¶èŠÉ-’ض\‘jÇ’+B‰zn7Iš†ÛHí-òyë`óQ$‘cËw™ÜJeóEÎ^À·•Ê%:!aEÞˆ4U¦$_ÚÄ^xµôl¸b.›Jõ@Zà=¦}‰,MÌØq¶QŽ„2Ÿ¼M ÉyÔöfrØ ¯–žN&Kƒ¥¸VÛb|´Jnìmipº‰“éàì­fð€Êå´õjýàt0ƒ„)‘ôí¸˜©¥ˆg§NÙ;mEúRH0°R"ñ¤š[’%—wg€&®•Ç 'Ö9@÷È\GÉ’ˆ2í¨ìWµ¸p„ W„‘—ôÝ’``ÐÍ’Ý ‰óÒÆ’ˆ2í®Ìf™¢Ö‰Ù“@B|%–ƒB"M‚!Q Õ ðÂ’ˆ2í¬.ÜÄm‚K“‘¦ùnY00ç''TK"Ê”Ø$«Aª9¤Äfîà‰ùfI007$VÆÑ% K"ú±ëv 1õ¯–|öÛ_ü£Ô^9ÑÜã6K‚¹ ™e5á ¿Hì’dAè·•Ø5-”Ëdª(SÍ4§{™Ï @bÿÖ[4¸4MŠE\·Ó[2Í£g=ÔŸpéËŸcžNK©öî)Õ6•BQ$Iå‡ØÞZ¿ïH58ÕÎeyŒw¹×O”vC‘ýÆcܾ2Z꘬6y¾@ð\55©J,æÐGªM É„ön=ÑÞ-ÉìÝ2!ùg5åe‰$u ³M²(ôÛRHR“Ù@Mó[Q€LûÞjŸë·y©ÝÏ—Ð]D\DOü³^,¢þ±[:m–¸[è«×8WäsT®¢ûê´ÏóæC¿ Eˆ†î§ZϨŒàJû€ŒJ=ª=Cº€Á“6¹†ßO è(èFU¯ª:Bɨ­kÐà5’Kªø±j $…ðB*4dœäš+ÛÐü>úƒ‰jõní m¦ƒ‚­P ƒêƒUÏ ýCA…I¡(@±W¤¢Õ¸/q'¨lWµ Üî™mî³ H Hz \ÏR¡Òn`Kñ½®DòvIçH•eÜéõ°Å/ TIbŸ^CUÛ]lz ´3¤i˜àµŽ!aÁ‚?ZBâô î炈ú&¢øC¶ÏCR_’¶âÄÈ@Ñ„ä Qd+0-úW…UCÅâ‹Ø.ã¥Ä=w±aJƒ¬ Fe¨™7‚p‡¨•Ö¬ Œ°¡ƒS+éHÝ.6÷T—á [|f(›lœØy¼@ëö4íƒ2ÔHDÉÇ©à¼3Hð3uI^ƒ HæÛí+B¶» A¸)’G45!9ëQszÔo{…ç>6ê¹GíH§[½Ä5¯±aúó¨Âʤ½NÃMá²mB¢XÓTÜÁ¤€f6׸9"7z2nª+*ê*Ï}­k‚j¦éƒ3Mk´µj·]¥œ3H>b-Ùî™×¸’Š’E!Û¿ÿëkBÒh j³™Éœë¢tzœk‰5#Ò)\…|¯‘ZÜòWC2-qú{RѺêÇð\ÖŸåQƒ@2„Á µRïÕ¤§þ¸‚ž5\G¬TôÞHùÐïHèÛkœÈ¨Wÿ0€epN yRU½Ý©Þ5Ÿ4ô¢iÆ•V5®$½„l_#¯ÁZ!Ûi›ä?°,¯ ’b ‘Ç–\áúSWÌA•XcœjU(nÓbqˆ@ïà6 €¸ÙÎàºÖ¥þRžè€.H›קÌZ“8"ã-'•ÊÞ¥;¨THgº–$a{¡#ã¿£sÜn'|¨¸Äª“t¥iÐÁ?OZž$½R¿úÙç¿i^ƒúáoþIMá×WûÚÇî(ó³O–Ž®ó¼wlÝ;vhœ;C$²ìϯø‡FÜý¤MRg|¼J¦ÿ¿ý±Wï.×ÿ៪·ppj”™A’ÉŒÉPI $ÅESP¼ó²!©·G£6’·„¤Ž!©u$­’G9®¢ÕFã5ª«Ââ¼)EqAâ˸¢$áÖ-I$\kN+‹!Q—–$XK…õñ*™-”%µZ‹NuMK‹g¦2#µà]Y$¾÷Œ”%ø›TXµÎdT——N÷gzÃJ¦²N¨ÈÑIªð¥ÜâyæÉt!ìå$“÷!oÒÕÔU ǘޮ0%¹BÉ»è"Lq\1¿4\J*S”rô¬Rë4ăÙY~ö¼™é ”L‘ŠN."e2ÙôÒ9æÉtnÃ=«t1œ„x4"’åg¯Á,˜Má®0Z ¾üëÓ™B©ì]0¸‹äÓácXÇ2E²üä³l/S|J¥wJ)äSg8VÂ;œ;ËS\JšKJÂQöCÒ²ß C9¦å‡‰)Ní´Û% 32N Ÿ€$>˜\TaAŸ 08&àÅ‚%ña:(™I|<9|&fÙÌáCRùÀ‹•ÂǵÌ$>³BãÅ0¹¸1feF "§&ñ‘åkC¶Òø‡OaI|˜â”+‰Ï‚>7ƒ|ñòf ZzpÀû’ø<7Ì¢ã¹a‡LáOŒu“ø4>Š•Æ' lJÕJâSdI|˜â‘“ÄÇ›Ã'3ËáƒD( ^ $ÇÃ@-Jfþ,õŽäïiqœqoz*—S^£y{ÁLã#ÖÍ4>+´ êMãó¤™i|í4>“ºÌ’ø0Å$'‰Oó$kåðÉxrøèïór»_€ªŒ.e±a‹§M\„$>VþŽô^z¦IOUt_W»MãƒËj@ŸzÏÍ4>Ê=IuAŸ§!˜©X¦ØäÄ%kåðɸsøЄ¦=A…B¯ëZ"‹{+‰•¿‡«C«\–Çí®p 2Ð4>’ƧâJãÓ6ÓøÈV¥m¦ñQ]i|p k–ƧUíKâó\²VŸŒ•Ã‡öe=!ÚV0pYR )SŠEã¡d&ñ±ò÷p7:nŒ€¿1x+ IãCÓh{ÓøXáæA¶Òø(VuAŸju¨³$>L1ËiY+‡OÆÊáC!9îQHžà1$Ýv±Õ’™ÄÇÊßÃ=÷I£½Í7º<Èf—ÖeÛ„D5›ìVÉJã#[i|+êJãcF85ÓøTi S¬r qrøŒÍ>§´Ë·9¤ n ƳP}F*†¤V2“øÀ_?†{΀÷ÊÔycÈë½z¥Õ‘4>½W“]i|$’Æç¶?‘­4> êÕop¢ºÒøLê³4>çUšÆ‡A«Hærøh¨RH ^Ð €¦VÄmž&ñ1ó÷5šÆçÜNãS¥i|X~¦XåÎO’5søD“ć¦ñÙ6‰ËO£RŠìä'1sø„žÄ7G¬4>Û&ñ3H˜âS*7•s'ñ©Td+ÏvI|j#’ćϳˆ]L±(•-ª£°ó‰„¬N§Ã’ø0ŧd:_–«£qç 5ª©"Kâ×HY«…™Å'tÕêj…%ñaŠMVŸ¹¼…‡$–ć)^Ñ$>ÈbI|˜bMâbŸðÅ’ø0Å­¤½6ñPÅ’ø0‚B•Åo111111111111111111111111111111½ ýÿU•Ù[%p{ÿ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/selectiontype-datarange.png0000644000175000017500000000352214030601041026157 0ustar rusconirusconi‰PNG  IHDR´n|F$HgAMA† 1è–_0PLTEÿÿÿZZ\ïèìÿ$‘ÿj²²²ÿ[ÿŸØÿR±dddÏÏÏÿwÅ‘‘‘ÿÏíwwwµŽ¦^äûöbKGDˆH pHYsÃÃÇo¨dIIDAThÞí˜ÍkGÀÇ+md«rЕaƒ*”æÒTÔÁr1µQ% rP0!ÄbbDÈQzôt1©ÈÁ%CKz Ø\L+¨éY{È!"ô/è¡ofeI»šÑ>9çà‡,Y£7¿}ûöÍ{o†±c9–cù\ ~ÈWüÓˆ>üµ?!úã¯}V%úðr”Våm…ÕG‰RÎÌ~7„Õç~ç%|´DB›–]'“¿àœo²³¼”!(Ç×VÈèQDWØç9ŠÕÛ«CZç|:}±6Úõ5òï¢k°6”CØßü#9ä¢ p NG‡r—'û¼ÔТ/dÄ{ ¬[Õb­EF‡ßäù 6sW«³’¬˜®£›þ,ÌE±ÛxŽoçÏp¾Àî^c:«·ÁºiÃ*Hi¢W¶èmµÊ'ðF¦'µh¾H¹è5ü[&›6T› s^Í•uhahªeƒµ-? ŒCMÆ~ÀE³ª„:«°v%¾v ]$ùz'0v#/n„*:ôX¦ðEª€AR5mÊšAÍÔøål¼\)³ÐLE£füû!ƒÎÆeh>“àfØ°òó%6š{Œ¦/è⺵ w…ŸÂ”j,Ð,ëddò0\‰`˜,iÐ Òî — ¤•>v©î&Ù™Õh£ŠQñ:‰š´³±-iuˆó«ˆ¾®FG?`$Õ_ˆò"ö(èùhó©ÈÖèðûxÒWJ-s­ÎÈ%ú6½ÃVB|‘1ä/–Ñì…†J+Vxk¬‹ÎRÐ-ö×þü|V³8Ÿ(-)´NÖcÏ =è± ½ÉsahX8ß&ø÷ ­TܽT09º|–KØx³õ¨@/*ÔFüÚ F›[Ò‚-lŸÒ _uÿ•V›­`Ä âùu¾Ž?à÷jó>ôœ˜EŒb£®Ê‹Ù'ÿyјd­ÁfGÛN†ò¥^Ø—³*Í/³|{édCäÉÌ“ë½cñ …fË‹Æ|i½°ì‚íˆíû=ªD~Zòk&|·‹1Y%ôhP¡#3S¾ )¦çOy­fÛµ”3°‰r¤C|hŒs‘¿»‚Ž(xÑÑ›Іè*jIÿð—ÍeWÆ%áEËfGߟ‰)ïnúŒfñ¼}Úk ‹5Uߟ•wä¢~«hëÖÓsIZ8ä~ïˆôõ²OMöy-£ú”æ¥'›ž¡õ´UëÞ»kµñš¯´è“¶ÕT qKªx†²ìB½WAJôÖ ¤í¬i~Íy¾zo<Þµ­Ît¢,ËbfdÚ3´Ó§àŠ¹¥E/ëÐìŽgh¥_ÁõISGVÿ"g^ëÑ·JÉŒæ‡XA‹¾ÂŒ†î¾»V_‚”­~ÀræcY)Õ&tÑÛ}¹­-Åû¨r˜w {Ì—–»hÐtð¸Æ”‰KÎ<ÿº[0k°¦G§æ˜AÒZtxªƒ6m_Þí¢EN®öæl¹ÓРÏæ;µ8毘˜:/”Ó=_;ƒÐ7(^=.²_®kµî¡Ü—5|îØX$B¢­`$,t¾¡e?Ón±±ÛúV’{Úe­ñ8âÛhDœUâŠ{.ÐiÂæÖ1‚šØŽìaH¿]òy¼8Ã%ZÝI0õK1MóÕjáë„ûAã2²¯£NR´ê´ãáù­´IÒÛ¥…v¨=¬dEiqhGñâÅÉýFÐÁΡÄgèòÝ·OòË fö#%Ógi5³©©cx¹èmûŽåpò?ÄÊ¢ì¹?jÔ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerLog__inherit__graph.png0000644000175000017500000000164714030601041030655 0ustar rusconirusconi‰PNG  IHDR…k«º\ýgAMA† 1è–_0PLTEÿÿÿÿÿÿ±±´iiiNNN˜˜˜………èèê///ÏÏÑ+PnnEE|_|g¿tRNSªvå’bKGDˆH pHYsHHFÉk>‘IDATXÃíÙ1oÓ@à.ì=#JÔ¢¨#S ‰¢²%ŽL¶#~æêN‚[J.zÊÖŠTºKaŒPÂAêÞ…½?‚g§²ª$Žm.Tõ,Ûw÷ùÞó)’/L967Rc©±û,yTç =9Q*ÌÉsÈÜyC‹eèð†eÁb‡Í`p×ÈŠS“é/w?á™ÖÂbZ•N¼çó->¼w4bMÍŸ æ¹×rf®ôšY°Ò˜°svà'¼–©}‰ã‚od¾2í¼šù ³Ö$–Aõ(f 9˜hÌùIpjÓL¦øâäÂr›×Øýv!0ô<YSö ÀÊÃ:åòô”¹d_ež‹0XûúÝÒ°OL–Ù[nUg5N~R2£ öh?Îb[m$ˆÔ¸-$yãs=$Ó°–z~Îm7ªG´qæ*Wî…²qéþP5¶\÷—ª±ãºSUcÛuÝ#E㌌ߊÆŠÆ%?ÕŒQ/&ÊØñŒ©šñx EÔKÔHÔHÔHÔ¸µFÄÖØ÷¨M2Ïø›O¨›S¾ !ï¨!cŒq6túV0Œ*/ÄMC®0úVÃÂö»Š¦è¶&ËctЦÑzÛØÃ/ÒŸšôî€=»Ú@×=0Qo‰%†:šžÑŽëïM‰V½â²ˆRË‘ƒ-ƒ®e±„­Ú*ƒêaèÑÔ»TÆ™a ´QPÏ0¨gO¬Ê…æ fß3zN%0ƒŽÔ¸Ê šÚ³šâ ‚{úGÊ¥ØA.³[Ô¯°\‚wKÝ:Ø^¨):õY#@hM»f’Ú\j$ ecéKµkø]Ý‹ùÿ￤n(ÔAò Û¤ðH%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPMarginGroup.html0000644000175000017500000003731714030601036025365 0ustar rusconirusconi QCPMarginGroup Class Reference
Public Functions | Protected Functions
QCPMarginGroup Class Reference

A margin group allows synchronization of margin sides if working with multiple layout elements. More...

Inherits QObject.

Public Functions

 QCPMarginGroup (QCustomPlot *parentPlot)
 
QList< QCPLayoutElement * > elements (QCP::MarginSide side) const
 
bool isEmpty () const
 
void clear ()
 

Protected Functions

virtual int commonMargin (QCP::MarginSide side) const
 
void addChild (QCP::MarginSide side, QCPLayoutElement *element)
 
void removeChild (QCP::MarginSide side, QCPLayoutElement *element)
 

Detailed Description

A margin group allows synchronization of margin sides if working with multiple layout elements.

QCPMarginGroup allows you to tie a margin side of two or more layout elements together, such that they will all have the same size, based on the largest required margin in the group.


QCPMarginGroup.png
Demonstration of QCPMarginGroup


In certain situations it is desirable that margins at specific sides are synchronized across layout elements. For example, if one QCPAxisRect is below another one in a grid layout, it will provide a cleaner look to the user if the left and right margins of the two axis rects are of the same size. The left axis of the top axis rect will then be at the same horizontal position as the left axis of the lower axis rect, making them appear aligned. The same applies for the right axes. This is what QCPMarginGroup makes possible.

To add/remove a specific side of a layout element to/from a margin group, use the QCPLayoutElement::setMarginGroup method. To completely break apart the margin group, either call clear, or just delete the margin group.

Example

First create a margin group:

QCPMarginGroup *group = new QCPMarginGroup(customPlot);

Then set this group on the layout element sides:

customPlot->axisRect(0)->setMarginGroup(QCP::msLeft|QCP::msRight, group);
customPlot->axisRect(1)->setMarginGroup(QCP::msLeft|QCP::msRight, group);

Here, we've used the first two axis rects of the plot and synchronized their left margins with each other and their right margins with each other.

Constructor & Destructor Documentation

§ QCPMarginGroup()

QCPMarginGroup::QCPMarginGroup ( QCustomPlot *  parentPlot)
explicit

Creates a new QCPMarginGroup instance in parentPlot.

Member Function Documentation

§ elements()

QList< QCPLayoutElement * > QCPMarginGroup::elements ( QCP::MarginSide  side) const
inline

Returns a list of all layout elements that have their margin side associated with this margin group.

§ isEmpty()

bool QCPMarginGroup::isEmpty ( ) const

Returns whether this margin group is empty. If this function returns true, no layout elements use this margin group to synchronize margin sides.

§ clear()

void QCPMarginGroup::clear ( )

Clears this margin group. The synchronization of the margin sides that use this margin group is lifted and they will use their individual margin sizes again.

§ commonMargin()

int QCPMarginGroup::commonMargin ( QCP::MarginSide  side) const
protectedvirtual

Returns the synchronized common margin for side. This is the margin value that will be used by the layout element on the respective side, if it is part of this margin group.

The common margin is calculated by requesting the automatic margin (QCPLayoutElement::calculateAutoMargin) of each element associated with side in this margin group, and choosing the largest returned value. (QCPLayoutElement::minimumMargins is taken into account, too.)

§ addChild()

void QCPMarginGroup::addChild ( QCP::MarginSide  side,
QCPLayoutElement *  element 
)
protected

Adds element to the internal list of child elements, for the margin side.

This function does not modify the margin group property of element.

§ removeChild()

void QCPMarginGroup::removeChild ( QCP::MarginSide  side,
QCPLayoutElement *  element 
)
protected

Removes element from the internal list of child elements, for the margin side.

This function does not modify the margin group property of element.

The documentation for this class was generated from the following files:
  • src/layout.h
  • src/layout.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_c.html0000644000175000017500000002275414030601037024053 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- c -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_rela.html0000644000175000017500000000312014030601037024536 0ustar rusconirusconi Data Fields - Related Functions
 
qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_4.png0000644000175000017500000000134614030601042024415 0ustar rusconirusconi‰PNG  IHDRˆ#åhŠôgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>IDAThÞí™±rÚ@†— «WÀOܪuïH'7iàÒ¨u)Ïð®(ìTöP¤ÁÏͤ¢¹T<€š?…NÇÝ"á#™ÙO7»{{˯Õ2À ÅãSê. D ‚TÁ¸[¼Ñ—Ôµ$ä•nìÊuÈmSW•Œ-=¹õØwüN]Y"2o­3D ‚TÁ‡ ’ý{Š³æ‹äŽ2Ê(£;g™–Ì^ß{½Çñà²ÍO*K´p°ÌÀ解‚AFé,% V˜€Á­Í ½!C§´T`XàêÝ}l¾¸8ÆÌ­#Ù…w10áafÀ»ƒÁX{±Òv ‹Ò |°{J/Cî<Pc£²¶Üų½N$HmWµ;¾~‡Hï9 r¯›ömS»Gîõ}-•ÈÀAÖ¥³å0ÞMæ ‚´×ó€·ööÙjq{]ÑùÊà>÷g #Là‹$j¨.Ä+ÑRD4ÔPCÅ€÷}>‹³jö| úFÚÌóÃVÒrut'ªa¼ïydü½3Ô0xÞ»³mÓƒÌ5Ö"k±ŠêA€Â6b1`áƒñ1C5”“ƒÑf̓ ýCuÖ#H9TGÝoªsZzmÚÇ5ý¢ÍߵᅓÑWz´ëqü¶Ÿ©ëþô»Œ@¨ D ‚TAð±{ê[þGœ ÷©+IÊîÝôßÿ!D ‚Æô’º„Ëâ=Y‘ÉŸ„í£%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPSelectionRect__inherit__graph.png0000644000175000017500000000164714030601041030710 0ustar rusconirusconi‰PNG  IHDR…k«º\ýgAMA† 1è–_0PLTEÿÿÿÿÿÿfff222NNO™™™www………çç误³ÓÓÕ+Pnn÷&ptRNSªvå’bKGDˆH pHYsHHFÉk>‘IDATXÃíÙOkAð~'aCCK#+ææ6¦Tðº`nÎî¾4½ Toù“b<&™’é­Ò€(J¯^Ä£xô"n¤ ?@Á7»¦µq³›dêŸâ¼ÃììÎîoæ½YIæˆr\›ÓF¤‘*NwF´;µ¿ÖÔ9˜Ú „‰F „MÖå3Í=¾=_}mÙÚ̆CRÔØ–wöƒ EIÿmiT€@•xph÷P56HŽïðáëX y˜~Ü$.^äÄ;° ²ú’Nf„õhåä€ó²ÅQ@'Ì%H¾úŠ·,‰Rb<ï‡ÆƤ5 v@ ž¾w$=;Ì¥øÁŠ52ýÅ>®¹æQâ’\ÉA#ö°¦Ë q;³·É˜˜ü=…Muc|hãO0}Œ×ócâæ`ÜHaÔ‹~ÒÉÆ¿®lœúÇÊƉÿYÕÈúþWUcÉ÷ªÆ¢ïûûŠÆG4¾)§h+'h|Q3rH$mL’±$š‘¹#éÓ†6´¡ mhCÚ¸²ÆQüOXŸâ‡—Ãœá+ÔyX¡!‚ÿO›Ö°¡,ºà €GmÀþO;ëq¨ {Æneǵ­‚5_Ùa³i{vŒÁËž| ÇxAˆ6ÎÈdc†=G¸P梉p¡ ÂhápU Ö…UÁïÛ‚ÉÆmÉ\øZI¸¸B\‡‡‡µèu ¬‡h”îrœˆÉ¦Ôƒ·ä(^pð=Ù• ¢Ö40º¬ e¬i'¢¦Btª¿ã=ÕÆ•7.ásýE^%ÿ½ÿ’þºñL9ž|?y¡IDATxÚí_lÇ}Ç}øÁH8'òŽºóQa%95 ÑnÐÚÔA\£çÚ„ZˆÖw·&¥ ÀõÁè+…pEÈF^â:DPäåRTZ®^ ÿ4âÄY“e_¤WÁìƒÔ'· HMç7³{·fvg÷fÿÌí} “w»Ë½›fæ7³»¿ï<€¦âhæ´¿Av5eÃ×” _‰³9ù„L}e¢Ø¬éR5Yl2|6—¦løš²ákʆ¯l°)qÖ\Çhî&’Ͳ~ÍéM¤ëÙ¶ÅƆ¨„JúK”…F ÙèÞל\6s­Sm´ö܃H;©Í¯³Ù—ÙlðÏRqíÜIJ)5ð‹6”³¨=òùÅÒÎ%<ð9§ë¥e­¤7*Û~‰AÚŒ~¹„G1°ŽÑ*Û-ÂÍi“˦‹n¢ËÀæ¤öäü¹ÒëßE­Ê®,¯!4«Í¿nÕ›y¼ƒÔ›Y ŽÑæ_£lª9`£ë+×ç¶JwÞF;ß wpýÑð^èoZH+ݹIØÀF| ®?ú䳶)TÑq»ÁåžY†zƒPûwL6°×b ›.šø65ê‹Ñ±-ô ´—oâfSÀ@Z’6U l M]Âÿá´M½v‹öÅõsˆÄðc8ãr® :ô³Ëzã8î€Ñò†VÑ5ò’ôÅhGÛÑðF³/n#Ò5Op Gèø‹2Ï‹²1.ÎÈÙ\š²ákʆ¯,±±zX ~Àhx¬³¯L±1gI}7æÙÆWVØü†èˆNo—Èô •ê¨xiC/)jvóʦøäú 2gu:}B¥RãØÖÆ£[d ….¬?žS6Û×e3‡'Ldú„J0N¾R¥S(„Nooå›ÍœVzî:}ÂïÚ°é¢\³1Ûž%•žÚ¡Ó'̦þ‚6S¨·)³/Æ1ü˜¾ƒÈô fâ[ˆôÅ0_Ïo_ÌÖï¼Ï£Ÿ-¼2̦ÔDS6™9›KS6|MÙð5eÃ×” _S6|%ÏæÑö )š¬ç¶$eú–!‡Í«ņèžñ/i|lH¥ÂæÙ½ƒ´Ë-¢4Ø<»×I»ØBJMo¯v©Å”<›«ŠÔšØÜVMâl3:iYX ³©i—X\ɲ™éšvÃ|Û$Ù§]Þ0J”ÍæGi7”’d³´×M»¸¡” ›²Jý0(A6•úaPrln«ÕÙ ÙÔô™JŠM±ÿi5´’bór-*165£vIÃ+!6õZTRlÔ‹Q DؔՋQ DØôTõQ%ÁfaßöfêGaW¥`{7õ£°kóû»éýp›j{wâ+âl‡1–Fm6 ®¡Í”ÍPEGGÌ+Mü~3¢^Ülv?pmHÉb>BÔ‹™MÙè2Ù$îG1¿%pël1³yÆ3"NÉ"{lj{‹6IûQdMïóù‰ûQdŽÍ Æ¥‰”ü(2ÇÆ¿GŸ/×¢ü?¢lÀæz6‚ºÞNÍëŠV ~_4öDÙ¬=Uo̵¿´E:³âû»%À¦ØïðÙÈó£˜âlÚöØ€Á#„ Ä¿e W¤„Ù,}ÀÚ*{Îð¦a„`sUHŸõFÇ=Ä¿× D&˦ʾµ ™Í=#‚˜‰"“es÷}vi¤~È× QQ6£6]ú#$þ!‘‰²©zf >ll³+<‚iŒvè´'àú/¬õi½ù÷ ýÜ,½Õ\o þ!‘‰²Ùý§4ŒmöÙU ÖF{´ÓM6Å{¡Ú‰áø_¢D¸¿AB£ùÏ‘›ŠqGŒ I~¶Í®<òhês$Ä“X‚GÃ:3Ÿí~6í,òJˆ ¯Ú¸>ßLš·Í®p›ZSŠõniåfó6‰%612èál•A6~J† ·Ú¸>ß4[°Í®Jè$1¥¸‚Žo4ˆ%hŽíJAÏvm)Cl¸Õ†Íf4»Â]KÑ4¥@Ÿ['mŠÄØÄe# ì°áWf›²Í®Ô0¥ÐÐ|¡Ž´SMK °‰Ó¦cs÷CÑÏ'}±mv…{^½¦xª·I DZ丛Ø}±blxc~i¢Î®ÔcãSmÒº“6Å~WBi„$Îf=|Öpl–Þ÷Ù™›¹YÃq°a^·I™MÅÀf´ùfã[mòÍæ„ÿs¹fÓ;ð/³%ý(jË>hKŠ%…Z~½#1„ýýBœå’!ÙlÊÁ—R@ï÷Ó.z d³yèP䨫Ƨ]pIfSñ>8áUµ—K“3? >¦2PÄvA.ßY¦©r?ø LH.ÿéÑYã~Úe•\6ƒ• #Þ3~™v‘…%•MиlLÔA#—ÍæQÀ¿N»À!$“ÍLиï=%ìÙFå‘Èæn@RæYã7i7”$²)öïøJ»´á$‘ÍÂû¾»ÏªÕ T6þ¼¦‰lüx¹ÿŸi5´ä±Ù<ôû˜¾RnR旖ŦâÀ+}…†|CIcã7/òí+Ð/ð÷õöÓ.gÉbSûßó ³$‹Ï—w¹”å‘$6>S)¥l2…’ÃæÌy{Ê®ITþü(¸×B«îè;?ŠÜk¡=wôÎÝýpnO¼é‰ÞycÃ3BTÞØðzbVˆÊNO\a99§ãG! ²ÙÔ8=qµ=? Ñè¸%› çöÛÉ9? ÁãœO!K`Ãé‰cÏ¢Òñ£H‹ÍóêÏÉ9?Š´Ø :ŒUÞ5Ðtü(Rb3ËìVz¼«YéøQ¤Äf÷±ñ6÷¥tü(¼ÑYfq²é3(ø\—HÇÂ!:n6'wìª>&×éøQx£#Í /¡&¦ódm{élXÓÌžÏ#JéøQx£#q^Àÿ­w_EߥkÛËfÃÜÜö»tžŽ…7:Zl® —ÑKæÚö’Ù,x§™5c%ð[Ê’¨Å){>qÃtzA¥¬µí%³ñnªþŽú,6~áÃß‘BÔâr´=Ÿ˜¸R<9³szƒ®m/™MÙ;Œé…΃ñ þŽ¢~žèH^Ï‘|b¤#º¶½d6wÝ[–œ¶³Al¹eó°q„†Ý…x@Øß¾SŒM˜Ðñ?}â ÃøÛ3¤‹äý(ÂFÆ‚ÍX¡ã&Ñà‘¼EØâm9جŽ£?zá·ÿ÷Ùg†mËN0›$ý(B¶»Ñ3Æã³ñJ€M’~ʱIÐBY6 øQÄÀ¦e{]w½7´˜®MÅïG!ÌFã³ÙÑßXýC}cU׿R×›”E‹þ²ýÀjÚxè­Õ:þ[›2Û–7y? odĵOc`á³yºù'ÍÕåß»¸ÚúÓVýüŽGµÁlÎ/¿1bsÍØú¦ ùQx##g8ÅgScugþå[ç[õÕ5üKo×qŒhÕq=ÚnÃ{\™êÛu½µ†7íÐ]çu²ج>ݲؔñhÙ—M‚~ / h­;mD¢_Ý‚¬P½íÇæy ¤ lÌzS¿¾MëÍÓôå…ïP£^Ň\·v­ÂÂæ¼Åæ- ú³‘#? †T½××hô[C¯.–º«¿©?¿FØ,ëô%®D°±Ž7A•yÞÚµ ;lèuÓDØøQ0¼( Þ,–HôÿðV²Ô½›a›2û‹ÍÆ &›çaã*°i“CÌ]@ÕѦ¾ì FšÏ>? †°Á?iþ0ac.u¸}ñí‹-6¸!µñÍ‹f›º~‘²i¯Þxᯠ²kv8úb?“ˆO\¥VÏË€$âGáõ¢°Ø@ôÿ MÑ¥îyl†1ÜbƒûâÕíÖvkg½Eûâí Êf»uQƒ°Á» /ÞÞ ­léI„P› Öì‰ÅFÀÂëEa±è‡ÝÄ͉.uÏe³z¡q ìû½Ù`ãñ¢à„2ÒÓÛ%2­ÂòUÇÙý(BFÆøç 8ˆ°axQpÂ!Ôé´ ÿ¿ýÊ¢ýlA~œO]e_ ~S†'|GÖH‡T¼¸î<›¿EÙ}S†'|@›¢qïa±ñ—‚l¼^¼ð³'xA¦UÞ65l¼^¼ð1^i•§/žL6TcM¬²Ïæü×û_‘ÙŒ¥øÙŒuG:Ú}†$Ù„KyRQ³з~rã†ñû“hòmòlÂÔ°³ £Í½EÔ7lK Tû}_3Œ6>%µ.x’'ŒEO0Ál £ChŒº~ˆÌöDò›`6' ùÐëw¬mð´@ßØïä Ô™£MgÈž29€gý "¥‘c¶`*SÏmU Æ§‘l¾cøý"¹.q1ða£†¿²åGXÞ‡¶=r‘ xÍØû×8¿lŠö -ô0ö•ûæoÁ"ÕPh6ä1­ÏðÿŸ2wÃ5­NÚ…’¤HÏ¥ïÉ0þ—s÷ÎÄ<€%Ÿa¯‹ %îPxRÜ’ƒ¡,àÄÍñ­*œÜkS„ü©_ îW³>¹á3÷& Û Ÿw÷ñ0Í××¥ãËê'˜EÉóµÒùéeTbcÁ +Z´Yäš¿o¼êcÁHlî™/6 ‹Õ Fb3tªú·*¤v}D¯ëE-ØÎYݱ`46»GÖ+Ÿ$ñ¡T Fô©¶*¤ìX0¢§ÔèÁ…"&é$i¼“vYÃ*"›ÍƒáËžØetÇ‚ÙØVf( ^«gR‘}E¥ÀÕX¬?RÌÈ.ª/¤­Q‰¶*¤ÚX0*ûBµ3B 3P©4ŒÊƱLÎcB±ÊÔ;ÊLA#ûÛê ŒGRe,™cõç­ŠdÝ~Ï‘<)~C9מoUã=ìãQ&Ù¸XY^‰²‘úõ3u?|$ç’ê­*l\ º ->%½4eãŒTøí„þ*l\«cWÅÖöHÞJ)î³6—á|[št&ïG5)îÃæ¡#×{‘"“÷£@îuì¿6îUY‹‹²?=I?ŠTØxVóY 0y?ŠtØŒ.©›z78'ïG‘›š§ƒ žt&ïG!ÂF“Îõ»® Á­*y?ŠÈE‚~ Bàì6ä~ÆÈƱ®Qm¯ Â&I?Š›µ§ê ²˜2îÊê_=µ+›²7joòäý(FlÚÜØ ‹pCƒ¦Q o˜•H"4èx7ùòäý(Fl.£ ]Ø×4*BcÝ8­IgãZÒÐå$ïGÁ`ƒCàe¡Ï €/"ùl*Œoõ˜ïêwaØ”0ý(ö‚<)(›Q›‚×: €1°A½ï6ß.‡ÁÆ6·Bô¶“ ¬­ÎÇ$âGõsÊfØÃë?û²F£bÉ_Êf³ÀПòÿÀËÆ>·šm~ÿ‚“vºéÇFÀ9c8þ—€“ÍÑd}+ÆÁ¦Ynùu9N6KŠþÝÔÁ†bC/€+ƒA…N¶á}]÷Ùý(mì·Ãø¶%çùä±A»‡Œ>íŸÎ°¤€¢¯wÁ}bãÑ-p¥ÐÐÛ$˜ ؆ЅõÇÝg ò£@ãâøØÔ˜KÛåØ?aIÑ-éè Txt¥J\)€ ² ë´cmx?Š 6¼o7>ï¼Ä¿\Á`c·¤h ÀîÀ†¼Y3 *ð6›@¥ÅæÌ?±¶r»o›²[R̵¿ÿ2°yj‡´)`sªI‚I¶1ÛT†ÙTØšw…ÔÛÛ-)póiÁüSß!}1f1“ã:lcõÅYfƒz+ÌÍ·÷ƒÙP1çVZè²dÍçš ûVgHwÏ0eá+56Ì!‚GHYCÀTîOͯGÉ–À†=ÄAÐåd„Í\¤¼alj¼ÁÌ»ŒYg>îkŽÄ¸ŠCõŒ7†åÍwå ïø8olªÜùL¥ÿq¬¥É>´yÄÛS6\OL°[5þÕ,w°šd? ¶úî®ÛAwe2+Il|ÖÚdO²/Ilª>W—Ša3®lIŸÞ‚Õ/…Ï“%ÉbSó«eO$WB²ØðÇÆ šñ©èy2$il|…ΆH•ÉŒ¤±)ú_ëWA8ÒØ ‡}wßVŽ<6å€!_°mª!yl˜·ÆíºªÚY"›A©0Ï(Vs$²AýBÀWÕ‚#“ÍRàâ¬Ï*G&›jðÓÅWUŠV2Ù…qÐUcòóÙšpxËøuÚe•T6aô–¡Ê¬\.›"WjÎ÷Ó.µ˜ä²ñŸ[*÷ÕJf³ ” ](Ë%³a?ÅåQ±gü&í’K6›3ã?ª/*ÐéÈfSáËžQûûÆOåXR<ñÄãâ_/U6hó»K<Û6œÚâß.]6eþõ?᧧BJ6>gÊf–[q¦lPcÊÕx3N6}pÉuŒO.Íɱ¢_!6Ü'#Û¶Þ°ØØidq_ ¨ä`SÒ‡ UlƳhÚŠ… ïþ/#Ûv{‹ÉÆZÜ×͆,¥xº)ÊfœBÌÇà üØزm‹—^„góçôfI×hÚÔ-¿$‹û~^ïg3— ïY!lܘhtCºº=`)sý‚õeãbê8q±i’µÔÙಣ¿ßù6| Ž2ÍÕíO+¢›—cgè8QØhÇ|ƒcBñcÊÆ–FŒPÅ̆N˜FG0i¢«Û ›—/ÅÎõýÙ„r»P|BöÚÓˆçŸúG3cÇB3:‚IYÝ×ܦŠíµÅØÙx—Cq°‰>xÖíJϧMÙÓˆçôõ|8šÑ±¢[«Ûã$ýòü¹c[±³A›îÇÇ…¢ >xÖm¸mÁgÍ¢)^63F×¹Ádãu¡  IDAThÞíY;’Ó@}Kyt pn2náå[òH ¤$ $d,Énù{e› D>€’G ÖhfV¶%£µ(ªŸª¬é™~=í'uû£ Š›gsgðo@e 2TÀ¢np;w6gżöãàn¸ÅnîÌΈ¾Ö"\zŽßsgw6d‘¥½€Ê P¨ ‚2\"C† —~fÍdr|kx G¿ï{}3"ÖHÐ#gÎ~”4´t´4,ýLIÇ­p IÇ5XF˜ÝèTX¼§£Ý›ß)0,:ãû :Jáßh™x¤ d(Ä;¤e®eeKCÕç5¯«È·x”MÌ6¼Øi”í”2T2ªü&Uâß –&8·°~})üœ+º\ xõ(›”ì8ÊjÀ¥T†æ¸ö‰ä¯ñ/½GÌnFU"ƒ‹¬*Øá8;æUÜW”± [ä‡ä |Mâ-ðàí—w{ѳwzû×Ü-2T:7üerÝöEÈ,iX°¢ãõ^v›CÅš¼((MÉpígŠhæ˜ ëžVH¶Mny@†° l/»m‘e²Çä-²ÅÒ×í”èZë”81–a1¦€~žVwÑ|eúô‘Ç`” OúïCLWSP*•A 2H>)v£þøŸÈðwsgsV¼ ÆúDúD»…Ê@e,p3w óãÕ›?NYâŒÚ»ˆ%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func.html0000644000175000017500000002220414030601037024552 0ustar rusconirusconi Data Fields - Functions
 

- a -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPStatisticalBoxData.html0000644000175000017500000004653714030601036026666 0ustar rusconirusconi QCPStatisticalBoxData Class Reference
Public Functions | Public Members | Static Public Functions
QCPStatisticalBoxData Class Reference

Holds the data of one single data point for QCPStatisticalBox. More...

Public Functions

 QCPStatisticalBoxData ()
 
 QCPStatisticalBoxData (double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector< double > &outliers=QVector< double >())
 
double sortKey () const
 
double mainKey () const
 
double mainValue () const
 
QCPRange valueRange () const
 

Public Members

double key
 
double minimum
 
double lowerQuartile
 
double median
 
double upperQuartile
 
double maximum
 
QVector< double > outliers
 

Static Public Functions

static QCPStatisticalBoxData fromSortKey (double sortKey)
 
static bool sortKeyIsMainKey ()
 

Detailed Description

Holds the data of one single data point for QCPStatisticalBox.

The stored data is:

  • key: coordinate on the key axis of this data point (this is the mainKey and the sortKey)
  • minimum: the position of the lower whisker, typically the minimum measurement of the sample that's not considered an outlier.
  • lowerQuartile: the lower end of the box. The lower and the upper quartiles are the two statistical quartiles around the median of the sample, they should contain 50% of the sample data.
  • median: the value of the median mark inside the quartile box. The median separates the sample data in half (50% of the sample data is below/above the median). (This is the mainValue)
  • upperQuartile: the upper end of the box. The lower and the upper quartiles are the two statistical quartiles around the median of the sample, they should contain 50% of the sample data.
  • maximum: the position of the upper whisker, typically the maximum measurement of the sample that's not considered an outlier.

The container for storing multiple data points is QCPStatisticalBoxDataContainer. It is a typedef for QCPDataContainer with QCPStatisticalBoxData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods.

See also
QCPStatisticalBoxDataContainer

Constructor & Destructor Documentation

§ QCPStatisticalBoxData() [1/2]

QCPStatisticalBoxData::QCPStatisticalBoxData ( )

Constructs a data point with key and all values set to zero.

§ QCPStatisticalBoxData() [2/2]

QCPStatisticalBoxData::QCPStatisticalBoxData ( double  key,
double  minimum,
double  lowerQuartile,
double  median,
double  upperQuartile,
double  maximum,
const QVector< double > &  outliers = QVector<double>() 
)

Constructs a data point with the specified key, minimum, lowerQuartile, median, upperQuartile, maximum and optionally a number of outliers.

Member Function Documentation

§ sortKey()

double QCPStatisticalBoxData::sortKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ fromSortKey()

static QCPStatisticalBoxData QCPStatisticalBoxData::fromSortKey ( double  sortKey)
inlinestatic

Returns a data point with the specified sortKey. All other members are set to zero.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ sortKeyIsMainKey()

static static bool QCPStatisticalBoxData::sortKeyIsMainKey ( )
inlinestatic

Since the member key is both the data point key coordinate and the data ordering parameter, this method returns true.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainKey()

double QCPStatisticalBoxData::mainKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainValue()

double QCPStatisticalBoxData::mainValue ( ) const
inline

Returns the median member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ valueRange()

QCPRange QCPStatisticalBoxData::valueRange ( ) const
inline

Returns a QCPRange spanning from the minimum to the maximum member of this statistical box data point, possibly further expanded by outliers.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorGradient-levelcount.png0000644000175000017500000002420214030601040026617 0ustar rusconirusconi‰PNG  IHDR´0ÊÜgAMA† 1è–_ýPLTEÿÿÿÿÜsNÀøùÙŒHR«ëÿö½EˆèýÿýþûÚ‹9 &sÓúÿï£3„åûûôÅw/€åùÌp9@k£ÔôþöÙ6 @ºûÿÿë™3œÞìñìÿä‡&X±êöÚ ]Êþÿê”&"™ëÿVÈú+â›G|â€Þýþí¦<ÿþë§c\’й Ôe  kÓûÿ'”é£F ;¨ïï¨6wÚþÿå勤îÿ H´Ÿ³ÿõ·ñª; g¼ñèÐÐüìÂ{0&ÆT ;çŠ%F¸õX§ýí°8©ñÙl ÿá{1 0Ü£|ŽµÞk„¯Òëúî¯Pí¼G•Ý. ZLª­¯²¶¹¼ÁÅÉÍÑÕÙÝàâæ é ëíïïòò"ô%ô)ö-ö2ø6ø9ú>ú òAúCüEý ÖIýMý©ýÿQÿUÿ•ûÿëZýˆÿÿ^ýbÿwÿÿ1öeÿïiÿmÿhÿÿqÿ\ÿÿvÿVÿÿyÿ|ÿLÿÿ–KúDÿÿ`ú‚ÿ†þ‰ý’\úŽþ’ÿ<ÿÿUú¥–ÿ™ÿ5ÿÿÿ¡ÿ,þþ¡ÿ¦ÿªÿ®ÿ²ÿ¶ÿ#ÿÿ¹ÿ½ÿÁÿÅÿÉÿÍÿýýÐÿÔÿÙÿÿÿ¢Ýÿáÿåÿÿÿêÿîÿôÿ ÿÿ þÿúÿòÿ‚Aÿÿ™ èÿ6øÈ_ïÿãŠÍ†y2ar]9=vFMVe6miIAZQ-)yBébKGDˆH pHYsÃÃÇo¨d$¬IDATxÚíy|–Õ•ÇÓNÛ;ÚÂPÛj‘±Õvj‹ÎÔ´c;­­S[k§µËÐq:f¦Óad_dQ$a $ ®,Yª(…²6„„E6™ZŠA‰€(Èö™{ÏÝÎ]žç½Ï›çM0¾¿?š¼$¦ïÉ7¿sνÏ] òÊ+¯¼òÊ+¯¼òÊ+¯¼òÊ+¯¼‚õþIk¿…||XúðGÈŸ^TpñG !k×þÏ:_ÂþýŸüT[ téeùtAA›Œïò?ÿ‹+:þå•Ÿùäg¯ºª]ÁÕŸûü_uüÂ5m+D¦+:~±EØfãûR§k¯¾î¯á³¿¹¶àrA„øåë¨G?ñÉëé— ¿/Xˆ_ý0!{mk¿í$ºák_ÿè§Ûn|úðÇÚ} !wQûo|óÆ‚Ï|î[*DúW{Õ·oúûïÜ|Ë ?öðâVâ7¾{ëßk×Úï;™ncÛf|ß¿|üíÿ±Ýtǵ?¾ù–‚¯þäÓ*ÄŸþìZúWùOßÿâ%4pñ‚†ø¥Î?¿±µßwR1„íÛj|ÿܱ*ü:Üiÿ•þ mrHç;oûÉõ_úÙµâ ñ†Ë®ëüó÷Î_)ÈëÂ6ß/:ÜÉ>P„¬VÐ?DâOÿõVö•K¿}sÇ_¶/ Ü_z|×{H·ÉZØÖâkÿo¿jwÅ·‹.¹üßÿã‡?ºéÖÏ°Ží»WBˆ×_uÕUWîç·\ñ½[ ~ýÁ~«@¼ !þç¯Ú_~Ý­ýÞ“ ¶ÅøÚ_v;íc~Óþ×´ù/šN¿LÇM@ˆ4«t¹ä××òßW\|û å/hˆ?½tþå-­ýÞ“ ¶áøòÊ+]zÙí×·ö{ÈÇر)”6Þû!ƾöõ»Úpxï/nÛá…ÆH.HÅ¿½á½b$]»uëÞ£éÙ³g¯^½z“Þ}úôéÛô»ûîþ ÝsïàûÈ}TC† !ÅT%%¤dèÐaÆ'#FŒ9²”Œ¢=z4)+++//'ååc¨È."?”ƒHyÍ4jûoKKKÉHÐúǧ?X¿½v®’#¬‰4Føà¾dAC¨ú£zYR o¿¬ }ð¾,üâƒ~{¾·Ü<„})BJR‡„%!'8‚ýâÙïÒwÎqf•••¤’K|TD$DÉ þQ¥¤´R„Œ! ïW9FX°Ä‚‡~Û¢{„½9Â~á@ï& 2R«Œ`KKÁÜc8¼ÊÊqãÆÝOî×¢¯9HŽQ›‘[‘;‘CÁ ¢ð®q•-B¡Þ–ˆùr|±!¢?^f‹”ʼn}uxq”RFØ݇pG8x0&XÌ 2ŽIl€ C6ŠL@’$F0£"cˆÂ»ÒUNö-Ž@84R<²²‘-€°+ ìa!ìo"¢MDz2HJE •ü½ &NœH&*a€²­ …÷€+’)¦æ ,ö#,‰ª9C‹E8hнƒ­4ª ––r r€ã8>†l’-0J/jˆÒˆ¢«iI„½cr•5S¹EHˆ,†ÂU)4B5r€߃–,Ž¢p"2"ëipÃý-üÕðC>ìXÒ\‚ee£l€$a²™ ãê<ŠŽÕ@ÀÇ‘=bƒ”UBE‘QxºÊ¡ ûùŽj>ASM¤]E?ƒŠ†”)BÁ‚••øQbqM¦Ÿ>¦I ŠÊŠn6ˆ(¼)®rˆÐGpj*Ù@1÷{ºQõ €€’›†5Y±41r+bˆˆak!ìëL!‰*=žc„=„º*òBˆ Žc5PðzÓ™ª˜¦sI’£ ÑfˆÂ{ÂUîÊ)As”˜2Ân„„Ø„‚ X:ñz”Ü ,ÅRaäÁŠ6DÅ…7ÓUîæ˜`®ˆé"ìPu32r2‚å’ µ øf’MˆÈ‰š¡ò¡ðIW-ˆ0m‚ˆaªƒ ÔÏØíe+ñ BdRÖÏÄ!Ä&œ*Nœøàƒ=Í HùÑhæÏŸÿÌ3ÏÆnáÂE\ .ä(9G†Ñ¤È r#ŠdŠ|¨ßÞbW¹Bh ÇÚ¿üß͉WÕï’ø0=„K¬b‡Pš á¸û9Aòcô–.­fZºt)É1rŠQ¢Ê¦Ôˆ&CÞ󮚉°"aB€\!95GQ1ô#äyt¬6!íd(AfA ñ[Z½lÙ²åBôÓeŒ$`n¤gqŠQQDÁ#|ÁU®ÆšpL@Pe&„#s°k7£Ÿal!.…Ò„ˆà,æ@ÆoùŠ•«´V®\±‚Œ`FEQ@„lÊ+¢fXÆ^ßz8Àº85e„KBòÊ„Y¤*éJSD¸…3ì†lÈZR¡²a½2áôsæ3‚«kÖoÜTW·µ¾¾©¾¾~+å¨)J+.G¥1CÕÒ ð¶¹j6Â-™¢ÉÑ•êjˆqkõ³! ŸŽîhÒGheR>ª°ªRH+á#Ì„óŸ]´l%µàƺÍõ Ûwìíر}{ƒ¢(*²"@”FTMÍ$dCÞ+®š°"3Âǽ…pyƒ¡g FWÃJÚ™ÔE(»–G™ i¥W¯Û°is=å·Kj÷nŠ‘š‘æTÛŠ"ml˜átæC*†­Ð›F\eÏ0U„[ õàž?òµB7CK!Í£Ô„³ç/¬^±ºfCíÖ†=»wíR¿cFqçží4Ýpˆ¨µÎ†Q1„¾T¤Rá.WÍG8/áDÅ¢¶Á§MÙ2LuPAµDŒ+P1¤ ÙóB>;c!GóèÓ´Ò4ºj-%¸}'å·mï6¶mŠÔ‰:2ˆÚ‰ÜˆLC–J¹ íý»me7¨0Ç{ÃÆYk]â¦ÆŽÑù‘ [LöôÇB^ Y¥•paõÊ5ë6Ám/ÓvÿEhúâ.±–36¨þ”B\Fä gp†† Qx;]5ß…þL‹°!Fó30¬ÌàBÏÌ!oJÕè^eRT 5BV Y¥•pUÍÆÍ ”àË/½ø"Ì~ÑÁ·‚(2'n2j"‘%S`¨Ë!³!mJ1Âí®R@XŠ°*€`CCM¹4E„ûÃñC!äÑåkÖ×Öï‚/ðÇŒ"eø²`¸GeSÔØ(#R†llåÛ…WïJ|¹ûûìâ»hæ¹9úä—æ#\ÓA‹3 B#Ù‡ê¡!ô¤ ‡٫W®Ý°yûîW¶½ôâó‹_eeøÕÅÏ3'j†`DDÆê¡d(lh#ÜìJ|õjt¤Èg/½´}". Dh›Åèe¸*)à „A1R„û<6Ôà Œ íÂYs²<ºuÏ.FðÕ¹OÎœ9óɹs_¥NĹ”ùúQ3\ÄúR!0DáÕ¹_ÕûˆSý’ ¬È ¡ì} ës0(Fа!TC>A#‹!š`SçS„ë6Õï~åå_X1…­•ŸB>Es)K¥ª/ÝÃfkD°"ƒF Â,›Ñpo0„Úñö?þæ-·}”mÝb§úu,üJ4BT ûD"¬³F0ŒkkÜqEÂÄ12š ‘ ˜6|Ü@8C ¤yô…ÅONyôxˆ2|r.”CY Y9ܳƒ‘Ïr'2†Ô‡´¥¡C|fÃéÓéØÃû ®såü…BÕ¸î[‰\X±Ïeøp,ÂÿÉŒ0¦$Nn¦ cb$û †j`!m({RÑ’Ž€ ¶qè bÆðÕ™S¸æÆ+ð „–†M›nG7n†+h9d ʤlX®u…ëDy|Ý/bNAó"ôØpHóRU‡UÃðZ˜)F²ÿþ}¨¥Á Øðž{­L:•à “™Æ:ÒU5›vÂGh×î…%R†1TD`¸fõÊeËx54Š¡pµ+ñU8äî¦[?ô¿Á©~ü`Â=Ï+ÜiîªäüóßåÙ ŠQ"Üg§R164l8ŒŽ e&\5뙥+×nܺ“¶34‘>tå•<‘>åAÈFhO!-‡+ ÒLZU…ûÞ*Wò«_îÀNVþ¿Ÿ‚Sý~I0aE¯€L:]w¤ z'l²Ú‡ÄHæir†¶ ™TL’Ê~fõúÍ;vm{ñù§fNyô¡GQ}éåmb²z( J†ëkÖ°j(Žp’p¹«4fgü3¥ã£2)üZ‡lh¨KaPxól†<•ZÕP̱™´ŠgÒzÞ’Îd›Žf"‚Û0A-Ê’=¨ÝDm¸š5¥ E1ô#\æ*-„b2éP!ŸI@Ð3NÌBB¢Šçƒ;6ÊEË×lؼÆö‹ç>Éö<‹Z÷ìá5uâÖºZ°á B£á^d+…åOJ=b††â7]‰Çö¿€¿!ØàL¤–C¸`ÉçRÖÒ°rÓlvGÃmÈšÒEËV³'†»ÙCñÄל•á¢÷(„ôkÔ†¡paÄ b¾«VôŒîhÔò™¬Öµ Bƒ¡nK• Z Þ³Ž†=3\]³±®~‡Zy±KóSχ€áŽ}µáæZŒP *ìÙ™f†— aE÷Œ6Tûa¶úA­Š$Ü¢31Ä©”w4”áDÉpÕÚõ›êêTϲ0Áœ(×V¶>‘-pœwí–e;£gg¬iîY®REX‘9•–ýVþbíŠø¬±ñ™ÖBxà€ÉPõ4¾rÈS)š)Uk Öo¬­c¤êëå|v]­P[!¼•1d‹¤hÆei"eéòjÚ³Ù6Gê>©˜á*]„C·+-§·ó«…<¿÷9Õ1Ës‡å<ëCÏŸ-¡á‹I«W®^ º71f°$Ÿ-ʧbŸl‚uÞ âž`Ã];·o­Û¸žŽ ín†M‘ w•­4þþ\†•sµ6²±¦9¨8r’iT.åól#ôJ¶ÉÓgÌž/öU¬­©©j@ë`£Ì±X’)3ânÙͬ€9ÒÙVÅkg¦¹JÙ…®= Ëž …XgI®¸'ÍO¤Š¡2¢ìK †÷h†k†LâR¾AmÕ*=!½6«Q’#µ"M§,›îaÃÂZ˜œÑ&œ&ZËŸ&»JaC½ß~Z Ã¥‚à†¸J˜*ƒ±»õc œKV¹t*<À‡¥ù°Ów!Û¦ s`l*s% ¥aßµâf(—›ë`zWÂù³gÌКìEˆ¹J¡3ã=ÞÇ°ì¹àm†[·Zÿ0+Çý ÕøÐW‡É¥P|‡ ìö5g>Û°ÍL`{î9L±w”&U¶y57uµÁƒÖìšÊ£á#®r€ÐñὋóËÊËøùT–k„"N¦CÔ—Š‚H(6üÂÁ³f³“Kø¹%ÀH.Š°…”ÖE±xOqO{Z?²cl‹yÐU.:ç`ôõ3¤ÜÛh•·BIÑ5"ojäté½xŒO“iéÔÑ|ß=;ü‚@'ÍVGÐ0ŽŒ"5ãjÞðÔðl°Ñ}boílšä*'ݳLŠ#!òÁâo«‚ z6‹NMuPAåhDïàBneé”S¤'듼fsKFV$E·³ öUT/…ˆ³­Õkö~ƒ ¶ÒØS–Lñ&‹’¨#-p–‰½ ߎÑuh²AÅ!ÐÁ(ˆÜˆ={öòMÔ<>œo-OÔã²Á‘ˆ$Ï¬Ô ‰^‡h—rÛ‹×ÄöÂÑq)Äœ¸°Â³>±xdY¤&Çœåû/ŒÚž¯'B¸wï!LÑѨˆl5 ~ø0‡ÈO¢™ ç"VÂéÎp¶¬ÁÜÈ‹ãÒ¥KõN_´‚t’&h ç*g݈0 Æž\5ÛOÐ{–Шât2!ŠDœMûô1–ÓHˆ°gS”‡Ì²™áeƒ°âãÄþÅ.ÅáeY ¦‰PuÛF‹"nN{õ²!jŠê‹©ØŒèôõ§åDçÓúHRóð.ëHÙѶRRæDû.'ÐØ,NÏç7V¤:¨xí5ôÎmŠ†åÜ·aˆÕm:¡âK,EiÆIÆ:'Yzvå*9ÂFªÃ‡“Aôì¹ä¡X22Áù¦èÂפ<ý»ÙV4(>Ž(ò»HÊùuN&Xwá³¹ËUµ.9H !×믇CÜÛÃ¥øÅ7YLÕÿQ."Œ™ vÅEq€uÎW‰¼XMPת±IÔ­NÆÕ?úpuÏU#¥®œMÌ ‚ÞhFUŒ¸Õ)Œ"þ/‚Åh"D Œ±ï칑DeTt¹Ú8|«a¥qK¿àÀºðg¤+gsR„TGšB­è®SôÝHÒ¥–'F#y“Ë‹±ÂgF?Å.Åᚢ¼äìÌÛ(+›ŒËï¢êMÌY =fE÷¤¡>ôR=}3ÔþÞ „A1J„Z6È3Úê=¸C•Í¦È0–™c¼²2ûÞ´‘æ”#\y·OfƒtìXŃû­H1ºƒ‘¾»DƒÅHû×7ýòqc dFhQâÝwãõa³¹awþŽ‚œÊA Á0aªu‰¨Ñp7äßÄœ!‰…Hu< <†3¤dʈø²£ó¥d1FtH ŽÊŽ€‘eFµ;TeE“¢©àY7ùZ7jw•® µšÞz3EgÝ°¿C R$BüÕ0JT¯kE“¬P £ö#Š^+Bs3v„À(Ajzø&fÆh o˜+ï&æŠùfÈ-Ä!‰á%@#Áì\EpT™ÅnÒŠò¸šûÌËcYY¬Ì1‚È8à0Œp¨+ssÚA'ND·¨ÁU1„A1Êé팲p ’Œ£0ã~ZÁŠ¾É7M0Ž°[LÞ¥Œ•‡ Eᕸ271çaìÈ#ˆAƒb$Ô;±B85IÆñP¤í µ"äS ¢°"Pd9G,NOðÓ>Ë€0XÙ"ä:y8$ŸÊ  ð<ðÞŠ•äÉQ2Œ‚â¼ý*ŸÚyQdÆažð¿¡RsÃK!Ó)§cuGã3AËBB\t‡±Þpÿ4)I†±‚UF ÑH§(ŸrŒC=M Ç7”¹ŒÄ…—Ý“ŠfCll´Íè2ú†[1͉AÏÁö®Òq[ôß(LÆ‘Ú(*ˆÝ{X¤¤Å’¡^yR%âª\Èuúu¢³¿4É #EJ~&< Ûi¥cHì5EI9¾Ã¼( Òö”66¸;UbqI&_ ©ÌÇ!÷èšàQFšm÷Y®3Ѥ:Št’‘dßy›C¤£ TûÂúa QIÏïCØx$SIŒžAÍBÃ=Ì‘;j⢟1Ž”"‡èͦʉEeTx÷¹jU„´µ1G={{Õ¯8ƒRDèç‡ðizݦ\ô3 òèÉÓÇß`éTdÓýÆXŽÅ!¡á]x­)ðÞQêß?*Àñý{§ŒPDüL|‚ž„‘œÑON‘m#Ê pѤèi¥ÊÖExölgÐٳ濟4!öê§ñãÑpƒ¾ÿœê ‚ê8~.>†îÓwÜAÿ÷ ›È8uô˦`ăñ QeSyǺAÑ.tÖ~ƒÁ¶²ÞS‘Þ¹N-1â‚Þ‰dÇèû†D.4ÇÏÀGáu’ºã5㑦£ÇNk†¬5åsn½4Dvw‰¢»ðW9wá¹Î~áïyÍ„Ø=DÓ…±_ ÏxÚPdOó+,,<ËTXÈ 6žh:uò4t5hx!ŒØ[Ý]b@¼/3®rŒ°s´ð·ÙOŠ[¡"ˆõôð+b¢)DÎ ¢1Îï¦ì '²¢8بn?£Ú‘®rŠ°s¬º ï¢7 2„|lÈm¨R)ò¡<:CAÔûGÌ¿®®RFÞ‹F0|ËËÐ{ËenSϘÍh ¢"4Wªlø¦X…vWw$ +JŠ’£Ñp/±•ö âLr‚B_[š)›1:ÿaÂAEp!´òèyË„¡´á[oËeQ(—.‘W(@ï-­È(Þ-'Ð nq•® ³ h#l¬ˆRÌ#!…˜ a€ ­‰íL¡)¥6d©ôµ½ñ 1Ä»YP~½¢©TžÏa'ë‡dx F'ÎX&ÔÏ#€á™Fñ ÿ]µ°Í`ˆ’)‚û¹³ ìb7[(¼°[µãfCÐAmÃè’Œ0cŒ$ÁÐBxÞ$¨²žô$¯†oóu¼¥Y0O`£ :ûYç¹Bá…ݪƒ0hj;s&c1ùŒ0cŒÄ¬„§¬7!~À‹j™›Ž=¦m(Ê!b(®+UNdb_{"[\£a…v«v ÂìºczŒ0cŒät¬ ý‹|é¸P!d™”WC”Jõ…¥5EÊ…wÀ /ìVí–@øzEBˆÁ3ÆH³kæfÆAXdä&ÄY&å6ô0äÉÔ‘a4¬…C·jG*²QøÆÛ°Â^]3¨H#Ñ¥ðT&„ ‹„ iÕ!“*ŠTz@æ5¢¢ˆÂ;äŠõ†ïòù°[µ£]˜ù1}0ÂS™ZãĆÅH<ýhÂ"› äQááwd5”6Ô>ä DL…·×•]'2ÞªÝ"#øH‡²®…q1’Øq½¡dˆ$Ö±!„td(2éÛÃyC0¢±wŸàðÂnÕŽFø¤>aÆT ZaÆI¦nF"ŒaÈ B)ÔOâLªv› UEdEžçp*<ì ºU;a–ýCÏ›—phŸ)Ælžu JÚ-¢\Šˆ!ö2Ãó¾‘âìLªÃlÈ´wKª³3ñõ Â`xÖ(Ly!T™ôMmÃÆ 6DN±ÅfY »øZØy`¤f#Å!4l¨2ŒúS èAø. T6tJ#*ˆö~çðT÷Td‰°SÄ_D(=+Fçç$|R¿n #t"€‚ BH[R3“©Ôñ!g(œˆÂó½Ñú.Œúq'Z.ôü¤”ÚÅ0Š¡ è ÄÅÛÐÇPøЀˆÂ;ì*Í'é" ¯†-ŒÐ²¡±Ð!(ª~†MvËÃM™§) †&Ä¡ç¼ aÀø¾åJbê=M…ˆ «„`B„ + Ú Q2ÕQxÇ]¥‰0ÁúÑ‚Il˜C„MÖ>Þs ‘$A¡™I+ÔÁmC" ï´«4f5Iƒ0¼)ÍBÝ’6Ä ;ùb‚„¼¡Q %B“!‚HŒ·g+Õ§öY<óãÂm˜"BB,„¶ U*UÛzm~‚ BؤÚY µ ÷b"†Úˆ]†û¨­´—?¥jÂ`†i*â3©¶¡Þšm „<Ú&tªjˆR©!Z)JN¹jååO…±jDz,j_½ÃðŽ€ˆ Î£¡,†Ê†‡Œ{ †Kì•¢¤ÉUº/½ˆ'Øz£Inš=©Å0"ÿGNP›ÐFaC‹¡2" ”—'lJ3©åžvº64"Œò5"(óh yº7*‡&Ã%&®ZuAþùÆLj„þLê0D±Îa‚ái !Τí»ŸQ2]Ò5½ðB&aØ¥1£N¶*Bˆ˜a$Äsˆ 4!Cx !TÅÐe8ÏbQxg\µææ´Ìƒ{ÒôOCãe( žsø;ƒ ‘Gëe@¨Ë¡ÍÐh¸ÏÙÊÉFí4 !4btþoï©°âTêehéŒE›ÐFøºÐL¥ŽQxžÄ‹Ú) |^‡BÌaŒ 5Ä3AH£:6t¢/Ä3ˆÉɉ!ÂfÒTúN|²|؈k‘l%|„çw°éá ¯„!y .Z#!1ò]¼ ˆ`H8ÃàðnøÚ×ï FHÌ_| /#¿É@H*¼/S‹ÑDxŒp‘LÅCsùà•ÁÙ#DÜC¸ ¿Í‰À½\‡áÛ&Bʈ†!\ îO€q!"<‘"ÂŒ1’ Rño/1 RéÆø^lbnßfÃ{ßÄØvÿBßG1¶ñðÞ1¶ñðÞ71æ•W^yå•W^yå•W^yå•W^yå•WKéÿÏ?“¼ùÂ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerPi.html0000644000175000017500000011164614030601040025463 0ustar rusconirusconi QCPAxisTickerPi Class Reference
Public Types | Public Functions | Protected Functions
QCPAxisTickerPi Class Reference

Specialized axis ticker to display ticks in units of an arbitrary constant, for example pi. More...

Inheritance diagram for QCPAxisTickerPi:
Inheritance graph

Public Types

enum  FractionStyle
 
- Public Types inherited from QCPAxisTicker
enum  TickStepStrategy
 

Public Functions

 QCPAxisTickerPi ()
 
QString piSymbol () const
 
double piValue () const
 
bool periodicity () const
 
FractionStyle fractionStyle () const
 
void setPiSymbol (QString symbol)
 
void setPiValue (double pi)
 
void setPeriodicity (int multiplesOfPi)
 
void setFractionStyle (FractionStyle style)
 
- Public Functions inherited from QCPAxisTicker
 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Protected Functions

virtual double getTickStep (const QCPRange &range)
 
virtual int getSubTickCount (double tickStep)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
void simplifyFraction (int &numerator, int &denominator) const
 
QString fractionToString (int numerator, int denominator) const
 
QString unicodeFraction (int numerator, int denominator) const
 
QString unicodeSuperscript (int number) const
 
QString unicodeSubscript (int number) const
 
- Protected Functions inherited from QCPAxisTicker
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Detailed Description

Specialized axis ticker to display ticks in units of an arbitrary constant, for example pi.

axisticker-pi.png

This QCPAxisTicker subclass generates ticks that are expressed with respect to a given symbolic constant with a numerical value specified with setPiValue and an appearance in the tick labels specified with setPiSymbol.

Ticks may be generated at fractions of the symbolic constant. How these fractions appear in the tick label can be configured with setFractionStyle.

The ticker can be created and assigned to an axis like this:

QSharedPointer<QCPAxisTickerPi> piTicker(new QCPAxisTickerPi);
customPlot->xAxis->setTicker(piTicker);

Member Enumeration Documentation

§ FractionStyle

enum QCPAxisTickerPi::FractionStyle

Defines how fractions should be displayed in tick labels.

See also
setFractionStyle
Enumerator
fsFloatingPoint 

Fractions are displayed as regular decimal floating point numbers, e.g. "0.25" or "0.125".

fsAsciiFractions 

Fractions are written as rationals using ASCII characters only, e.g. "1/4" or "1/8".

fsUnicodeFractions 

Fractions are written using sub- and superscript UTF-8 digits and the fraction symbol.

Constructor & Destructor Documentation

§ QCPAxisTickerPi()

QCPAxisTickerPi::QCPAxisTickerPi ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ setPiSymbol()

void QCPAxisTickerPi::setPiSymbol ( QString  symbol)

Sets how the symbol part (which is always a suffix to the number) shall appear in the axis tick label.

If a space shall appear between the number and the symbol, make sure the space is contained in symbol.

§ setPiValue()

void QCPAxisTickerPi::setPiValue ( double  pi)

Sets the numerical value that the symbolic constant has.

This will be used to place the appropriate fractions of the symbol at the respective axis coordinates.

§ setPeriodicity()

void QCPAxisTickerPi::setPeriodicity ( int  multiplesOfPi)

Sets whether the axis labels shall appear periodicly and if so, at which multiplicity of the symbolic constant.

To disable periodicity, set multiplesOfPi to zero.

For example, an axis that identifies 0 with 2pi would set multiplesOfPi to two.

§ setFractionStyle()

void QCPAxisTickerPi::setFractionStyle ( QCPAxisTickerPi::FractionStyle  style)

Sets how the numerical/fractional part preceding the symbolic constant is displayed in tick labels. See FractionStyle for the various options.

§ getTickStep()

double QCPAxisTickerPi::getTickStep ( const QCPRange &  range)
protectedvirtual

Returns the tick step, using the constant's value (setPiValue) as base unit. In consequence the numerical/fractional part preceding the symbolic constant is made to have a readable mantissa.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getSubTickCount()

int QCPAxisTickerPi::getSubTickCount ( double  tickStep)
protectedvirtual

Returns the sub tick count, using the constant's value (setPiValue) as base unit. In consequence the sub ticks divide the numerical/fractional part preceding the symbolic constant reasonably, and not the total tick coordinate.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ getTickLabel()

QString QCPAxisTickerPi::getTickLabel ( double  tick,
const QLocale &  locale,
QChar  formatChar,
int  precision 
)
protectedvirtual

Returns the tick label as a fractional/numerical part and a symbolic string as suffix. The formatting of the fraction is done according to the specified setFractionStyle. The appended symbol is specified with setPiSymbol.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

§ simplifyFraction()

void QCPAxisTickerPi::simplifyFraction ( int &  numerator,
int &  denominator 
) const
protected

Takes the fraction given by numerator and denominator and modifies the values to make sure the fraction is in irreducible form, i.e. numerator and denominator don't share any common factors which could be cancelled.

§ fractionToString()

QString QCPAxisTickerPi::fractionToString ( int  numerator,
int  denominator 
) const
protected

Takes the fraction given by numerator and denominator and returns a string representation. The result depends on the configured fraction style (setFractionStyle).

This method is used to format the numerical/fractional part when generating tick labels. It simplifies the passed fraction to an irreducible form using simplifyFraction and factors out any integer parts of the fraction (e.g. "10/4" becomes "2 1/2").

§ unicodeFraction()

QString QCPAxisTickerPi::unicodeFraction ( int  numerator,
int  denominator 
) const
protected

Returns the unicode string representation of the fraction given by numerator and denominator. This is the representation used in fractionToString when the fraction style (setFractionStyle) is fsUnicodeFractions.

This method doesn't use the single-character common fractions but builds each fraction from a superscript unicode number, the unicode fraction character, and a subscript unicode number.

§ unicodeSuperscript()

QString QCPAxisTickerPi::unicodeSuperscript ( int  number) const
protected

Returns the unicode string representing number as superscript. This is used to build unicode fractions in unicodeFraction.

§ unicodeSubscript()

QString QCPAxisTickerPi::unicodeSubscript ( int  number) const
protected

Returns the unicode string representing number as subscript. This is used to build unicode fractions in unicodeFraction.

The documentation for this class was generated from the following files:
  • src/axis/axistickerpi.h
  • src/axis/axistickerpi.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemText.html0000644000175000017500000021733714030601040024673 0ustar rusconirusconi QCPItemText Class Reference
Public Functions | Public Members | Protected Types | Protected Functions
QCPItemText Class Reference

A text label. More...

Inheritance diagram for QCPItemText:
Inheritance graph

Public Functions

 QCPItemText (QCustomPlot *parentPlot)
 
QColor color () const
 
QColor selectedColor () const
 
QPen pen () const
 
QPen selectedPen () const
 
QBrush brush () const
 
QBrush selectedBrush () const
 
QFont font () const
 
QFont selectedFont () const
 
QString text () const
 
Qt::Alignment positionAlignment () const
 
Qt::Alignment textAlignment () const
 
double rotation () const
 
QMargins padding () const
 
void setColor (const QColor &color)
 
void setSelectedColor (const QColor &color)
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setSelectedBrush (const QBrush &brush)
 
void setFont (const QFont &font)
 
void setSelectedFont (const QFont &font)
 
void setText (const QString &text)
 
void setPositionAlignment (Qt::Alignment alignment)
 
void setTextAlignment (Qt::Alignment alignment)
 
void setRotation (double degrees)
 
void setPadding (const QMargins &padding)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const position
 
QCPItemAnchor *const topLeft
 
QCPItemAnchor *const top
 
QCPItemAnchor *const topRight
 
QCPItemAnchor *const right
 
QCPItemAnchor *const bottomRight
 
QCPItemAnchor *const bottom
 
QCPItemAnchor *const bottomLeft
 
QCPItemAnchor *const left
 

Protected Types

enum  AnchorIndex
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
QPointF getTextDrawPoint (const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const
 
QFont mainFont () const
 
QColor mainColor () const
 
QPen mainPen () const
 
QBrush mainBrush () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A text label.

QCPItemText.png
Text example. Blue dotted circles are anchors, solid blue discs are positions.

Its position is defined by the member position and the setting of setPositionAlignment. The latter controls which part of the text rect shall be aligned with position.

The text alignment itself (i.e. left, center, right) can be controlled with setTextAlignment.

The text may be rotated around the position point with setRotation.

Constructor & Destructor Documentation

§ QCPItemText()

QCPItemText::QCPItemText ( QCustomPlot *  parentPlot)
explicit

Creates a text item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setColor()

void QCPItemText::setColor ( const QColor &  color)

Sets the color of the text.

§ setSelectedColor()

void QCPItemText::setSelectedColor ( const QColor &  color)

Sets the color of the text that will be used when the item is selected.

§ setPen()

void QCPItemText::setPen ( const QPen &  pen)

Sets the pen that will be used do draw a rectangular border around the text. To disable the border, set pen to Qt::NoPen.

See also
setSelectedPen, setBrush, setPadding

§ setSelectedPen()

void QCPItemText::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used do draw a rectangular border around the text, when the item is selected. To disable the border, set pen to Qt::NoPen.

See also
setPen

§ setBrush()

void QCPItemText::setBrush ( const QBrush &  brush)

Sets the brush that will be used do fill the background of the text. To disable the background, set brush to Qt::NoBrush.

See also
setSelectedBrush, setPen, setPadding

§ setSelectedBrush()

void QCPItemText::setSelectedBrush ( const QBrush &  brush)

Sets the brush that will be used do fill the background of the text, when the item is selected. To disable the background, set brush to Qt::NoBrush.

See also
setBrush

§ setFont()

void QCPItemText::setFont ( const QFont &  font)

Sets the font of the text.

See also
setSelectedFont, setColor

§ setSelectedFont()

void QCPItemText::setSelectedFont ( const QFont &  font)

Sets the font of the text that will be used when the item is selected.

See also
setFont

§ setText()

void QCPItemText::setText ( const QString &  text)

Sets the text that will be displayed. Multi-line texts are supported by inserting a line break character, e.g. '
'.

See also
setFont, setColor, setTextAlignment

§ setPositionAlignment()

void QCPItemText::setPositionAlignment ( Qt::Alignment  alignment)

Sets which point of the text rect shall be aligned with position.

Examples:

  • If alignment is Qt::AlignHCenter | Qt::AlignTop, the text will be positioned such that the top of the text rect will be horizontally centered on position.
  • If alignment is Qt::AlignLeft | Qt::AlignBottom, position will indicate the bottom left corner of the text rect.

If you want to control the alignment of (multi-lined) text within the text rect, use setTextAlignment.

§ setTextAlignment()

void QCPItemText::setTextAlignment ( Qt::Alignment  alignment)

Controls how (multi-lined) text is aligned inside the text rect (typically Qt::AlignLeft, Qt::AlignCenter or Qt::AlignRight).

§ setRotation()

void QCPItemText::setRotation ( double  degrees)

Sets the angle in degrees by which the text (and the text rectangle, if visible) will be rotated around position.

§ setPadding()

void QCPItemText::setPadding ( const QMargins &  padding)

Sets the distance between the border of the text rectangle and the text. The appearance (and visibility) of the text rectangle can be controlled with setPen and setBrush.

§ selectTest()

double QCPItemText::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemText::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ anchorPixelPosition()

QPointF QCPItemText::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Returns the pixel position of the anchor with Id anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor).

For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor.

See also
createAnchor

Reimplemented from QCPAbstractItem.

§ getTextDrawPoint()

QPointF QCPItemText::getTextDrawPoint ( const QPointF &  pos,
const QRectF &  rect,
Qt::Alignment  positionAlignment 
) const
protected

Returns the point that must be given to the QPainter::drawText function (which expects the top left point of the text rect), according to the position pos, the text bounding box rect and the requested positionAlignment.

For example, if positionAlignment is Qt::AlignLeft | Qt::AlignBottom the returned point will be shifted upward by the height of rect, starting from pos. So if the text is finally drawn at that point, the lower left corner of the resulting text rect is at pos.

§ mainFont()

QFont QCPItemText::mainFont ( ) const
protected

Returns the font that should be used for drawing text. Returns mFont when the item is not selected and mSelectedFont when it is.

§ mainColor()

QColor QCPItemText::mainColor ( ) const
protected

Returns the color that should be used for drawing text. Returns mColor when the item is not selected and mSelectedColor when it is.

§ mainPen()

QPen QCPItemText::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

§ mainBrush()

QBrush QCPItemText::mainBrush ( ) const
protected

Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is.

The documentation for this class was generated from the following files:
  • src/items/item-text.h
  • src/items/item-text.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_20.png0000644000175000017500000000132614030601042024471 0ustar rusconirusconi‰PNG  IHDR}# Í)gAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>IDAThÞíY;RÃ0]˜È Q®àø©˜a†¡IzÌ L´”4áæ è Œ @ó(,)ZÙ vë¹°¼Ÿ§}’¼ãLNš(NÇ. JÒ£ôA0³ƒ7º»–ApA÷fävý‰>Ç®j|Ò‹Ï|ÇÇØ•ý9æÞxÂïz”>EüéÉßH_QB %´r–fIÌõHDD¯47Ï·=Ëý©ìqw™­€Av(¡QB p–kH€ ±0 4Jãí†îÝqœQláÚéÕÔCº@ÄØ%àÓjç]3o áÉ&_ L䃉\;gô3ì¼kóÄ ]™‘râTáïú)J7] ÍâKÇÃwLb ÂyS3OÈhýõ–,!3 "]°µVÈ‘A mDlÇBé"ðnòBF¾€ko9ø‰Ø[z¿¢m¡ê¡;¥W[YU#/GÁÞΰ·ô~mΧ/¡¡¹C¸9ð5St{—P¨¬!£/Ygh2ì-XšC´ì°ðL{¨¥)°òŽ`g%dÆnï¶IåkȘaóRX)¼ÍåhÇÎÒk¤A»²³—ÿ,}Öÿ àý0CBDWtýëü¤¾öÌÿ7ßðQz”¥Géí`þ@¿ƒgMéwc×4ÎÝè$þÓ:ADéSÄŒžÇ.a,|áúÓ/ZUWÔ%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-time.png0000644000175000017500000000155414030601041024451 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨džIDATxÚíÜ1nÛ0Æñ¯õ=ÒÎx…Àð5²éÉ* c·îí ½E è\ä:HfI‰Œ Ä®øˆÿo²”7¼Ïd,Y‰¼šß»’ÅŒv²Ü0ÉÛ½³À¿bÃ`Fyêåê5ú¨#K;IÈRg–v’ûà3ÞD¯kÙ[ uØ»–9òå$I½|t¤Ì¹´¾iW¹·+jÑÆDrYFyyy Å +Yº9‰—×)TØ™Ë)êÛØjÕIê5JrêåÂÑ¥õN’ÔÍçâúz¤]åzÜ®¨EYgQö-os.N>d²3—N£Æ°a™Z-.4á£7“›KzÎë÷–vµ<Ê«1E.KzÖÎDòYÆE÷öçÒk½¹œ¤°aýÇÕr?Íy^ýŠ^Ô³¤³~F•Ÿô¹X¿·´«ôhJñRE]Ú˜H>Ë=…K‹6ærÔƒìÍåG1×M§r 뽞Wçœîõ I:ê¬é7†×¾ê÷—vµìñ¨óFEMÚ˜H>ËAôUO!‹í¹t’Î!‹¹¼”ë†Sy͆5Ýìô[w‹Ÿ8}Óã<†É9z›­ëkv•ëq»¢mL¤”E’¾HáÒÂò\¤{=&ÇV沕«â©,¯OÝ|ƒ-§Þ» Û×Üvï•ØœH>‹VGvç"Š7¡kÏ"•îaå²V–dZé7ƒœÜÜd7ÿGˆ´¾¹—£a¾á[®¨KYgqó雘‹4D“±6—¿–¹ÕR~ºdúÆà4?=Så3Ùé‘‹>©ÔžbÅîDÖYÜÜ÷ÐÀ\–4X›K¼aÙ^-Ј?ÝŠðž”6n%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/qcp.css0000644000175000017500000002767414030601040022150 0ustar rusconirusconi/*************************************************************************** ** ** ** Doxygen Style Sheet for QCustomPlot documentation ** ** Copyright (C) by Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** ** ****************************************************************************/ body { font: 14px/1.25 "Open Sans", Arial, Helvetica, sans-serif; } p { margin-left: 0.5em; } body { background: none repeat scroll 0 0 #FFFFFF; color: #333333; } a:link, a:visited { color: #00732F; text-decoration: none; } a:hover { color: #45a51c; text-decoration: none; } table { border-collapse: collapse; width: 100%; } table.params tbody tr td.paramname { padding-right: 1em; } table.params tbody tr td { padding-bottom: 0.4em; } table.memberdecls { background-color: #F6F6F6; border: 1px solid #E6E6E6; border-collapse: separate; -moz-border-radius: 7px; -webkit-border-radius: 7px; border-radius: 7px; font-size: 12px; max-width: 1400px; padding: 1em 1em 0; margin-bottom: 15px; } table.memberdecls h2 { font-size: 140%; margin: 0 0 0.3em; padding: 0 0 0 0; } table.memberdecls tr:last-child td.memSeparator { display:none; } table.memberdecls td.memSeparator { border-bottom: 1px dotted #ccc; height: 0; line-height: 0; margin: 0; padding: 0; } table.memberdecls td { padding: 2px 0; } div.image { text-align: center; } div.title { font-size: 160%; font-weight: bold; text-align: center; } div.memdoc dl dd table { background-color: #F6F6F6; border: 1px solid #E6E6E6; border-collapse: collapse; font-size: 90%; } div.memdoc dl dd table tbody tr td { padding: 0.25em 0; vertical-align: middle; } div.memdoc dl dd table tbody tr td em { font-family: monospace; font-style: normal; padding-left: 1em; } div.memdoc dl dd table.params tbody tr td em { font-family: Arial,Geneva,Helvetica,sans-serif; font-style: italic; padding-left: 0; } div.memdoc dl dd table tbody tr td p { margin: 0; } div.memdoc dl dd table tbody tr td p code { margin-right: 2em; } h1 { font-size: 130%; margin: 1.8em 0 1em; } h2 { font-size: 120%; margin: 1em 0; } h3 { font-size: 100%; } h3.version { font-size: 90%; text-align: center; } a.headerLink:hover { background-color: #fff; text-decoration: none; } a.headerLink { background: none repeat scroll 0 0 #f6f6f6; border: 1px solid #ddd; -moz-border-radius: 7px; -webkit-border-radius: 7px; border-radius: 7px; font-size: 14px; font-weight: bold; line-height: 2.2em; padding: 0.3em 0.5em; white-space: nowrap; } div.header { margin-bottom: 1em; vertical-align: middle; } div.header img { border: medium none; margin: 0 1em 0 6px; vertical-align: middle; } div#top { margin-bottom: 0.5em; } hr { -moz-border-bottom-colors: none; -moz-border-left-colors: none; -moz-border-right-colors: none; -moz-border-top-colors: none; border-color: #A0A0A0 -moz-use-text-color -moz-use-text-color; border-image: none; border-right: medium none; border-style: solid none none; border-width: 1px medium medium; height: 0; margin: 1.8em 0 1.6em; } table h2 { margin: 1.3em 0 0.8em; padding: 1.3em 0 0; } div.navpath { font-size: 160%; font-weight: 700; margin: 0 0 0.8em; text-align: center; } div.navpath:after { content: " Class Reference"; } div.navpath + div.contents > h1 { display: none; } div.contents > p > code { background: none repeat scroll 0 0 #F1F1F1; border: 1px solid #E7E7E7; color: #000000; display: block; padding: 0.2em; } tr.inherit_header > td{ font-size: 110%; font-weight: 700; padding: 2em 0 0.3em 0; } tr.inherit_header > td > img{ display: none; } /* td.memItemLeft, td.memItemRight, td.memTemplItemLeft, td.memTemplItemRight, td.memTemplParams { margin: 4px; padding: 1px 0 0 8px; } */ td.memItemLeft, td.memTemplItemLeft, td.memTemplParams { white-space: nowrap; } td.memItemLeft, td.memTemplItemLeft { width: 10%; } td.memItemRight .el { font-weight: 700; } /* hide brief method descriptions in table of methods at top of class pages */ td.mdescLeft, td.mdescRight { display: none; } div.memitem { margin: 0 0 2em; padding: 0; } h2.memtitle { display: none; } div.memproto { background-color: #F6F6F6; border: 1px solid #E6E6E6; -moz-border-radius: 7px; -webkit-border-radius: 7px; border-radius: 7px; font: bold 14px/1.2 Arial,FreeSans,sans-serif; padding: 3px 5px; } td.fieldname { padding-right: 1em; width: 1%; white-space: nowrap; } td.fieldname > em { font-family: monospace; font-style: normal; font-size: 0.85em; } td.fielddoc > p { margin: 0.2em; position: relative; padding-left: 4.4em; } td.fielddoc div.image { position: relative; } td.fielddoc img { position: absolute; left: 1em; top: 0; } td.fielddoc > p > code { position: absolute; left: 0; top: 0; } table.fieldtable { background-color: #f6f6f6; border: 1px solid #e6e6e6; -moz-border-radius: 7px; -webkit-border-radius: 7px; border-radius: 7px; padding: 3px 5px; margin-left: 2em; width: 90%; max-width: 60em; padding: 0.5em 0.5em 0; border-collapse: separate; } table.fieldtable th { background: none repeat scroll 0 0 #e5e5e5; -moz-border-radius: 4px; -webkit-border-radius: 4px; border-radius: 4px; padding: 0.3em 0; } table.fieldtable tr:last-child td { border-bottom: none; } table.fieldtable td { border-bottom: 1px dotted #ccc; } div.memdoc { } table.memname { display: block; } table.memname * { display: inline; } table.memname tr + tr { white-space: nowrap; } table.memname td { white-space: nowrap; } td.paramname code { font: inherit; } .memtemplate { color: #606060; font-size: 80%; font-weight: 400; margin-left: 3px; } .memnav { background-color: #E8EEF2; border: 1px solid #84B0C7; margin: 2px 15px 2px 2px; padding: 2px; text-align: center; } tr.memlist td { background-color: #EEEEEE; border-color: #FFFFFF; border-style: solid; border-width: 4px 2px; padding: 0.1em 0.3em; } tr[bgcolor="#f0f0f0"] td { background-color: #EEEEEE; border-color: #FFFFFF; border-style: solid; border-width: 4px 2px; padding: 0.1em 0.3em; } td.indexkey { font-weight: 700; padding: 1em 0.25em 0.2em 0; text-align: right; vertical-align: top; width: 180px; } td.indexvalue { padding: 1em 0 0.2em 0.25em; text-align: left; vertical-align: top; } tr + tr td.indexkey { padding-top: 0.2em; } tr + tr td.indexvalue { padding-top: 0.2em; } td.mlabels-right { text-align: right; } .title span.mlabel { color: #a0a0a0; font-size: 0.7em; font-style: italic; } span.mlabel { margin-left: 1em; } div.tabs ul { display: block; list-style-type: none; margin: 0; padding: 0; } div.tabs li { display: none; margin: 0; padding: 0; } div.tabs li.current { display: block; font-size: 160%; font-weight: 700; margin: 0; text-align: center; } div.tabs li.current a { color: #000000; } div.tabs + div.contents { visibility: hidden; } div.tabs + div.contents > ul { list-style-type: none; margin: 0; padding: 0; visibility: visible; } div.tabs + div.contents > ul li { font-weight: 700; margin: 0.1em 0; padding: 0 0 0 2em; text-indent: -2em; } div.tabs + div.contents > ul a { font-weight: 400; } div.tabs + div.contents h3 { display: none; } table.doxtable { width: auto; } table.doxtable th { -moz-border-bottom-colors: none; -moz-border-left-colors: none; -moz-border-right-colors: none; -moz-border-top-colors: none; background-color: #666666; border-color: #666666 #666666 -moz-use-text-color; border-image: none; border-style: solid solid hidden; border-width: 1px 1px medium; color: #FFFFFF; padding: 4px 4px 5px; } table.doxtable td { background-color: #F6F6F6; border: 1px solid #E6E6E6; border-collapse: collapse; font-size: 90%; } dl.see { } dt { font-weight: 700; } div.multicol { -moz-column-count: 3; -moz-column-gap: 1em; } p.startli, p.startdd, p.starttd { margin-top: 2px; } p.endli { margin-bottom: 0; } p.enddd { margin-bottom: 4px; } p.endtd { margin-bottom: 2px; } caption { font-weight: 700; } span.legend { font-size: 70%; text-align: center; } div.qindex, div.navtab { background-color: #E8EEF2; border: 1px solid #84B0C7; margin: 2px; padding: 2px; text-align: center; } div.qindex { line-height: 140%; width: 100%; } div.navtab { margin-right: 15px; } a.qindex { font-weight: 700; } a.qindexHL { background-color: #6666CC; border: 1px double #9295C2; color: #FFFFFF; font-weight: 700; } .contents a.qindexHL:visited { color: #FFFFFF; } a.code { color: #3030F0; } a.codeRef { color: #3030F0; } dl.el { margin-left: -1cm; } .fragment { background-color: #F5F5F5; border: 1px solid #CCCCCC; font-family: monospace; font-size: 9pt; line-height: 125%; margin: 4px 8px 4px 2px; overflow: auto; padding: 4px 16px; word-wrap: break-word; } pre.fragment { background-color: #F5F5F5; border: 1px solid #CCCCCC; font-size: 9pt; line-height: 125%; margin: 4px 8px 4px 2px; overflow: auto; padding: 4px 6px; word-wrap: break-word; } div.fragment div.line { white-space: pre; } div.ah { background-color: #000000; color: #FFFFFF; font-weight: 700; margin-bottom: 3px; margin-top: 3px; } h2.groupheader { font-weight: 700; font-size: 170%; margin-bottom: 0.8em; margin-left: 0.8em; margin-top: 1.8em; } div.groupText { font-style: italic; margin-left: 16px; } p.formulaDsp { text-align: center; } img.formulaDsp { } img.formulaInl { vertical-align: middle; } div.center { margin-bottom: 0; margin-top: 0; padding: 0; text-align: center; } div.center img { border: 0 none; } .permalink { display:none; } span.keyword { color: #008000; } span.keywordtype { color: #604020; } span.keywordflow { color: #E08000; } span.comment { color: #800000; } span.preprocessor { color: #806020; } span.stringliteral { color: #002080; } span.charliteral { color: #008080; } span.vhdldigit { color: #FF00FF; } span.vhdlchar { color: #000000; } span.vhdlkeyword { color: #700070; } span.vhdllogic { color: #FF0000; } .overload { font-family: "courier new",courier,monospace; font-weight: normal; font-size: 65%; color: #A0A0A0; } .arrow { color: #9CAFD4; -webkit-user-select: none; -khtml-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none; cursor: pointer; font-size: 80%; display: inline-block; width: 16px; height: 22px; } .icon { font-family: Arial, Helvetica; font-weight: bold; font-size: 12px; height: 14px; width: 16px; display: inline-block; background-color: #728DC1; color: white; text-align: center; border-radius: 4px; margin-left: 2px; margin-right: 2px; } .icona { width: 24px; height: 22px; display: inline-block; } .search { color: #003399; font-weight: 700; } form.search { margin-bottom: 0; margin-top: 0; } input.search { background-color: #E8EEF2; color: #000080; font-size: 75%; font-weight: 400; } td.tiny { font-size: 75%; } .dirtab { border: 1px solid #84B0C7; border-collapse: collapse; padding: 4px; } th.dirtab { background: none repeat scroll 0 0 #E8EEF2; font-weight: 700; } qcustomplot-2.1.0+dfsg1/documentation/html/open.png0000644000175000017500000000041414030601042022303 0ustar rusconirusconi‰PNG  IHDR ÿîƒgAMA† 1è–_ PLTE2JŽÿÿÿÕªè”tRNS@æØfbKGDf |d pHYsHHFÉk>IDAT×c`@¡¡ ¢¡ ¬! Œ@t?ØÃÓo%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssPeace.png0000644000175000017500000000050714030601041022727 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+yIDAT(ϵ‘Ñ „ çÙÔ"]¸åP¥ØÈ+À$È™»Ü‡»!„e– Ä×Xà_`Ÿ Ꙩc*©W‡m#w¤•@ A?Ï—äÊÀÖ¬wI#r“ÌÃIƒCÁ$LÆ”O‡„)­³<Ýâç;\÷µ^ø¬)NÚÍ&ŒËî.%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPStatisticalBox__inherit__graph.png0000644000175000017500000000477614030601041031110 0ustar rusconirusconi‰PNG  IHDRPû±pgAMA† 1è–_0PLTEÿÿÿÒÒÔiiiQQQ­­·………ççè///ÕÕä,!!Wii™­­ÊCCzìY3ßbKGDˆH pHYsHHFÉk>õIDATxÚí=LGÇç`ÁLPŠHnÎæ0BiNø,@iÖìÀù¨H|QR¤@–;7ÖZ[nPÀqœ8RdŸ„K wI‘o'^;U"ÑÐ$÷nœÚMޛ݃åØ[öëfö¬÷Gp{;»³?fvÞcñÿÆH$Rú9Yg•€–£ƒj@£ŸB š=P >õl€Öø"ëæsŒó%-Ë Ý•»+O_eú=Ó Z 6@Ï Pn˜,??—µš®ñ’VŸgz®XÉè{ÌÔQS+õÆÖu ÒÐ)]{ô€é]Ÿ”3ÊaáNàè–8ס¡Œ_3YžЃ©7¤6½ÁŒIvI¼1¾pA‡™zÐÃÅä€Þ¬3sž{»o*÷Ü©?;¢ô cÜ`UaôöÃV‰sìeÎmáØ @YÙÔ㾟ìZDËu%W€æû®GíB/6H#ßÙ^`ýh‰g#:q¯àŒ¨Éª¸‰Þ~VÅ/ØËì°Ó4±† èãPΗG» hb¯?D:×|/îÑ sÜíø½9ò›@á<áé_€÷ÐO7œ"6qbØe†;qW£ @Ý÷9Ó ½5g„ùÞ½»@ùÍSïÞ“.(:ûŦðöëtq›6´œzû¾§ÀÆpZÏcEƒc¾Ç©ËVLý<|:ò›S§~ >nÖ©Þ~]Â^(4ÁÔCƒ½ë³˜<î{ˆ&.”/õqÇ|‹IlŠÅÄêz]tä7…§(,¦>Þ'œýîb* Ð>Ž½ (6‰ÅT›Á7<ù¸ï£É/à××uÙÚlBÏ‹‹$3¿eË0"ïáE^%ê"‡]´Ýƒ>ÂE^Ê°÷öÂE¾OØÇi)ÎîJövd˜úÏØOoÿ“¨‡ÓÏÚœÄeìCöp’vvÙŽ„ ™üß0ªI–Âý'ð¹Û~P»³ûÜœýB¤Ð@üý©DNÆ^¿ŠyâàöšTÐÁ¸!*öwW1CÔ€„¸tT½±BTB“lÅ Qg~•Î ƒ³ùœ„™"¦îGQ{Éro\E^À±CEBE¾®ôÐÔPÄ™Œq¯¤¤h!ª?ÆêKK‘BÔK…Å…Q©w{Kh”ÛNQhj(ôB>-=É7]?lˆRä*äŒ~§ü?å·F†¤>ø+TÔ‘üüá«0!Jöó‡¿B„(eI>"†üç¢T<øë„•è÷*©*8D©yþðW`ˆRœä((D©zþðW@ˆÊHhjh§Žºçµú)Nåó‡¿Z,•ÏþòQjŸ?üå;vY M å|âú ‚$o¦mipõMÚ åH~…Ð*RmÏDu(¶4zM4Ð5è®æÍÿt»@Õh¾¼(4QM:˜»uI Ij ´_6hœš© Ij dN}¢š\Læ¢Ð$5bmÉ O‰k šE)ôÕBÓfPoÍßUn4rå‘’:Ü:ôg7–‘.Ô[óW}wå0©G mã´F–—š«±£5ó8\˜Ô1Í;‰ë‘4Q¨ ×øðC6#B=7œ#áŒÚ º^gGkþjËnRn'ñc…—ØÁ!NÜ+tMœäi:GÂgqt­­ ]³Âï­ùËÍTݤ„Nâǟľ‘…~=LJËþÄ‘ÐC~rV¨·æ±wܤoÝÄ¿à¤~Ø/j{±h ΘÞpŽ”Ê÷ÖüYw“:艦wˆ…©ß¸p³<–ý‰#qêÇÖÚ ê,&oÍ_™Ÿg"©cšw?,&ÌòpÎãbcbx²?q¤ŒÅÔPZ5™ÈLJ ÚÙ µEµÔA£üjüg•¿ lýëg€:âÏP0,{y¥!œ^'.x’¤NùëCm/¥LIX¨¦š!”°šò…jˆ0ºž¸S’^§Pç(EXžª $$²NI©£MAâu²ÚßßÞßWMN³:(((ª P%P%P%P%Pí(f]úæ‚Þ ¶5üܼ$´œ¨° ÔJ “@ 4c õ u¾iÝâU‹óW9ß4]®Šç·LhW zcîâœU»2iUf*æèÅŠéÀÃq„ý3¥ æ¦U·ªˆ²Z1§,X‹Ï™¼RQÆ—U^è*7V6o+²Ê– 3À6fáˆÖpÎMexuvàÔ›£ÅÕ¹Ú”bP¼gŠã¦uWf? SÎQsªl• åSï`ú-óaY¬¢™YTì0± @kª@a1UÅW¿2 0æ•" qeåB _`êq‡3¢8õuESžôLÿ ¿Å‹VQ,&|Å„;Ä=ªt1YÖŠñ&e&%P%P‰ òz5ÑŸ§-É%‘H~úFæ%³‰ñÅ%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_g.html0000644000175000017500000004020614030601037024047 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- g -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemStraightLine__inherit__graph.png0000644000175000017500000000227514030601041031357 0ustar rusconirusconi‰PNG  IHDR•³ryCWgAMA† 1è–_0PLTEÿÿÿÿÿÿiii111OOQ™™™………ççè±±µÓÓÕ*P4nn^Ù#tRNSªvå’bKGDˆH pHYsHHFÉk>§IDAThÞíÛ¿OÛ@pþ„^‚#R„hFéVféFe‰‘³ýÂQ&@HtäO(`tŒ Ú¡BêÒ !–ª+CUÓŠ¿¡Rw†¾óÅ`NÎäT º.þñáîqÊW¢h«g}ƺ·Uš(\“yV9(lA®å^—m¬nE ±”­ 4ñ"X´`NÜØ“eoGµ’ÿѱª+=[>)Q«&îØOn„%û_Ü9Ò> áÀ"Ç°¦d-Aj!Òš×õÉrùM<‘pϱÈÔ.-fÉ~Ù@#2kà‰’xƳ@ͺ^cÒÿµêŽÀ)±^îKk¡hï¥Åö謕_ kÛ“kœøêÛ8Ƶ¬„”dÐõѪ€—ö¾¦dâíÜÜÕW$§Šï{XÔgå—±£Å+Ïz^Ï©±³¼3<+·†~ª\¥f}Š×´Y—ñ¹6ë"þ®ËªÆñ/]ÖpŸé²†â8ÞÑd}Cë&ë­sMÖZ?ôXƒH©ü"U¬aa)¼‹T¬ÊoQz,,•­j,cËXÆ2–±Œe¬ÿÁꜭžªd¬WÖ=²ÕöŒõÚr”{W¥Ÿ¹uWŒ©ne³Õ¨–Z4«SKÑÊf«®Ó›•ÉV«³ó"Ï+AÓ*£ÕcÀ!tçðÔh[Î×ne²Õ’3•äŒïEè(£ÕÉ9/¶†»a[ÆškÁ\¹6"òÏþ@´­­¶Ö(ÂÖy|PÅ5’€#´Èç@2ZM­£dÐÅÊd«Ë¤¼ˆk,Däm+ZÅ5âÐ:ak7+“­22@±÷ì¹Ge´zbØ2lífÝÎV»×?ëŸX÷ÈVÛ2Ö++7[휯f3V“¯¦eòÕB–ÉW Y&_5–±Œe,cËXÆ2ÖCZ‡ÝcÏÓî—ÔËîá#íu9Òâ*2V^±î–3|B°e¯·ñË2øáC|åX[ͱ¯,p6ÊnXA}åæTR+^Ñ ÷x(.]gQÌÆ鹡rÏ CÏ˘Hæ…£uøú›_ú| ­†¸(µÄvX£¸Š%KkõÅÆ—ŒGÓ¶´Ø•%F;úµyÕ{ù'êLZͺ+&À£%W®1RkcÜî°'ËÅÞÏHËÃá9Wö^‰ö3q ¼k¯nø uÝÕ·ï[[@‹•WÆzxKãߡݺŽ:xÿÃò¨,-OêÅ_V‡#•%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLegend__inherit__graph.png0000644000175000017500000000251614030601041027337 0ustar rusconirusconi‰PNG  IHDR‹Cøûà¡gAMA† 1è–_-PLTEÿÿÿÿÿÿ222iiiSSU°°´………ççèÔÔÖP*4nn·eL‰tRNSªvå’bKGDˆH pHYsHHFÉk>;IDATxÚíÛMkAð^üÓdú "”@½™Öµâ-¶ íÍÙì×â¥Ø‚ƒˆàÍš•í±¥E/AD ^zï'ÐEð^½û!œÙM£Mæ5»h”ç t§ÙìyÙòg2Aʨ‰ d,˜…eçjHpV¼º„ ‡RAæ÷b„Pf Z„ø°EᾸfTÆß‹ÕðMÎîaBRe´!^|”]댽ð"Ò!  MÉ{xib6É£]~}¯73,$*O|ÒäOÆ$8¨SrëY3 Æ“{€Ÿ¨Š¿ü,02¿•MDø–ѵºp¡G9³é0Å9°hWî<Ì^-ÔòǺՂïðçmÞù€‘&™óBÎLAíbŠ&†Úþå5ž½AåtÃV)Œºù; ¸—Œé¬)êt[u¦-a”uvb|‰3“~+ƒ™O¿–Á¼K¿”ÁüHÓý˜Ó4=/Î̦izRœ¹Ê™ÏÅ™yΗÊÌ|âŒq©Ì _¨4ífÎs^˜ù.j«0Çe~ 2È ƒ 2È ƒ 2JÆø=4Ç‚qü†â?Á¸ɼ\ddÁÛ0£ ü(éÖC%Œ.ð£Q—™‘~ϳ®1€Œ™ó"À]häïá#ü®/¦7(ÿ‡Áa¯Ád½‘~Ý=FôFXø£×`úA] ü83Ûgºâë7´SL~üø ÂFÛÙ³yüÇú ÚV,ø`à7ͧØØ$ds“Ǭߘ”L±Kàçt«?'ƶùSÌß`ü'eàgÌýúñæ~…Ìý”…¹Ÿº0÷CdAd7¦jû­è˜JÓ6ì µLÝ<€¼)Æè3@kFŸZ3ú КÑg€îŒ4aP² Ð}Š‰,t[pehÍXd€£ÝÅCà¿÷žBFÆXg}ZfÚ:÷ÛÐ1ÒÂÜOY˜û) s?uaî‡ 2È ƒ 2È 3>LUÍiöû­ 2ö‰Ÿ,ýûÅÔÍ].ddÅ´Œ!ñ‹³ïßÔÈè¿™ðø•Uo »þøÒJžzÆ°ëŸ!Í.%K–Œ|×_—ŠüRñ;]ËAIwý5ø fÁè¿jx|%cLƒ2$~~6Vó;îú³¿‹µ»þÆå=…Œ;3ÒN¿!fZ½O³ßocÑæ~ÊÂÜOY˜û© s?dAdA™1cäáŸ<÷[Q3._ñB %Ö…Œ¬"Kf‚$©Áb ­$©mï,îk·ãN­$»Q¼˜$qâ‹k|xÜOb/Hü¦-&(^çLÞ›¥»Q|Ó˵¤¹êÌäsÀÿóóCœ„÷AeògÄ!qa²)nñ)ΙeÞâƒÎت¿àI6¢UX|ͧxU<;Lq’xë‹ÜñJ¹‹ùd—ýf@f ˜r>4áŸ~ßͧ¦Eý§L)uí'÷îóS`à%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTicker__inherit__graph.png0000644000175000017500000000656214030601041030214 0ustar rusconirusconi‰PNG  IHDR@µ¤ÂÀgAMA† 1è–_0PLTEÿÿÿÿÿÿiiiOOZ¡¡µ………èèì,,,ÑÑØ®®Ë""X*7cc“ºItRNSªvå’bKGDˆH pHYsHHFÉk> \IDATxÚíÝ]lÉpúÐÇNb›ÅÎÕ2XJ‘Ú‡9!¨*Ý:ë3†ëCh$Ð8å­Rs‡>í!õª:-´§‹ˆZ,¥¯á©9N¥º‡U¨Ní9<\á¡Íºº¸ê.kU ªMÒÎÌÆŽíýš™ýÏz[y@&ëuÖ?fvf?þ³3ûPÄÓ¾~ÀvsCG@S8<郎AomeÕ¾ãZ¡¬6Ó^A¥LËÓ4-ÖÔ´Iò}³½6 `öíRf(÷“±˜2…ÆÇlYתsù6Ð!cåshHeÈ7ÿLyùÄÌÐ/Õ!’©*~禆ԥÌMíRlJUQç\FÓ’ãkmQ;¬eè’TàI”TcU T¦†Æ^R^,•ÕØÛw,±2:•C/Í©±ãxy ¡ýj ŸÍîçŠs*] ¨½2œ9„–N"õ@1cNâ]/ƒ÷>òÌâŸÈh­=ÿ¨t)¤"FKšVýÊËøËïN´¹Sä5F–³(÷ ÄÿºV%è’T`»’ ô=\|¹lY=ðÕR»ˆÕlíÈoÈJõçyTxWÕ†ßéÒ%©Àv3ƒPퟘŒ©q-g–p%‰Ÿº©ebV33UTàJ’ëÒ%©@„*e ­ uà8þ5ÐLÜK猃SMâe§ñ'ˆíÈ&êë—@6$ ¸`>(ÃlIpÅøÔ¦¤WÿÛ– àÎú4ÜÆ$A}€o‚úà+ë5ÐíAW`óxµ± ü?†¦›ÿöÁSõ¡} @åü—à>PཿÁû ñõj¤‰æ¦P©ÿQ†(e¦µH“õM9>(àÎI> `|½i ­€o ăþ¸÷§j @{ç‚n2 t¨ÁÑÞ³×àHÓç‘Ö'íï1U§7càÀy§c°dïUZp`ªYs2Geæà›_8½›Û}eÇÈJ¼Ò*ÀÀ´ó1βFq“•xaø×Ð@—“˜ oÔ8FVÒ…%Xà¼ËYjoûEc¯$ ÀÀd}Ú È5Æ;^‰ ‹ø¶ÛupO3ã5ÆËÃx%^®$‰fÙ j Üv½ÑC]zÝuU4€Û“ÑÆ=.„#ôºÐŒpþ‘ÇÊ•µéhç=ïU*Ž§í4Û ø® ÆŒGƒoÁò©…zãûbÛßKbÀd³Êð¡ãÃǤY2ðƒú:DLBÈ$ûÊ>1 .ÀdŸ Ð?”}‚@¿ LƒeŸÐ/o™k`> w*[ °b@ï LÔÆü@Ï üÀ|ZeÝ$ â•3pýe„×Ý30¹X{EÊZÍmU¢Y{E#®çióiÞÇ t»Ù[?ðÝO8âv%2Ó€ßýD€n¸ÞE ˜v¾N^în$ ÜÞtôX•åã:g`¢.¥úŠßXuR›Oåñø€© ‡7$5/"ÀÛ«ö÷n™Î‘EŒulˆ¨8ÜP]i¼æüá@c­cCÀyûiŠkóèîL¶ãg ý4aƽyî0n;Êyõ¦íÐÖH{öö hk¤w<oâcQ`O#­xû8#Æ=R`²»‘V.øt ¯ÿ½ÛçwzÀ1F¿Õj_³Â¸±[ëùæoĽëJd¦Õ®3iÿü㣓ø“e[0– 8b<élc”ó §W¼ã@À÷ ã1§;b¨ˆ· Ên×X}œc\ÐA*‰i9QØo¬²úÄ"Ƹ1¦°ÏhTzÇxÄê;Ôáæ\§ÀJàW†úØJœÀ¯àY„>Âÿ0_… |þÄ%MvÅÏX¿#L`Ý0È™Ìm’‘L½¹÷lÍ ¨àF¦ŒÏLº+ú}:yñ\Óh|òzˆÀ´Ñ¸„ÿ¹nдٹênµû¿rqkÍ06^ÿ µˆGHAŠ•µŽ5Ë\R®Æƃçek(ZL>ce}çSúJ|{גߦ>ÜpÓtí?Ÿ˜Fãþó÷¶;+&¶E‹)í©ê?w-åȦˆËµÙ*W‰ :wÊQŸñäκæýçÕÀpà²Ugp¹Öd_µ|ÊruâÀïî¥ûØÝÊo™Ì(à­¨ëm±¤åõ©3-S WÙ’˜Ãµ7ÊÃNž:óVþàÑÒlE?j˺^ N׶¤Þ[íõ+…Ò"Î3=;›Ï]^¼r´@3µ@ÞÑôBv1«)U {ÀPÒ0§ÏJ£8[¹R(Îæ§F ¥Ó‡,àĨž+êÇJ/êýjùÒbEÏæôÂå‰30§ëÚ¢®iôýî1.Qmt õÃm`1G^Kzÿ€¸’,ÒJ¢ë7ôË¿ÊWF —Nµ‹¸P=BWö Ønfp+§¿5a«$Wr‡èʾu}|”ùH² ü0Ø—ó9¦¶ÌõÀß/øûµ°u\éUz(Ž0p÷l毑æëøPæ¹t `.E… r5òÃH~F/…2‘âWuD¸J6ñÞÅs¦¼‹“}Ýce9¤o­“×oÒËöû§wßüþÕ„iL¶6sí¹§Ð¾l'IxhêL/Ð'ôáÒóV½½Ô±&anv,µJ»u,:4ugÀ‡ ˜2 2‚BÜv•c¢ÜûYRÚM«´E‡ëù=†Ûo¦uˈV[†c½‚Kû§¡qá6¦IQãô¦ï ÷àŒÐ€ïÖºѾ[ÄÞûGh@zú©•…]´D‡¦æ¦w«¯b—Ù;¹qM=*­Úqï‚ìBÞ¡©¯ª¢9Hw¾MDnSO",Üä2‡ŒU4I¬îsúÃr± y‡¦¾*| Ê{‹ŒBΡ©샸ú~|oµc™MÈ=45&’¿i…EÈ;4u ªövëYa¨ËœCS"[Ǩ[³Œ@¨^ëš~ƒD…w6c¥Þ>ü ~°ÉÞî ¦÷@°aÑG«=o¤½…¡¶;æÞÂн¼={(‡tèæ®» â󛶷RõÇe·/ ‹žÕHºv„ó¹Üö„ZˆœR`®µ%. óWòž%á&÷ö47ÝsÝC¦˜p¹³°l€ŒèüD "fYON [Ê{,‡÷¹:·,ÄMvW§Ÿ¾Ý™Qd<Ù)ðð©Ç(332ª 70í¼¹e>è?ÐåÙº]=üŽÈô©%w‡ä"ï1ag ØbŽx‡@G1ÂgXÝÔÈbÆý¢°wÇ ŒÄáÜ¿;%àÓúf!R¶ †#Ç7 épB {¢0ÍЀdbµ_@ÏÃI;-Ô×ÿÝ/ KâLœ17¦ûôÛ [ÁâqÃ2¦½;_›Ç¸3à#<8Ýöª'pŒm+þ¿- L{ƒ zÇkª(^Y ºç1Â_°yŒ€I!þø‚űö#$*$Ðk”IÎ`qû'X â~æÊ,&³±ðꊦB=Nþ9ƒÅˆLYLWƒæ Ç`»œÁbkÊb²˜ |zYƒÅÖ”Åt5,е©á Ó)‹É˜Ô§ Éæ´5XL§,&cRWT` Û ãÁæ1†ºœÕDâPg¥´c=‰Ðirh“]ý0#Dógÿ‘¢m{„,ZÀTóR´aÀyŒ¡h»·‹Šp°Ø2†¦œj2Lš+l^Ú\\PÓÁmK˜Ï˜tšl(J@i3êÁMê¸"çY^Ài1eL+ L™¾û DqòLB”hYÂܧ°ÓïÀw­€*uðÙ'g€NÕ¡{@Ï¡ðíÜg J›¯߈L º ›‡ð@ßþË}úõ_î?txt)@ÜÚ€ -8D¿$ ™¢fhi@\™ÇŠåoˆÓ<±-Elþb{ŠÀ\aàèŸÔ¾9¢Å±¾¹£ÅaÙ£Åø¢vXË$Ç aÙ£Å8Wœ#Qã¾}£Åøø‡dãWRÐT"=ZÜ¿&=ZÜ&Çsaû>±?P8 €à8z§`ÑbM >±O 4u÷ˆÔòî,¥ðÿtw–þ ˜S=—[m>N%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_p.html0000644000175000017500000001147214030601037025076 0ustar rusconirusconi Data Fields - Functions
 

- p -

qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemEllipse.png0000644000175000017500000001105414030601041024123 0ustar rusconirusconi‰PNG  IHDR,Èe,ggAMA† 1è–_ÀPLTEÿÿÿ÷øýiVè**ìÑÑæžñþèçòÿÿ›¡¥Y_X.3- Ð(#]5M,™©° ³Gd9iYÐsŸç™Ñe¤‚¼h %œ[f¡”æ óžåƒžÅ¢[îµòÿþæÿpØÿÕÿÐeÿ /ÿéþÿ3ÿSÿzàŠæ“éÿ. ù/–ÿF´ÿôµÿQÎ*›‚n+óá¡þÐúÿUïZÈûÖÿW”iØiÔÿŠäLŒþQÊðLbKGDˆH pHYsÃÃÇo¨d“IDATxÚí] {šÊa@4j4GOLlb“æÕ˜súÿÿÕÝ{_A¼®¯i ZgXì½f1 A8á„N8á„N8á„š@”±!shHI){o3BUÅf£U|; MªXöîfƒ"7 ‡}`mÔ›«¦"¨š¦É’TpCa*²÷8$U®´†TP"Êm`1-D‡† [ÚN³ì]ßJCF²¤F¾G\t€!Ó¢`È4Mõ»»ã&ÒFÙ[¦­·yœ[òCCÓZ¢’[Ÿ›mÝ ™èöÎú+ /Ï{]›ñiºS6 )ÑRš²œOÅj¶mäɲ×Iê÷Gc j¼¾½Þ5²Z0&©¢¬å„Ž»lÚ½‹þf ½¡ïË»gŒ1S¯~RŠYÏèMÌ<«{Öÿþî·{6f´ë=¾Ø v2ï;¢Òᢋ´ë5 oêû­w'ÜODø“ü }¯ô?42ò%Ïsÿ8¤Ar®\ ¨6yñ_G©¿ªK-¾#‰OõQ€žµ'áV½ÈzVÅ)F~pY¤AÞªïñ/hSº_­ÂÈrÈ År®\HJFÑ•æÍ/BÚÒ¦Ïr!ó¬*ðê2‘u«©ª6cdM…¬75Vådsï3 ’u¥Éq‡ä hûÑ6ÇwÚ­9lý¹Ï—™ °C¨\8ŠhðR·¿!k UšŒ´áA;¶‘¬Œ˜ ¸à(g=*4”KjBhƒœv5;0 {Pç[EËÂû£Í*»Ÿ5°òÆ™e)•›zÖéȇƒY¸ ºa‡Vl"U4hÌûÄ«T`ùsÒkó.÷këhZ³W*®BÂ|,\¥Ìsm†L²9Ùsj”ÍQ„fÕ¹‚2_¶jÀUeتWa«&\![vù\™e³P¶D«6\á9‘ßb“c­£¬~ßä¡#¶iÙ»™z”YÇPÞxŒŽ$ ¹äá±d!—<4jrkC ž‡âÑd!‡<<ž,ä‡ö±œ ´àe‰Vu¦“s «à»jŽ¨d^´šGT²úýn±ó4ÇTß ¯ðGUß‹®ðGUß‹®ðGUß¡ÂzKUèéç‚Uì"ç–käPèØAQeêpÌ*†dØ÷F~ö/úÒ±ÔFAË\UÉ¡Cd‘¹ßŽŠogîöh³(²‚1é€Ó LŸC;8*‹k¡å8Þi4*ø˜Bgˆyf‡ˆo@ý3ŠÅ¥²$5 «èzÁ¿c¯`²ÐTÈ’µÌjd—ØYEW­Ð‚z\tÕûýsŒ¬büíeN×ѼVðü¯¤Õ™CGEW!NŠ:ŒP¬TK³öÏwˆˆi‹‡°ÀÇŒÍi×Á‚å1'‡lSÌ‹O^b& Ë Q€9ÑÐá0³ó²"Û‡ŽÍœ{fíojhÖ~(Wе uiXås–`'¯! Ï÷dñ Ó‹"]V¶R—G‹¡íÊt_ÅC1O“ã‡ÐöÏÓŸô£¸˜î;ã°Ÿ'¥ ‹“mé1„¯À:Šõ;\Ö±¡UûùÒó¢W¢Shñ ¬ú‡ÇÀÂЪ÷ ‘ש0@»Ösñ]Ê÷ñšu^ƒÏϵ'D=VL>Î*1è4“dþà6Áªë2ü2ž+SW-ƒ§ßßz-ψ]žC¬ö2Á­z¥= «N°pVÞƒ°šµÈóº'áÔ¬Èß¡{õ*òe÷vØ*ÿ9‡FmØ*ïDX?¶ªÀU]تWõ`«*\Õ­êp…lU{¼Uþy0Ø ûÃJ=™Ý2ÃX´bO’nÓŽ7ïÏ«õé!ý¡7²¬rǢ븤ì^ñëO÷Á˜=DÚ,óg#d™=x{ÀÁ¼"-˜Eê’R69«P‘•y­:‰8wƒÒÞh”MÎ*ZÌÉÀöµê<Ò}>:·°´·Š[ŠîœL.5°\IU«ï‚ HÐ1E¯Î|à™IÑ•G®\ÅB²TIhhŠC­j,:ïQ£ÙPE«dŠ¢ Ñ„:_à‚°ÂA{ShV/hÓÒ¯~l«²iH ZeÒÕ¥Vµ®ovC„C[ÖLDϪÔesÈf9Ï‹<7©^¹Ë›ïáXÔæ}§MϬQ±J¢mñMFH@£â'¿]pLjò*õ]‹êåFÕÒªËú¯ÖWÅÞ´bËÎKئiÚ_áÙ3gÆÐæ`ôu˜é@âaµèk°ð6èÒE­Šš^t=zëVb·„`qæLSdq*H~+.æ—öo%+´4`ÛnµkA›°v4ª¿dË.ýÙü0ÓYá³Çû¬TYíDw‚¦“;‘ìÖÊ<‰¸ˆ.‹S´ƒËX=š—õ³¥ýáƒÊgªÖh©“÷¬¸¥Á¤ Û‚¥ûð9Ïí¸„…[É x3p<ö4rŸ=š} éBÈJw‚¦…{M›¨wì­À• Ñ­ðós*xÎìT àsîoÕëà¡÷Mh`¿=‰÷.2ÈJX°Cx]xdŸótË…t ÑoþÐ?Èt |Î}ðÐ{Œª¶Ki‡¬w'jú_áÈb;ñ¾¡[Z¸Fú~rw äM®³8°þ„Töîàå?!YÁo 9öù€¬¤¥+ÿ,Ž0~®C©9›CæŒäÏa+÷™ÛùËÊwèÚuuq½;QÓøÎ-FÖ£ð‘µÖ-Ì»û)tÿ‡ø:38ìEVÂÒ¶½©?Vzåè„R·s¸éÀ’¬³qÇêXº¼¹;aÓ›ÈÚЭ€,(íðù Na¾‡i!‹a¦á YIKïhÑìÕídèZÔ"£‹¦Ã~¼yÂ5Lñ‹œ;;º4ýAt¿ k­[òýä¯vëîÞ}Šœ V£Ï–õãOXàq?MZ`%ýlýZ% Êè͇æAF«»e6ò†}âmÔ‰— ŠŽ¼Ý‰š†¢¤¶d­vkª}LZÔ-ˆ Í»Îש #–oÄ°`¯M»·6ÆgQµ®{ôº6ûz{¯¡gP6AQ”†"'»•¯SAV$,d1F-Ë´»kaCå3 ÉdŸBžö;¯‹ аm˜) $„$Kkݪ2䶒Æ@¬n´Á2 ½ír%s3Ó0]7C“¡lhj!®ÝД/öØÓæ¤Ývd¹¸=Q›Œ,¥¦d% ¯ÊÄÒ°¶@¹]ä `IRSjVQ(Ûk'4YTÕâ“CÑ¡¥ÕxŒj¹Â£ðjç„N8á„N8;R mˆÛÉ=\šh“«´JUJ o»f´zwóª] ™ô±bÈÚ&´±·˜@õñ+µR•ZÂÛ¦™ ¡>6Q¯³éc9’•Bh˜RîJZ¥*µ„·M3 œ¼…7&`dÑÇò#+Ð&0¥ ÿžŠ©•ªÔÞ6Í,j•É‰Yô±üÈJ£ ¡M4* ©=µSªRÛ5³¨UFV}¬²î£ÔÈ‘¬íšÙ YUˆ¬4B›ÀNKa•M«T¥–ð¶ifa«afÐÇò#+Ð&DJÝ´JUJ o»fñÄþª’>ö-¸(UkšYEõ±oQ´RµY3«>Æ;5³N8á„N8!ÿ ôÞy•%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPTextElement.html0000644000175000017500000025350214030601040025360 0ustar rusconirusconi QCPTextElement Class Reference
Public Functions | Signals | Protected Functions
QCPTextElement Class Reference

A layout element displaying a text. More...

Inheritance diagram for QCPTextElement:
Inheritance graph

Public Functions

 QCPTextElement (QCustomPlot *parentPlot)
 
 QCPTextElement (QCustomPlot *parentPlot, const QString &text)
 
 QCPTextElement (QCustomPlot *parentPlot, const QString &text, double pointSize)
 
 QCPTextElement (QCustomPlot *parentPlot, const QString &text, const QString &fontFamily, double pointSize)
 
 QCPTextElement (QCustomPlot *parentPlot, const QString &text, const QFont &font)
 
QString text () const
 
int textFlags () const
 
QFont font () const
 
QColor textColor () const
 
QFont selectedFont () const
 
QColor selectedTextColor () const
 
bool selectable () const
 
bool selected () const
 
void setText (const QString &text)
 
void setTextFlags (int flags)
 
void setFont (const QFont &font)
 
void setTextColor (const QColor &color)
 
void setSelectedFont (const QFont &font)
 
void setSelectedTextColor (const QColor &color)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual void update (UpdatePhase phase)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
void clicked (QMouseEvent *event)
 
void doubleClicked (QMouseEvent *event)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
QFont mainFont () const
 
QColor mainTextColor () const
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 

Detailed Description

A layout element displaying a text.

The text may be specified with setText, the formatting can be controlled with setFont, setTextColor, and setTextFlags.

A text element can be added as follows:

customPlot->plotLayout()->insertRow(0); // inserts an empty row above the default axis rect
customPlot->plotLayout()->addElement(0, 0, new QCPTextElement(customPlot, "Your Text"));

Constructor & Destructor Documentation

§ QCPTextElement() [1/5]

QCPTextElement::QCPTextElement ( QCustomPlot *  parentPlot)
explicit

This is an overloaded function.

Creates a new QCPTextElement instance and sets default values. The initial text is empty (setText).

§ QCPTextElement() [2/5]

QCPTextElement::QCPTextElement ( QCustomPlot *  parentPlot,
const QString &  text 
)

This is an overloaded function.

Creates a new QCPTextElement instance and sets default values.

The initial text is set to text.

§ QCPTextElement() [3/5]

QCPTextElement::QCPTextElement ( QCustomPlot *  parentPlot,
const QString &  text,
double  pointSize 
)

This is an overloaded function.

Creates a new QCPTextElement instance and sets default values.

The initial text is set to text with pointSize.

§ QCPTextElement() [4/5]

QCPTextElement::QCPTextElement ( QCustomPlot *  parentPlot,
const QString &  text,
const QString &  fontFamily,
double  pointSize 
)

This is an overloaded function.

Creates a new QCPTextElement instance and sets default values.

The initial text is set to text with pointSize and the specified fontFamily.

§ QCPTextElement() [5/5]

QCPTextElement::QCPTextElement ( QCustomPlot *  parentPlot,
const QString &  text,
const QFont &  font 
)

This is an overloaded function.

Creates a new QCPTextElement instance and sets default values.

The initial text is set to text with the specified font.

Member Function Documentation

§ setText()

void QCPTextElement::setText ( const QString &  text)

Sets the text that will be displayed to text. Multiple lines can be created by insertion of "\n".

See also
setFont, setTextColor, setTextFlags

§ setTextFlags()

void QCPTextElement::setTextFlags ( int  flags)

Sets options for text alignment and wrapping behaviour. flags is a bitwise OR-combination of Qt::AlignmentFlag and Qt::TextFlag enums.

Possible enums are:

  • Qt::AlignLeft
  • Qt::AlignRight
  • Qt::AlignHCenter
  • Qt::AlignJustify
  • Qt::AlignTop
  • Qt::AlignBottom
  • Qt::AlignVCenter
  • Qt::AlignCenter
  • Qt::TextDontClip
  • Qt::TextSingleLine
  • Qt::TextExpandTabs
  • Qt::TextShowMnemonic
  • Qt::TextWordWrap
  • Qt::TextIncludeTrailingSpaces

§ setFont()

void QCPTextElement::setFont ( const QFont &  font)

Sets the font of the text.

See also
setTextColor, setSelectedFont

§ setTextColor()

void QCPTextElement::setTextColor ( const QColor &  color)

Sets the color of the text.

See also
setFont, setSelectedTextColor

§ setSelectedFont()

void QCPTextElement::setSelectedFont ( const QFont &  font)

Sets the font of the text that will be used if the text element is selected (setSelected).

See also
setFont

§ setSelectedTextColor()

void QCPTextElement::setSelectedTextColor ( const QColor &  color)

Sets the color of the text that will be used if the text element is selected (setSelected).

See also
setTextColor

§ setSelectable()

void QCPTextElement::setSelectable ( bool  selectable)

Sets whether the user may select this text element.

Note that even when selectable is set to false, the selection state may be changed programmatically via setSelected.

§ setSelected()

void QCPTextElement::setSelected ( bool  selected)

Sets the selection state of this text element to selected. If the selection has changed, selectionChanged is emitted.

Note that this function can change the selection state independently of the current setSelectable state.

§ selectTest()

double QCPTextElement::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Returns 0.99*selectionTolerance (see QCustomPlot::setSelectionTolerance) when pos is within the bounding box of the text element's text. Note that this bounding box is updated in the draw call.

If pos is outside the text's bounding box or if onlySelectable is true and this text element is not selectable (setSelectable), returns -1.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayoutElement.

§ mousePressEvent()

void QCPTextElement::mousePressEvent ( QMouseEvent *  event,
const QVariant &  details 
)
virtual

Accepts the mouse event in order to emit the according click signal in the mouseReleaseEvent.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayerable.

§ mouseReleaseEvent()

void QCPTextElement::mouseReleaseEvent ( QMouseEvent *  event,
const QPointF &  startPos 
)
virtual

Emits the clicked signal if the cursor hasn't moved by more than a few pixels since the mousePressEvent.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayerable.

§ mouseDoubleClickEvent()

void QCPTextElement::mouseDoubleClickEvent ( QMouseEvent *  event,
const QVariant &  details 
)
virtual

Emits the doubleClicked signal.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPLayerable.

§ selectionChanged

void QCPTextElement::selectionChanged ( bool  selected)
signal

This signal is emitted when the selection state has changed to selected, either by user interaction or by a direct call to setSelected.

See also
setSelected, setSelectable

§ clicked

void QCPTextElement::clicked ( QMouseEvent *  event)
signal

This signal is emitted when the text element is clicked.

See also
doubleClicked, selectTest

§ doubleClicked

void QCPTextElement::doubleClicked ( QMouseEvent *  event)
signal

This signal is emitted when the text element is double clicked.

See also
clicked, selectTest

§ applyDefaultAntialiasingHint()

void QCPTextElement::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
protectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Reimplemented from QCPLayoutElement.

§ draw()

void QCPTextElement::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Reimplemented from QCPLayoutElement.

§ minimumOuterSizeHint()

QSize QCPTextElement::minimumOuterSizeHint ( ) const
protectedvirtual

Returns the suggested minimum size this layout element (the outerRect) may be compressed to, if no manual minimum size is set.

if a minimum size (setMinimumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMinimumOuterSize) to determine the minimum allowed size of this layout element.

A manual minimum size is considered set if it is non-zero.

The default implementation simply returns the sum of the horizontal margins for the width and the sum of the vertical margins for the height. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented from QCPLayoutElement.

§ maximumOuterSizeHint()

QSize QCPTextElement::maximumOuterSizeHint ( ) const
protectedvirtual

Returns the suggested maximum size this layout element (the outerRect) may be expanded to, if no manual maximum size is set.

if a maximum size (setMaximumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMaximumOuterSize) to determine the maximum allowed size of this layout element.

A manual maximum size is considered set if it is smaller than Qt's QWIDGETSIZE_MAX.

The default implementation simply returns QWIDGETSIZE_MAX for both width and height, implying no suggested maximum size. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented from QCPLayoutElement.

§ selectEvent()

void QCPTextElement::selectEvent ( QMouseEvent *  event,
bool  additive,
const QVariant &  details,
bool *  selectionStateChanged 
)
protectedvirtual

This event is called when the layerable shall be selected, as a consequence of a click by the user. Subclasses should react to it by setting their selection state appropriately. The default implementation does nothing.

event is the mouse event that caused the selection. additive indicates, whether the user was holding the multi-select-modifier while performing the selection (see QCustomPlot::setMultiSelectModifier). if additive is true, the selection state must be toggled (i.e. become selected when unselected and unselected when selected).

Every selectEvent is preceded by a call to selectTest, which has returned positively (i.e. returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). The details data you output from selectTest is fed back via details here. You may use it to transport any kind of information from the selectTest to the possibly subsequent selectEvent. Usually details is used to transfer which part was clicked, if it is a layerable that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need to do the calculation again to find out which part was actually clicked.

selectionStateChanged is an output parameter. If the pointer is non-null, this function must set the value either to true or false, depending on whether the selection state of this layerable was actually changed. For layerables that only are selectable as a whole and not in parts, this is simple: if additive is true, selectionStateChanged must also be set to true, because the selection toggles. If additive is false, selectionStateChanged is only set to true, if the layerable was previously unselected and now is switched to the selected state.

See also
selectTest, deselectEvent

Reimplemented from QCPLayerable.

§ deselectEvent()

void QCPTextElement::deselectEvent ( bool *  selectionStateChanged)
protectedvirtual

This event is called when the layerable shall be deselected, either as consequence of a user interaction or a call to QCustomPlot::deselectAll. Subclasses should react to it by unsetting their selection appropriately.

just as in selectEvent, the output parameter selectionStateChanged (if non-null), must return true or false when the selection state of this layerable has changed or not changed, respectively.

See also
selectTest, selectEvent

Reimplemented from QCPLayerable.

§ mainFont()

QFont QCPTextElement::mainFont ( ) const
protected

Returns the main font to be used. This is mSelectedFont if setSelected is set to true, else mFont is returned.

§ mainTextColor()

QColor QCPTextElement::mainTextColor ( ) const
protected

Returns the main color to be used. This is mSelectedTextColor if setSelected is set to true, else mTextColor is returned.

The documentation for this class was generated from the following files:
  • src/layoutelements/layoutelement-textelement.h
  • src/layoutelements/layoutelement-textelement.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/datacontainer_8h.html0000644000175000017500000000371014030601036024742 0ustar rusconirusconi src/datacontainer.h File Reference
Data Structures
datacontainer.h File Reference

Data Structures

class  QCPDataContainer< DataType >
 The generic data container for one-dimensional plottables. More...
 
qcustomplot-2.1.0+dfsg1/documentation/html/ssDot.png0000644000175000017500000000034014030601041022433 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+IDAT(Ïc`¡àÿ@;`pü¶½œ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_g.html0000644000175000017500000003367314030601037025074 0ustar rusconirusconi Data Fields - Functions
 

- g -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPFinancialData.html0000644000175000017500000004132114030601036025577 0ustar rusconirusconi QCPFinancialData Class Reference
Public Functions | Public Members | Static Public Functions
QCPFinancialData Class Reference

Holds the data of one single data point for QCPFinancial. More...

Public Functions

 QCPFinancialData ()
 
 QCPFinancialData (double key, double open, double high, double low, double close)
 
double sortKey () const
 
double mainKey () const
 
double mainValue () const
 
QCPRange valueRange () const
 

Public Members

double key
 
double open
 
double high
 
double low
 
double close
 

Static Public Functions

static QCPFinancialData fromSortKey (double sortKey)
 
static bool sortKeyIsMainKey ()
 

Detailed Description

Holds the data of one single data point for QCPFinancial.

The stored data is:

  • key: coordinate on the key axis of this data point (this is the mainKey and the sortKey)
  • open: The opening value at the data point (this is the mainValue)
  • high: The high/maximum value at the data point
  • low: The low/minimum value at the data point
  • close: The closing value at the data point

The container for storing multiple data points is QCPFinancialDataContainer. It is a typedef for QCPDataContainer with QCPFinancialData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods.

See also
QCPFinancialDataContainer

Constructor & Destructor Documentation

§ QCPFinancialData() [1/2]

QCPFinancialData::QCPFinancialData ( )

Constructs a data point with key and all values set to zero.

§ QCPFinancialData() [2/2]

QCPFinancialData::QCPFinancialData ( double  key,
double  open,
double  high,
double  low,
double  close 
)

Constructs a data point with the specified key and OHLC values.

Member Function Documentation

§ sortKey()

double QCPFinancialData::sortKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ fromSortKey()

static QCPFinancialData QCPFinancialData::fromSortKey ( double  sortKey)
inlinestatic

Returns a data point with the specified sortKey. All other members are set to zero.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ sortKeyIsMainKey()

static static bool QCPFinancialData::sortKeyIsMainKey ( )
inlinestatic

Since the member key is both the data point key coordinate and the data ordering parameter, this method returns true.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainKey()

double QCPFinancialData::mainKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainValue()

double QCPFinancialData::mainValue ( ) const
inline

Returns the open member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ valueRange()

QCPRange QCPFinancialData::valueRange ( ) const
inline

Returns a QCPRange spanning from the low to the high value of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarLegendItem.html0000644000175000017500000014076014030601040026136 0ustar rusconirusconi QCPPolarLegendItem Class Reference
Public Functions | Protected Functions
QCPPolarLegendItem Class Reference

A legend item for polar plots. More...

Inheritance diagram for QCPPolarLegendItem:
Inheritance graph

Public Functions

 QCPPolarLegendItem (QCPLegend *parent, QCPPolarGraph *graph)
 
QCPPolarGraph * polarGraph ()
 
- Public Functions inherited from QCPAbstractLegendItem
 QCPAbstractLegendItem (QCPLegend *parent)
 
QCPLegend * parentLegend () const
 
QFont font () const
 
QColor textColor () const
 
QFont selectedFont () const
 
QColor selectedTextColor () const
 
bool selectable () const
 
bool selected () const
 
void setFont (const QFont &font)
 
void setTextColor (const QColor &color)
 
void setSelectedFont (const QFont &font)
 
void setSelectedTextColor (const QColor &color)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual void update (UpdatePhase phase)
 
virtual QSize maximumOuterSizeHint () const
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QSize minimumOuterSizeHint () const
 
QPen getIconBorderPen () const
 
QColor getTextColor () const
 
QFont getFont () const
 
- Protected Functions inherited from QCPAbstractLegendItem
virtual QCP::Interaction selectionCategory () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 
- Signals inherited from QCPAbstractLegendItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A legend item for polar plots.

Warning
In this QCustomPlot version, polar plots are a tech preview. Expect documentation and functionality to be incomplete, as well as changing public interfaces in the future.

Member Function Documentation

§ draw()

void QCPPolarLegendItem::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractLegendItem.

§ minimumOuterSizeHint()

QSize QCPPolarLegendItem::minimumOuterSizeHint ( ) const
protectedvirtual

Returns the suggested minimum size this layout element (the outerRect) may be compressed to, if no manual minimum size is set.

if a minimum size (setMinimumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMinimumOuterSize) to determine the minimum allowed size of this layout element.

A manual minimum size is considered set if it is non-zero.

The default implementation simply returns the sum of the horizontal margins for the width and the sum of the vertical margins for the height. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented from QCPLayoutElement.

The documentation for this class was generated from the following files:
  • src/polar/polargraph.h
  • src/polar/polargraph.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_u.html0000644000175000017500000000661014030601037025101 0ustar rusconirusconi Data Fields - Functions
 

- u -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPSelectionDecoratorBracket__inherit__graph.png0000644000175000017500000000221114030601041033215 0ustar rusconirusconi‰PNG  IHDRÐkô‡ñgAMA† 1è–_0PLTEþþþÿÿÿ222fffKKK———´´¹vvv………èèéÑÑÒ+!!Yff—'ƈ«tRNS«â¢bKGDÿ-Þ pHYsHHFÉk>sIDAThÞíšAOQÇùž,‰„ìÅr(Fˆ—m§•}áB¬k<ô7?€‚_€ÒPO¶¯$NLÄè¡‘ƒ‰1ñb<èjøø&μ])XZ·¥Ý y“fúúŸ7óÛ7m퀈È è?O÷Цڀ — hJ÷²YYŠdõ4ôœ…% î‰5pOƒ¬`©©¶Ó¨¸£Ö‡ÝדÖH^$?V΂E÷3¥Åc­sÕ=1O¯ßË],áXâ¬Z¶KE‹xæE¸8Ì;!A "æXuÑå§^ˆ™}Çb78¡[7õrÒšÈè 'ÆEŠö+Ò8x7ì€èŒb…$ØÕ5h¢»–bý€r†H[ðSÃÜ“Ö±q.O®–n] ÈÖó½Ôù0Ðzî­-¦?Ð’·nÕoƒÞd‘[G ›NT‚ñ^äŒ"Ü¢#_äaXŒs=aéñöE‡²laëa ÂÞ·Ëýd@Ô7ôÔÚ€ªÂØã/¡¶åÚ€ÂÙÓ¯]$u:ú hÄóv#yÞq$ QÏ;ŒôÎó¾Eúåy?#y^c×9(æ‘Õ#1è8Ð(ƒ#}bÐ÷@×ô95ï°‹$2 2 2 2 2 2 Š´Öé÷ž‰T§w4(ÛÛÿ;žgi„}7êHv_ZµÙÇ2$`¥ ´>’'+EZÕT”ù·(›AÛ™Í æ—ï£,H5³)Ï‚NòkùxKdŠ£|¹²&U± ”ì² @Ò*)ˆ+ÜDzä”-¬p0 ò•*HUMÒ>Êl•°ˆ.ƒ ² ·QÝ´Q²K•¸uj6)*„µ?bjƒîœ:Ašæ¸u2‹*×°5ˆ;]HÌQ•'çê3R%Žú _tiUÂ<0HõùJ Uu…v­ãWUÝ>í ~âëõE!&·D}¾B ;§+œ; Iº¼!+3YÔŽº”ö[Ç †@äÖ!fÈçü ¾#_¡Ö•Ó¼/Ýf¼ T¦öÕxÉŽÎ=áƒHDÊJÉ øA}FZáa@û!íK4bÅíþýù»4Ad@}EõWЫPߪ^È]ýŸ&^ ÐVDöÛb¢ÒÇzß’%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/plottable-curve_8h.html0000644000175000017500000001245014030601036025237 0ustar rusconirusconi src/plottables/plottable-curve.h File Reference
Data Structures | Typedefs | Functions
plottable-curve.h File Reference

Data Structures

class  QCPCurveData
 Holds the data of one single data point for QCPCurve. More...
 
class  QCPCurve
 A plottable representing a parametric curve in a plot. More...
 

Typedefs

typedef QCPDataContainer< QCPCurveData > QCPCurveDataContainer
 

Functions

 Q_DECLARE_TYPEINFO (QCPCurveData, Q_PRIMITIVE_TYPE)
 

Typedef Documentation

§ QCPCurveDataContainer

QCPCurveDataContainer

Container for storing QCPCurveData points. The data is stored sorted by t, so the sortKey() (returning t) is different from mainKey() (returning key).

This template instantiation is the container in which QCPCurve holds its data. For details about the generic container, see the documentation of the class template QCPDataContainer.

See also
QCPCurveData, QCPCurve::setData
qcustomplot-2.1.0+dfsg1/documentation/html/dir_d1ab82e73f77cddd99808c625b504457.html0000644000175000017500000000640614030601036026712 0ustar rusconirusconi src/plottables Directory Reference
plottables Directory Reference

Files

file  plottable-bars.h
 
file  plottable-curve.h
 
file  plottable-errorbar.h
 
file  plottable-financial.h
 
file  plottable-graph.h
 
file  plottable-statisticalbox.h
 
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerFixed.html0000644000175000017500000006075414030601040026155 0ustar rusconirusconi QCPAxisTickerFixed Class Reference
Public Types | Public Functions | Protected Functions
QCPAxisTickerFixed Class Reference

Specialized axis ticker with a fixed tick step. More...

Inheritance diagram for QCPAxisTickerFixed:
Inheritance graph

Public Types

enum  ScaleStrategy
 
- Public Types inherited from QCPAxisTicker
enum  TickStepStrategy
 

Public Functions

 QCPAxisTickerFixed ()
 
double tickStep () const
 
ScaleStrategy scaleStrategy () const
 
void setTickStep (double step)
 
void setScaleStrategy (ScaleStrategy strategy)
 
- Public Functions inherited from QCPAxisTicker
 QCPAxisTicker ()
 
TickStepStrategy tickStepStrategy () const
 
int tickCount () const
 
double tickOrigin () const
 
void setTickStepStrategy (TickStepStrategy strategy)
 
void setTickCount (int count)
 
void setTickOrigin (double origin)
 
virtual void generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > *subTicks, QVector< QString > *tickLabels)
 

Protected Functions

virtual double getTickStep (const QCPRange &range)
 
- Protected Functions inherited from QCPAxisTicker
virtual int getSubTickCount (double tickStep)
 
virtual QString getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision)
 
virtual QVector< double > createTickVector (double tickStep, const QCPRange &range)
 
virtual QVector< double > createSubTickVector (int subTickCount, const QVector< double > &ticks)
 
virtual QVector< QString > createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)
 
void trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const
 
double pickClosest (double target, const QVector< double > &candidates) const
 
double getMantissa (double input, double *magnitude=nullptr) const
 
double cleanMantissa (double input) const
 

Detailed Description

Specialized axis ticker with a fixed tick step.

axisticker-fixed.png

This QCPAxisTicker subclass generates ticks with a fixed tick step set with setTickStep. It is also possible to allow integer multiples and integer powers of the specified tick step with setScaleStrategy.

A typical application of this ticker is to make an axis only display integers, by setting the tick step of the ticker to 1.0 and the scale strategy to ssMultiples.

Another case is when a certain number has a special meaning and axis ticks should only appear at multiples of that value. In this case you might also want to consider QCPAxisTickerPi because despite the name it is not limited to only pi symbols/values.

The ticker can be created and assigned to an axis like this:

QSharedPointer<QCPAxisTickerFixed> fixedTicker(new QCPAxisTickerFixed);
customPlot->xAxis->setTicker(fixedTicker);
fixedTicker->setTickStep(1.0); // tick step shall be 1.0
fixedTicker->setScaleStrategy(QCPAxisTickerFixed::ssNone); // and no scaling of the tickstep (like multiples or powers) is allowed

Member Enumeration Documentation

§ ScaleStrategy

enum QCPAxisTickerFixed::ScaleStrategy

Defines how the axis ticker may modify the specified tick step (setTickStep) in order to control the number of ticks in the axis range.

See also
setScaleStrategy
Enumerator
ssNone 

Modifications are not allowed, the specified tick step is absolutely fixed. This might cause a high tick density and overlapping labels if the axis range is zoomed out.

ssMultiples 

An integer multiple of the specified tick step is allowed. The used factor follows the base class properties of setTickStepStrategy and setTickCount.

ssPowers 

An integer power of the specified tick step is allowed.

Constructor & Destructor Documentation

§ QCPAxisTickerFixed()

QCPAxisTickerFixed::QCPAxisTickerFixed ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

Member Function Documentation

§ setTickStep()

void QCPAxisTickerFixed::setTickStep ( double  step)

Sets the fixed tick interval to step.

The axis ticker will only use this tick step when generating axis ticks. This might cause a very high tick density and overlapping labels if the axis range is zoomed out. Using setScaleStrategy it is possible to relax the fixed step and also allow multiples or powers of step. This will enable the ticker to reduce the number of ticks to a reasonable amount (see setTickCount).

§ setScaleStrategy()

void QCPAxisTickerFixed::setScaleStrategy ( QCPAxisTickerFixed::ScaleStrategy  strategy)

Sets whether the specified tick step (setTickStep) is absolutely fixed or whether modifications may be applied to it before calculating the finally used tick step, such as permitting multiples or powers. See ScaleStrategy for details.

The default strategy is ssNone, which means the tick step is absolutely fixed.

§ getTickStep()

double QCPAxisTickerFixed::getTickStep ( const QCPRange &  range)
protectedvirtual

Determines the actually used tick step from the specified tick step and scale strategy (setTickStep, setScaleStrategy).

This method either returns the specified tick step exactly, or, if the scale strategy is not ssNone, a modification of it to allow varying the number of ticks in the current axis range.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPAxisTicker.

The documentation for this class was generated from the following files:
  • src/axis/axistickerfixed.h
  • src/axis/axistickerfixed.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/performanceimprovement.html0000644000175000017500000001712214030601036026320 0ustar rusconirusconi Plot Performance Improvement
Plot Performance Improvement

QCustomPlot employs various techniques like adaptive sampling and text object caching in order to cut down the time required to replot. However, some features like complex translucent fills and thick lines can still cause a significant slow down. If you notice this in your application, here are some hints on how to increase replot performance (to benchmark performance, see QCustomPlot::replotTime).

By far the most time is spent in the drawing functions, specifically the drawing of high density graphs and other plottables. For maximum performance, consider the following points:

  • Especially if you are using complex fills under/between graphs, thick lines, translucent colors: enable QCustomPlot's OpenGL hardware accelerated rendering via QCustomPlot::setOpenGl. For details how to correctly enable OpenGL acceleration, see the documentation there. OpenGL acceleration is available for all Qt versions that are supported by QCustomPlot, and the respective backend is chosen appropriately.
    For Qt versions before 5.0, an alternative to QCustomPlot's own OpenGL acceleration is to supply "-graphicssystem opengl" as command line argument or calling QApplication::setGraphicsSystem("opengl") before creating the QApplication object. This enables application wide OpenGL acceleration.
    Note that with OpenGL acceleration, the maximum frame rate might be constrained by the vertical sync frequency of your monitor (VSync can be disabled in the graphics card driver configuration). So for simple plots (where the potential framerate is far above 60 frames per second), OpenGL acceleration might achieve numerically lower frame rates than the default software renderer, because it is not capped at the VSync frequency.
  • Avoid lines with a pen width greater than one. This is especially relevant with the default software renderer, less so with OpenGL acceleration.
  • Avoid complex fills, e.g. channel fills between graphs with thousands of points. This is especially relevant with the default software renderer, less so with OpenGL acceleration.
  • If you often need to call a full QCustomPlot::replot only because a non-complex object (e.g. an item) has changed while having relatively static but complex graphs in the plot, consider placing the regularly changing objects onto an own layer and setting its mode (QCPLayer::setMode) to QCPLayer::lmBuffered. This makes QCustomPlot allocate a dedicated paint buffer for this layer, and allows it to be replotted individually with QCPLayer::replot, independent of the other layers containing the potentially complex and slow graphs. See the documentation of the respective methods for details.
  • Qt4 only: Use Qt 4.8 or newer. Performance has doubled or tripled with respect to Qt 4.7. However, QPainter was broken and drawing pixel precise elements like scatters doesn't look as good as with Qt 4.7. So it's a performance vs. plot quality tradeoff when switching to Qt 4.8. QCustomPlot internally tries to work around the worst glitches of this kind.
  • To increase responsiveness during range dragging, consider setting QCustomPlot::setNoAntialiasingOnDrag to true. This is only relevant if using the default software renderer. (OpenGL antialiasing can't be toggled on-the-fly and would require an expensive reallocation of the sample buffer.)
  • Qt4 only: On X11 (GNU/Linux), avoid the slow native drawing system, use raster by supplying "-graphicssystem raster" as command line argument or calling QApplication::setGraphicsSystem("raster") before creating the QApplication object.
  • Avoid any kind of alpha (transparency) colors, especially in fills.
  • As a last resort, try to reduce the number of data points that are in the visible key range at any given moment, e.g. by limiting the maximum key range span (see the QCPAxis::rangeChanged signal). QCustomPlot can optimize away millions of off-screen points very efficiently.
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerTime__inherit__graph.png0000644000175000017500000000166414030601041031031 0ustar rusconirusconi‰PNG  IHDR‹kµslNgAMA† 1è–_-PLTEÿÿÿÿÿÿ………iii±±´MMN˜˜˜ééê111ÐÐÒP+nnÞœ^€tRNSªvå’bKGDˆH pHYsHHFÉk>¡IDATXÃíÙO‹Ó@ð=y›š¥ë"2)³loi—ÀöÖ?® 'AoÎLöeMñ°] xô#”Eo‚DÉ}¡ô"ü=xŒ°Àïà$µµ¶ÍNj#.:ïPè›™_ß›I)I7 ˆ¸µ¡5ctVÛ‹LÉ]K˜æê½hf6XNÆ@ÀÁÚ“•&"š«0ε ñ²i–8œ)­Vƒ™² ^•?Ù¶&K d23@`C{€/Ì€)˜.Ü`æ¹dÊÑl—í3sïÁ˜¹Û‡®€;g̼§ªfÊàqÉÞ‡aضo™.Ú€˜NÈÛ ϯIà¡;eÄQòjæßb€gPz.œ>+=¢Ó¦˜s¿ó¾©f¶&ÀaÓ=Ùj²-cf(·Ø8 ­f¢>ä¿ýeÐÌ`põXÂ\¯gÅè4kä`‘ÉŽø£rJf3þT³-‚y)‚ùÇý˜Q_¬Ï”ãX}Tjæ¦d>¯ÏìHFyTjæƒd”G¥fäAÅñùÚÌ(a.ŠaNÖfd[ê)šÑŒf4£ÍhF3šÉb”üžªÿIæwnëæoò†“5ãgxN¦Š>!†=ô&+©<:ËLLpôv½z‹Z9l-”ÁçŒOªœ†òãˆcy¢V[<-'$Ü ìш§ ßahɺA,Nk’±¢*÷-/¨qzº?fÜ>ñœ¶$®|ó6º„A†qá·7^%Á ¦Æ 9,·é²¦dX ä<Òp§ŒŸ¬LÓDÒZj.Ûâ0ÝbB:¤Òö¢¯ÔƒiS<ªuêü¦Òv.9pB<²ë†•¹-® 'üÉXÉðâåw8)ò^Åšùw˜b~²øåƒ+û§ÛÕ`Ö=í4Þ|hˆµÌ¦ o%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPSelectionDecorator.html0000644000175000017500000005771614030601040026723 0ustar rusconirusconi QCPSelectionDecorator Class Reference
Public Functions | Protected Functions
QCPSelectionDecorator Class Reference

Controls how a plottable's data selection is drawn. More...

Inheritance diagram for QCPSelectionDecorator:
Inheritance graph

Public Functions

 QCPSelectionDecorator ()
 
QPen pen () const
 
QBrush brush () const
 
QCPScatterStyle scatterStyle () const
 
QCPScatterStyle::ScatterProperties usedScatterProperties () const
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setScatterStyle (const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties=QCPScatterStyle::spPen)
 
void setUsedScatterProperties (const QCPScatterStyle::ScatterProperties &properties)
 
void applyPen (QCPPainter *painter) const
 
void applyBrush (QCPPainter *painter) const
 
QCPScatterStyle getFinalScatterStyle (const QCPScatterStyle &unselectedStyle) const
 
virtual void copyFrom (const QCPSelectionDecorator *other)
 
virtual void drawDecoration (QCPPainter *painter, QCPDataSelection selection)
 

Protected Functions

virtual bool registerWithPlottable (QCPAbstractPlottable *plottable)
 

Detailed Description

Controls how a plottable's data selection is drawn.

Each QCPAbstractPlottable instance has one QCPSelectionDecorator (accessible via QCPAbstractPlottable::selectionDecorator) and uses it when drawing selected segments of its data.

The selection decorator controls both pen (setPen) and brush (setBrush), as well as the scatter style (setScatterStyle) if the plottable draws scatters. Since a QCPScatterStyle is itself composed of different properties such as color shape and size, the decorator allows specifying exactly which of those properties shall be used for the selected data point, via setUsedScatterProperties.

A QCPSelectionDecorator subclass instance can be passed to a plottable via QCPAbstractPlottable::setSelectionDecorator, allowing greater customizability of the appearance of selected segments.

Use copyFrom to easily transfer the settings of one decorator to another one. This is especially useful since plottables take ownership of the passed selection decorator, and thus the same decorator instance can not be passed to multiple plottables.

Selection decorators can also themselves perform drawing operations by reimplementing drawDecoration, which is called by the plottable's draw method. The base class QCPSelectionDecorator does not make use of this however. For example, QCPSelectionDecoratorBracket draws brackets around selected data segments.

Constructor & Destructor Documentation

§ QCPSelectionDecorator()

QCPSelectionDecorator::QCPSelectionDecorator ( )

Creates a new QCPSelectionDecorator instance with default values

Member Function Documentation

§ setPen()

void QCPSelectionDecorator::setPen ( const QPen &  pen)

Sets the pen that will be used by the parent plottable to draw selected data segments.

§ setBrush()

void QCPSelectionDecorator::setBrush ( const QBrush &  brush)

Sets the brush that will be used by the parent plottable to draw selected data segments.

§ setScatterStyle()

void QCPSelectionDecorator::setScatterStyle ( const QCPScatterStyle &  scatterStyle,
QCPScatterStyle::ScatterProperties  usedProperties = QCPScatterStyle::spPen 
)

Sets the scatter style that will be used by the parent plottable to draw scatters in selected data segments.

usedProperties specifies which parts of the passed scatterStyle will be used by the plottable. The used properties can also be changed via setUsedScatterProperties.

§ setUsedScatterProperties()

void QCPSelectionDecorator::setUsedScatterProperties ( const QCPScatterStyle::ScatterProperties &  properties)

Use this method to define which properties of the scatter style (set via setScatterStyle) will be used for selected data segments. All properties of the scatter style that are not specified in properties will remain as specified in the plottable's original scatter style.

See also
QCPScatterStyle::ScatterProperty

§ applyPen()

void QCPSelectionDecorator::applyPen ( QCPPainter *  painter) const

Sets the pen of painter to the pen of this selection decorator.

See also
applyBrush, getFinalScatterStyle

§ applyBrush()

void QCPSelectionDecorator::applyBrush ( QCPPainter *  painter) const

Sets the brush of painter to the brush of this selection decorator.

See also
applyPen, getFinalScatterStyle

§ getFinalScatterStyle()

QCPScatterStyle QCPSelectionDecorator::getFinalScatterStyle ( const QCPScatterStyle &  unselectedStyle) const

Returns the scatter style that the parent plottable shall use for selected scatter points. The plottable's original (unselected) scatter style must be passed as unselectedStyle. Depending on the setting of setUsedScatterProperties, the returned scatter style is a mixture of this selecion decorator's scatter style (setScatterStyle), and unselectedStyle.

See also
applyPen, applyBrush, setScatterStyle

§ copyFrom()

void QCPSelectionDecorator::copyFrom ( const QCPSelectionDecorator *  other)
virtual

Copies all properties (e.g. color, fill, scatter style) of the other selection decorator to this selection decorator.

§ drawDecoration()

void QCPSelectionDecorator::drawDecoration ( QCPPainter *  painter,
QCPDataSelection  selection 
)
virtual

This method is called by all plottables' draw methods to allow custom selection decorations to be drawn. Use the passed painter to perform the drawing operations. selection carries the data selection for which the decoration shall be drawn.

The default base class implementation of QCPSelectionDecorator has no special decoration, so this method does nothing.

Reimplemented in QCPSelectionDecoratorBracket.

§ registerWithPlottable()

bool QCPSelectionDecorator::registerWithPlottable ( QCPAbstractPlottable *  plottable)
protectedvirtual

This method is called as soon as a selection decorator is associated with a plottable, by a call to QCPAbstractPlottable::setSelectionDecorator. This way the selection decorator can obtain a pointer to the plottable that uses it (e.g. to access data points via the QCPAbstractPlottable::interface1D interface).

If the selection decorator was already added to a different plottable before, this method aborts the registration and returns false.

The documentation for this class was generated from the following files:
  • src/plottable.h
  • src/plottable.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/core_8cpp.html0000644000175000017500000000231414030601036023410 0ustar rusconirusconi src/core.cpp File Reference
core.cpp File Reference
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_k.html0000644000175000017500000000300214030601037025057 0ustar rusconirusconi Data Fields - Functions
 

- k -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAbstractPlottable1D__inherit__graph.png0000644000175000017500000000426214030601041031740 0ustar rusconirusconi‰PNG  IHDRPÀ ×&gAMA† 1è–_0PLTEÿÿÿÑÑÔiijLLS˜˜˜………çç駧·111®®ÊÕÕå- Whh˜ö€(bKGDˆH pHYsHHFÉk>©IDATxÚíœÏkGÇGÖªQl×v}(¶Œi  lCa£eS%—ÜKJþ@±ÖLÈÉ4)iMCé5—dÁ!'z økKÐÒlâ^J/ÿ.}of×QäÕjH;«f¾ÂòhGûöãy3o´æk¢¤¤4|Í/DÖi) Õè †Ðè§(Pš=P ¾ôl€Vé:ÉÓ¡ôª–eмyÛ Õ³ßýK=Ó Z 9(5,Rüx†·¥k´¢Ù‰ž+ŸÏèyJ.!¨;¢–V)”–nêlC'tíÑ¢O|Zͨ˜£yJî¥:tTñù)‘¥=J=ŸÚÙ[ÄX!çø ã+tŽÈ}½˜èu›XçÉÂ{%xaÞqSz^>(i¹å A)-P›h%2˺šº»˜Œ €’É =_ÜëwJ¶v&­Ñ÷”lH*P:Þ 4²ä€Þ\í£~ë×sV h_]{.› ¤:/e„SÑq¶e3„Ò¬ãÈf¥ÇÙ—ÍJß8Îï²BéÐq^Éf¥ŽãŒÅ²Ÿv@{²)BhAdS„Ð ‚î˦¡Sú‹lŠº Ȧ¥™}Ù T*Pª@¨U  TŽ¨ͺ¨ͺ¨ͺ¨ͺ²Â}ÿÁ¯Ñù¢ûäCÄŽá¾äȧC±c8Iüdôi/¶U ÝÒúœ¢÷¼Gï ªõÄ9~‰< Úå¾?axQº‚iD£ç˜.¾ ÅhÏó<ýšÒÕº¯¢}Þu9Š&ëõã Ýîû‰º?h± ´zݪä¯Kü<× Ú“ýfã8h·ûþÖ÷Ûh†Á T˜ïsešäѧè9¢…<È‘o¸ÏyÂ~zú sè>#Ô Mº«ôöC«B)Fi¸]ó;8(©ú€v¹ïW&*h¹6s%n¾Ÿxäèz±q@‚ù¢}‰L£%žè™;%1¢ib½ý¤‰O¥>'ºÎlc‡} ³i1_B»½ˆt®ùÞ›£ÜÝŽ?k#¿Ô›£—à5ÄÉÃ)¼‰‰!ÄC^2€¾vßç(¤ ¦Zb¸ùÞ]G ŽüÞÔ»sÒEg?oro¿ÎAçð-nÁŽ¾©ïrßJd Óú>dwW˜ï1õ»ü‚˜ú‹ðtä÷,&S¿ ë¶H=÷ö#è.Fá Ð©‡zÛg1u¹ï¡JX¸PZ´2I…ùoòÅDlÝÖù¢]ðÊ“ ‹i’Nrg¿»˜*t’bÅ.¾˜*8|Ë“û>šü ¾½(do††ìx[*Pª@cƒFwßrä'boì¾îûcn|çY@o·#¿= Òg‘»ý§çÕÞ02ùï¨Í“èÌ=Heª3rßìh{ü$ao1ȳ‘r’^Ãùk1FlB/ò‹$3¿ë¤aD>Ä‹¬' ‘Ã#÷ Ï á"O ÆŸ£= ù9aŒÙTœÝCøÓÃN¦þS΋kÿ$ŠPx63êâÄ/ãìN9sI"tH'…¿)þ £šd)Ü}_£å°«±ÏÍ9»é@rÍÄ/ù÷_¤ÈIÈ•õ˜'ξÜNt6n‰º²Ÿ*'!1KT‚9S'c•¨"”¦´«D’ðKFæý‡¿üK”ÜûùŽ]–J“§œO]—Vš†kj0GZ Using QCustomPlot with special Qt define flags
Using QCustomPlot with special Qt define flags

Safe string casts with QT_NO_CAST_FROM_ASCII and QT_NO_CAST_TO_ASCII

QCustomPlot can be compiled with the special Qt flags QT_NO_CAST_FROM_ASCII and QT_NO_CAST_TO_ASCII out of the box. All strings used in the library are wrapped in QLatin1String to avoid casts from string/char literals. So if your project requires the added cast safety from these Qt flags, you can use QCustomPlot without any changes necessary.

Avoiding Qt specific language extensions with QT_NO_KEYWORDS

QCustomPlot is a library based on and written in Qt. This means it uses Qt keywords such as foreach, signal, slot and emit for improved readability.

However, some projects wish to disable these Qt specific language extensions by using the define flag QT_NO_KEYWORDS. To compile QCustomPlot with that flag set, it is necessary to replace all occurrences of Qt keywords. This is easily done with QCustomPlot code, by using the following regular expression replacements:

Search patternReplace with
(^|[^\a_])emit\s\1Q_EMIT —note the trailing space
^( *)signals:\1Q_SIGNALS:
(^|[^\a_])foreach( *)\(\1Q_FOREACH\2(

QCustomPlot code is written with these replacements in mind. They always work and catch all occurrences of used Qt keywords. Their functioning is also automatically tested upon every release.

The regular expressions can be applied in any IDE/Editor that supports them, including QtCreator itself. Below is a python script that is used to test the functioning of the regular expressions. It takes the names of the files to process (e.g. qcustomplot.cpp qcustomplot.h) from the command line and performs the replacement on them.

#!/usr/bin/env python
# This script is used to make the amalgamated sources qcustomplot.h/.cpp compatible
# to compiles with flag QT_NO_KEYWORDS set. It applies the following regular expression replacements
#
# (^|[^\a_])emit\s -> \1Q_EMIT
# ^( *)signals: -> \1Q_SIGNALS:
# (^|[^\a_])foreach( *)\( -> \1Q_FOREACH\2(
#
# to the files whose filenames are passed on the command line. The replacement can in principle be
# applied to the sources with any other tool or editor that knows regular expressions.
#
# To test: Copy freshly amalgamated qcustomplot.h/.cpp files into this directory, call this script on
# them, and then run qmake; make
import os, sys, re
baseDir = sys.path[0]
os.chdir(baseDir) # change current working dir to script dir
def performKeywordReplacement(filename):
print("making '"+filename+"' no-keywords-compatible...")
patterns = []
patterns.append((re.compile(r"(^|[^\a_])emit\s"), r"\1Q_EMIT "))
patterns.append((re.compile(r"^( *)signals:"), r"\1Q_SIGNALS:"))
patterns.append((re.compile(r"(^|[^\a_])foreach( *)\("), r"\1Q_FOREACH\2("))
inFile = open(filename)
outFilename = filename + ".tmp"
outFile = open(outFilename, "w")
for line in inFile:
for patt in patterns:
line = re.sub(patt[0], patt[1], line)
outFile.write(line)
outFile.close()
inFile.close()
os.remove(filename)
os.rename(outFilename, filename)
for filename in sys.argv[1:]:
if not os.path.isfile(filename):
print("file '"+filename+"' not found")
sys.exit(-1)
performKeywordReplacement(filename)







qcustomplot-2.1.0+dfsg1/documentation/html/layoutsystem-addinglegendtitle.png0000644000175000017500000000510514030601040027571 0ustar rusconirusconi‰PNG  IHDR,Èe,ggAMA† 1è–_ÀPLTEÿÿÿþô»N qèýýÿï¤,0êøûøþåOÁøþÝtÔÒÓøôÇ+’éý“““õÎmb›¥Ó÷üh,5ã¤R'X¯éá“,+’è“& OÂ/œ'hÀ“hnžÒïQUeTV¦÷Í^ êïìQ°kÔøÑlTn©2" ZÈ›¦g¬T+f¦¿·äΡ dÒ­«’°ñþm þÿæÿû׆åÿ}âàÓÐebKGDˆH pHYsÃÃÇo¨d¬IDATxÚí]_ª:'¦)’•¦¦fEIÆ­,{iÚ{ßÿ[½ PgWe‡œÿ¯nÜÅéœý=gc;cS@ ‘9œ¨„BñÐfd§¥²¦i‡¶"#¨èg‡6!;¨ê„åC[‘ÔŠ¦eœ{—ÄÃÅ…‚_ÛQÑ}×"‡þಀ*’%†Ëzüjaå\DŠ&upU-ÚÀ·¯ýk$ „aí áBR}Ü)ªÂ0a€žB²B† g„d|t iDV¤z'‹4mé’1 DV6{Ãã"+½ È¥ = `Ÿ”½áþ9Ñ…a¸W]†û,€}ÙÃ{Öî®/8葛߷™Wô¶~±ruäÛWW{©6<«Cšww×ëe§w÷¿oëûîá±8p¼®®tKvH¡ñ¤õˆáañT%†Þ>§žœP‡j?ÓÛ\Òþs¯TJÔ¿^tBšuž¨ís–¥)4b’åÑ!al CÊýFY‘÷‘ [:#â”-ê6(µãzÍ%}vå’OF–Enÿù* è&€x–ýõuß#CS5hµË¬öYAEÛ˃Žïtã™s$ÒeW=Ÿ,V`OvéÚjß@¿ÉY´ÍªwÈ ã†÷¬ à±öö‡zMçå’u>pì))»Œ,ûƒz×½½UOÉÙ.]Ûì3U‡¬„±% Y|›åœø Ÿ=vn5¶XïÁ!ߤˮêôvJ–Kïyoèú ͵ÕLyÖ̯ZDZb  k‹}ƒïëivÉb½×ùí¡d™Ó×Ù’, ×g¥û²>˵'³ {Ö^æY¦êy“¿\É ±¯V«§ýZê†E¨€º0 ÿÖu,cÃäp„cCIt¡gìC²öÉ„@›¼Ù«¿¦Q“Ñ•}ÏÒ´^û<ò{[¹ Þ7—Ŧ‹Õï:ÈvÒ,}œge>½ÑèoŒë-²ù ÃY}Xì8åªÓ¼~ªêCÍ% ²*¥áÓ¨9Ù, Ã#ÈH{d±fV¿êüø×'ê‚,ö¿ª³å­Ác ÃC°N–kO(YÝKÆ »žOd¹^PÞ©+A²FtÏšö=â<ËTozÛB¬KbÏ‚‘E[&¿Í:c¯¼Ý;ä³¢ÿ(-‡¶Yù?[fV% ad-zC¯q¢½a»ô©Ø¯7Ü”ØI‰¬„±›h›µw]ÇÐnœ¬|„áFHCVÂÀ)šÜÎ: YòÃð(<ëXàº0 c모«{0 Cì»|¿Ÿ[ÁPÉ°¯gÄØ^%½ à”e,ì H¦k¬+w³ïY§¥­UêÇÏîl±¯å¬ö¢‰²>ë"ÒÂ+a)0YÊÌ*xKnMõSa3ð½ì§)üÆ.²Vz·ÝcZÆs„O1€Éšµôa°°ºE—ØŽñá§)¼F\]±6“, ½ÅïA¢ӜXïßÏ£BÇOSx 1]›íkÕ‹óQÏ’*aÁÂPáõR]½]¦)¶¦uDÉr˜ÏY Þf)Ë„…©¾4'#»TÒ²ömXÉÂÐ#+HXhéÒŸíó MÛ³ÖnÎüØ0 +HX(=òC‹èƒ‘Ÿ¦Ø/Y‘ê,¤Æ6L*ÏŠœ)Ã0)]èYû,€}¸´;iÃrëY‰V;šÔq‘•^äÒ…ž°ïxÈèl{ò² V…NêÈYoèMþÏ3«Ðx¢ßæ]»X^ìOWö=‹%,4M™O_½o r†þ ÛàÈ >f¼Ñ0d³3Þi´p^–,cÅõÒ'Ë>oЕ‡Þ0˜Ïb+ýØ7娢?6ÆlÚ¯²HZt§¥O¿xTh̬ÕkQ¹ C–dmpdù«—ƒ /iQVfÖÐ/8g‹éÂ_º2†°„G–ëå§ÙÅ*iAÉò‹i»Öñ7ùI‰¬„7 WžµJZ,=Kqí+îåÄœ-í^ö†K²ªú°8¾÷Ú¬eÒ‚’åÓç/§¼QW¦ÃP˜,ï9‹#Kép½a´ di^1½âßå %‹m¡dÄ9w'a$kÓ|Úç^{ Õuù~m^Ùy]ŸÕYKŽ‰­ÏjË{üU’dÑ ò«“DÈÒFvŒõY C¶)šÖ¢GÈþú¬¸d…®ÏºÔ;Ãæ- wèÚbßei·†!¨ÒñåÓ“Ý°y–6òÚ©Ÿè†åˆ¬ƒ&\Ãœ»#d¼6 {–´ªd CiUɆÒ= „d„0 @Ïá£@à C€’Â0= „½!@à C€’Â0= „d„d\Ú--г„4×ù/¸D²B„æ–¡Ç"+O˜Ý}¨èYÂB'H–¸G–„çèK '+£wŠª,€PL²òô¬HBH@dž g„,€!èY!$ „af¤B†! CгBH@Ãì B†! CгBH@Ãô,€>:„"yV´ØͨªŽ¾:+,›5HOU¥44­8ûg¼)ªòv¤ v&›nÞX˜âïn ×n,ö‘ÈB‰Lá0*—«RÝÊDr„z"|›…ÛŸym³NÄø;#À{ÄÁ½Ì"~‹baðç΃0Ðo öQU¤°ë0j~Ü# þeqð[„VçÎC`ªJÖi©ÌöþÞHÏüË,0ô¸MëÅ… °æÚ*”¬J( ŸNO¢‘µÜ¢‚å¹ó ¾¯§P²ªzXÄóã"’ÕrÀÍwî¼8Ìéë L–R+šÖN'NÕ³V[ƒjn­Ž}„kO"¥¬NmߌˆãžHdq[ï±`ªÞ¨¸×VÝ©*â¸' YüÅÂàÏG­VOû5˜Ðe½a^5wö%ÑÆ=ÈZÛ¢Xü¹ó ÀÃvo@ „,ø¼Høø¶š²%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_z.html0000644000175000017500000000232614030601037024073 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- z -

qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-time2.png0000644000175000017500000000225314030601041024530 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨dÝIDATxÚ휽nÛ0F¿þ~ˆ6»7nú o]ûJ÷N;yêRg6ú‡ ]¸eéÔô!´u°,ˉ\›Ž¨{%Ÿ“!"C@ÇŸ"Z?$%8;Jköì <8Øxp°7h8<µ68:, )ÖáKÃC-qùø=Ø;ØxpÈoàÁ!ÿ‘8³¸Â€Áð¤±íááÀC&Ö#ã™á¾£¤_ÆŸßÞÁÞÀƒƒ½{ÿÁÿ8¬ ¨RQáÌf*53Ü¿‡¹Jóã`ï`o`èà¿ÃZj¡‰n´¿Až1PöiRŽ‡îö)ë7WëŸ.-ìR Öoólψ\ƒÄÛ{{öì |8¸¤ëw@Ãt°7ðà`oàÁÁÞÀ‡ƒKb5 ä¼ì <8Øxp°7ðáÿawTSÛ§Ã-Kse§¶µ}ò) XO¯Ü EÛ-ÛâqŠE3æ™é}) ØÎ /”Úꚥn˜©mþvfz~R R8þçnç…ßêâ^)êûÝÐ6uõµþJ½) ô¿¼ÌËj‹¶’ô¶j_‹<}Ñ« HHáú¿ÂÚ]]ªm­©Ã-ºæþ Gù HHáú¿ÂÚ·ºÔ¶t¸E·<\á(¿)) „X­.[J«j1Öý-º³˜Õ[Í™R}) Ø?¢c3+¼1›Ã³»ÂQ¤@ ¤0:þ•‡J ] º%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemRect.html0000644000175000017500000014775714030601040024654 0ustar rusconirusconi QCPItemRect Class Reference
Public Functions | Public Members | Protected Types | Protected Functions
QCPItemRect Class Reference

A rectangle. More...

Inheritance diagram for QCPItemRect:
Inheritance graph

Public Functions

 QCPItemRect (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
QBrush brush () const
 
QBrush selectedBrush () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setSelectedBrush (const QBrush &brush)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const topLeft
 
QCPItemPosition *const bottomRight
 
QCPItemAnchor *const top
 
QCPItemAnchor *const topRight
 
QCPItemAnchor *const right
 
QCPItemAnchor *const bottom
 
QCPItemAnchor *const bottomLeft
 
QCPItemAnchor *const left
 

Protected Types

enum  AnchorIndex
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
QPen mainPen () const
 
QBrush mainBrush () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A rectangle.

QCPItemRect.png
Rectangle example. Blue dotted circles are anchors, solid blue discs are positions.

It has two positions, topLeft and bottomRight, which define the rectangle.

Constructor & Destructor Documentation

§ QCPItemRect()

QCPItemRect::QCPItemRect ( QCustomPlot *  parentPlot)
explicit

Creates a rectangle item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemRect::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the line of the rectangle

See also
setSelectedPen, setBrush

§ setSelectedPen()

void QCPItemRect::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the line of the rectangle when selected

See also
setPen, setSelected

§ setBrush()

void QCPItemRect::setBrush ( const QBrush &  brush)

Sets the brush that will be used to fill the rectangle. To disable filling, set brush to Qt::NoBrush.

See also
setSelectedBrush, setPen

§ setSelectedBrush()

void QCPItemRect::setSelectedBrush ( const QBrush &  brush)

Sets the brush that will be used to fill the rectangle when selected. To disable filling, set brush to Qt::NoBrush.

See also
setBrush

§ selectTest()

double QCPItemRect::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemRect::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ anchorPixelPosition()

QPointF QCPItemRect::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Returns the pixel position of the anchor with Id anchorId. This function must be reimplemented in item subclasses if they want to provide anchors (QCPItemAnchor).

For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor ids and returns the respective pixel points of the specified anchor.

See also
createAnchor

Reimplemented from QCPAbstractItem.

§ mainPen()

QPen QCPItemRect::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

§ mainBrush()

QBrush QCPItemRect::mainBrush ( ) const
protected

Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item is not selected and mSelectedBrush when it is.

The documentation for this class was generated from the following files:
  • src/items/item-rect.h
  • src/items/item-rect.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/selectiontype-singledata.png0000644000175000017500000000351414030601041026345 0ustar rusconirusconi‰PNG  IHDR´n|F$HgAMA† 1è–_0PLTEÿÿÿZZ[ÿëø˜˜˜dddèèè±±±www×××ÇÇLJ‡‡µŽ¦ÿÒíÿ¤Ûý_ÿG©°‹ÄbKGDˆH pHYsÃÃÇo¨dCIDAThÞí™KoÛF€×âÃ’€{e&>)MP=Rìú,F’ø¤ F‚ôD#j>‰µ›Ø=Ñ÷(#Ò£Ò¦Úþ^û Š¢÷*ÿ èÌÒ–HjW\åçà"‹äîÇÙÙÙ™Ù cgr&gò¡ @á ?…÷§T*úÍßýÑoÿîÓÐú4Ño.§©õië4´>Mô„r±~y­o|=zVñûq …¶¹ÛÕ&ç\€.›æNI£qaàŠ6Ú-/ëh]¸6‰Ö¼ËPõj*úb}24óÁazè:¬Mdö/2†Ú¤äK|ÿ šm1Ê/i./)Ñ·šBœ~o¥UßÑFO?uyƒ­ÍŒÖ,k9 ॷ<РZOñËDuæÙÌ.Siýø®‚oÐ*= tÅE?›ÂÙö¢·ñí!ºbÂÓÄva…±Emh—÷Uè ÂPUŽNZ Ž&&c»ô†¼g6UZûÀ—¾~ÀiiÙš,ÁØ ÙÅlæ=ºüS²Å¼—X±Ý«¦Æ–óÖRƒYûÞ:3Öê÷ÿbbYVéKç#¨Bøªtr¶úy¿ÿ/þ°|§I(¦ŒÈ…¤Êéh»÷ºßE¿2%FÁÈð#²?ü)´¶wK©hÃ;A ±p6ÏIšm&Ð<5ŠX­îßýþÃyWå#~Lh\·|¼Ú9ßuç>î÷ÿ‰ÜsÊZÅÑ6UÇÕg‡äÍׯ¢÷ R¿Ú‰£ Ôú w=5Ú§x^È{Ù;A²e"!S Ã`UT£A†ÎÕž×ãNÒrnG¦–´f•ú¬?¶ˆò…AèºU[8»GgÆ -râúˆ/%‡"–h1Ž¦ì4¦>£.î$”f7‰¾W0DSNU×g-éˆ:f%Sæ”–®H×ta)iDaëj¢%öÛJô¡tMpsЊôÀáõ ¡µµ í}%zÚåm ·4†»Õa·ºÑBr÷™YR²ýšâÝ‹]nÆ® CݺL%Ò´L=³ñÑ48Ö ¬"g¤nYˆw'iŒ6’Ð "9éÑ3Vô«K¥¹¦â ôQ˜sŽÇÝSh½€å¾\äYYô¼-2¥\…!º2ÛŽ¥5fµoÄEÚ6HÑ ¨àqI—èyáp˜ØëPS£ç%êYA%Ú\ÛMÄÝ!šb²dil¸b§¡@/`¯óᵑ̘”ë‘ËÁM¹IB[ôÞÞPë@>#™»ôÚˆ/ s¼ °²”À°†[Ðãþ®Üpǯå?ùñ´Cqr5Pu¡=XÝû𳪎Ž¯'ÜD–ãh®Uœw ØÌJ(”£æÔ=pç1»™†òÖŸ¨?Ñ+Á˜·§Uœ‹ '”–j‰žôxªWœ‹ÄNÇJC1¤EtLtŠó0±Ç-k¥ïû0‰}¢…æñc—Dœ”‰Ý» ßꤶ¿ã¥vÊVÝ´š†_çí¸/™AúXq9~®ÃÁÝgñšAdz¶Üh9F¦ð_îÞÉ•Îzxš‡nÓËøðÝoââI-½Ã%Š2:dš¸{®ÆH±"¬·µÐXŽLÔÉ{c· Ç‚–>WÕBcÑ!Ð+öïݤ/Fqªs„½ò×^4fDzV`eìj¥®…™+ý(7ÏçKϴȶ»ÃÌe—?äH¹¬”ÇÛ[íj éÔoeïŠ_•G’uµÎÀé¬Çg~OhG£Ê´^KÚŽà¬_€öy¼)N.µ´Þ¥0ÿcËѱ`¨5×hF¶ž4¹LüïDº“ÒùÄñzÇÃ'òL#ª’,ÒÖCïP{RéPjñõŽâ'”KT‚w€7ß=Ú§ð›}ñë»')fßV ÐÉ¢šÖÌÕ “ËWüòÛCÎä˜ÀÒßå%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPCurve.html0000644000175000017500000040013414030601040024201 0ustar rusconirusconi QCPCurve Class Reference
Public Types | Public Functions | Protected Functions
QCPCurve Class Reference

A plottable representing a parametric curve in a plot. More...

Inheritance diagram for QCPCurve:
Inheritance graph

Public Types

enum  LineStyle
 

Public Functions

 QCPCurve (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QSharedPointer< QCPCurveDataContainer > data () const
 
QCPScatterStyle scatterStyle () const
 
int scatterSkip () const
 
LineStyle lineStyle () const
 
void setData (QSharedPointer< QCPCurveDataContainer > data)
 
void setData (const QVector< double > &t, const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void setData (const QVector< double > &keys, const QVector< double > &values)
 
void setScatterStyle (const QCPScatterStyle &style)
 
void setScatterSkip (int skip)
 
void setLineStyle (LineStyle style)
 
void addData (const QVector< double > &t, const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void addData (const QVector< double > &keys, const QVector< double > &values)
 
void addData (double t, double key, double value)
 
void addData (double key, double value)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
- Public Functions inherited from QCPAbstractPlottable1D< QCPCurveData >
 QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual QPointF dataPixelPosition (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
virtual void drawCurveLine (QCPPainter *painter, const QVector< QPointF > &lines) const
 
virtual void drawScatterPlot (QCPPainter *painter, const QVector< QPointF > &points, const QCPScatterStyle &style) const
 
void getCurveLines (QVector< QPointF > *lines, const QCPDataRange &dataRange, double penWidth) const
 
void getScatters (QVector< QPointF > *scatters, const QCPDataRange &dataRange, double scatterWidth) const
 
int getRegion (double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const
 
QPointF getOptimizedPoint (int otherRegion, double otherKey, double otherValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const
 
QVector< QPointF > getOptimizedCornerPoints (int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const
 
bool mayTraverse (int prevRegion, int currentRegion) const
 
bool getTraverse (double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const
 
void getTraverseCornerPoints (int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector< QPointF > &beforeTraverse, QVector< QPointF > &afterTraverse) const
 
double pointDistance (const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const
 
- Protected Functions inherited from QCPAbstractPlottable1D< QCPCurveData >
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A plottable representing a parametric curve in a plot.

QCPCurve.png

Unlike QCPGraph, plottables of this type may have multiple points with the same key coordinate, so their visual representation can have loops. This is realized by introducing a third coordinate t, which defines the order of the points described by the other two coordinates x and y.

To plot data, assign it with the setData or addData functions. Alternatively, you can also access and modify the curve's data via the data method, which returns a pointer to the internal QCPCurveDataContainer.

Gaps in the curve can be created by adding data points with NaN as key and value (qQNaN() or std::numeric_limits<double>::quiet_NaN()) in between the two data points that shall be separated.

Changing the appearance

The appearance of the curve is determined by the pen and the brush (setPen, setBrush).

Usage

Like all data representing objects in QCustomPlot, the QCPCurve is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.)

Usually, you first create an instance:

QCPCurve *newCurve = new QCPCurve(customPlot->xAxis, customPlot->yAxis);

which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.:

newCurve->setName("Fermat's Spiral");
newCurve->setData(tData, xData, yData);

Member Enumeration Documentation

§ LineStyle

enum QCPCurve::LineStyle

Defines how the curve's line is represented visually in the plot. The line is drawn with the current pen of the curve (setPen).

See also
setLineStyle
Enumerator
lsNone 

No line is drawn between data points (e.g. only scatters)

lsLine 

Data points are connected with a straight line.

Constructor & Destructor Documentation

§ QCPCurve()

QCPCurve::QCPCurve ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs a curve which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

The created QCPCurve is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPCurve, so do not delete it manually but use QCustomPlot::removePlottable() instead.

Member Function Documentation

§ data()

QSharedPointer< QCPCurveDataContainer > QCPCurve::data ( ) const
inline

Returns a shared pointer to the internal data storage of type QCPCurveDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular setData or addData methods.

§ setData() [1/3]

void QCPCurve::setData ( QSharedPointer< QCPCurveDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPCurves may share the same data container safely. Modifying the data in the container will then affect all curves that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

curve2->setData(curve1->data()); // curve1 and curve2 now share data container

If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the curve's data container directly:

curve2->data()->set(*curve1->data()); // curve2 now has copy of curve1's data in its container
See also
addData

§ setData() [2/3]

void QCPCurve::setData ( const QVector< double > &  t,
const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data with the provided points in t, keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by t in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

See also
addData

§ setData() [3/3]

void QCPCurve::setData ( const QVector< double > &  keys,
const QVector< double > &  values 
)

This is an overloaded function.

Replaces the current data with the provided points in keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

The t parameter of each data point will be set to the integer index of the respective key/value pair.

See also
addData

§ setScatterStyle()

void QCPCurve::setScatterStyle ( const QCPScatterStyle &  style)

Sets the visual appearance of single data points in the plot. If set to QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only plots with appropriate line style).

See also
QCPScatterStyle, setLineStyle

§ setScatterSkip()

void QCPCurve::setScatterSkip ( int  skip)

If scatters are displayed (scatter style not QCPScatterStyle::ssNone), skip number of scatter points are skipped/not drawn after every drawn scatter point.

This can be used to make the data appear sparser while for example still having a smooth line, and to improve performance for very high density plots.

If skip is set to 0 (default), all scatter points are drawn.

See also
setScatterStyle

§ setLineStyle()

void QCPCurve::setLineStyle ( QCPCurve::LineStyle  style)

Sets how the single data points are connected in the plot or how they are represented visually apart from the scatter symbol. For scatter-only plots, set style to lsNone and setScatterStyle to the desired scatter style.

See also
setScatterStyle

§ addData() [1/4]

void QCPCurve::addData ( const QVector< double > &  t,
const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Adds the provided points in t, keys and values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ addData() [2/4]

void QCPCurve::addData ( const QVector< double > &  keys,
const QVector< double > &  values 
)

This is an overloaded function.

Adds the provided points in keys and values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

The t parameter of each data point will be set to the integer index of the respective key/value pair.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ addData() [3/4]

void QCPCurve::addData ( double  t,
double  key,
double  value 
)

This is an overloaded function. Adds the provided data point as t, key and value to the current data.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ addData() [4/4]

void QCPCurve::addData ( double  key,
double  value 
)

This is an overloaded function.

Adds the provided data point as key and value to the current data.

The t parameter is generated automatically by increments of 1 for each point, starting at the highest t of previously existing data or 0, if the curve data is empty.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ selectTest()

double QCPCurve::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a selectTest specific to this plottable's point geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation. QCPAbstractPlottable::selectTest

Reimplemented from QCPAbstractPlottable1D< QCPCurveData >.

§ getKeyRange()

QCPRange QCPCurve::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPCurve::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ draw()

void QCPCurve::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPCurve::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

§ drawCurveLine()

void QCPCurve::drawCurveLine ( QCPPainter *  painter,
const QVector< QPointF > &  lines 
) const
protectedvirtual

Draws lines between the points in lines, given in pixel coordinates.

See also
drawScatterPlot, getCurveLines

§ drawScatterPlot()

void QCPCurve::drawScatterPlot ( QCPPainter *  painter,
const QVector< QPointF > &  points,
const QCPScatterStyle &  style 
) const
protectedvirtual

Draws scatter symbols at every point passed in points, given in pixel coordinates. The scatters will be drawn with painter and have the appearance as specified in style.

See also
drawCurveLine, getCurveLines

§ getCurveLines()

void QCPCurve::getCurveLines ( QVector< QPointF > *  lines,
const QCPDataRange &  dataRange,
double  penWidth 
) const
protected

Called by draw to generate points in pixel coordinates which represent the line of the curve.

Line segments that aren't visible in the current axis rect are handled in an optimized way. They are projected onto a rectangle slightly larger than the visible axis rect and simplified regarding point count. The algorithm makes sure to preserve appearance of lines and fills inside the visible axis rect by generating new temporary points on the outer rect if necessary.

lines will be filled with points in pixel coordinates, that can be drawn with drawCurveLine.

dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in dataRange, e.g. when extending ranges coming from getDataSegments.

penWidth specifies the pen width that will be used to later draw the lines generated by this function. This is needed here to calculate an accordingly wider margin around the axis rect when performing the line optimization.

Methods that are also involved in the algorithm are: getRegion, getOptimizedPoint, getOptimizedCornerPoints mayTraverse, getTraverse, getTraverseCornerPoints.

See also
drawCurveLine, drawScatterPlot

§ getScatters()

void QCPCurve::getScatters ( QVector< QPointF > *  scatters,
const QCPDataRange &  dataRange,
double  scatterWidth 
) const
protected

Called by draw to generate points in pixel coordinates which represent the scatters of the curve. If a scatter skip is configured (setScatterSkip), the returned points are accordingly sparser.

Scatters that aren't visible in the current axis rect are optimized away.

scatters will be filled with points in pixel coordinates, that can be drawn with drawScatterPlot.

dataRange specifies the beginning and ending data indices that will be taken into account for conversion.

scatterWidth specifies the scatter width that will be used to later draw the scatters at pixel coordinates generated by this function. This is needed here to calculate an accordingly wider margin around the axis rect when performing the data point reduction.

See also
draw, drawScatterPlot

§ getRegion()

int QCPCurve::getRegion ( double  key,
double  value,
double  keyMin,
double  valueMax,
double  keyMax,
double  valueMin 
) const
protected

This function is part of the curve optimization algorithm of getCurveLines.

It returns the region of the given point (key, value) with respect to a rectangle defined by keyMin, keyMax, valueMin, and valueMax.

The regions are enumerated from top to bottom (valueMin to valueMax) and left to right (keyMin to keyMax):

147
258
369

With the rectangle being region 5, and the outer regions extending infinitely outwards. In the curve optimization algorithm, region 5 is considered to be the visible portion of the plot.

§ getOptimizedPoint()

QPointF QCPCurve::getOptimizedPoint ( int  otherRegion,
double  otherKey,
double  otherValue,
double  key,
double  value,
double  keyMin,
double  valueMax,
double  keyMax,
double  valueMin 
) const
protected

This function is part of the curve optimization algorithm of getCurveLines.

This method is used in case the current segment passes from inside the visible rect (region 5, see getRegion) to any of the outer regions (otherRegion). The current segment is given by the line connecting (key, value) with (otherKey, otherValue).

It returns the intersection point of the segment with the border of region 5.

For this function it doesn't matter whether (key, value) is the point inside region 5 or whether it's (otherKey, otherValue), i.e. whether the segment is coming from region 5 or leaving it. It is important though that otherRegion correctly identifies the other region not equal to 5.

§ getOptimizedCornerPoints()

QVector< QPointF > QCPCurve::getOptimizedCornerPoints ( int  prevRegion,
int  currentRegion,
double  prevKey,
double  prevValue,
double  key,
double  value,
double  keyMin,
double  valueMax,
double  keyMax,
double  valueMin 
) const
protected

This function is part of the curve optimization algorithm of getCurveLines.

In situations where a single segment skips over multiple regions it might become necessary to add extra points at the corners of region 5 (see getRegion) such that the optimized segment doesn't unintentionally cut through the visible area of the axis rect and create plot artifacts. This method provides these points that must be added, assuming the original segment doesn't start, end, or traverse region 5. (Corner points where region 5 is traversed are calculated by getTraverseCornerPoints.)

For example, consider a segment which directly goes from region 4 to 2 but originally is far out to the top left such that it doesn't cross region 5. Naively optimizing these points by projecting them on the top and left borders of region 5 will create a segment that surely crosses 5, creating a visual artifact in the plot. This method prevents this by providing extra points at the top left corner, making the optimized curve correctly pass from region 4 to 1 to 2 without traversing 5.

§ mayTraverse()

bool QCPCurve::mayTraverse ( int  prevRegion,
int  currentRegion 
) const
protected

This function is part of the curve optimization algorithm of getCurveLines.

This method returns whether a segment going from prevRegion to currentRegion (see getRegion) may traverse the visible region 5. This function assumes that neither prevRegion nor currentRegion is 5 itself.

If this method returns false, the segment for sure doesn't pass region 5. If it returns true, the segment may or may not pass region 5 and a more fine-grained calculation must be used (getTraverse).

§ getTraverse()

bool QCPCurve::getTraverse ( double  prevKey,
double  prevValue,
double  key,
double  value,
double  keyMin,
double  valueMax,
double  keyMax,
double  valueMin,
QPointF &  crossA,
QPointF &  crossB 
) const
protected

This function is part of the curve optimization algorithm of getCurveLines.

This method assumes that the mayTraverse test has returned true, so there is a chance the segment defined by (prevKey, prevValue) and (key, value) goes through the visible region 5.

The return value of this method indicates whether the segment actually traverses region 5 or not.

If the segment traverses 5, the output parameters crossA and crossB indicate the entry and exit points of region 5. They will become the optimized points for that segment.

§ getTraverseCornerPoints()

void QCPCurve::getTraverseCornerPoints ( int  prevRegion,
int  currentRegion,
double  keyMin,
double  valueMax,
double  keyMax,
double  valueMin,
QVector< QPointF > &  beforeTraverse,
QVector< QPointF > &  afterTraverse 
) const
protected

This function is part of the curve optimization algorithm of getCurveLines.

This method assumes that the getTraverse test has returned true, so the segment definitely traverses the visible region 5 when going from prevRegion to currentRegion.

In certain situations it is not sufficient to merely generate the entry and exit points of the segment into/out of region 5, as getTraverse provides. It may happen that a single segment, in addition to traversing region 5, skips another region outside of region 5, which makes it necessary to add an optimized corner point there (very similar to the job getOptimizedCornerPoints does for segments that are completely in outside regions and don't traverse 5).

As an example, consider a segment going from region 1 to region 6, traversing the lower left corner of region 5. In this configuration, the segment additionally crosses the border between region 1 and 2 before entering region 5. This makes it necessary to add an additional point in the top left corner, before adding the optimized traverse points. So in this case, the output parameter beforeTraverse will contain the top left corner point, and afterTraverse will be empty.

In some cases, such as when going from region 1 to 9, it may even be necessary to add additional corner points before and after the traverse. Then both beforeTraverse and afterTraverse return the respective corner points.

§ pointDistance()

double QCPCurve::pointDistance ( const QPointF &  pixelPoint,
QCPCurveDataContainer::const_iterator &  closestData 
) const
protected

Calculates the (minimum) distance (in pixels) the curve's representation has from the given pixelPoint in pixels. This is used to determine whether the curve was clicked or not, e.g. in selectTest. The closest data point to pixelPoint is returned in closestData. Note that if the curve has a line representation, the returned distance may be smaller than the distance to the closestData point, since the distance to the curve line is also taken into account.

If either the curve has no data or if the line style is lsNone and the scatter style's shape is QCPScatterStyle::ssNone (i.e. there is no visual representation of the curve), returns -1.0.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/namespaceQCP.html0000644000175000017500000010764114030601036024037 0ustar rusconirusconi QCP Namespace Reference
Enumerations | Functions | Variables
QCP Namespace Reference

Enumerations

enum  ResolutionUnit
 
enum  ExportPen
 
enum  SignDomain
 
enum  MarginSide
 
enum  AntialiasedElement
 
enum  PlottingHint
 
enum  Interaction
 
enum  SelectionRectMode
 
enum  SelectionType
 

Functions

bool isInvalidData (double value)
 
bool isInvalidData (double value1, double value2)
 
void setMarginValue (QMargins &margins, QCP::MarginSide side, int value)
 
int getMarginValue (const QMargins &margins, QCP::MarginSide side)
 

Variables

const QMetaObject staticMetaObject
 

Detailed Description

The QCP Namespace contains general enums, QFlags and functions used throughout the QCustomPlot library.

It provides QMetaObject-based reflection of its enums and flags via QCP::staticMetaObject.

Enumeration Type Documentation

§ ResolutionUnit

enum QCP::ResolutionUnit

Defines the different units in which the image resolution can be specified in the export functions.

See also
QCustomPlot::savePng, QCustomPlot::saveJpg, QCustomPlot::saveBmp, QCustomPlot::saveRastered
Enumerator
ruDotsPerMeter 

Resolution is given in dots per meter (dpm)

ruDotsPerCentimeter 

Resolution is given in dots per centimeter (dpcm)

ruDotsPerInch 

Resolution is given in dots per inch (DPI/PPI)

§ ExportPen

enum QCP::ExportPen

Defines how cosmetic pens (pens with numerical width 0) are handled during export.

See also
QCustomPlot::savePdf
Enumerator
epNoCosmetic 

Cosmetic pens are converted to pens with pixel width 1 when exporting.

epAllowCosmetic 

Cosmetic pens are exported normally (e.g. in PDF exports, cosmetic pens always appear as 1 pixel on screen, independent of viewer zoom level)

§ SignDomain

enum QCP::SignDomain

Represents negative and positive sign domain, e.g. for passing to QCPAbstractPlottable::getKeyRange and QCPAbstractPlottable::getValueRange.

This is primarily needed when working with logarithmic axis scales, since only one of the sign domains can be visible at a time.

Enumerator
sdNegative 

The negative sign domain, i.e. numbers smaller than zero.

sdBoth 

Both sign domains, including zero, i.e. all numbers.

sdPositive 

The positive sign domain, i.e. numbers greater than zero.

§ MarginSide

enum QCP::MarginSide

Defines the sides of a rectangular entity to which margins can be applied.

See also
QCPLayoutElement::setAutoMargins, QCPAxisRect::setAutoMargins
Enumerator
msLeft 

0x01 left margin

msRight 

0x02 right margin

msTop 

0x04 top margin

msBottom 

0x08 bottom margin

msAll 

0xFF all margins

msNone 

0x00 no margin

§ AntialiasedElement

enum QCP::AntialiasedElement

Defines what objects of a plot can be forcibly drawn antialiased/not antialiased. If an object is neither forcibly drawn antialiased nor forcibly drawn not antialiased, it is up to the respective element how it is drawn. Typically it provides a setAntialiased function for this.

AntialiasedElements is a flag of or-combined elements of this enum type.

See also
QCustomPlot::setAntialiasedElements, QCustomPlot::setNotAntialiasedElements
Enumerator
aeAxes 

0x0001 Axis base line and tick marks

aeGrid 

0x0002 Grid lines

aeSubGrid 

0x0004 Sub grid lines

aeLegend 

0x0008 Legend box

aeLegendItems 

0x0010 Legend items

aePlottables 

0x0020 Main lines of plottables

aeItems 

0x0040 Main lines of items

aeScatters 

0x0080 Scatter symbols of plottables (excluding scatter symbols of type ssPixmap)

aeFills 

0x0100 Borders of fills (e.g. under or between graphs)

aeZeroLine 

0x0200 Zero-lines, see QCPGrid::setZeroLinePen

aeOther 

0x8000 Other elements that don't fit into any of the existing categories

aeAll 

0xFFFF All elements

aeNone 

0x0000 No elements

§ PlottingHint

enum QCP::PlottingHint

Defines plotting hints that control various aspects of the quality and speed of plotting.

See also
QCustomPlot::setPlottingHints
Enumerator
phNone 

0x000 No hints are set

phFastPolylines 

0x001 Graph/Curve lines are drawn with a faster method. This reduces the quality especially of the line segment joins, thus is most effective for pen sizes larger than 1. It is only used for solid line pens.

phImmediateRefresh 

0x002 causes an immediate repaint() instead of a soft update() when QCustomPlot::replot() is called with parameter QCustomPlot::rpRefreshHint. This is set by default to prevent the plot from freezing on fast consecutive replots (e.g. user drags ranges with mouse).

phCacheLabels 

0x004 axis (tick) labels will be cached as pixmaps, increasing replot performance.

§ Interaction

enum QCP::Interaction

Defines the mouse interactions possible with QCustomPlot.

Interactions is a flag of or-combined elements of this enum type.

See also
QCustomPlot::setInteractions
Enumerator
iNone 

0x000 None of the interactions are possible

iRangeDrag 

0x001 Axis ranges are draggable (see QCPAxisRect::setRangeDrag, QCPAxisRect::setRangeDragAxes)

iRangeZoom 

0x002 Axis ranges are zoomable with the mouse wheel (see QCPAxisRect::setRangeZoom, QCPAxisRect::setRangeZoomAxes)

iMultiSelect 

0x004 The user can select multiple objects by holding the modifier set by QCustomPlot::setMultiSelectModifier while clicking

iSelectPlottables 

0x008 Plottables are selectable (e.g. graphs, curves, bars,... see QCPAbstractPlottable)

iSelectAxes 

0x010 Axes are selectable (or parts of them, see QCPAxis::setSelectableParts)

iSelectLegend 

0x020 Legends are selectable (or their child items, see QCPLegend::setSelectableParts)

iSelectItems 

0x040 Items are selectable (Rectangles, Arrows, Textitems, etc. see QCPAbstractItem)

iSelectOther 

0x080 All other objects are selectable (e.g. your own derived layerables, other layout elements,...)

iSelectPlottablesBeyondAxisRect 

0x100 When performing plottable selection/hit tests, this flag extends the sensitive area beyond the axis rect

§ SelectionRectMode

enum QCP::SelectionRectMode

Defines the behaviour of the selection rect.

See also
QCustomPlot::setSelectionRectMode, QCustomPlot::selectionRect, QCPSelectionRect
Enumerator
srmNone 

The selection rect is disabled, and all mouse events are forwarded to the underlying objects, e.g. for axis range dragging.

srmZoom 

When dragging the mouse, a selection rect becomes active. Upon releasing, the axes that are currently set as range zoom axes (QCPAxisRect::setRangeZoomAxes) will have their ranges zoomed accordingly.

srmSelect 

When dragging the mouse, a selection rect becomes active. Upon releasing, plottable data points that were within the selection rect are selected, if the plottable's selectability setting permits. (See data selection mechanism for details.)

srmCustom 

When dragging the mouse, a selection rect becomes active. It is the programmer's responsibility to connect according slots to the selection rect's signals (e.g. QCPSelectionRect::accepted) in order to process the user interaction.

§ SelectionType

enum QCP::SelectionType

Defines the different ways a plottable can be selected. These images show the effect of the different selection types, when the indicated selection rect was dragged:

selectiontype-none.png
stNone
selectiontype-whole.png
stWhole
selectiontype-singledata.png
stSingleData
selectiontype-datarange.png
stDataRange
selectiontype-multipledataranges.png
stMultipleDataRanges
See also
QCPAbstractPlottable::setSelectable, QCPDataSelection::enforceType
Enumerator
stNone 

The plottable is not selectable.

stWhole 

Selection behaves like stMultipleDataRanges, but if there are any data points selected, the entire plottable is drawn as selected.

stSingleData 

One individual data point can be selected at a time.

stDataRange 

Multiple contiguous data points (a data range) can be selected.

stMultipleDataRanges 

Any combination of data points/ranges can be selected.

Function Documentation

§ isInvalidData() [1/2]

bool QCP::isInvalidData ( double  value)
inline

Returns whether the specified value is considered an invalid data value for plottables (i.e. is nan or +/-inf). This function is used to check data validity upon replots, when the compiler flag QCUSTOMPLOT_CHECK_DATA is set.

§ isInvalidData() [2/2]

bool QCP::isInvalidData ( double  value1,
double  value2 
)
inline

This is an overloaded function.

Checks two arguments instead of one.

§ setMarginValue()

void QCP::setMarginValue ( QMargins &  margins,
QCP::MarginSide  side,
int  value 
)
inline

Sets the specified side of margins to value

See also
getMarginValue

§ getMarginValue()

int QCP::getMarginValue ( const QMargins &  margins,
QCP::MarginSide  side 
)
inline

Returns the value of the specified side of margins. If side is QCP::msNone or QCP::msAll, returns 0.

See also
setMarginValue
qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemStraightLine.png0000644000175000017500000000237414030601041025130 0ustar rusconirusconi‰PNG  IHDRæ /µàøgAMA† 1è–_ÀPLTEÿÿÿÒÒÒVVVööú°°°ggg777 '''xxxFFFîçôÏÏÿ±±þloÿÿœ«ó ý ÿýRRÿ,,Ÿz"ðôµÿ ÿ›ìÿ£]ÿ¶ôÿøÈÿ`ÿ -ÿÎúÿ´RÿèÿÿÒ»ÿýØÿ…åÿ( ÿ;ªÿI®ÿöºÿÿŠ×ÿ/“ÿê“ÿì¯ÿ¡1ÿ IÿÏfÿò®ÿtÔÿš1ÿpØÿÍbÿ%_ÿ¦ïÿ%%3Dƒÿç>€bKGDˆH pHYsÃÃÇo¨dcIDATxÚíÙ{WÚ0ð€EA¶¡MeZŠˆÕ2—áÜæ÷ÿVKzÁ‚Âñœ¥Äç÷×s ‰o“WBtS©©B±ŒÚñI½Ñ8=S=ÂTš­úi£Q?9®ªÇRˆvõèìTLáQµ­z,ÅHÖ(ŸÂfEõPþ—IˆõvVª­t õX£6íÇÍ­Æu™iU~ s1™i·YòXç2ãQJ™u®u™iSƒ§¤Ýo]^fjªGSPF~¥  Óa®êÁ!+3õV³rÁcÚOõ$K¯ë2Ã,晦êQIdd»™+…G-âP= k¥™îfŽß–‹_T¾ºj¿!Í—Õc)Æv™ÑŽžҼ܆TõPŠ¡}™!_¥Ìhsî}CR™¹ô¯²‡×=ÒP Å“›`d hOÜ«J(õÜ{›}Äع#}{4ïÅ“ðÁnáCù¥”™È½p\>øŸN¾GþU䇎;%êÆ3NùÍ£;$·?xL2›—ú×PkÊj¯Eô,ÜÞÒÿIV“[“Þ“Åd8öïÄ»ñ*ž‰ÄK“¿SNÀÜJùaù’±ÿôk2"K¿#fóJÌ^³O&YÍIóQÜHÃ{ÌÚ~ñuC*s7#bõý§Å{1Çá3ÙŽ)q6µù™¯óú¿RÕ^‹è”ܸÃËõ¢Íb>­S&6]´K­Å,%§w£èÝLä;”n” 8&¯AÁJ´„’„¿Ó˜ƒgyßl›¾W;ÏÊL‘ÒèõR¹Û`šÜ÷ùœKã2WüŽ ú§„ é‡b^zÉZ]ü•ó¥q™é¾tEÌ6-cÓý¡˜åϽL,Ú¶]ê÷Ψmµ×h2vßïŸ{;®G.¨¥zp2ìÝ1þ4üUνh¯2}ÿß»AßöÀfgÄÝ4ø®)vÖ¤Úè¬%Ý4wÖø±wÞ+é¬I±¯³–tÓâÖ„èÕÌæFÉ5‰1÷uÖ–IÌY0Í5µ´Îšô˜û:kiÌÕœ¤1åvÖJŽ¹«³–‹)ÞŸ†ÔÎZ©1wwÖÖ1yD šÊí¬•swgm”Å5þ~0”ÚY+9¦ªÎÚç‹)»³öIc€–þ÷Óf°ò¯ i%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPColorMap.html0000644000175000017500000030106314030601040024632 0ustar rusconirusconi QCPColorMap Class Reference
Public Functions | Signals | Protected Functions
QCPColorMap Class Reference

A plottable representing a two-dimensional color map in a plot. More...

Inheritance diagram for QCPColorMap:
Inheritance graph

Public Functions

 QCPColorMap (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QCPColorMapData * data () const
 
QCPRange dataRange () const
 
QCPAxis::ScaleType dataScaleType () const
 
bool interpolate () const
 
bool tightBoundary () const
 
QCPColorGradient gradient () const
 
QCPColorScale * colorScale () const
 
void setData (QCPColorMapData *data, bool copy=false)
 
Q_SLOT void setDataRange (const QCPRange &dataRange)
 
Q_SLOT void setDataScaleType (QCPAxis::ScaleType scaleType)
 
Q_SLOT void setGradient (const QCPColorGradient &gradient)
 
void setInterpolate (bool enabled)
 
void setTightBoundary (bool enabled)
 
void setColorScale (QCPColorScale *colorScale)
 
void rescaleDataRange (bool recalculateDataBounds=false)
 
Q_SLOT void updateLegendIcon (Qt::TransformationMode transformMode=Qt::SmoothTransformation, const QSize &thumbSize=QSize(32, 18))
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
virtual QCPPlottableInterface1D * interface1D ()
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Signals

void dataRangeChanged (const QCPRange &newRange)
 
void dataScaleTypeChanged (QCPAxis::ScaleType scaleType)
 
void gradientChanged (const QCPColorGradient &newGradient)
 
- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Protected Functions

virtual void updateMapImage ()
 
virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Detailed Description

A plottable representing a two-dimensional color map in a plot.

QCPColorMap.png

The data is stored in the class QCPColorMapData, which can be accessed via the data() method.

A color map has three dimensions to represent a data point: The key dimension, the value dimension and the data dimension. As with other plottables such as graphs, key and value correspond to two orthogonal axes on the QCustomPlot surface that you specify in the QCPColorMap constructor. The data dimension however is encoded as the color of the point at (key, value).

Set the number of points (or cells) in the key/value dimension via QCPColorMapData::setSize. The plot coordinate range over which these points will be displayed is specified via QCPColorMapData::setRange. The first cell will be centered on the lower range boundary and the last cell will be centered on the upper range boundary. The data can be set by either accessing the cells directly with QCPColorMapData::setCell or by addressing the cells via their plot coordinates with QCPColorMapData::setData. If possible, you should prefer setCell, since it doesn't need to do any coordinate transformation and thus performs a bit better.

The cell with index (0, 0) is at the bottom left, if the color map uses normal (i.e. not reversed) key and value axes.

To show the user which colors correspond to which data values, a QCPColorScale is typically placed to the right of the axis rect. See the documentation there for details on how to add and use a color scale.

Changing the appearance

Most important to the appearance is the color gradient, which can be specified via setGradient. See the documentation of QCPColorGradient for details on configuring a color gradient.

The data range that is mapped to the colors of the gradient can be specified with setDataRange. To make the data range encompass the whole data set minimum to maximum, call rescaleDataRange. If your data may contain NaN values, use QCPColorGradient::setNanHandling to define how they are displayed.

Transparency

Transparency in color maps can be achieved by two mechanisms. On one hand, you can specify alpha values for color stops of the QCPColorGradient, via the regular QColor interface. This will cause the color map data which gets mapped to colors around those color stops to appear with the accordingly interpolated transparency.

On the other hand you can also directly apply an alpha value to each cell independent of its data, by using the alpha map feature of QCPColorMapData. The relevant methods are QCPColorMapData::setAlpha, QCPColorMapData::fillAlpha and QCPColorMapData::clearAlpha().

The two transparencies will be joined together in the plot and otherwise not interfere with each other. They are mixed in a multiplicative matter, so an alpha of e.g. 50% (128/255) in both modes simultaneously, will result in a total transparency of 25% (64/255).

Usage

Like all data representing objects in QCustomPlot, the QCPColorMap is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.)

Usually, you first create an instance:

QCPColorMap *colorMap = new QCPColorMap(customPlot->xAxis, customPlot->yAxis);

which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.:

colorMap->data()->setSize(50, 50);
colorMap->data()->setRange(QCPRange(0, 2), QCPRange(0, 2));
for (int x=0; x<50; ++x)
for (int y=0; y<50; ++y)
colorMap->data()->setCell(x, y, qCos(x/10.0)+qSin(y/10.0));
colorMap->setGradient(QCPColorGradient::gpPolar);
colorMap->rescaleDataRange(true);
customPlot->rescaleAxes();
customPlot->replot();
Note
The QCPColorMap always displays the data at equal key/value intervals, even if the key or value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, you shouldn't use the QCPColorMapData::setData method as it uses a linear transformation to determine the cell index. Rather directly access the cell index with QCPColorMapData::setCell.

Constructor & Destructor Documentation

§ QCPColorMap()

QCPColorMap::QCPColorMap ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs a color map with the specified keyAxis and valueAxis.

The created QCPColorMap is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPColorMap, so do not delete it manually but use QCustomPlot::removePlottable() instead.

Member Function Documentation

§ data()

QCPColorMapData * QCPColorMap::data ( ) const
inline

Returns a pointer to the internal data storage of type QCPColorMapData. Access this to modify data points (cells) and the color map key/value range.

See also
setData

§ setData()

void QCPColorMap::setData ( QCPColorMapData *  data,
bool  copy = false 
)

Replaces the current data with the provided data.

If copy is set to true, the data object will only be copied. if false, the color map takes ownership of the passed data and replaces the internal data pointer with it. This is significantly faster than copying for large datasets.

§ setDataRange()

void QCPColorMap::setDataRange ( const QCPRange &  dataRange)

Sets the data range of this color map to dataRange. The data range defines which data values are mapped to the color gradient.

To make the data range span the full range of the data set, use rescaleDataRange.

See also
QCPColorScale::setDataRange

§ setDataScaleType()

void QCPColorMap::setDataScaleType ( QCPAxis::ScaleType  scaleType)

Sets whether the data is correlated with the color gradient linearly or logarithmically.

See also
QCPColorScale::setDataScaleType

§ setGradient()

void QCPColorMap::setGradient ( const QCPColorGradient &  gradient)

Sets the color gradient that is used to represent the data. For more details on how to create an own gradient or use one of the preset gradients, see QCPColorGradient.

The colors defined by the gradient will be used to represent data values in the currently set data range, see setDataRange. Data points that are outside this data range will either be colored uniformly with the respective gradient boundary color, or the gradient will repeat, depending on QCPColorGradient::setPeriodic.

See also
QCPColorScale::setGradient

§ setInterpolate()

void QCPColorMap::setInterpolate ( bool  enabled)

Sets whether the color map image shall use bicubic interpolation when displaying the color map shrinked or expanded, and not at a 1:1 pixel-to-data scale.

QCPColorMap-interpolate.png
A 10*10 color map, with interpolation and without interpolation enabled

§ setTightBoundary()

void QCPColorMap::setTightBoundary ( bool  enabled)

Sets whether the outer most data rows and columns are clipped to the specified key and value range (see QCPColorMapData::setKeyRange, QCPColorMapData::setValueRange).

if enabled is set to false, the data points at the border of the color map are drawn with the same width and height as all other data points. Since the data points are represented by rectangles of one color centered on the data coordinate, this means that the shown color map extends by half a data point over the specified key/value range in each direction.

QCPColorMap-tightboundary.png
A color map, with tight boundary enabled and disabled

§ setColorScale()

void QCPColorMap::setColorScale ( QCPColorScale *  colorScale)

Associates the color scale colorScale with this color map.

This means that both the color scale and the color map synchronize their gradient, data range and data scale type (setGradient, setDataRange, setDataScaleType). Multiple color maps can be associated with one single color scale. This causes the color maps to also synchronize those properties, via the mutual color scale.

This function causes the color map to adopt the current color gradient, data range and data scale type of colorScale. After this call, you may change these properties at either the color map or the color scale, and the setting will be applied to both.

Pass nullptr as colorScale to disconnect the color scale from this color map again.

§ rescaleDataRange()

void QCPColorMap::rescaleDataRange ( bool  recalculateDataBounds = false)

Sets the data range (setDataRange) to span the minimum and maximum values that occur in the current data set. This corresponds to the rescaleKeyAxis or rescaleValueAxis methods, only for the third data dimension of the color map.

The minimum and maximum values of the data set are buffered in the internal QCPColorMapData instance (data). As data is updated via its QCPColorMapData::setCell or QCPColorMapData::setData, the buffered minimum and maximum values are updated, too. For performance reasons, however, they are only updated in an expanding fashion. So the buffered maximum can only increase and the buffered minimum can only decrease. In consequence, changes to the data that actually lower the maximum of the data set (by overwriting the cell holding the current maximum with a smaller value), aren't recognized and the buffered maximum overestimates the true maximum of the data set. The same happens for the buffered minimum. To recalculate the true minimum and maximum by explicitly looking at each cell, the method QCPColorMapData::recalculateDataBounds can be used. For convenience, setting the parameter recalculateDataBounds calls this method before setting the data range to the buffered minimum and maximum.

See also
setDataRange

§ updateLegendIcon()

void QCPColorMap::updateLegendIcon ( Qt::TransformationMode  transformMode = Qt::SmoothTransformation,
const QSize &  thumbSize = QSize(32, 18) 
)

Takes the current appearance of the color map and updates the legend icon, which is used to represent this color map in the legend (see QCPLegend).

The transformMode specifies whether the rescaling is done by a faster, low quality image scaling algorithm (Qt::FastTransformation) or by a slower, higher quality algorithm (Qt::SmoothTransformation).

The current color map appearance is scaled down to thumbSize. Ideally, this should be equal to the size of the legend icon (see QCPLegend::setIconSize). If it isn't exactly the configured legend icon size, the thumb will be rescaled during drawing of the legend item.

See also
setDataRange

§ selectTest()

double QCPColorMap::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractPlottable.

§ getKeyRange()

QCPRange QCPColorMap::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPColorMap::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ dataRangeChanged

void QCPColorMap::dataRangeChanged ( const QCPRange &  newRange)
signal

This signal is emitted when the data range changes.

See also
setDataRange

§ dataScaleTypeChanged

void QCPColorMap::dataScaleTypeChanged ( QCPAxis::ScaleType  scaleType)
signal

This signal is emitted when the data scale type changes.

See also
setDataScaleType

§ gradientChanged

void QCPColorMap::gradientChanged ( const QCPColorGradient &  newGradient)
signal

This signal is emitted when the gradient changes.

See also
setGradient

§ updateMapImage()

void QCPColorMap::updateMapImage ( )
protectedvirtual

Updates the internal map image buffer by going through the internal QCPColorMapData and turning the data values into color pixels with QCPColorGradient::colorize.

This method is called by QCPColorMap::draw if either the data has been modified or the map image has been invalidated for a different reason (e.g. a change of the data range with setDataRange).

If the map cell count is low, the image created will be oversampled in order to avoid a QPainter::drawImage bug which makes inner pixel boundaries jitter when stretch-drawing images without smooth transform enabled. Accordingly, oversampling isn't performed if setInterpolate is true.

§ draw()

void QCPColorMap::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPColorMap::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

The documentation for this class was generated from the following files:
  • src/plottables/plottable-colormap.h
  • src/plottables/plottable-colormap.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/tab_b.png0000644000175000017500000000044214030601042022412 0ustar rusconirusconi‰PNG  IHDR$ºZM?gAMA† 1è–_!PLTE¨·Ö½ÉàÌÔèÂÎâ¸ÄÞ±¾Ú­Ñ•¦Ì‡šÅr†¸ÿÿÿ#7q,bKGD hÐôV pHYsHHFÉk>(IDAT×c```PB íÀ„0†`Ø€!¢ y(`˜<‡ ñè1+á%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPaintBufferGlFbo__inherit__graph.png0000644000175000017500000000204114030601041031251 0ustar rusconirusconi‰PNG  IHDR£kéù/jgAMA† 1è–_-PLTEÿÿÿÿÿÿ………iii²²µLLMšššèèè222ÓÓÕP+nntRNSªvå’bKGDˆH pHYsHHFÉk>IDAThÞíØAkAàþ…éÆ•5Et#Sš[Ò²Po1º= ^ÙíÛ¸ÅCSYðØŸƒ-IeÁc@¼yðôàQp…þÿƒïÍ&a¡Ùf £Xœ ¤3³3ïÍÛ¥aW˜évoÅ’Iç±Éö„ÈFl’ŒÙ3™¶%/7¡k8à@ é@ÄX. ïÌÈŠ,ÀÑ|ŽFuÜ#÷¨† 6xljÞö\/cao!)NDuäŠÄO 1G¸Zrì½xÉRØq qA$À0œO€]á ê 7Ô( °5ÃKà¹ÏšÂ éeN¯ÏÒÓž{÷Ä8ÇÙÓÑ,JŽäÇ@%.iŽ¢l¼ Ôº:ÎÛoŠ;1é>ž2àwy–ÔîÈU‰g3Ò-WÔ'Î>LdÏcÚÃÜíã’Ä©¯a×+ÉÉüÔ–‡±×¬q€‰7v8Û#r#§Ä÷‰}¥ì©(£Ó2ñg»‹ÈÛ³›ˆ1ÉV–‡fr!ðJŽ«®ê+%Ǻ XªA3Œ‘Œå£ë?,—ÚÆ-ù¯`²)òÖ¦V;?ÔZ¶}_ÅWÍ…ÚäjñÍ4¹Vü4M¾+~˜&ÅÈ0y^fI¯(tK®KÞEò»Yr IÍ’ë’_Ô,¹.‰/Š‰QòœÈ óäQS×]hIKZÒ’–´¤%-iIKÞ òÃò·Û¯4Þ€w*¤¡W½ ™ú&·¤>Ù†6T†’˜«É6àßÆ`8Û…_€3´gȇÓí®•` ™fÃõdóoå¾|(+ÑHœQ!Í„õt3Cri”©ß–|LËD0¶w…)I$Âtïµp6ZV’aäЭ##¿%9^GIôóiâ’üœå~Ü¥eeâýзäR²<ËuÜÕå*ñpNâläã4”Qv?jÉ剫ºð³ T+B‘]ºˆË¸‰å«òLÉð$#UžtK ôQ¯”çêÄç7QI¶aJ†’Î2Õ Ew-KtÊãûa÷o?=–´d=ùþC¶ôÞ­/k;×ûµ¡ÝþcÒÈíSmïG¼(¹fjc%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/plottable-financial_8h.html0000644000175000017500000001243314030601036026040 0ustar rusconirusconi src/plottables/plottable-financial.h File Reference
Data Structures | Typedefs | Functions
plottable-financial.h File Reference

Data Structures

class  QCPFinancialData
 Holds the data of one single data point for QCPFinancial. More...
 
class  QCPFinancial
 A plottable representing a financial stock chart. More...
 

Typedefs

typedef QCPDataContainer< QCPFinancialData > QCPFinancialDataContainer
 

Functions

 Q_DECLARE_TYPEINFO (QCPFinancialData, Q_PRIMITIVE_TYPE)
 

Typedef Documentation

§ QCPFinancialDataContainer

QCPFinancialDataContainer

Container for storing QCPFinancialData points. The data is stored sorted by key.

This template instantiation is the container in which QCPFinancial holds its data. For details about the generic container, see the documentation of the class template QCPDataContainer.

See also
QCPFinancialData, QCPFinancial::setData
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPColorGradient.html0000644000175000017500000013445314030601036025666 0ustar rusconirusconi QCPColorGradient Class Reference
Public Types | Public Functions | Protected Functions
QCPColorGradient Class Reference

Defines a color gradient for use with e.g. QCPColorMap. More...

Public Types

enum  ColorInterpolation
 
enum  NanHandling
 
enum  GradientPreset
 

Public Functions

 QCPColorGradient ()
 
 QCPColorGradient (GradientPreset preset)
 
bool operator== (const QCPColorGradient &other) const
 
bool operator!= (const QCPColorGradient &other) const
 
int levelCount () const
 
QMap< double, QColor > colorStops () const
 
ColorInterpolation colorInterpolation () const
 
NanHandling nanHandling () const
 
QColor nanColor () const
 
bool periodic () const
 
void setLevelCount (int n)
 
void setColorStops (const QMap< double, QColor > &colorStops)
 
void setColorStopAt (double position, const QColor &color)
 
void setColorInterpolation (ColorInterpolation interpolation)
 
void setNanHandling (NanHandling handling)
 
void setNanColor (const QColor &color)
 
void setPeriodic (bool enabled)
 
void colorize (const double *data, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor=1, bool logarithmic=false)
 
void colorize (const double *data, const unsigned char *alpha, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor=1, bool logarithmic=false)
 
QRgb color (double position, const QCPRange &range, bool logarithmic=false)
 
void loadPreset (GradientPreset preset)
 
void clearColorStops ()
 
QCPColorGradient inverted () const
 

Protected Functions

bool stopsUseAlpha () const
 
void updateColorBuffer ()
 

Detailed Description

Defines a color gradient for use with e.g. QCPColorMap.

This class describes a color gradient which can be used to encode data with color. For example, QCPColorMap and QCPColorScale have setGradient methods which take an instance of this class. Colors are set with setColorStopAt(double position, const QColor &color) with a position from 0 to 1. In between these defined color positions, the color will be interpolated linearly either in RGB or HSV space, see setColorInterpolation.

Alternatively, load one of the preset color gradients shown in the image below, with loadPreset, or by directly specifying the preset in the constructor.

Apart from red, green and blue components, the gradient also interpolates the alpha values of the configured color stops. This allows to display some portions of the data range as transparent in the plot.

How NaN values are interpreted can be configured with setNanHandling.

QCPColorGradient.png

The constructor QCPColorGradient(GradientPreset preset) allows directly converting a GradientPreset to a QCPColorGradient. This means that you can directly pass GradientPreset to all the setGradient methods, e.g.:

colorMap->setGradient(QCPColorGradient::gpHot);

The total number of levels used in the gradient can be set with setLevelCount. Whether the color gradient shall be applied periodically (wrapping around) to data values that lie outside the data range specified on the plottable instance can be controlled with setPeriodic.

Member Enumeration Documentation

§ ColorInterpolation

enum QCPColorGradient::ColorInterpolation

Defines the color spaces in which color interpolation between gradient stops can be performed.

See also
setColorInterpolation
Enumerator
ciRGB 

Color channels red, green and blue are linearly interpolated.

ciHSV 

Color channels hue, saturation and value are linearly interpolated (The hue is interpolated over the shortest angle distance)

§ NanHandling

enum QCPColorGradient::NanHandling

Defines how NaN data points shall appear in the plot.

See also
setNanHandling, setNanColor
Enumerator
nhNone 

NaN data points are not explicitly handled and shouldn't occur in the data (this gives slight performance improvement)

nhLowestColor 

NaN data points appear as the lowest color defined in this QCPColorGradient.

nhHighestColor 

NaN data points appear as the highest color defined in this QCPColorGradient.

nhTransparent 

NaN data points appear transparent.

nhNanColor 

NaN data points appear as the color defined with setNanColor.

§ GradientPreset

enum QCPColorGradient::GradientPreset

Defines the available presets that can be loaded with loadPreset. See the documentation there for an image of the presets.

Enumerator
gpGrayscale 

Continuous lightness from black to white (suited for non-biased data representation)

gpHot 

Continuous lightness from black over firey colors to white (suited for non-biased data representation)

gpCold 

Continuous lightness from black over icey colors to white (suited for non-biased data representation)

gpNight 

Continuous lightness from black over weak blueish colors to white (suited for non-biased data representation)

gpCandy 

Blue over pink to white.

gpGeography 

Colors suitable to represent different elevations on geographical maps.

gpIon 

Half hue spectrum from black over purple to blue and finally green (creates banding illusion but allows more precise magnitude estimates)

gpThermal 

Colors suitable for thermal imaging, ranging from dark blue over purple to orange, yellow and white.

gpPolar 

Colors suitable to emphasize polarity around the center, with blue for negative, black in the middle and red for positive values.

gpSpectrum 

An approximation of the visible light spectrum (creates banding illusion but allows more precise magnitude estimates)

gpJet 

Hue variation similar to a spectrum, often used in numerical visualization (creates banding illusion but allows more precise magnitude estimates)

gpHues 

Full hue cycle, with highest and lowest color red (suitable for periodic data, such as angles and phases, see setPeriodic)

Constructor & Destructor Documentation

§ QCPColorGradient() [1/2]

QCPColorGradient::QCPColorGradient ( )

Constructs a new, empty QCPColorGradient with no predefined color stops. You can add own color stops with setColorStopAt.

The color level count is initialized to 350.

§ QCPColorGradient() [2/2]

QCPColorGradient::QCPColorGradient ( GradientPreset  preset)

Constructs a new QCPColorGradient initialized with the colors and color interpolation according to preset.

The color level count is initialized to 350.

Member Function Documentation

§ setLevelCount()

void QCPColorGradient::setLevelCount ( int  n)

Sets the number of discretization levels of the color gradient to n. The default is 350 which is typically enough to create a smooth appearance. The minimum number of levels is 2.

QCPColorGradient-levelcount.png

§ setColorStops()

void QCPColorGradient::setColorStops ( const QMap< double, QColor > &  colorStops)

Sets at which positions from 0 to 1 which color shall occur. The positions are the keys, the colors are the values of the passed QMap colorStops. In between these color stops, the color is interpolated according to setColorInterpolation.

A more convenient way to create a custom gradient may be to clear all color stops with clearColorStops (or creating a new, empty QCPColorGradient) and then adding them one by one with setColorStopAt.

See also
clearColorStops

§ setColorStopAt()

void QCPColorGradient::setColorStopAt ( double  position,
const QColor &  color 
)

Sets the color the gradient will have at the specified position (from 0 to 1). In between these color stops, the color is interpolated according to setColorInterpolation.

See also
setColorStops, clearColorStops

§ setColorInterpolation()

void QCPColorGradient::setColorInterpolation ( QCPColorGradient::ColorInterpolation  interpolation)

Sets whether the colors in between the configured color stops (see setColorStopAt) shall be interpolated linearly in RGB or in HSV color space.

For example, a sweep in RGB space from red to green will have a muddy brown intermediate color, whereas in HSV space the intermediate color is yellow.

§ setNanHandling()

void QCPColorGradient::setNanHandling ( QCPColorGradient::NanHandling  handling)

Sets how NaNs in the data are displayed in the plot.

See also
setNanColor

§ setNanColor()

void QCPColorGradient::setNanColor ( const QColor &  color)

Sets the color that NaN data is represented by, if setNanHandling is set to ref nhNanColor.

See also
setNanHandling

§ setPeriodic()

void QCPColorGradient::setPeriodic ( bool  enabled)

Sets whether data points that are outside the configured data range (e.g. QCPColorMap::setDataRange) are colored by periodically repeating the color gradient or whether they all have the same color, corresponding to the respective gradient boundary color.

QCPColorGradient-periodic.png

As shown in the image above, gradients that have the same start and end color are especially suitable for a periodic gradient mapping, since they produce smooth color transitions throughout the color map. A preset that has this property is gpHues.

In practice, using periodic color gradients makes sense when the data corresponds to a periodic dimension, such as an angle or a phase. If this is not the case, the color encoding might become ambiguous, because multiple different data values are shown as the same color.

§ colorize() [1/2]

void QCPColorGradient::colorize ( const double *  data,
const QCPRange &  range,
QRgb *  scanLine,
int  n,
int  dataIndexFactor = 1,
bool  logarithmic = false 
)

This is an overloaded function.

This method is used to quickly convert a data array to colors. The colors will be output in the array scanLine. Both data and scanLine must have the length n when passed to this function. The data range that shall be used for mapping the data value to the gradient is passed in range. logarithmic indicates whether the data values shall be mapped to colors logarithmically.

if data actually contains 2D-data linearized via [row*columnCount + column], you can set dataIndexFactor to columnCount to convert a column instead of a row of the data array, in scanLine. scanLine will remain a regular (1D) array. This works because data is addressed data[i*dataIndexFactor].

Use the overloaded method to additionally provide alpha map data.

The QRgb values that are placed in scanLine have their r, g, and b components premultiplied with alpha (see QImage::Format_ARGB32_Premultiplied).

§ colorize() [2/2]

void QCPColorGradient::colorize ( const double *  data,
const unsigned char *  alpha,
const QCPRange &  range,
QRgb *  scanLine,
int  n,
int  dataIndexFactor = 1,
bool  logarithmic = false 
)

This is an overloaded function.

Additionally to the other overload of colorize, this method takes the array alpha, which has the same size and structure as data and encodes the alpha information per data point.

The QRgb values that are placed in scanLine have their r, g and b components premultiplied with alpha (see QImage::Format_ARGB32_Premultiplied).

§ color()

QRgb QCPColorGradient::color ( double  position,
const QCPRange &  range,
bool  logarithmic = false 
)

This method is used to colorize a single data value given in position, to colors. The data range that shall be used for mapping the data value to the gradient is passed in range. logarithmic indicates whether the data value shall be mapped to a color logarithmically.

If an entire array of data values shall be converted, rather use colorize, for better performance.

The returned QRgb has its r, g and b components premultiplied with alpha (see QImage::Format_ARGB32_Premultiplied).

§ loadPreset()

void QCPColorGradient::loadPreset ( GradientPreset  preset)

Clears the current color stops and loads the specified preset. A preset consists of predefined color stops and the corresponding color interpolation method.

The available presets are:

QCPColorGradient.png

§ clearColorStops()

void QCPColorGradient::clearColorStops ( )

Clears all color stops.

See also
setColorStops, setColorStopAt

§ inverted()

QCPColorGradient QCPColorGradient::inverted ( ) const

Returns an inverted gradient. The inverted gradient has all properties as this QCPColorGradient, but the order of the color stops is inverted.

See also
setColorStops, setColorStopAt

§ stopsUseAlpha()

bool QCPColorGradient::stopsUseAlpha ( ) const
protected

Returns true if the color gradient uses transparency, i.e. if any of the configured color stops has an alpha value below 255.

§ updateColorBuffer()

void QCPColorGradient::updateColorBuffer ( )
protected

Updates the internal color buffer which will be used by colorize and color, to quickly convert positions to colors. This is where the interpolation between color stops is calculated.

The documentation for this class was generated from the following files:
  • src/colorgradient.h
  • src/colorgradient.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerText__inherit__graph.png0000644000175000017500000000165514030601041031057 0ustar rusconirusconi‰PNG  IHDR…k«º\ýgAMA† 1è–_0PLTEÿÿÿÿÿÿ°°´iiiMMM˜˜˜………èèê111ÏÏÑ+PnnEE|R{ÝìtRNSªvå’bKGDˆH pHYsHHFÉk>—IDATXÃíÙ1oÓ@à.ì=#JÔ¢¨#Sš¸Š`!ŠÜnG;!j)Œý (vuÊV U‡nÄ’#ÔŸÀ€pºwaïàùQpšØአªßàD÷î>ß{gEJ²D”cy©0®4Ök‹G3eX‹F5m,^ƒvë =—aÁKR‡ìßgãe@i^£ÄO±¶Ö =¦Z{j¹ ½‰o’ûÓztç°OZºÜ.¦eƒêeV6^ærFv㘶´æ;{G'ümUÚG¢Ÿ5µ×irØz©Z†N¾,‚bNgDòÔBÊ»ËPÑÉ]¯:6¬ ^ ÍÙSr¯J6L¬eã„Žk)=מ|Ê0ˆ÷ólqÙl’W:5G=Š ~d°,ƒ<ØÉó°Í7ˆÂ¸),iã½9#ž geÌJʘ«qÖŒlã4ÞW6.ãseã"þ¢j¬Äñ7Uc-Ž‡ªÆjLJŠÆ)ßK4Î 4¾ªe$²&ËXKŒ¡šñ𠌬G¬0 £0 £0 £0 ãÆæÿ„õy~zCð j"˜4\¡·ÔàyŒàkQŽð:¿–Øù`ÒH~S' oÏë8f#ðCa4¦6ÀÓW®èñ  ËwX7ê5¸ÜOF@p+² „\pLÀ§ &|Øhøa»¾ãÙ<ØkŒ¶-˜+oó ŽÝ~(Ób¶N…Âb8¹ÝLˆ€œÀ±%2=¯Ü:Ø^2i»=6\–\“öJÈc3zÉž QݺÚ¼kzãZxh×d·Woù˜fsÎVG´£nª§=Ö’Iì©áv1mL÷TÃþËÏiaÜHã:>×}S%¶þ¿ÿ’þ¹¡ÔPOöDõQ”–š%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPDataContainer.html0000644000175000017500000020166214030601036025643 0ustar rusconirusconi QCPDataContainer< DataType > Class Template Reference
Public Types | Public Functions | Protected Functions | Related Non-Members
QCPDataContainer< DataType > Class Template Reference

The generic data container for one-dimensional plottables. More...

Public Types

typedef QVector< DataType >::const_iterator const_iterator
 
typedef QVector< DataType >::iterator iterator
 

Public Functions

 QCPDataContainer ()
 
int size () const
 
bool isEmpty () const
 
bool autoSqueeze () const
 
void setAutoSqueeze (bool enabled)
 
void set (const QCPDataContainer< DataType > &data)
 
void set (const QVector< DataType > &data, bool alreadySorted=false)
 
void add (const QCPDataContainer< DataType > &data)
 
void add (const QVector< DataType > &data, bool alreadySorted=false)
 
void add (const DataType &data)
 
void removeBefore (double sortKey)
 
void removeAfter (double sortKey)
 
void remove (double sortKeyFrom, double sortKeyTo)
 
void remove (double sortKey)
 
void clear ()
 
void sort ()
 
void squeeze (bool preAllocation=true, bool postAllocation=true)
 
const_iterator constBegin () const
 
const_iterator constEnd () const
 
iterator begin ()
 
iterator end ()
 
const_iterator findBegin (double sortKey, bool expandedRange=true) const
 
const_iterator findEnd (double sortKey, bool expandedRange=true) const
 
const_iterator at (int index) const
 
QCPRange keyRange (bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth)
 
QCPRange valueRange (bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange())
 
QCPDataRange dataRange () const
 
void limitIteratorsToDataRange (const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const
 

Protected Functions

void preallocateGrow (int minimumPreallocSize)
 
void performAutoSqueeze ()
 

Related Non-Members

(Note that these are not member functions.)

template<class DataType >
bool qcpLessThanSortKey (const DataType &a, const DataType &b)
 

Detailed Description

template<class DataType>
class QCPDataContainer< DataType >

The generic data container for one-dimensional plottables.

This class template provides a fast container for data storage of one-dimensional data. The data type is specified as template parameter (called DataType in the following) and must provide some methods as described in the next section.

The data is stored in a sorted fashion, which allows very quick lookups by the sorted key as well as retrieval of ranges (see findBegin, findEnd, keyRange) using binary search. The container uses a preallocation and a postallocation scheme, such that appending and prepending data (with respect to the sort key) is very fast and minimizes reallocations. If data is added which needs to be inserted between existing keys, the merge usually can be done quickly too, using the fact that existing data is always sorted. The user can further improve performance by specifying that added data is already itself sorted by key, if he can guarantee that this is the case (see for example add(const QVector<DataType> &data, bool alreadySorted)).

The data can be accessed with the provided const iterators (constBegin, constEnd). If it is necessary to alter existing data in-place, the non-const iterators can be used (begin, end). Changing data members that are not the sort key (for most data types called key) is safe from the container's perspective.

Great care must be taken however if the sort key is modified through the non-const iterators. For performance reasons, the iterators don't automatically cause a re-sorting upon their manipulation. It is thus the responsibility of the user to leave the container in a sorted state when finished with the data manipulation, before calling any other methods on the container. A complete re-sort (e.g. after finishing all sort key manipulation) can be done by calling sort. Failing to do so can not be detected by the container efficiently and will cause both rendering artifacts and potential data loss.

Implementing one-dimensional plottables that make use of a QCPDataContainer<T> is usually done by subclassing from QCPAbstractPlottable1D<T>, which introduces an according mDataContainer member and some convenience methods.

Requirements for the DataType template parameter

The template parameter DataType is the type of the stored data points. It must be trivially copyable and have the following public methods, preferably inline:

  • double sortKey() const
    Returns the member variable of this data point that is the sort key, defining the ordering in the container. Often this variable is simply called key.
  • static DataType fromSortKey(double sortKey)
    Returns a new instance of the data type initialized with its sort key set to sortKey.
  • static bool sortKeyIsMainKey()
    Returns true if the sort key is equal to the main key (see method mainKey below). For most plottables this is the case. It is not the case for example for QCPCurve, which uses t as sort key and key as main key. This is the reason why QCPCurve unlike QCPGraph can display parametric curves with loops.
  • double mainKey() const
    Returns the variable of this data point considered the main key. This is commonly the variable that is used as the coordinate of this data point on the key axis of the plottable. This method is used for example when determining the automatic axis rescaling of key axes (QCPAxis::rescale).
  • double mainValue() const
    Returns the variable of this data point considered the main value. This is commonly the variable that is used as the coordinate of this data point on the value axis of the plottable.
  • QCPRange valueRange() const
    Returns the range this data point spans in the value axis coordinate. If the data is single-valued (e.g. QCPGraphData), this is simply a range with both lower and upper set to the main data point value. However if the data points can represent multiple values at once (e.g QCPFinancialData with its high, low, open and close values at each key) this method should return the range those values span. This method is used for example when determining the automatic axis rescaling of value axes (QCPAxis::rescale).

Constructor & Destructor Documentation

§ QCPDataContainer()

template<class DataType >
QCPDataContainer< DataType >::QCPDataContainer ( )

Constructs a QCPDataContainer used for plottable classes that represent a series of key-sorted data

Member Function Documentation

§ size()

template<class DataType >
int QCPDataContainer< DataType >::size ( ) const
inline

Returns the number of data points in the container.

§ isEmpty()

template<class DataType >
bool QCPDataContainer< DataType >::isEmpty ( ) const
inline

Returns whether this container holds no data points.

§ setAutoSqueeze()

template<class DataType >
void QCPDataContainer< DataType >::setAutoSqueeze ( bool  enabled)

Sets whether the container automatically decides when to release memory from its post- and preallocation pools when data points are removed. By default this is enabled and for typical applications shouldn't be changed.

If auto squeeze is disabled, you can manually decide when to release pre-/postallocation with squeeze.

§ set() [1/2]

template<class DataType >
void QCPDataContainer< DataType >::set ( const QCPDataContainer< DataType > &  data)

This is an overloaded function.

Replaces the current data in this container with the provided data.

See also
add, remove

§ set() [2/2]

template<class DataType >
void QCPDataContainer< DataType >::set ( const QVector< DataType > &  data,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data in this container with the provided data

If you can guarantee that the data points in data have ascending order with respect to the DataType's sort key, set alreadySorted to true to avoid an unnecessary sorting run.

See also
add, remove

§ add() [1/3]

template<class DataType >
void QCPDataContainer< DataType >::add ( const QCPDataContainer< DataType > &  data)

This is an overloaded function.

Adds the provided data to the current data in this container.

See also
set, remove

§ add() [2/3]

template<class DataType >
void QCPDataContainer< DataType >::add ( const QVector< DataType > &  data,
bool  alreadySorted = false 
)

Adds the provided data points in data to the current data.

If you can guarantee that the data points in data have ascending order with respect to the DataType's sort key, set alreadySorted to true to avoid an unnecessary sorting run.

See also
set, remove

§ add() [3/3]

template<class DataType >
void QCPDataContainer< DataType >::add ( const DataType &  data)

This is an overloaded function.

Adds the provided single data point to the current data.

See also
remove

§ removeBefore()

template<class DataType >
void QCPDataContainer< DataType >::removeBefore ( double  sortKey)

Removes all data points with (sort-)keys smaller than or equal to sortKey.

See also
removeAfter, remove, clear

§ removeAfter()

template<class DataType >
void QCPDataContainer< DataType >::removeAfter ( double  sortKey)

Removes all data points with (sort-)keys greater than or equal to sortKey.

See also
removeBefore, remove, clear

§ remove() [1/2]

template<class DataType >
void QCPDataContainer< DataType >::remove ( double  sortKeyFrom,
double  sortKeyTo 
)

Removes all data points with (sort-)keys between sortKeyFrom and sortKeyTo. if sortKeyFrom is greater or equal to sortKeyTo, the function does nothing. To remove a single data point with known (sort-)key, use remove(double sortKey).

See also
removeBefore, removeAfter, clear

§ remove() [2/2]

template<class DataType >
void QCPDataContainer< DataType >::remove ( double  sortKey)

This is an overloaded function.

Removes a single data point at sortKey. If the position is not known with absolute (binary) precision, consider using remove(double sortKeyFrom, double sortKeyTo) with a small fuzziness interval around the suspected position, depeding on the precision with which the (sort-)key is known.

See also
removeBefore, removeAfter, clear

§ clear()

template<class DataType >
void QCPDataContainer< DataType >::clear ( )

Removes all data points.

See also
remove, removeAfter, removeBefore

§ sort()

template<class DataType >
void QCPDataContainer< DataType >::sort ( )

Re-sorts all data points in the container by their sort key.

When setting, adding or removing points using the QCPDataContainer interface (set, add, remove, etc.), the container makes sure to always stay in a sorted state such that a full resort is never necessary. However, if you choose to directly manipulate the sort key on data points by accessing and modifying it through the non-const iterators (begin, end), it is your responsibility to bring the container back into a sorted state before any other methods are called on it. This can be achieved by calling this method immediately after finishing the sort key manipulation.

§ squeeze()

template<class DataType >
void QCPDataContainer< DataType >::squeeze ( bool  preAllocation = true,
bool  postAllocation = true 
)

Frees all unused memory that is currently in the preallocation and postallocation pools.

Note that QCPDataContainer automatically decides whether squeezing is necessary, if setAutoSqueeze is left enabled. It should thus not be necessary to use this method for typical applications.

The parameters preAllocation and postAllocation control whether pre- and/or post allocation should be freed, respectively.

§ constBegin()

template<class DataType >
QCPDataContainer::const_iterator QCPDataContainer< DataType >::constBegin ( ) const
inline

Returns a const iterator to the first data point in this container.

§ constEnd()

template<class DataType >
QCPDataContainer::const_iterator QCPDataContainer< DataType >::constEnd ( ) const
inline

Returns a const iterator to the element past the last data point in this container.

§ begin()

template<class DataType >
QCPDataContainer::iterator QCPDataContainer< DataType >::begin ( )
inline

Returns a non-const iterator to the first data point in this container.

You can manipulate the data points in-place through the non-const iterators, but great care must be taken when manipulating the sort key of a data point, see sort, or the detailed description of this class.

§ end()

template<class DataType >
QCPDataContainer::iterator QCPDataContainer< DataType >::end ( )
inline

Returns a non-const iterator to the element past the last data point in this container.

You can manipulate the data points in-place through the non-const iterators, but great care must be taken when manipulating the sort key of a data point, see sort, or the detailed description of this class.

§ findBegin()

template<class DataType >
QCPDataContainer< DataType >::const_iterator QCPDataContainer< DataType >::findBegin ( double  sortKey,
bool  expandedRange = true 
) const

Returns an iterator to the data point with a (sort-)key that is equal to, just below, or just above sortKey. If expandedRange is true, the data point just below sortKey will be considered, otherwise the one just above.

This can be used in conjunction with findEnd to iterate over data points within a given key range, including or excluding the bounding data points that are just beyond the specified range.

If expandedRange is true but there are no data points below sortKey, constBegin is returned.

If the container is empty, returns constEnd.

See also
findEnd, QCPPlottableInterface1D::findBegin

§ findEnd()

template<class DataType >
QCPDataContainer< DataType >::const_iterator QCPDataContainer< DataType >::findEnd ( double  sortKey,
bool  expandedRange = true 
) const

Returns an iterator to the element after the data point with a (sort-)key that is equal to, just above or just below sortKey. If expandedRange is true, the data point just above sortKey will be considered, otherwise the one just below.

This can be used in conjunction with findBegin to iterate over data points within a given key range, including the bounding data points that are just below and above the specified range.

If expandedRange is true but there are no data points above sortKey, constEnd is returned.

If the container is empty, constEnd is returned.

See also
findBegin, QCPPlottableInterface1D::findEnd

§ at()

template<class DataType >
QCPDataContainer::const_iterator QCPDataContainer< DataType >::at ( int  index) const
inline

Returns a const iterator to the element with the specified index. If index points beyond the available elements in this container, returns constEnd, i.e. an iterator past the last valid element.

You can use this method to easily obtain iterators from a QCPDataRange, see the data selection page for an example.

§ keyRange()

template<class DataType >
QCPRange QCPDataContainer< DataType >::keyRange ( bool &  foundRange,
QCP::SignDomain  signDomain = QCP::sdBoth 
)

Returns the range encompassed by the (main-)key coordinate of all data points. The output parameter foundRange indicates whether a sensible range was found. If this is false, you should not use the returned QCPRange (e.g. the data container is empty or all points have the same key).

Use signDomain to control which sign of the key coordinates should be considered. This is relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a time.

If the DataType reports that its main key is equal to the sort key (sortKeyIsMainKey), as is the case for most plottables, this method uses this fact and finds the range very quickly.

See also
valueRange

§ valueRange()

template<class DataType >
QCPRange QCPDataContainer< DataType >::valueRange ( bool &  foundRange,
QCP::SignDomain  signDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
)

Returns the range encompassed by the value coordinates of the data points in the specified key range (inKeyRange), using the full DataType::valueRange reported by the data points. The output parameter foundRange indicates whether a sensible range was found. If this is false, you should not use the returned QCPRange (e.g. the data container is empty or all points have the same value).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Use signDomain to control which sign of the value coordinates should be considered. This is relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a time.

See also
keyRange

§ dataRange()

template<class DataType >
QCPDataRange QCPDataContainer< DataType >::dataRange ( ) const
inline

Returns a QCPDataRange encompassing the entire data set of this container. This means the begin index of the returned range is 0, and the end index is size.

§ limitIteratorsToDataRange()

template<class DataType >
void QCPDataContainer< DataType >::limitIteratorsToDataRange ( const_iterator &  begin,
const_iterator &  end,
const QCPDataRange &  dataRange 
) const

Makes sure begin and end mark a data range that is both within the bounds of this data container's data, as well as within the specified dataRange. The initial range described by the passed iterators begin and end is never expanded, only contracted if necessary.

This function doesn't require for dataRange to be within the bounds of this data container's valid range.

§ preallocateGrow()

template<class DataType >
void QCPDataContainer< DataType >::preallocateGrow ( int  minimumPreallocSize)
protected

Increases the preallocation pool to have a size of at least minimumPreallocSize. Depending on the preallocation history, the container will grow by more than requested, to speed up future consecutive size increases.

if minimumPreallocSize is smaller than or equal to the current preallocation pool size, this method does nothing.

§ performAutoSqueeze()

template<class DataType >
void QCPDataContainer< DataType >::performAutoSqueeze ( )
protected

This method decides, depending on the total allocation size and the size of the unused pre- and postallocation pools, whether it is sensible to reduce the pools in order to free up unused memory. It then possibly calls squeeze to do the deallocation.

If setAutoSqueeze is enabled, this method is called automatically each time data points are removed from the container (e.g. remove).

Note
when changing the decision parameters, care must be taken not to cause a back-and-forth between squeezing and reallocation due to the growth strategy of the internal QVector and preallocateGrow. The hysteresis between allocation and deallocation should be made high enough (at the expense of possibly larger unused memory from time to time).

Friends And Related Function Documentation

§ qcpLessThanSortKey()

template<class DataType >
bool qcpLessThanSortKey ( const DataType &  a,
const DataType &  b 
)
related

Returns whether the sort key of a is less than the sort key of b.

See also
QCPDataContainer::sort
The documentation for this class was generated from the following file:
qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_3.png0000644000175000017500000000127014030601042024410 0ustar rusconirusconi‰PNG  IHDRx#õ$mgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>êIDAThÞí™±QÃ0†_8?&ÙÀ àRrÔÉÎ f±îX€†ãÎd ÜPЈ*¤ù),Ë’œ@ 1ºSô»y’žžßg=Ëv2è¢tå;#ðŸ”tæš^|g3’néAÛ“n—žÓŽ¦¾sA;šÒ§n%æ9ŽæVëâîáº"ða­(¥”RZéžµÕ“ªãÑj¥t7(™{=o=1´f˜á°J0$¥î)!Q©9 @bÖ-@¢PÖi`,±…„8šÉodsÌ(”Uh¤Òñh3XÏa,À`ÁX:g颶ž•òÜñ¡Ï–ƒÁ¨Î \+«Ö'©{…ÛC>Bfjv3¾Ev0¦é9C‰Ü¨'¸û7àæØX+Ü^€RÛs302]+¬/Cß³±j«‚`yÕ8vûŒXÒnKÞÒ)øF`½n…vXŽ|Ú¦å›%. ‘õ02TèJ½£@ ‰MÏÓ-éùx% ,­í¥ßãÛ%Þøæ=Œ6F»²]é ÇÓÞ´J'ÞMËúZ¢>®é>œ—qÿJiÿí¸Í•Ð½ùf;ƒxµÜòx˜"pèŠÀ¡Ëz,í(õÏ(2‹5€ŸèÕwf#éÆ°'ñßÃÀCWBϾSø_}ƹI\zéG%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayer.html0000644000175000017500000007471514030601036024212 0ustar rusconirusconi QCPLayer Class Reference
Public Types | Public Functions | Protected Functions
QCPLayer Class Reference

A layer that may contain objects, to control the rendering order. More...

Inherits QObject.

Public Types

enum  LayerMode
 

Public Functions

 QCPLayer (QCustomPlot *parentPlot, const QString &layerName)
 
QCustomPlot * parentPlot () const
 
QString name () const
 
int index () const
 
QList< QCPLayerable * > children () const
 
bool visible () const
 
LayerMode mode () const
 
void setVisible (bool visible)
 
void setMode (LayerMode mode)
 
void replot ()
 

Protected Functions

void draw (QCPPainter *painter)
 
void drawToPaintBuffer ()
 
void addChild (QCPLayerable *layerable, bool prepend)
 
void removeChild (QCPLayerable *layerable)
 

Detailed Description

A layer that may contain objects, to control the rendering order.

The Layering system of QCustomPlot is the mechanism to control the rendering order of the elements inside the plot.

It is based on the two classes QCPLayer and QCPLayerable. QCustomPlot holds an ordered list of one or more instances of QCPLayer (see QCustomPlot::addLayer, QCustomPlot::layer, QCustomPlot::moveLayer, etc.). When replotting, QCustomPlot goes through the list of layers bottom to top and successively draws the layerables of the layers into the paint buffer(s).

A QCPLayer contains an ordered list of QCPLayerable instances. QCPLayerable is an abstract base class from which almost all visible objects derive, like axes, grids, graphs, items, etc.

Default layers

Initially, QCustomPlot has six layers: "background", "grid", "main", "axes", "legend" and "overlay" (in that order). On top is the "overlay" layer, which only contains the QCustomPlot's selection rect (QCustomPlot::selectionRect). The next two layers "axes" and "legend" contain the default axes and legend, so they will be drawn above plottables. In the middle, there is the "main" layer. It is initially empty and set as the current layer (see QCustomPlot::setCurrentLayer). This means, all new plottables, items etc. are created on this layer by default. Then comes the "grid" layer which contains the QCPGrid instances (which belong tightly to QCPAxis, see QCPAxis::grid). The Axis rect background shall be drawn behind everything else, thus the default QCPAxisRect instance is placed on the "background" layer. Of course, the layer affiliation of the individual objects can be changed as required (QCPLayerable::setLayer).

Controlling the rendering order via layers

Controlling the ordering of layerables in the plot is easy: Create a new layer in the position you want the layerable to be in, e.g. above "main", with QCustomPlot::addLayer. Then set the current layer with QCustomPlot::setCurrentLayer to that new layer and finally create the objects normally. They will be placed on the new layer automatically, due to the current layer setting. Alternatively you could have also ignored the current layer setting and just moved the objects with QCPLayerable::setLayer to the desired layer after creating them.

It is also possible to move whole layers. For example, If you want the grid to be shown in front of all plottables/items on the "main" layer, just move it above "main" with QCustomPlot::moveLayer.

The rendering order within one layer is simply by order of creation or insertion. The item created last (or added last to the layer), is drawn on top of all other objects on that layer.

When a layer is deleted, the objects on it are not deleted with it, but fall on the layer below the deleted layer, see QCustomPlot::removeLayer.

Replotting only a specific layer

If the layer mode (setMode) is set to lmBuffered, you can replot only this specific layer by calling replot. In certain situations this can provide better replot performance, compared with a full replot of all layers. Upon creation of a new layer, the layer mode is initialized to lmLogical. The only layer that is set to lmBuffered in a new QCustomPlot instance is the "overlay" layer, containing the selection rect.

Member Enumeration Documentation

§ LayerMode

enum QCPLayer::LayerMode

Defines the different rendering modes of a layer. Depending on the mode, certain layers can be replotted individually, without the need to replot (possibly complex) layerables on other layers.

See also
setMode
Enumerator
lmLogical 

Layer is used only for rendering order, and shares paint buffer with all other adjacent logical layers.

lmBuffered 

Layer has its own paint buffer and may be replotted individually (see replot).

Constructor & Destructor Documentation

§ QCPLayer()

QCPLayer::QCPLayer ( QCustomPlot *  parentPlot,
const QString &  layerName 
)

Creates a new QCPLayer instance.

Normally you shouldn't directly instantiate layers, use QCustomPlot::addLayer instead.

Warning
It is not checked that layerName is actually a unique layer name in parentPlot. This check is only performed by QCustomPlot::addLayer.

Member Function Documentation

§ index()

int QCPLayer::index ( ) const
inline

Returns the index this layer has in the QCustomPlot. The index is the integer number by which this layer can be accessed via QCustomPlot::layer.

Layers with higher indices will be drawn above layers with lower indices.

§ children()

QList< QCPLayerable * > QCPLayer::children ( ) const
inline

Returns a list of all layerables on this layer. The order corresponds to the rendering order: layerables with higher indices are drawn above layerables with lower indices.

§ setVisible()

void QCPLayer::setVisible ( bool  visible)

Sets whether this layer is visible or not. If visible is set to false, all layerables on this layer will be invisible.

This function doesn't change the visibility property of the layerables (QCPLayerable::setVisible), but the QCPLayerable::realVisibility of each layerable takes the visibility of the parent layer into account.

§ setMode()

void QCPLayer::setMode ( QCPLayer::LayerMode  mode)

Sets the rendering mode of this layer.

If mode is set to lmBuffered for a layer, it will be given a dedicated paint buffer by the parent QCustomPlot instance. This means it may be replotted individually by calling QCPLayer::replot, without needing to replot all other layers.

Layers which are set to lmLogical (the default) are used only to define the rendering order and can't be replotted individually.

Note that each layer which is set to lmBuffered requires additional paint buffers for the layers below, above and for the layer itself. This increases the memory consumption and (slightly) decreases the repainting speed because multiple paint buffers need to be joined. So you should carefully choose which layers benefit from having their own paint buffer. A typical example would be a layer which contains certain layerables (e.g. items) that need to be changed and thus replotted regularly, while all other layerables on other layers stay static. By default, only the topmost layer called "overlay" is in mode lmBuffered, and contains the selection rect.

See also
replot

§ replot()

void QCPLayer::replot ( )

If the layer mode (setMode) is set to lmBuffered, this method allows replotting only the layerables on this specific layer, without the need to replot all other layers (as a call to QCustomPlot::replot would do).

QCustomPlot also makes sure to replot all layers instead of only this one, if the layer ordering or any layerable-layer-association has changed since the last full replot and any other paint buffers were thus invalidated.

If the layer mode is lmLogical however, this method simply calls QCustomPlot::replot on the parent QCustomPlot instance.

See also
draw

§ draw()

void QCPLayer::draw ( QCPPainter *  painter)
protected

Draws the contents of this layer with the provided painter.

See also
replot, drawToPaintBuffer

§ drawToPaintBuffer()

void QCPLayer::drawToPaintBuffer ( )
protected

Draws the contents of this layer into the paint buffer which is associated with this layer. The association is established by the parent QCustomPlot, which manages all paint buffers (see QCustomPlot::setupPaintBuffers).

See also
draw

§ addChild()

void QCPLayer::addChild ( QCPLayerable *  layerable,
bool  prepend 
)
protected

Adds the layerable to the list of this layer. If prepend is set to true, the layerable will be prepended to the list, i.e. be drawn beneath the other layerables already in the list.

This function does not change the mLayer member of layerable to this layer. (Use QCPLayerable::setLayer to change the layer of an object, not this function.)

See also
removeChild

§ removeChild()

void QCPLayer::removeChild ( QCPLayerable *  layerable)
protected

Removes the layerable from the list of this layer.

This function does not change the mLayer member of layerable. (Use QCPLayerable::setLayer to change the layer of an object, not this function.)

See also
addChild
The documentation for this class was generated from the following files:
  • src/layer.h
  • src/layer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/doxygen.png0000644000175000017500000000066514030601042023027 0ustar rusconirusconi‰PNG  IHDRhvU`KgAMA† 1è–_ PLTE[h‹ÿÿÿàõ?tRNSð³ÚO÷bKGDf |d pHYsHHFÉk>ÅIDAT(Ͻ‘1Ã0EñÀž¡ÜǼS‰ÿ«ôc¬¤JÓ5¶†yt©?†l¸À¿ãéæ¼!̹±ô  ?®´±G"äoF2‘Î`t¡n;Z´…¦‡›—Ãñ°¨z!Eo‘wÀô'b:N”7nP*úƒºT"×Z?èTH$™ŒMbAÇ1/´jÓÈ`›Ó($5C™Hß`¢(ôÊy¯Gè)àö}(rÓ¿ˆS?ÌÔ³V‡l%jZÄ>Rd¡×a%WóÄcÍ%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_f.html0000644000175000017500000000663414030601037025070 0ustar rusconirusconi Data Fields - Functions
 

- f -

qcustomplot-2.1.0+dfsg1/documentation/html/LayoutsystemSketch.png0000644000175000017500000002364214030601040025234 0ustar rusconirusconi‰PNG  IHDR’’l˜<gAMA† 1è–_÷PLTEÿÿÿôôôËËËNNN;;;TTT“““äääÛÛÛkkkÃÃà ììì\\\‹‹‹EEEœœœ„„„«««£££##$ccc¼¼¼,,,yyy 333ÓÓÓ³³³ttt KD0ûåžÿé¡öàœ2+«mtjJ¦˜iij| e\A̺€ØƉSL5…zUjaI)%C=+òÜ™}sP!оƒŸ’eëÖ”¯¡o;5&¶¦t•ˆ_kU6È·3."À¯z# ¢•g&#[T:cdkos‹ÆÌïrt~^atTXiFIX12:">@Q58C$%-*+5ÈÎëøåªW[u€ˆ­”µ¯ºí¼ÈÿŽ—À«·é’›Å©³å˜¡Î–ŸÌ¢­Ûœ¤ÒŸªØ¨ÖŠ†€¹Åüw¡¶Àõ¦Ÿƒ}„©íà·ls’ci…diˆqw—±¼ïF<4NRh}€“ILdv}Ÿ;?OE1ó©Tÿ±XŒb2  »ƒBÔ“J# W= ÎŽHù­X y£2#„]/µ}@yU+·ÂøáœN’e3ˆŸì£R•h4åŸP™k6Ÿo8À…CʼnE±|>ÊFJF8©vqŠ‘Õ l‚ïô¯`wŠî4wkHVžŸ¤¼18\X> FS•=H…%)¡‹j~ê9Cx“Ìé«hN7³¾òWMA/1=FT›h|å@L‹\WGfzá…c<†]0­±ÌâÐŽ(*5cwÜyX4TF=ºÀÚtmUKZ¤=I…%C ("<8)àÎŽ“ˆep]Op†ùë«gبvnƒô‚Žây‹ò+2T@ILT‰R_¤ØгÀÊø’…\WP8Ž‚[Â<€gbKGDˆH pHYs Ú ÚKöë#­IDATxÚí}œGyç{ÞvÞzÞ÷陞žê™]¯¼–_Ö–,ËoØ’mc'±1–8É^ØS|œq€ÈH+Ù²‘‘‘MlÀ˜ˆóårg# 1oNŽ»„Ä`r$’Üî%9Hî¸Ë9ï$¤ªºçm·k»gj¶«w÷ùùóhg§{ªëå×UߪêYk …B¡P( …ZM±¸÷û‰d25å}(é¾ÊæØ¿y½°F™ËÙ¿¥²‚z©Ty¡2Õš÷ñjVA¦ÂÕ4d<ß=§CÎóQï¾Òü‡Yžh–Ì¢û"%ö#Íðë€ßu°™œl™#¡ewxßý1ú’UIZÝ_÷ÓüGÏYˆñŸ-˜h·¡—Ý âü4ŒÐk© v‘×4B¿¶ ÞÖ˜–A2ÙôHKh³S̲äÖè@‚V’ `vè¡Ÿ­iÿH’JºwÔ8õW,OÕ M&c“wÎqƒvL³r´ÃÊUx²)çÔiè„]QYb²Ú0“0£å Ý®Ó(W©C-mé:!Õ’Ö‰¤nΆ³µR͵ųF½®Å2%hf2¬ö“YÞÄΕjYn­—˜mÖ¦‰I Hµ­h…L=—Éðn¢ÛtižZßVÊ`É6Úe>ÔY3£µ²`d³Œ€:àÂNÌé½ÂT»nÕÙýÒM›)O•èM’’¨j¦™/Ój)Ò÷MHTL=윭•lƒõ•Ùž5zJÑ`8~&ئÎúÔ,ègÞ#wé(¨ºïÔÍàYÈQÈÞ3”iÒü–;:õ”R¯³°Ë!ÕO!©;e2Ël4Ó[mwLÓSZ•‘O“Ú¢B³lѳ^¶!ål ÕáÿòûÊ+­A€¢³r§á”ëìfm³jšÕ»?ºÖ¨A—Þ-8eN¥æìv»mÒפg¯®5R½j'!ÁFºlÕhE“™ÍTЬÌ* ÓüF Ca“¿¼Î{BËp‹Ìà¡gÜ 5Ì)*v“¤S7»‘Ótb¦ Ö(@w ÍÕç%n_`8V0I’ª<Øü]k´ Ý}'F5UL9FÒMÈSÐj«Ajz–ÖWŽgÐ%/z×d™sëáòäO™ù¸­×ÙÍ>KÇMê` §=¤Ö»‡µ!k(mÎÒúá*:'Ru;Ù~?¼éÚÐíj\kXÝ ×íe9ÐòÎÃ2ìÅë´’î –¥÷˜u>~0b÷…ÍzÜɳSjÔß¼ôÄÚçlm4ÕÖ™-ô¶ t h·Ôu³UçÖ ýÅl‰5ƒ9[)³6°í2ÒÑSÓ zfL×S•2[h˜‚r•¯4äzÝG5`~RÐ;ÕµF ’q­Ö`©&;Z–ám›¸ë݉O³‡9k¦B’V“Õ[âiÓ’éôª %Àœ.Óªâw«Àd±àPh›±ù”ÄE•)­óîÂL ,x–u0YÅO™z™;A«%ù(?ÃzJvs äØ=’!YÎÖ€Û%cÐÏò6jÔ Ÿ›TÜ5‘TPÔ¨BoRÓµí–À™6³ÞfÖhÒ|ón¢íž’rÇS–ÕÓLÿ÷65e»LKFÇ‹†®'R mšÄXÖÌz -Eo³Ê:‘µZ^;Í” ÷…ÑZ˼»K‚zÀEãš»t²Lù7ùe«žg ‹­õ­É!#ÐüXg÷œ¬¢¦XÕ²™-H¹&ŸØªšæýNÞ vv+ïB1<¥8:â§FTÜ€ŒÕ•¦ó×X+ðð1uŠuÖùÄ&*:m`÷+A†,°¬ËÐJ’#ºU t„«Þ´5JÊÒþÕ¡sÅ#X³~JgÝ 3¡`Ÿ2€úÓÖèh:0d¬_5Î0b̦å[ L[£¢»—Êë°ðWÉâ˱’Å/H²"äšipÚ qÈ0:ª³±&b‹4P.æœa¤—Oqí$˜¶*Ô,… ¹N¤xk¡'39;ÒGCWƒ6ƒê< )ÅúÙvH›’—5µQeJ-ô³EmrÖšs®:7ÊgiÔ¢­±œõÀp¯'à)€-gÏ¢sœŽö!%Ú p®ê<ôuƒŒóC½ä c/@.õ‚Ñ nÛjÇÒÅ;T硧sYvIØW=gn&¬ÔØã\qtó;.V‡®¶ï¤Æ¸ô²ð/|9nÅx²Muµ­‘Îت:®ÎÙBqÅ•*.½Æ~†´ ;UWÜÚèJ€…ˆôm—SȘ{…¢‹£5–ëª9˜»Ju&¸®^P=¡5–élÚJ:ðåâ±Kdt…ÖX¦ˆL[9dì¾HeÐÃR?m½ìÚSì`q­ÚŒ 5†¤~Úº‹ö[dŒ¼h4i¡5¥~Úz»…±K= £5iëYŽ3^©º*æуŠÂ´ÕÙœS]Lhž"1mÝí±Gu6˜Ð=EbÚzë6”÷]\h®ÔO[¹Î>ïÒó¢±LÖp¥~Ú5¡5©Ÿ¶FNh ®L[#'´S¦­‘Zc>"ÓÖÈ ­1ÏÔO[#'´Fd¦­QÓf·Æíº~N[=µÉ­q-_—Æi«—6¹5øw¦Ô?I­¡5~lëömö«æ½b·}­o\aïðÄNû²<Ž~Dh E¬ñÊ_Ø/´Æc§—> ð/ŸŽ5¡øŧlßø×qjiÅÓh£Zãñ¥°õ© ÅÇŸú¸o|ì©­¾qÅS¿äÛžú·+baé„ÀÑcãÿîégžùÄ™cCñÉ3ÏúƧÎ|Ú7ž>óï}ã3g>»<ôOý²ýœœ5NÂ!zýÏùüP|áÌ|ãóg>ç_<ó%ßxþ̯,ýù_Ýú·5±ÆÕÿáV‘5ž°õO‰ ¾pDʇϩ.ƒ—¾ +žH‹*küÇÿôIÕµå­_ûu¹^ã¶H:žzþÝë„5ßóÕu%ÒoHYãäoªÎ¿P'<­9Öx>­º¦ú*<$c ÕéûÃë‚5ßÉ™êk0'c¿®º"Üïeè±Æo©®)‘~ûž'¤XCuþ…zúxY#r¬qzÏ7TW•H¿#ŇŸW¡þ3²†œ55BÖ@ÖYYC$d d o!k k„¬¬!²²†HÈÈÞBÖ@ÖYYC d d ‘55¼…¬¡˜5Þ¿í ª«J IÖx೪ ²†¬5³Æ“»¾¦ºªD’co~Quþ…BÖ²²†@›5ÞÈ…¬¬!Ò&cß½í•ÈÁ„¬¬!²²†@ÈÈ"!k kx YYC d d 5B±ÆE¿‡¬!kH Y#kœ»û[ÈQ²†¬55DBÖ@ÖðÖ·õd¬]Ö8fÄËÈ…¬¬!Ðï¿ý}“5>ƒ¬!+d d o!k k„¬¬!²²†HÈÈÞBÖ@ÖYYC d d ‘55¼…¬¬!²²†@ÈÈ"!k kx YC1k5?¯ºª’d‡¢jyd i!k(f÷½ó;ª«J$9Öx!ª3/d i!k k´ùXƒ k²²†H›Œ5îúíÈÁ„¬¬!²²†@ÈÈ"!k kx YYC d d 5B±Æ•ðvdÈYCRÈá°Æ¶}ÈQ²†¬55DBÖ@ÖðÖ·õ‘55¼„¬¬!Ðî?½1Yã+ô²†œ55¼…¬¬!²²†@ÈÈ"!k kx YYC d d 55DBÖ@Ö𲲆@ÈÈ!k kˆ„¬¬á-d Ŭñ_¢ú—òdYãYÕ YCVÈŠYãþw~UuU‰$ÇÏ}Nuþ…BÖ²²†@›5Þ sÈÁ„¬¬!Ò&cGþëKÈÁ„¬¬!²²†@ÈÈ"!k kx YYC d d 5B±ÆöKîAÖˆŒ5$…¬Š5Î_ø.²FT„¬!+d d ‘55¼õ•g6(k<;÷d )!k kô½w}hc²ÆWÿ²†¤55¼…¬¬!²²†@ÈÈ"!k kx YYC d d 55DBÖ@Ö𲲆@ÈÈ!k kˆ„¬¬á-d ŬñðYÏ«®*$Yã¾cª ²†¬5³ÆÿýÛª«J$IÖø’êü …¬!)d d 6k(±²F„„¬!­MÆÿÇeÈÁ„¬¬!²²†@ÈÈ"!k kx YYC d d 5Âaÿy7²Fd„¬!)dP¬ñ*²Y#*BÖ²²†HÈÈÞúcrrc²Æ§‘5$…¬¬!Ð'=¾1YãO®CÖ²²†·55BÖ@ÖYYC$d d o!k k„¬¬!²²†HÈÈÞBÖ@ÖYYC d d ‘55¼…¬¡˜5N‘ÿ¥ºªBÖ@ÖYC1k|ø÷þXuU‰$ǧ¾¡:ÿB!kH YYC ÍÆŠ¬¬!!kHk“±†"k kDHȲBÖ@ÖYYC$d d o!k k„¬¬!²F8¬qù½È‘²†¤5B±Æ+È÷‘5¢"d Y‰XãÎïÞÝ7Åw÷#k k8Ö¸ó»‡îèI}?²Æ¦cc+YãMÔ+¤¿f}±ÆgÏBÖ“k<äa›nCÖØd¬ñº£ 3ã‹»ð Ôë5¾ñ²†¤ë½·o×݆ëÈÓ׻AÖ@ÖÁÈ›5[Ycó±F@k k k k k k k8BÖ@Ö YYÃ[ÈÈ!k k„¬¬!²²†·5T³ÆÜTW•@’¬1÷Œêˆ„¬!+d Ŭñž ?£ºªD’c‡¿¦:ÿB!kH YYC d µ¬qü›;£:ÉÛl¬¡èCŠXã4{"ûYÕu%²†JÖ˜ãOëGó½o6ÖPô‡¨¬qÄù"Ç×UW–§5”²†ch‚(²†RÖ8É­ñ´êÊò²†JÖàÖˆh"k¨d :AùS;šÃ ²†RÖ8aÓßKuM‰„¬Š5þì¿ÍÇŽù?OdYãþ/üPuDú¿‘g'ž[: ºêšèóä”kDtßð{úIOk¨b û–•Ö¸––ƒ¨þ^Áƒ2Öxˆ|Bu ¼õ¥å =Öø(#åü¿§ðô™ßþÞŸ‡__¦ñÉ_ùá/>"cœøÕ_û“3þ½ß—ŽúÆŽ/çéÿÝãžÖˆk‡î]9_|ùYøÍUâ/^þ´o|ñåÏúÆó/Ý7~Àã&ø¥="†Rïë/žY5þÒ7ô—ÿ*@|Õ7à忦ñЬÈhÔXã¡^¿vê¡Óô·çV}ãÁ¥ùÆ7—NúÆá¥?¥ñÂÜaik|äÅÃKÓAS÷QÔò‹¹¥ˆÓ¾a/=IãQûãkD†5N­˜]G^£ZcÝ(Z¬ñ(Àa©â(зFTXãE°O¨®‘QµÁ­Ö8 pZu…Õ‡»ƒó·F4Xã1NJ',=nÜçlGmpkDƒ5N‚ý˜dqBÒqþÔ€3—ÚàÖˆkœ8*[œôœó°ï66¸5¢À'lxQumÕƒŽ5žd¯7¸5¢À‡U]Aõ¤c þzƒ[#¬q?À)ùâ„¥ÃÌÎð·Á­Ö˜ƒ‡T×Å¢Öø¨;{ÝàÖPÏ/—/MX:2ÐÅmpk¨ewÁ}ï¡w¡êªA/€Ý{ýXãາûrx«rÖ¸ `î «È÷Ÿ>"†=`äaŸÀ‹d=áÓr}`Q9kÔ)Ó=NŸ°A~ùä9€ž½>p·ÈûÖÍÞJ°wéjYcq?€ýd8%v¾N+ÙÏÛ½ýáã‚[ƒ^Öx‡ö©uiŽ#Gé-ô–E嬱x ¬c{“ЋïÕUçNB÷ð"¨e{ö›ª+bL‘›­°Ü‹·ï]§æÐo¹Óei•¬q»ߢ?ÞzGr ~¯Lox›ûòÍw-.®j ªŸ ¥\Ö@O¨’5ö‚¾¼†×N73g’Jâ&ø¾ð˜‡5Ö¹ (×0Ö¸àgÃ+)óÐR)¼à ƒÏûaA kÌ¿þ®GtØ^Aé`p§d߇›Ä7œ5Yü›+ÕXƒ)´±Y¼ëönÜ(3tØ7ögx3íäV¾Ð fƒ¿O>~7Ô¸M/¯Ú~kh=t俉RèÞ^ì[Üç{¿åß_¼ueìg«ýßoY|·oä(ž †Nÿ[þÞM‹‡ÜØÐ{=»ø“¾qŒvß~AhÏç:·¨_Üë÷j€ YãlvïKçû±k~—o왿Ô7vÎoY6 ý~ÃüžqÅüC°gÅ{»ç/tc@ïõp,ÌŸ .÷ ÂzZ߸Ö7ìùWˆ—ö\¥ª×¸`û|hºà*É$¶ÀÜj‡´úá§5³ÆE†WŒsl¸X6 €KV;ŽÖ˜”5VŸMX´‹:G2‰Á>{µãh Y》Â+Åe7ʦaÃ߯z­1klé~mñ¹ãè<€UwвÆn ²m5‚^òÁ„ š£“¨U…Ö˜ˆ5v\b!v­¾D?xÉï ´†¼5®¿[p¢¢£×å²i,ÀŸ3Г°ÆN°eç £h|£ p¥Ï)h XãZ€W„X„+þA6Ýpƒß)h yk\fûvÎÕNù” °ZCÞ e׬GÑè£vÂ6ßsÐÒÖ¸`G˜%¸"@³úh{w¡5d­qö\f®¸Z6]p–ÿIh Yklø³0 ° vË&qU ~­!i :òŸfþÏŸÀâÚ–@+fh Ik,Èü#iÁÖé'¿ÝxWh 9k\ç¿t4Q]; Þë‚íÍ¡5¤¬±}›ã#‰ÀVé4>„Ö²Æî ¨?Aí˜ÀC†—ûíÆ»BkÈXãòp7\ÙNú.é4HÀ­@´†„5^ØjæÏóÝI÷×µA'ÛhÀJ¬XPØ s!>¿Ã¿Îp©t" Aie³YcûøÖ(-_ øÀù¡fþBù/°eý€SœÍf@ƵFzÙâeöþQ4/°˜+ž¹Ù¬±Æ¸ÖÐ’Ã Ÿ»ÀDúÓßËÁ€}[&èÌæ²ÆK7ÄǶFŒØ»¯wµ `áú0u‘NÄzêBðS׿ha¡1¶3¨7’ªÿöjͤW$œAU˜J%åʉ0U0¤1A|®j•ªÑ”3Æ€š­‰%HÉñºïìQr=5 nF™P÷‚™Ix1zð“Ñc© ÷ŠíI4”= j¡5ÆQGgÇ»bI:‘,رàg£5ÆQ̯hMâŠ#œÖC³ùp¯˜œ[QU #œŽÖ]i€TÈ—4 'Ÿˆ ÉQNGkŒ.#ô:£Såšt"•Ñ­1²J3!_²>‰©r¬‘ÎGkø)ÛéÿËTÐGë—GUiºÿ¯«À8‹uó‘樀„ÖðÔLov x [½;® ºß °á"Á¶¼;u£Û¥¡#;¸6ezn× ÷Ë,8µ>ÜÓ£öoѣ˭Qq’-2k4Dgb ÞïëìMÙ± ωkÞ¦ùlà VB½Ìz Í fŽ^Ãb×퀑`¶²SΠÔwóe“[ƒ3_ºÛBù^S•À Ýê)Š¾¤0ËÚ½LÏg SãÖàMDÛ¨ÛM;¶â¬Q§mOºÓH{E¯Ñè^¦é3¡˜šï†](ÐO–IŒOcc¦‘¬°®°¢%˜ÏH[Oh *“Ð!?N›Å¹ÅÝOt›ª-ª§E4!ld‰Ñyû\Ã11i²ùΰ5š´7(37j :fœëiÝʼnénÇU…ÕWOôŠìÑ€íh ºév‚Eë~ž¯lô :ªF±F¬6Ânÿºk¦î~ÍSç·´„áñîÍ« wÔʠ󵎀^çÖ 3’ mΓ¶ë6b&k\¦ Â1±:á'éî¾¹å³@U·˜“éÕm¶Ùn:¹®ñËÑ´ -3+Ž»I¼º5ªÉºÕ‚ÄÏÈ\é„a¤Ò‚ƒÙñ¿²&ªº³ÂX5å<7Zh¥fBJÎ Á0|Ë^+:Ëè±l©›b¾:ã¤Ö` “®ògªlÞÛaÿVRE K©†ó‰X…í.ƒ¦ý¨¦© j4ñ™izrv¶ÐŒkÖTI³ÒœÉ™Ú ý|©Ã.:nåÔÀë˜Po›}$/è`:6iDdTØ›Ùòʳõ:æ”ú ÎѸ<&<ÆXÿ#“Ø剭²SËG^®4?'7tÏÇØýÐq×2ÝDúCr:îžVúÉNvœSùq˜M¡äŠIB&òà*~Ó¯ÜÛ6 fO‡Z¬_e³4(Ó­Bø<=EêÐÝ»q;™ $Xsô4:z,ú³É©Ù=¹Pgcâ¸ôŒi¦m´gå“aªÑf/yÝÕž8”Ó%:SNÓ†åËÅ´»šz!ÏÖ^ÙA©§á>[fAŠ«)êö –Îæ€U­æP3Å=6l“X,ìgoQ£©èñ/ö~¼;ãS{bð†ecJŒ;º‰Ýó)ÝYª¹]LÁ»ê~Æ]à¥cLÍYõåÔl1bOkv‚&4!{£ÖHyƒxYcª;ëá+¶¤ÍÖ.:›‘lQ'ÍÚ›¾`VÑf{+BMBžo ÒžcÚ":XÝ5>¾v[uö#ôzÓÒGyŠµÜéSšµ|œ¶(mØ L»3é6[1,ðÓ d“ýÙ Åóþ µ4³6ro®Ý6€Xãi=T͸´vÛ˜ã.ᆬî*¿5ZËV~‚Z#УŸÖÈЬ4i{Ôú cUÚ$-Ú%—ƒ¬KJ«Õ®[” b ƒ=’oÓk¶ «V¬i3¬²R´ïb/Šìœ6¿¯Ò ËHÐszÕ`OO’F±Ã*´e³Z%á|¨ÐîÄI»˜ªýgµÂQ3g›%-mM8v±›ÒÒí\^3X™Êm:'×ùn²EvkÑ »sçéG›Ž52†N*´à‰¶Mª%¢'é0œ¦ïÑŠ(–˶Ù`K‹„pì2²ZÓ¬ÒsÜ)cÍ´I‹mÇ’â5Ø3¼Óî¯mñÝ^zƒ†ÓmŒ/N¡«‰íôw£©4äªLÇ*ºUá G­kW§‰éŽ¥E-§gle‡5Çâ†^qÖÛÁ¨Ř5ˆ9•¤}«íJôj–µ&)±-¶$=- ™B fesþ8)eÝà ˜³”'Úúl–ÜÖ0iGm±ÎÚèí´ð™SHÄ6#†óýê®i6§Sý§")vkjf½otw@)+ ¨›lºÅöf]kô`œ­ò°§<©5øDÎÕ؃3¬Ä´ukŒæõ$µFŒ6ßP¸5ºÏjÝÁÊ´cŒs…Õ[Oçý#>#Ò[é3ö9£–ÓI}ìŸpÄë˜M»­QIš:ð6 w-Û)rçWX£MG…ÔEþÒâkƒvËÐÖÌò÷ gNOS¶F¾7ßsZ9O±Œ²FÑí0ŒÞóé|$c]G9Ú}ñ†o˜ö°5JИIq®f,Ýr¸s¬Q´†=Ew¬Á^:O`Ü• ,”ø{ÎÚòrktúÖà}BRôìé!k4ܧ·úÛZüÛ…Oؾ%CIÊPrCÖ`M‘6d¦¨ø€ÂîR»Ìö”ÿI­Qq¿¶2h÷™®®5ú… [£; 8×°»›ï l5°ei¶: ~æ51¥ÁlY¬1¬aèSY›õØßOÌéÅ2÷õÖ¬N­‘þœ†³I¶šÌ8ªKåÚ5èù©R¹Ò³e‡in‚eÖèÐdKÔ‹ÉR1;h þ¨°ž«ÖûvÌ€U5yz£}³5ŽòuÍJ5ý5s--nÚfµK…? kî›|N7+„ÞÅuÛi˜Ž¡Ûõ‚Ö¦Ó±sq-Eíø‹6a“Û¢á¦^ÔuNglòÊö«‹î81mòInŠ¢FI›¢ Ÿ,ó÷ùff¼®çfú3ŠoF‡Y$â·á5ÊÊ’H±ÉݲïYyÞ µ†*ŒýœödTµ»sÀÌð] üõ”„h›Æ( …B¡P(jbúG À ƒŸC¦ì%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀtEXtSoftwarewww.inkscape.org›î<IEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemBracket-length.png0000644000175000017500000001152614030601040025363 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_ÀPLTEÿÿÿþé•&yàë­Q6  \¦èüòûôooo±U  0ëç•+—ªÑèè辪wk†±üÔi ¤Ö××íÑ›2,(^°ÿóµs- ^Èêêÿ,[E_Ç÷ƒåúÑpW¯é+H õ÷øåò寯¯ÍÎÿŸ‘§777'''WWWGGGÆÆÆOOþ ÿ‘‘ÿÿÿ³³ÿmmÿ__ÑuuÒí..þ%%7ý䉭ɬÁïbKGDˆH pHYsÃÃÇo¨d½IDATxÚí][ÚHŽVƒD¶6ׯVÎ*æBH A@Ï+½ïÿÿ¯¾ý‘DQ$ó† Ä<û>}l+ò“Ù™ywf,ËÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀÀàÃààðÓÆÕÒer À˜âöJÛ¶Ý9)^äºÎ iˆ2¹à•¶§=ÛfŸ÷=)ÍJÙ/î_»Å‹„uû–öêT¿õν‹æ¯»r¥þìÙì»uùƒ{ßÕåq§/-Ögçä9Úö_½ëƒÃ¿íŸÅ«ê­òoû{WÈÝ?ûp±ªí™}-+”û³w}ÓûÉÿÍn õ¤® ×H*5¸îž²ë³Áµuqrdgaåæk÷¨÷©0áÁqçäâÎæ&dß½~ñêàÄâo͇àr| œ\~Ù·NTmŽ·>ÿe¦\aÂ\=¡ëå]çäæðÜß÷Ì7*u%É¥vf߯\Þ]&”ëõL˜0WF¾ªÞ*ÿþÖûœË5«ÚZ?¸Köså æê ]勧ƒ&»¡Ì—wç]Îc:…vO{ŒÙ/LÈ®…v×*—<¿*ß*ÿÎLÈšn—ÚJUx<Í”ËMøR=nB†›ð*ûa]Üu.Ï%“9㦼<^ç…Ÿ^¾š{á§æ…J[‘ö»?:+^ÈãгòB׆/Jë9;\|ñ¹6ŸrFÚ½øÂ!Öçs.<ìô9ÈLX¼ZäÀÜ„"­¸AßJµýãë°ûÇ!"<ó\xy|ÞåJÞ>+o —åÞzñeß߬Ô_‚£ùgœ… nEŒäqãœgw»ó"*Ò–ÒƒüÕœ‘&l:[ÕVü³Í”³øÿÙŸ½ÛB=¹ÙWM¦3^Ç”´,ÇQóævè†'<¤¼JêÆ„ ]±Ü®þÒ˜ÐÀÀÀÀ fŒ¢}ÏÀ`¸³mwß³0x‰€y€pl³±ËÆûž´AwÌ}jGÿ‡Ãö=ï6#d1 ۉ㠢„å?};Øz¢>Rjˆp5)ŸP{f' ŽRk£AÞ +Ä[šé½5›O?–p5}'±!á$Üì!¯…¢–ì­o1f NÃqœ0–ÄG‡[æ#§‘Í&vK^Å€°Äzƒ¼#¬Àœít\Ìç k6¬Mx4±“Èq Âáx2Žb;ÃDß#;;m4È[a‰`å-¬ðŽAÖ KŒ“-Ô{œÎæÿ<}'¬øLøߧ'^o×Ò;ÂS/Sã— ÿÊB©6öæ·` žäÈéæ=ت°Â»”°Ä:ƒ¼+,áÚÀNä5¦ËG1ôô¼cOJ˜ ?.¦–'.qìÓ„iD„=6|5r2„³‰Â®Ò…êNd †Ã¾º¿œñ]fÙRxæÿóË›xDaš0Gʲ`Z]»·#o¦üë¦ñ.¡Y'œiÂáV[ÃÙp¹öå%./,Ââc…W¹DaSš0‡—ÙpË\¿2rÙlÍ4Þ§ük„%F6 ¬ÀJxÖ& 9‰x¸_ í˜Í|ª°ÀDø!UX|€´áz«¿H• ÙVœæÕÈ› ͺi¼Kù×ÎYbAÞV×rBÓŸYÓ¾škiâyH6§ªUaoC`|#,S6Ünç»:rÉlÝ4Þ¥ükç,çÂÙ¥ÑSëŽÀ¢¹»!0®…2 }ùY(E>£ ø §üÎ0=µn]ðÂ$@‘g"{ÇH‡®7HÊ3L]µîq«‚: Z™êQ/›32a Ü 8ÃÔQëH1§ÂÝÐB·zceÂ-øÚàEå ”ŸqyሆÌ;Ò ‘üIŠ ~º°6c„û4NùqƒšMˆ^­¬Ÿ¤h$ÍÊ¥:ûP¸ApÊŸâÑÕ¼GOr›÷†o‘€‘ÔÑIqƒT ü8ÃÔEhÆh1„aN¥L‚GRœt'”7ˆ.BãƒN%ùBؼjœTëñ’]Pþ Ù¶yŸÝWxèõe`é:K†[tcÞ`'”¿ ¡Ñ“ñ´5ÀÀ­!ÊI-µîUì‚òW0ȶÍûb0hE`$ A§òô'ÃÝPþ]TòÞQÏÆ‚ÆŒ¤.êT*jÒNa'”'•¼µÐÿ~#w=p¯k¯±í†a· ¼\1I'Õ’¡ÆÙL†¹]óþ<’ŽyŒ¤˜ S=ç V°ƒŒ*=%ŒI]”ó£ÉP™tW s•¼õ@}M†‰þÍýn(ÿN*ykFÒ HÇ E²ãzïÂkwó>#i¶ð0E¨¿ÒÝúæ=IÑ Ò“*Ý­oÞÇ`$A¶&C»†dØòæ=Ipë=÷êIÉp'”Í{0’zàÖ;÷ê“*ÝmoÞ£‘”a¼W©cgØòæ=I#0U1,·yµ$Ãv7ï}ðz…`&kl¶þCÝVÛ›÷1VVö+i¢¿!©¡LÚöæ=I¬@ã-@åµz{†VË›÷h$€†ÍøŒÖÓ¤VÛ›÷`$ @Òc%³¬>£¹ÆÖòæ½FR†‘þ,™±:jl-oÞ£‘4Âê->¸Kˆê‰¤ e˜šš÷ IG`fÓ³Ö O†š 4ínÞ£‘ŒsVoÉ“¡nNÚêæ}¥HJg.X¹ÎŸ$¤õTÛ›÷ FGàÞ;Á6ëÙ­¢ºë¤ínÞ;`Ø’ü„¾¦Ç¡É#©î"[«›÷n•{%èkÚwzI=Ù°±Í{¨SôîT1B3› àMg9'Õ½½ouóÞ÷aàû¸~nBÍ-§V7ï]°7aq.Ënäô™ÝýŠV7ïlɧ ëÏ*.ÔÌR¸¡æE«›÷˜yÀƒi¡!¼Â ‘o‚ L£ÍÍû#€èý.`0 ‡ÖRi«›÷#p_QÑ ©—0-B©Ö þN(ÿÞš÷ vµF )Í7 Ô 6œXÃÅк×ó¥ÍlÞ;ÿèP0Ƀì?O€_¦C‚Ž“g?\,}k¶, »jÞcF\œ'ZdUñ¢1\L­ÅýCéžmÈRù ß˽ Ê?|ê\¹8©CpædqhõIÓ̓?à>e=¾þ"È8Í@ìéb[ *1Lš‚9fKnŠ‚úKų4(ˆ>ŸK…Ò…ørRÈ¡.£¯OøjWßsâï·ÖЪÀ0û‹ó€¨àó•‰h *ÌæŠgiPP¸a2£yˆ€z„z‡„¸J]ñ†ŽÚìõç”°á:±ôBgµdCŸˆ‡ð7LG.d%¦ úKŽt(ȳÏà×ÐZ̉ÉXÙPîõˆW%L¤O N1'^õ!Û+—aùë7]AÉ0éfŸÏT%ª ÇPß÷‰ªc’gëFƒ¢4 *%N+ö©Ÿ§ÐN‡ùz2!ZÂC/œ.U¯˜¬ õЗ!+ȱXôÓ–(ƒÐ&½bº‚Öð­äõ—}ë¼£GÁ9Si‡¼"ú¾jSM©QõÙ›<ΩÉÞ÷.e *ƒ ZŠò“äƒÏ­Î/2›ÉÕÓYÞûLÔÀnòHêõé‘I°ÇdŸÒÛtÞ+ƒ äoêsÊ ëáÁú>@§¦©yo‰tÈõË$9~w:ö¿çfØ™ †¾!§ü€‚ýû{ëŸ'˜,îï±ùÓøHÚ&ùB¿ è³ÇXuœ àŒS~,¯­áÇiÞóúd³9ÂÀ¾l:UVYÕwƒÅã|è?=¡ïú@Í{éUPÜÇœª÷Èø-oÞËku,Á <OÖr*¸ÝÍ{±»‡f ž÷Oç^¨ùDi«›÷bç즋‡ÕL¨ù4b»›÷X”Lú'g›ø­§ šÚ¼×tç}¥³ùô âc‡‚‹^¿æ› Û}ç=˜ Ï€ 3?¨ù¶íÆÞyŸêÐn‚%CuÔŒ.c¹-?ɦû~цÞyk©a¤Hª²2ÂAÏõ˜ ó¥zØT†©éÎ{†EÒI¥SPp2Ô|wE»ï¼·Hú,0†5EÒVßy‚žaeÒqÅHšêÐí­¾óÞ;`$õÁÀ˜×׬Phê÷ZôŒ±jˆFÒ ÆIýz 4»¡üûºó>ÃVŒEÒŒÐìûQB;¡üû¼ó™lî½#¬ùP¸¡æ'zµúÎû [ v=ŸäÍûŠVßy6 C0ÎÅ Úõ¸aCï¼×ö(!hõ0Œn¤`6¬É [ݼ÷Á­¡º!¸½/žž × wBù÷Ö¼Ÿ`½dýA3Ü°¡ÑÓ¼wÁ%?Áº†°ÖSìnwó>–¼[³æ•RÍ%šV7ï½*(.H Ö®ãZÜ°ÝÍû+‡¸`7!Û’Ã’WK÷~'”oÍûìïL°*[V)¥DÎh´(W ÕÍ{ô™ë¨f•Rzì­åDiC¦¦æ}X³: Eòfh}Fi»›÷â–ú-×Qfk(ÃÔtç=úÕc0U¡»ógiÝß7Ô š›ïƒÞ¿(ÛßãqÓz²»ÕÍ{‘Ý Ð S´Ÿ1­·9µºyWÙ`7ŒÀnüÈ‹:$%Sô-¨y/.1f0Ìy¨&5l,Zݼ‘›-ë'¨¦5¸a»›÷è)7>ÚEÝ0ª!î‚aî­yWÙ|ðKï³2}™ä‹T‹zÙÚܼ—n˜"òc°·î¢¹m¬¿ÚÝîæ½Ø~CAËG|N@§Ê›¿:›N 5ˆ¦;ïA®ÖÔ´òÈ,¦ÿ$T«›÷ðŒÊȈè§"#àT™ê<žßîæ½0 ´F}´Š9Ê׿½owó^TP°Ïž€™ }°^¾7Ô¢]†v7ïE›"Ýš©bФú·† e˜šš÷¢¶Œ-†ÌT!X¡ÉÎdØò潸bÐg;hŒé3Ò¤´¡ S×có#l— ùbЩÓ¼‡ÕW| f*tª@{ m{óž:l¶è#õŸdkyó^l 0ã¡™ íoÔp4¿åÍû]ò ä3Iê}NpÛ›÷Ü$˜~1XH°F¼‡Öa)hyó~ÖIÑ' 'X±%@)/ ínÞ‡`9k ödÁ¯žh¿;FŽÚÈæ}è©$z  ŒòûXuµÓÑLÉÆ5ïÝ1³cM›'Ü S@<„Ÿž©ùAP ; üA ,>.Ìm¼›a&ŒQBŠÄ0·& V¢üH4ð¸OEÔh Sîíä„©übXò…` Ò Ï!²ö„°C%½pú3k8íwmJ˜ósJ\Ì„¹M¢òÉæÂVÊ4?1¡™éRƒ¼ö&ŒM¼ýc ÎÖÃ≖é•ðÒ%ÑóLØr‚t.Ì šÎàòrdßIJw*+ÂI¸/aËå0&Ž)…û-U)áÔIéÂ^¨Ù€ÅÈAd³qù:}!\Î3êF0|èÏ9Â%å «ú…+(ø‹ ~GC„1L—Sqí¦KÊ—h6D¸Š‚ç `ûÆð8‰¡g¤¯“nˆ°Qð5óùÒš¿•²!ÂFÁè/†Cêw7DØ(¸Šé½õ8§ºwC„‚¯áC÷Û7CØ(h``````````````````°NíŸüçYÏ\…/ïlÛ>ï–ˆ^þ°íÁ-qäL˜6²QpݬÇ'ýßáÕß?:'4áƒÃÏ®[Zª½ù}{ɇ¤œ ÓF6 ®NÚùߟôÙàÄúÖ+[K™ð¥‚9ø°´‘3aúÈFÁ¸“>íôùÚûI¾é©R>,ud)LÙ(øVîuyLÔÐòú—?e¡ƒã¨÷™<²&l\£!°HnÄ|JðíðŠ>²¦Žl|;iÐË=¼Ðð[ù Data Fields - Functions
 

- d -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayoutElement.html0000644000175000017500000024067614030601040025721 0ustar rusconirusconi QCPLayoutElement Class Reference
Public Types | Public Functions | Protected Functions
QCPLayoutElement Class Reference

The abstract base class for all objects that form the layout system. More...

Inheritance diagram for QCPLayoutElement:
Inheritance graph

Public Types

enum  UpdatePhase
 
enum  SizeConstraintRect
 

Public Functions

 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual void update (UpdatePhase phase)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

The abstract base class for all objects that form the layout system.

This is an abstract base class. As such, it can't be instantiated directly, rather use one of its subclasses.

A Layout element is a rectangular object which can be placed in layouts. It has an outer rect (QCPLayoutElement::outerRect) and an inner rect (QCPLayoutElement::rect). The difference between outer and inner rect is called its margin. The margin can either be set to automatic or manual (setAutoMargins) on a per-side basis. If a side is set to manual, that margin can be set explicitly with setMargins and will stay fixed at that value. If it's set to automatic, the layout element subclass will control the value itself (via calculateAutoMargin).

Layout elements can be placed in layouts (base class QCPLayout) like QCPLayoutGrid. The top level layout is reachable via QCustomPlot::plotLayout, and is a QCPLayoutGrid. Since QCPLayout itself derives from QCPLayoutElement, layouts can be nested.

Thus in QCustomPlot one can divide layout elements into two categories: The ones that are invisible by themselves, because they don't draw anything. Their only purpose is to manage the position and size of other layout elements. This category of layout elements usually use QCPLayout as base class. Then there is the category of layout elements which actually draw something. For example, QCPAxisRect, QCPLegend and QCPTextElement are of this category. This does not necessarily mean that the latter category can't have child layout elements. QCPLegend for instance, actually derives from QCPLayoutGrid and the individual legend items are child layout elements in the grid layout.

Member Enumeration Documentation

§ UpdatePhase

enum QCPLayoutElement::UpdatePhase

Defines the phases of the update process, that happens just before a replot. At each phase, update is called with the according UpdatePhase value.

Enumerator
upPreparation 

Phase used for any type of preparation that needs to be done before margin calculation and layout.

upMargins 

Phase in which the margins are calculated and set.

upLayout 

Final phase in which the layout system places the rects of the elements.

§ SizeConstraintRect

enum QCPLayoutElement::SizeConstraintRect

Defines to which rect of a layout element the size constraints that can be set via setMinimumSize and setMaximumSize apply. The outer rect (outerRect) includes the margins (e.g. in the case of a QCPAxisRect the axis labels), whereas the inner rect (rect) does not.

See also
setSizeConstraintRect
Enumerator
scrInnerRect 

Minimum/Maximum size constraints apply to inner rect.

scrOuterRect 

Minimum/Maximum size constraints apply to outer rect, thus include layout element margins.

Constructor & Destructor Documentation

§ QCPLayoutElement()

QCPLayoutElement::QCPLayoutElement ( QCustomPlot *  parentPlot = nullptr)
explicit

Creates an instance of QCPLayoutElement and sets default values.

Member Function Documentation

§ layout()

QCPLayout * QCPLayoutElement::layout ( ) const
inline

Returns the parent layout of this layout element.

§ rect()

QRect QCPLayoutElement::rect ( ) const
inline

Returns the inner rect of this layout element. The inner rect is the outer rect (outerRect, setOuterRect) shrinked by the margins (setMargins, setAutoMargins).

In some cases, the area between outer and inner rect is left blank. In other cases the margin area is used to display peripheral graphics while the main content is in the inner rect. This is where automatic margin calculation becomes interesting because it allows the layout element to adapt the margins to the peripheral graphics it wants to draw. For example, QCPAxisRect draws the axis labels and tick labels in the margin area, thus needs to adjust the margins (if setAutoMargins is enabled) according to the space required by the labels of the axes.

See also
outerRect

§ outerRect()

QRect QCPLayoutElement::outerRect ( ) const
inline

Returns the outer rect of this layout element. The outer rect is the inner rect expanded by the margins (setMargins, setAutoMargins). The outer rect is used (and set via setOuterRect) by the parent QCPLayout to control the size of this layout element.

See also
rect

§ setOuterRect()

void QCPLayoutElement::setOuterRect ( const QRect &  rect)

Sets the outer rect of this layout element. If the layout element is inside a layout, the layout sets the position and size of this layout element using this function.

Calling this function externally has no effect, since the layout will overwrite any changes to the outer rect upon the next replot.

The layout element will adapt its inner rect by applying the margins inward to the outer rect.

See also
rect

§ setMargins()

void QCPLayoutElement::setMargins ( const QMargins &  margins)

Sets the margins of this layout element. If setAutoMargins is disabled for some or all sides, this function is used to manually set the margin on those sides. Sides that are still set to be handled automatically are ignored and may have any value in margins.

The margin is the distance between the outer rect (controlled by the parent layout via setOuterRect) and the inner rect (which usually contains the main content of this layout element).

See also
setAutoMargins

§ setMinimumMargins()

void QCPLayoutElement::setMinimumMargins ( const QMargins &  margins)

If setAutoMargins is enabled on some or all margins, this function is used to provide minimum values for those margins.

The minimum values are not enforced on margin sides that were set to be under manual control via setAutoMargins.

See also
setAutoMargins

§ setAutoMargins()

void QCPLayoutElement::setAutoMargins ( QCP::MarginSides  sides)

Sets on which sides the margin shall be calculated automatically. If a side is calculated automatically, a minimum margin value may be provided with setMinimumMargins. If a side is set to be controlled manually, the value may be specified with setMargins.

Margin sides that are under automatic control may participate in a QCPMarginGroup (see setMarginGroup), to synchronize (align) it with other layout elements in the plot.

See also
setMinimumMargins, setMargins, QCP::MarginSide

§ setMinimumSize() [1/2]

void QCPLayoutElement::setMinimumSize ( const QSize &  size)

Sets the minimum size of this layout element. A parent layout tries to respect the size here by changing row/column sizes in the layout accordingly.

If the parent layout size is not sufficient to satisfy all minimum size constraints of its child layout elements, the layout may set a size that is actually smaller than size. QCustomPlot propagates the layout's size constraints to the outside by setting its own minimum QWidget size accordingly, so violations of size should be exceptions.

Whether this constraint applies to the inner or the outer rect can be specified with setSizeConstraintRect (see rect and outerRect).

§ setMinimumSize() [2/2]

void QCPLayoutElement::setMinimumSize ( int  width,
int  height 
)

This is an overloaded function.

Sets the minimum size of this layout element.

Whether this constraint applies to the inner or the outer rect can be specified with setSizeConstraintRect (see rect and outerRect).

§ setMaximumSize() [1/2]

void QCPLayoutElement::setMaximumSize ( const QSize &  size)

Sets the maximum size of this layout element. A parent layout tries to respect the size here by changing row/column sizes in the layout accordingly.

Whether this constraint applies to the inner or the outer rect can be specified with setSizeConstraintRect (see rect and outerRect).

§ setMaximumSize() [2/2]

void QCPLayoutElement::setMaximumSize ( int  width,
int  height 
)

This is an overloaded function.

Sets the maximum size of this layout element.

Whether this constraint applies to the inner or the outer rect can be specified with setSizeConstraintRect (see rect and outerRect).

§ setSizeConstraintRect()

void QCPLayoutElement::setSizeConstraintRect ( SizeConstraintRect  constraintRect)

Sets to which rect of a layout element the size constraints apply. Size constraints can be set via setMinimumSize and setMaximumSize.

The outer rect (outerRect) includes the margins (e.g. in the case of a QCPAxisRect the axis labels), whereas the inner rect (rect) does not.

See also
setMinimumSize, setMaximumSize

§ setMarginGroup()

void QCPLayoutElement::setMarginGroup ( QCP::MarginSides  sides,
QCPMarginGroup *  group 
)

Sets the margin group of the specified margin sides.

Margin groups allow synchronizing specified margins across layout elements, see the documentation of QCPMarginGroup.

To unset the margin group of sides, set group to nullptr.

Note that margin groups only work for margin sides that are set to automatic (setAutoMargins).

See also
QCP::MarginSide

§ update()

void QCPLayoutElement::update ( UpdatePhase  phase)
virtual

Updates the layout element and sub-elements. This function is automatically called before every replot by the parent layout element. It is called multiple times, once for every UpdatePhase. The phases are run through in the order of the enum values. For details about what happens at the different phases, see the documentation of UpdatePhase.

Layout elements that have child elements should call the update method of their child elements, and pass the current phase unchanged.

The default implementation executes the automatic margin mechanism in the upMargins phase. Subclasses should make sure to call the base class implementation.

Reimplemented in QCPLayout, QCPPolarAxisAngular, QCPAxisRect, and QCPColorScale.

§ minimumOuterSizeHint()

QSize QCPLayoutElement::minimumOuterSizeHint ( ) const
virtual

Returns the suggested minimum size this layout element (the outerRect) may be compressed to, if no manual minimum size is set.

if a minimum size (setMinimumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMinimumOuterSize) to determine the minimum allowed size of this layout element.

A manual minimum size is considered set if it is non-zero.

The default implementation simply returns the sum of the horizontal margins for the width and the sum of the vertical margins for the height. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented in QCPLayoutGrid, QCPPlottableLegendItem, QCPTextElement, and QCPPolarLegendItem.

§ maximumOuterSizeHint()

QSize QCPLayoutElement::maximumOuterSizeHint ( ) const
virtual

Returns the suggested maximum size this layout element (the outerRect) may be expanded to, if no manual maximum size is set.

if a maximum size (setMaximumSize) was not set manually, parent layouts use the returned size (usually indirectly through QCPLayout::getFinalMaximumOuterSize) to determine the maximum allowed size of this layout element.

A manual maximum size is considered set if it is smaller than Qt's QWIDGETSIZE_MAX.

The default implementation simply returns QWIDGETSIZE_MAX for both width and height, implying no suggested maximum size. Reimplementations may use their detailed knowledge about the layout element's content to provide size hints.

Reimplemented in QCPLayoutGrid, and QCPTextElement.

§ elements()

QList< QCPLayoutElement * > QCPLayoutElement::elements ( bool  recursive) const
virtual

Returns a list of all child elements in this layout element. If recursive is true, all sub-child elements are included in the list, too.

Warning
There may be nullptr entries in the returned list. For example, QCPLayoutGrid may have empty cells which yield nullptr at the respective index.

Reimplemented in QCPLayoutGrid, QCPLayout, QCPPolarAxisAngular, and QCPAxisRect.

§ selectTest()

double QCPLayoutElement::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Layout elements are sensitive to events inside their outer rect. If pos is within the outer rect, this method returns a value corresponding to 0.99 times the parent plot's selection tolerance. However, layout elements are not selectable by default. So if onlySelectable is true, -1.0 is returned.

See QCPLayerable::selectTest for a general explanation of this virtual method.

QCPLayoutElement subclasses may reimplement this method to provide more specific selection test behaviour.

Reimplemented from QCPLayerable.

Reimplemented in QCPLayoutInset, QCPLegend, QCPPolarAxisAngular, QCPTextElement, and QCPAbstractLegendItem.

§ calculateAutoMargin()

int QCPLayoutElement::calculateAutoMargin ( QCP::MarginSide  side)
protectedvirtual

Returns the margin size for this side. It is used if automatic margins is enabled for this side (see setAutoMargins). If a minimum margin was set with setMinimumMargins, the returned value will not be smaller than the specified minimum margin.

The default implementation just returns the respective manual margin (setMargins) or the minimum margin, whichever is larger.

Reimplemented in QCPAxisRect.

§ layoutChanged()

void QCPLayoutElement::layoutChanged ( )
protectedvirtual

This virtual method is called when this layout element was moved to a different QCPLayout, or when this layout element has changed its logical position (e.g. row and/or column) within the same QCPLayout. Subclasses may use this to react accordingly.

Since this method is called after the completion of the move, you can access the new parent layout via layout().

The default implementation does nothing.

Reimplemented in QCPAxisRect.

§ applyDefaultAntialiasingHint()

virtual void QCPLayoutElement::applyDefaultAntialiasingHint ( QCPPainter *  painter) const
inlineprotectedvirtual

This function applies the default antialiasing setting to the specified painter, using the function applyAntialiasingHint. It is the antialiasing state the painter is put in, when draw is called on the layerable. If the layerable has multiple entities whose antialiasing setting may be specified individually, this function should set the antialiasing state of the most prominent entity. In this case however, the draw function usually calls the specialized versions of this function before drawing each entity, effectively overriding the setting of the default antialiasing hint.

First example: QCPGraph has multiple entities that have an antialiasing setting: The graph line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw calls the respective specialized applyAntialiasingHint function.

Second example: QCPItemLine consists only of a line so there is only one antialiasing setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the respective layerable subclass.) Consequently it only has the normal QCPItemLine::applyDefaultAntialiasingHint. The QCPItemLine::draw function doesn't need to care about setting any antialiasing states, because the default antialiasing hint is already set on the painter when the draw function is called, and that's the state it wants to draw the line with.

Implements QCPLayerable.

Reimplemented in QCPPolarAxisAngular, QCPLegend, QCPAxisRect, QCPColorScale, QCPTextElement, and QCPAbstractLegendItem.

§ draw()

virtual void QCPLayoutElement::draw ( QCPPainter *  painter)
inlineprotectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPLayerable.

Reimplemented in QCPPolarAxisAngular, QCPLegend, QCPAxisRect, QCPPlottableLegendItem, QCPTextElement, QCPAbstractLegendItem, and QCPPolarLegendItem.

§ parentPlotInitialized()

void QCPLayoutElement::parentPlotInitialized ( QCustomPlot *  parentPlot)
protectedvirtual

propagates the parent plot initialization to all child elements, by calling QCPLayerable::initializeParentPlot on them.

Reimplemented from QCPLayerable.

Reimplemented in QCPLegend.

The documentation for this class was generated from the following files:
  • src/layout.h
  • src/layout.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/QCPBars.png0000644000175000017500000000227714030601040022604 0ustar rusconirusconi‰PNG  IHDRÂȉÚü¤gAMA† 1è–_PLTE“““ÿÿÿ00dàà>¡¡ÿÈÊÿtv))ò bKGDÿ-Þ pHYsÃÃÇo¨dÎIDATxÚí]n"1„™HyÏ q67Èæ!È>$œ Ë ®¿ÒÑ«]c7îŸÒî^Ÿ7äx9ŒÞ%†6/ôEì{hŸlTHq. Â1Rš‘í‚ )R„£î”2÷-°öí=dJ1áê=%J6*¤\JWú¤„X»ƒðH6*$)ͼ#Ø ¼iÔFJsï6<¼ ø¾¦Â!بrá¡B°ÑŠBßóôxÈ\·(NikB°ÑŠBמá¡B°ÑŠjRtw¶Þæñ2±•ûút½ßï¾ÇþôÇîë0ñþgèâøêq8RçÒ ­¨Hiý”&—úk½„´‡ÇTÅõØLò)åêñÐ>!íA<¥â×øÒæ$ŸRÞy¶Œù¹¶PJ[$MbÏcÏ aÂC…PJ5Òì§4w6Ñèá0–H#!í!yòþsM¨9¥©™„P‡ö i<ÂHi?Ú'¤=DJµyhŸö)Õæaa“kü®RÚB­SJ·,·©Ç·ÃhrUþ6o‡t•(·ÿl¹Cšóð<¶ýí=¥-Ü×¹T£‡ö i¡ý”–ínþ³?2vH·™ÝLùÒÜ·/«Ž®-ŒåSŠ MpcU¼;G¨ù÷žz%D REJ§æ1…6ê€-H)šÇÚ¨B´ U¤tjSh£Ñ‚T‘Ò©yL¡: D REJ§æ1…6ê€-H)šÇÚ¨B´ U¤tjSh£Ñ‚TöSšûÌ;7)´Ñž×Öš-H5ÿÞÄ&ªè!ïZÍ)í•-HÕâ.è ràa½ç?¦~÷u]íqà tâü”y(.)µOˆ¤Š”NÍc mÔ!ZÊþº´í¼RÚ+!ZPxhŸ-¨F<´OˆT#Ú'D ª‘í¢Õȇö Ñ‚jäÀCû„hA5rà¡}B´ …‡úõ>)tY<“Æ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_21.png0000644000175000017500000000211114030601042024463 0ustar rusconirusconi‰PNG  IHDR›#°XºggAMA† 1è–_0PLTEÿÿÿbb”ÿÿÿ¡¡¡ÒÒÒhhh000SSUèèè##Z*ÎÎà¬¬É ÷å~tRNSªû²ÏbKGDˆH pHYsHHFÉk>2IDATXÃ혽nAÇ#¤<u `°/k! BŠBga°¨À$²i N©Ò)åú|ž¤°„+ Qåƒgð#\Å#¸Bâ(˜ÙÙر}gr†`Ýëóÿvgþ¿»Ù•å%X¤X_ú×2œ çÿ Æ)ï¤n|!'Õ"±Q/ÍœõjÓêÝQugh½èMUšÆY‰¢A<Ž·µé:áçª*v¡õøÞ8ÎÈåñôCz)z“bŽré"4óµ"3¹z4eT¨õÐBWcEøŽ%ÕÕ ]D¾¹ç¶oõ£DœÖS%rp mú^Æ ÅC®®•Éé‡äÒ³¢ÍŒ!y‚Œcö +.ÍCŒÁ)AÆ9Ó…æ[Èô@óPëq³å÷ÞCëX+È‹µ“ªÚ¸Mßl–¬íûQ”ŒÐzªüvºµ xÎ)iÈï™fãœ{T—¬ˆxžy“4)ˆÔ¦¢‡ ” 3phïÀCÿ"fÍC`öŽ*Uà ŽcÌCÒøf`mÿ44чëãqc‡Lå^µ¨-ç¡dp8gO+šÌ{±5=Q¨"mq“aV³ñ7)j†p³ˆÈÙ©{¾ZÛÛw¢„˜l6ó”F8 L³YÑdV»§‡½œZ…f„mÉ0ë( G¼õHç·Ë`z§mi6Æ)nv¬Èï qB;MnÊÛyÍj¶áQ@×Ͼø°ó€.iàfH³1ÎѾ%³ÚòɃä·# ïoÀÓ8æ æs”|9ؼ–«‡|„PAðå(`š`EÞ™´ª¥WQnZÛkŸfà˜ƒš*1Ž‡Oh;»|¸9¤4r€2µˆ’¹€>y‚¼wD!ºÐ¦y«1GÀê\>Øöd¿—B•Ø˜ÛœÃ~2Îüb~¿ÙŠ+½EÂù}=ÃÉp2œ+ƒƒiFNªEâCpŽ_¦ƒxœµT‹ÄÆ‹…üt"ùʱ¾tw‘âõ/™kŠ±W×%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayoutElement__inherit__graph.png0000644000175000017500000001511714030601041030731 0ustar rusconirusconi‰PNG  IHDRMoô0ÊgAMA† 1è–_0PLTEêêñÿÿÿhhh000PP[ŸŸµ………èèëÑÑÔ××æbb“6*##Y’mtRNS»U²bbKGDÿ-Þ pHYsHHFÉk>9IDATxÚí_lG~Ç#œ×шZS¤X¸Œ£ƒ}@Ñ0–ŒÀ(¨ 1ò¢¡8Šâ É)…ФðŸè%Áµv çÂByiÃÔ®w*Bpƒ¤6ÉP8çÓ‹}m%«y¨ÛÞ…Ôå! z®êçÃ],ªóÒr¹Kή–;³â| ˆûgvwv>žÙßþvæ7÷­¨÷Ù9Бæ iNÑæ iNêÛ°†ƒÉ—æÔ¨ØXÀœP0ùÒœË|¡`N£95JsŠ†4§hHsŠ†œ9Öh[wKǤ9uDœÓ.4Ž‹Mè €Ð4-ƒc€œ‡@ûVÍ©#✆^/¤ûrodŒÄ€ æ¤š8§èƒFšüy¸ðw Â(ò¨Çsè,&’™;òüäQºeDˆ­=„ÒôLšSGÄ9=¡19ÕëÓðVŸ O¼IjNì…!¼’Ÿü›0öx–Ô'¶†×é™4§ŽÈΩþ|z ¯cN}¸JÑE„'ƒ¯âŸ'1¢ù '¶ö$iA×q ÚïvÐå:MíqNƾólñ(Ýg”]-‘TœØZwr Úï–cw?ßt +ݺ8§ás£ÿ{= òxìì‹œÃ{ ùÁ\bGH»×Ã׺”S&ØóQN³•I—ëlØå€sÂvD?êG»°©À툴AL†³#r„ µ#ú_Óœ‚áô¾iÞv½Nv^ôT`«½šÓ–„9-™œ¾ß©Å“5Ï×1Ðt«ÝšÓ–”K7§ÄÛ//^__/Wðj¹ìSiNðG@[9${¶F0™+keü·Z^Y?¶xãëEí‡Ýªün…tÜL `cÙ¾õ“qº³øÓßm¾NpêNNV¿ÛHf œžfœ>v¹NpêNN¿[bôIb"÷¡qÁqêy›Cxâ|#62ñÁe©álàíl-Ë^œ@.NÌóS—ë§îädñ»õePWÛYòV9V"ž·á"«O˜¯øàŽP©Olí/7ŒërMs \Í~·XzñÙôçÉcê)æyãíq¾ÍHŠÜåùZ‘w Õê¥Ê§M×AA+˜û'‹ßíB%ŒÜ;FáPÏçDœo˜ÓQö͈sâkVN 9ÝT¬½ÁÜÄ8Yün‡AìOòç2±ž%œ^Ï’v,çñµQqÍaN£õµNÑQÄ8Yün`b;b¶²Øx ž·K/"b2¤™‘&\ˆ·ó5Í©£òìwÆ{+iN‘g; ¿·’æÔuä»F„¤9ECšS4Ô­œÆçeß‘7u%§‹×ך¿äª­îãD aMʾ#oŠ §Àüm샆¹ ûŽ¼)*œünkæ-ßþ¶oT§’ì;òxÿádQ¼¶ú¯[9œúiIö}xRô8=P¹;¿¥¤¨j¥ºr£(û^Ä9NËÕÿÙê)f1§ÕÄ©“Õ¼ìûTÄ8%×Vÿyëg¹fš_âŸÁSkfu=µ*ZœR•OJAœçŒù[H.bTw~"û¾Ú+Rœ0¦€Î´ô«ÍÀïSÕ»ÿ"ûÞÚ(JœÞ7·ühÚPuåâòšY¾ûÙ÷×Jât­úç;ù;Ës嘺¨¢Ãé‡Õ,ˆVº|’ *ɾOgE†ÓµêBç/r?A¥¤­NÊ®M\ÔVWð 8"œR!a"" ÄØÒ€Bï±LE‚SªòB˜—‹}+Nu…¥Š§ÞÚïB½^@»êZΊ œµ ^o¥9ùÒÒ—!_Psò£«ó!_Qsò¡·ªÓa_Òt=¦s¡÷¨”çoŽÅÑq9á#› KjH7*Õ9%B6õ¨œƒð‘M%ÐœìZ ÙÔ£rÂ׋Ž’a‰90ŽB ½G¥8§k«E WuÂ{ü0©O0V 5ô•ÚœRåi—u ÂG¶±aÀ¡†Þ£RšS¢ö•ë¾¹ºÚ\‚ðQûΓA¦a†Þ£RšÓ駡ºÚœƒðÅŽàv ¦œÂ ½G¥2§·Z=œ¼‚·ÔÎAø¨A†Cjè=*…9ÅË -ö†À©ý`àPBïQ)ÌéæÏ‚+ŸœÚ(œÐ{TêrºöyËÝ*p ô¢­¥,§rO€… 9uJµß š}øyßoè˜[6¥šàÉŒ†Ô‚Òœ„u¥Ý7'V}ßË¡}_£þ‚±ÆF”Í©£j×êÕ ¿†ѱë0Ïï({ fIŸ'Ñ÷’#ÇëÒœ:£¿m—‚sš’0a¤>í‰MÆöBL$©‡›á;¢ëSGÕ¶Õkâ„ŸOôe’¨d€ì!ü|:Ê‚ðùä¤Tè=*%9µoõšÛ=Dèh/ Õß;•1’9„ϧ€‚ðzeIENíl="»ú3`øüƒOàáÜø]*Ñ |À豤Ž°TätM¤‘Í.‡À8 ÀaoJ`Wf¥“öû±#”‚œz…>:ÕK¾ÿ)‘sjNÁëæW"©:éPPêqÚý¹P2ÍI®+ Bé4'¹Úùbé4'©¨–ÄjNRuâ¶`BÍI¦Þš¡9ITR¼¿Þ4W›©Åi翉¦L,™+’\mR¤§xy^0ååÊ–bðEOJqºy[,]üxõnQvfÕJœv Ë••iÙy [ qJÔD’Í®U¿-;«áK!N‰x"Ëæ­Ù9• u8%>₵ªê‘ò:#u8þYÛ$¸2m1†od¥ §Tû‘ƒñn­L@!Nímò3‡¤Tá´«Ý×Án®L@Nílò«]øÎd•"œÚùÉ—ÍßÈ΢\©Á)±6Ýjw<èò‘–œ®´ô“_íf‚K NÉr©ÅÞ®oóˆ”à´óçîû’Ç»¾Í#RS¼\tÝ7«Û<*8ýµ{·ÿ3ºÍcR€“»Ç(±Tí®¯¶îR€“«Ç¨·¶:-;sªH>§”›Çh¶Òm×[H>§ ÎÛp¡èK:§]Î#ühÒæ¸EÒ99W§ÞµV¦>_Ó(”|§[’lNÎ}ŒRµOŠ-Šùᔓ{§[“lNŽß3þ¡Òú­É_|ÍÉ¿«Ó™vÜiNaË¡:a b¡ÍQšSÈr¨Nøå¶Ôî0Í)d5W§T¥¥ÁäÎÉh±Esò«Ý_Ø·ü°"âwu˜ÿ‚Äú›T¾†êT4§­«6mÛÐÖ‚`r˜ÿ‚ÄΛTòï~—/iN[–½: û æ¿ vhaäÏÅ«s$„Î:Ë“GX29ÙªÓàÒê‚Øó_è9Ãd úç ˜> †‹Tøtš“ýý¤½:Åk·J‚;ÌA8‘ièŸy|(O6 !¼!H“kN>tsÔÎZ7Äk†—ÃüÂ'²óá”û;¼r”僓·I<êJ û°§ÙAdqª˜ë ïNW… =.‡ù/ˆ1|Ž´{äxôYÒîMœÃœö¿Ç’ûàäm®‘ŒÐ¹‘ø‘4N)Óä^‡8ýñö±Éaþ b—oØdëÃàSyH숴oN~îMð-ÜCv†¤qú}Ó4ÿ‹.½òK@ìqOý „ç¿ð[0uu=§W0§ê< ës¼~ ÍoÔõœj&¯P7MóǽvWÑœBRÒäœðsÊôÚ«èG‹ÿ'Vþ ¦.œ˜ï#HN°ž 9œvLdx;®Næ­yñ/.®WÌjØœ,“x49z!@ÔPœf×ÚÜËŽÕG ›Áz6äpú1Ç´‹ð öÎų|çÆ»a·{ÖI<8¾ù=ž §eÓ,‰d§aŽÞæD°ž 9œN0Lì1UmÞÿRѶáÅ:£’ð,ßœ¬“x(W‰Qú`’=ƤsßñܥȕD²Ó0G/ñIž%§Á?F–ΫWφN“ÎI›?Óœ¶ï>Ó°‰2ªÞ¹ñ{[Âæd™ÄƒV™‚‘Þ•¡ÞD.ñwC—åî ½­’HvæètR|üc¡óóÖ³!…SŠabÕÉ4oÛvãÛ\à‹œÑâ_6$ð7ÿÅÖ9±çSBÐè¡*ƉÎäAçf¥¹«²Û:¶ØR6NìùD'ùþ©ÌÊɇË­/œØ©¾eòªÏl'^2§92"ò7ÿÅ>ßœ6'ñ 3çî;r{˜#‘4Vx©f›œL!ÙÛ=zú£lš^òš8ùðb¹ýßôeò3§ÿô“ùÊhÝQ¨jšÄƒrz= OPGâ¾,Cß|ƒr"sèRN\o÷lsôÒIA²ä‡p>×ÈÉû ¸ršÙ¢rKì[uåØ_Èe´ÉÉ2‰™9—L¡kdˆ#±/eÉTâg §M;¢÷¸0'«·vs(Íìˆ4ád³#Tâô4ÃÔ>ÖQ˜œš'ñøÛ÷ƒˆ•s¦"ÈÉÁG¹1gŸ5ªqz†qú4ø2÷#·’1Æ[D­ÑÙš(§&a‹¢9ªq¿N÷_YÚþµÿ^b¹è¯³!̉?èÚ\D”SÁõù§ÖLó ‘,u^jùa¼XŽœË7‘•v=6óÊÏ ô|‘ ¼u¢™ÓDÖåã‚“ltZ*rjéÅrâ„›àÿn:#-ì×Æ¿‘ŸÉÚ33ñЄ§ §úd夌¦üÔaNÎ^,âiš‚¤\vÀäÈDý"‰eüqáTxl&;“'…ÿ*å„òS3¯æ†ÐÞÂL¡€&(§!\ÕFò#y¾€7«Æéòrå3?Çuš“£‹xšÒ~pƯr/ð– G=®œöÎ Íä'^Ÿ¦ ½öèؼR¨·{Ãx×#ÙG²|Aµútñúš¹rLÉúäèÅb³Ð1·®W|¢ŠgÙ+÷—v§Õ¯9±çÓkýÕDáùÜ«œ­OÖ^ü/(Åéâ2Ôãy.1NÞfqj÷¬^,êi¢ýà(§¿È3.N«Ïlí} Íä³3”ÓPSŽü)l.(é—Ô¤»ß¡Ëoúr$ö]çUO³ƒ8ÙV/õ4Ñ~pGH»wpŽ]dœzFZÛÏí©szndfj|†´{‡F0ºuÿƒ2N|!§§äâšY½«€ÇÊ.»Z½XÔÓDûÁ1;‚—cÜ[qç´a—"½†Ff Ø`ØK–F&èóizŒqâ #òíˆÁSk•ê5£ÐZßs=x±r¤£±;§™ïælf÷žçÅ^€¥qJœZÇ~"ëòíÔÊÑ‹EŠ[殜šüy1LœÓàtÈÅpÿÉŠ¹rc>ä«zЖü{WoÛ·oý»>I|¹ªß¿(aH¥0/éYªùasàò~ðý"´¸¸\Æ6x)´ëù”jœž]s6$;£%å¥'þböq·~Øà’¿ì gV1NÜÑq«‹dʪ/J.RS.EA•Msån°¬R•b}1¡ð‹’‹(§àúÂy;•étb j2Qï¥\ èFãÞy“½(Ý(Ê.yo"œ|x±Üú‰ê«Ï‘Ÿ?bÏ¢òÿ6ž˜€Z %úÎõµ¬Ä£ð$áxØI•QjÁ)tÅÍê4ù½É@MÚv§*›ý–[°—ƒä3Ìí«äEi±"(YýË)¨8ã4oߪ”¬«„•ÙÌJ¼—y.q‚=ôê~ðèI'\‘èà´Ó¤øV›÷Ç›¶ Þ×ÄÊ'ÖyóˈØàN’É £& z+^|ƒ§X‰sâ7élæKr8¥h=êà iŽ¼Œu<µ\g%Ή¿<+ÒÙÌ—äpJÔÿ'q…Z ¶©ä©“äýJ|ôç86Å= \TQ’Æ»Ÿ¨Ûy™Uo±X¸Þ8u²’¡K­F¸òþm9R×+«^. ˜$qúqý¿÷`åK:ys8Dჶ$›œÈ¥"lFÈâ´Û¬üèc@c…Í{>‡C>Hº ì…àü=è(^¼{”üÎ1[–$N½ØŒ¸M—óäo²F¬ orˆÂéj˜#½ ´Ö§Äß(2XÇ_IŠV3o4<.ÂA7ä…Ò{0J{±5pº¿¦í=zå ðÊmë°å69Dწ«áƒÊ)±Éé*ùüøK¯™ô1p™*|yÉâ´{Ämö—`ß 9Dჴ«ášŽ9 rç ÑC“ðÞ†žßs}…ßÀçI2ãÃ6V(2­Æ]/‡;DáCNå!½ØŽÊÃ~fGÔßsßõ˜A_Ãjü†·h-™œìJ,È|sqØG¸&¶¥|z£_uµ¼¾~lñÅ÷Ä® 91Ù+¶Ï=˜}®Å&mr³ô#ñ/^^¼¾¾^®0^wŽ-¾ü­¯ 915U(±±=ùËiçÝÎ1‰·€á vãëŽÇiN\M €eá¤^8áÿ˜¾ÿö©Å“ëkeúq ×°ÅÅašWÜÁåö¾hH_OœH8žÝö'þé¾Åë'×ËeZÁVh›‚á÷`Ú·Œ‰KòüO¯8LE-ê–õÈ <°Ð6!æU¯`„ׯéÆ6á÷`Ú·Œ‰K2§øJ±ycªöɼÀ±^9y‚ý;]i~’Hyø½ 92a°™¶!'pÚin÷¤5ÑAN\Bá÷h¤¼‰d†Œ]†3&.Ùœâå¢Óf‘€æâQøâä~FÊË"cû¶1'°ó玛ÛMù ¼DáóyJ(üÅÕ;•!c—!=`[rê-Ï;nŸ{HuTBá÷(§‡èØåQzÀ¶ä®¸|êõ~>p …ߣœ¦PšŒ]ÎB’~{rJºT(¦x÷~o»rr­PÄšø¶Ôœù ¿·m9 –§Ýv]õä@\ÚoÔ ·Ü?ˆã‡Ô‚¼ŒiN J8̾±o¹êe¯`¥95jw«žª—+Ò tÍɦ -vƽN<˜4'›RŸ·Ú‹ t=Ð’æd×ÍÛ-wŸ©Ü-JÈ•¿ð{¢øOR„“ãC«—ªÞul#©Â)îæ=ÚÐ劌*¥ŠTá®´ Y_«F*4G R†S¢qºwG©|R’OIR†Së—].\¥äzf¥INàÄmDËfwV)…8µ³Í™fת&;§¤'ç¾GÍz©²"ùû¡©Ä©·\J—\2¥¸'dJ%N¶9×ÕZ·™èJqJÔ¦ES.›·DÓn )Å©m~Ø:¸Ò4}ŽžíÄðÙŽK-NàfKSù%Óñá³—bœâ-M‰`âutâóPÇ¥§Ö¦„椌ZõiÑœR+¯„æ¤N»‡!råÛÔš@s DI÷©ëÑdHÙy‚Bzcm *´,kNÁè-×—(Vô ÷.@² ò“;6f=Z–5§€T›tÙ‘ã-÷°—†ÚC90Ž£Oö§û2 ‚9¿£HÎîÈóa4=^s H©Õ’óÆ©!àÞÈBí+õe€G gçÀžØ$8;üçDÐã5§ ´ó?·Û8±ç áÖ‡ÞKï—píêϧÁ#}2p¶>Œ–% Òœ‚R¢vÛq»½ÝcCféľûÈPÙK•vŒâ…{Ç’%€êÃhY*Í)0¹´|6;PN$Ô$ƒf!8ŒWrCEë)ôgÀ0á4|’a´<•æœN;ºlv9 œ¨AÍB0Æ&û3x-gœ Ûd-O@¥9§AG›¯þJd¸×JÌp·Js P©j©y£¿‘Á^„­Òœ‚ÔN‡·]íßSO ‡–OsRP©f?Ÿæ¤¢®4µ|š“’ºiÿ¡9)©ÞÊBãÍIM½µ:ß°îs¸lÃg;.¥9ÓóB½ês¼lç‡Ïv\jsJœøì,("µ9¸ýÕ­Rœ~D•dgA ©Î œŽò,ÁIyNà¦è`›m-õ9%k_É΂RŸH•dgA¾"À \¨NË΂tEx@}‘àN^”ÉŠ§ÄM?‹o'Eƒ¬u9¨ˆpÂÖywƒŠ §nN ÞÕ ¢Ã‰€*Ê΃4EˆH÷0 ò6S”8AùSBÉR¤8°$< ò6SÄ8{+wegAŠ¢Æ ÌVn•dçA‚"Ç ôvexìèqêÎðØäÔ·ÄüÌWD·ƒ²³î_äóy/˜~ÏREN¿GjNaJsŠ†4§hHsŠ†Úr2ÜvhNaŠs²„á3b¡ÀH\0›9Aö£9…)ÎɆo#¾¤šá»5§0Å9YÃð˜™èO÷ É–9tÖÈæ²9¾` ȉ¬¢ËɆÀØ C4ôk÷¼ #CG†ø‚®O2dç„žÀœð#Š†ÞcíU$á÷Ø‚æ$CMí œJÐÐ{l9Jþ› ðC"«èr²†áÃíÞÁ¹Dn¨8Ê8í/Ã8ñ…Qv¤æ¦ìv9YÁvD.6ÙŸÉBú|šCiƉ/d!=Ds Sï¹^ÂðQiNaJû¢!Í)Òœ¢!Í)Òœ¢!Í)Òœ¢¡˜ïÀ{šS¨YöxoŸì¬oᦣǩ+¥9ECšS4¤9EC½÷W«³úƒÿÈ¿Í6)ŒA%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssPlusCircle.png0000644000175000017500000000047214030601041023760 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+lIDAT(ϵ‘1À EÞÄsÕ±ž‘Õ›x Y»´FI£éPðBø K ð8}AºGÃ0”Ø«C»’ !S;Ò%!7 dÔöðZ£Ñ†xÎKn&@á˜Ä/3RÉ+Û;<žç\~x–³ õ~#ðþÕ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_s.html0000644000175000017500000017573114030601037025112 0ustar rusconirusconi Data Fields - Functions
 

- s -

qcustomplot-2.1.0+dfsg1/documentation/html/axisticker-text.png0000644000175000017500000000262714030601041024501 0ustar rusconirusconi‰PNG  IHDRX2*ŸmBgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÃÃÇo¨dÉIDATxÚíÛ/oÜHÆñçŽì«ˆN*X2¬÷ ÊÌBS•,±Ž„V ±BBNW¶,Òñ”-1 8éÔWav`Æf<öÚk;÷¾Ÿ‚¦þ÷ûùñxÖqR X¡âÜ ¼‹Îß=¼—ÞƒSøõÜçC1aX &,«Á„`5~i|Í BïÓæÜ €ËeÎÝÂDÅ„3Xòì§ôuKf1üØkK ƒä*T¨0’‰ëûëg û¸ÄÕÏ%MâÉ€%§¦r¼¯¥ò)û÷K9Ó»É;ÇÃðc¯}ÂÊ«s5«?—•UænÚã[.Qßô Ñåj§*”J2nhÌ;,¦ôì§r¼¯¥žiòŦÂ>FùÑÑxÜÚoòL{÷U:C?r¨Jê=o÷k”UO"vY¹E®Ä-·$ø¼ÖOµ÷ŽVVN¥Vm»4©>ýM°fhEp;®Ò>83ÿع2å*”U«:û}µÝóØDÚ©Ä’-»hÖ2úóŽ{†Ö^iP¿|RÝ+SªéSE¦´1Uú•ì±ã×ÀO(¼"kcªÄs÷±Ú…~âñjÏz½ DÕOX™‹É¨~Þ*£jni—•³~8@üý‡Ö7î¨EPÅT4¶T*oépÍ.êQjNUݽØÛÃSU!£ÄÕóó›H,•ö9•Õm¯v{¿þº',¿~ý2Ç„•ËT×µ]©û„ ™yKöŒë{À…ÍÄc#Ôî¿î¢¡ÄÞa%Õ“EsKã-«oÔæ¿›û©ï¿­©«Ø‰4¬]O¯EÇšã]$‘ «œ¼›·]xìBá^ÞHÆ{f‹%:öª´ßa%òß·enÀ—Ƽß•}ìÓûÞK'SÚH(ŸaÂJªËî«¿í„æOä-ÙI; îÅLYx×µ×fDëøÏϵÑFúæBÊ•ëN’tÙúBÛÞ×°ÍýÇÔÿ#¨RzÕo=K¿éF‡Èš!]üèY·=ÚKÌAWº«ÌOO$žJ×qê^ãõ§¹ÒF%:ôdU'ôÏ ¿¸¶mÇöÈží„–Häí¼è“¤¾*…~âÝ#t;.uLXÖƒ¶2J´Ó¥.õURü–þ¡WmÜŸö ö÷?]]y«;—¦’"k†uqаŸ9Å{‰ÛëRWº÷žˆæIdØqÚõ§j=Û|ÐTFŸÜd}£Ý ÍŸÈÛ9èU©¶Ú+…~âý#tDkš°RI‡j®þâÛ6ÞaÙ™üà¶WìﺲŠÑNµjÛ¥F÷ºŽn?´‹=¹)«ïb¶{ébÜkÞ×Fs%rì8‘ús³oTÚÏ9m;×õ»žÝ¡ý–ÐÒ‰,íQ÷z–ŽB?ñ¾:*uLXßU¨ÐNW²Ï+…rýíÖ}ÔN…¾ËHzÔ“ ]k§B…n#Ç ÷?ݵ«l¿åókÛ¥Ÿ«ÞM°ýÐ.t£»Îséêåx–ž_fJ¤ÿœl­ ¯þÜ®ô¤\·î ×Ý©Ðí ÃNV_?ëóä„–Ldy/R•‡? ýÄûFèºtžßÛú?#q`4û­[²ú_Ö\N–¹Ÿ¯ó§qkDâœË´;‘¼»ÿ…%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPItemText.png0000644000175000017500000001232614030601041023455 0ustar rusconirusconi‰PNG  IHDR,ª =‚6gAMA† 1è–_ÀPLTEÿÿÿ¢¤ñeUë&(äòôøÿ ö¨æýøúúÚðØŸçå‚«êÈò³e¢‘²ã¤Wg¦\’ Ο\îÐùÿúÕÿp×ÿ³RÍ|á} ›‘äv˜ÓŒl×~- ú’éÿ*žw¯RZ£fb"ò .ÿôµÿI­þ.!–¦¬™æy›1ÿÐfÿ  RceiVkÕÿ5X;ŸÔQ /žÆ;—Ønˆk — $W$0 kŠ;äÿ:¦­TüpûTbKGDˆH pHYsÃÃÇo¨d=IDATxÚí] w¢Juƒ(DGIòafC™€q”¨IfòÿÿÕ×ÕÍb¤‰¼è ÷¼s^FŒ\ªnW×ÒT*%J”(Q¢D‰%J”(Q¢D‰%Jü¨Ö*µz㻿Åi ªÔ*UµöÝ_ãDpöÝ_àtP­’ÿ«%gûØlU*JéˆûQC–ÕÒôsµZj|&´5Mëèšþ£Ýj~÷w9nTÕê¹Þíhçív뻿Ò£V×{'  Ÿ·[¥S¦£¥¥¡tÊT´µ8/‹á²˜S–2Æp®íGé”Í \•NIÑÊLV[쓬]2öoÆ?äÉúdìâ2úç+å¦ïzM5ûÝkò£5°ëæþŸEƾû² ÁÕè&…¬¹j{4žÜšc`Ç6ÆöÈ0‡ðÃ?ë”wŠr߸PõæA©Ê#!«…lJµ†uÅtLÕtœéí…9Ðg3D–~g¹ÿªS^)7•ÄÏÏûÄÔ“r‰ÉjÏ̾>òÓ÷¹0€" KC´IÉØ_[YOjVE?!¦0Yçªj>"Ë››S‘e:Ï”¬™y-¯û‰€¿Y«U꣫ï¾üC¥_Xƒ²*óiT_s²±q~²’2VS«•j½úÝ—/KÖ/Á /ˆ¶´™±t|ŽÄÈÒ´•åøNŸ¸áþå0»SžØp ¼ª`Gèé5Ø;D–~§;³À÷Ÿ‰À÷à¢ÝÉí0³Ð'kS›ºRNTÍD øýÖ³èC†ïÈ®ÍõµõÂêïLÇ9 3:Ä)•sIJPHºATôÅË›8 ZšÞíi[Ççpžs9%MYÛꉮ”!YM]s_‘bEhX¿QSsĨ¦Sb^ØÞ¤aÛ»dìÄÐB‚þõBÄ{eÚ“ûþç4³i©­fùO7àG’µ"N—bY+dOwPTä2,숖eG^‚€ÿäûô=.YÌÖÀ?L»Ãœ85§Dú¾MõBl LîÙ-,lb§“L„”r’,úJb•Ä(‚½Ó±µ£'à~ÁuÊ*IˆtòÉü^½SBJ9±Ò’«$`“wMÌÈØ;åfHâõCÀ0æÊ|˜3¸™.‹àíXR‡/·nwV4 Ú¦IDŒÁq‘½NscGç” ~Ñá²\á€!•¬'|Â0BÜäýýÖ ?´M[òà¨d¬òãx£ìnacó¬í"k‹µŸÿŒÃÔ Ù yÌ'ѯ ®»ÉL˜^³fuUµ²B„¿u,NÉJ†«W²SöÈe+KÕ,Ðw7ü9 îÊwÚðÖm(ç$5…mŒgÝ­Ž3BDÆŽÀÄx—ƒK­ƒ\rhoqIeŠþ *6½¼O}¼.¼à_4¯+†•³?3ê!‡dôõÑX¦"à›R¾Êgçah¸ÁJÐwªõH¹,çÈ¢ÑÑœŽ3w¦]£ƒh™cýÒÓ”"H’ÉBÛ[íª±.‡xºõÛˆ¾“Ÿ,ÊßzÀþ.Õ‘4ÍÌŽ1ÄÑ¼ë ¬,wnŸ3•±ªR­(j%‘f3Q¸©Y%#6°B²-ÉoÁ§¼~ü33sê1²úY¶ŠûY„1Á)kП^+ÎEa¥®FZIq®O¼n¼Jz"] AßÔñ§ ÄŸ±1EÈ çsÓwÌù˜vŒpVÿk…‘îFayëºçÝh’ GNœ ÆÙt:S[cïót*<É$sµø¹X¦1ÇïÏÌá¢(è R9ôs•8eU)Ì´pÊÁîFÿaºÓl¯’ÏÔj˜nú '4. œkÄÜ#KÇXQŽfÆabVÆ–bkz«@²T3Çs[“åR؃Cð²du·kz¼é^‰ëþÀ[E¡¦²ÊüB°`‹xqpµhRh'Î æ*Ó`E&LÊx]ñ….“ˆemÈ5 [€Mm°mÖ*EðÑ89?Š&Kß÷ rÁ%Á¬ý¢fQC^RÿüUÑå(Y;s×´ æJr°"3è .p“ˆ÷ÃL´°] \Ží¬VÇ ï’¬ ¥ŒºÕŠ÷’À:@‹ \ÑO­Þ¬àºfõÓwJ%¹ýºªV£GôŸ· ß±JQè¡è3¦jÞÜ4æcRY8ÖÜý™ySù‰,H½|PFÐX £$HÅ~+—ø¢+?ïåE“Õ=¶i± êSèæŒzòõ)y«] ot\¿/—K!ÉÐ?‡ì«éùfðÇ¿Ì‘SZÁmÍÌŒèX¿S.ùä¾N èIQ>ðZ.².À‰õ«\\ŸB7ÇÎ]Ÿ’#ËKè”FWë”ÚU6¦Áí½°ÖoA`í7÷¤YT‘n`â Ⱥ{bd}gü 6&Müº»äÄçIJ€"½f¨½ÁêSé°­Žfĺ#5—¥t„j-[ðVÉ] óP¼K"d ¶A@l Y– ëí$«I ,'YO0'diŒ¬žf«VÝè¤ä"Â2l­cìÈíÐ÷x;4óPÎÓ"ÈÊtæêX¯!Ë2û“zàýQo~+ [!Y¿àrŸî¿/±e=©ùÈ­9ú’…$Þ;4YzÇPÑ=صêN˜.‰úÏRc#¡E#ðCU©ï K°ÕñLůr²ð( \îØŠî>¤¹"nøXi\ dÕpŸu°ú5,Û@ßÔèû>¸ô=.YTÙâÉžÀ , I“*Î8"»òdÀ+@Ô1‡:˜ýÃÖ§4M±U¨{¥dùcpߧ8 KÛnR6ˆˆÀ9"+¬"AÊ¡Ú¬Ü%⃇œ>~m;Ä#[}j½û¯2¡—Õ²¸Å¼íÔ÷x²È ·™($mŒ`~ëKŒì†r€ú”Fu>¿Ù0ÌͲ5‰‚¿#iʲ‚¡ÂrÍÏdK”DaÝ«a6ðüV2Ù#ðwl)‡ˆl§Ë,N©CœÕûÒ”§’Éžð]ÊAHžZô—l³‘å±È5‘ì #Ø¢³¤Ò)‡X y¨Û ÿ0opŠ&{„öèRÊY8é$´~8Rµãüˆ&{„ÅðèRÊY0© )æ¸ oQá|…Éž°Š¤Ì•üY=!Y°@½FRQÁ0½ ¼Xð*ÒÑé{XJÀ9§ 73z7ÿ=Y¼ŠT¸¾Ë5ž€Eˆ“E }q'!\«åmQ¯"[H’E’™[–‹Šr â³²Ì!q„]qø‰‘¥¼~»ÑCžº»ð3áš8É!=‘òŽOßÉV€«yÏxªÍ /„F6õŽkoi3Ãñ7ú¹&Rv່SÑàEϸ a³M3Ã2çÁ€Ÿ¨ªÑÃmɦÀánd"Å'R.pöì`ÿ¢õ½‘ã;a²„# °¬{ø3cêÏ­kÜõnAÖu92'RÈ‹3&R8ãO’þÖàPÿ#Ôwìy×*Q°’Äø5(Ô›}H´Î¬À஡ma².Â! 2¾Ócd$‰ÝÕôzÁOHÈÓå€ä)¸fý5NÓ±Ž˜™éP²ÖËñgøÁüÙžã¦nJ–9ädiÄ ’ñ7 Û®«2UkTê9º#¬+õAÑg†…ÜÐ÷M¹aÿÑæL-/ü²¬wCN˜®Rd"¥£#}/0t)gËWx)žA²Æ¼Õjfš†9FDfà›HàÇ3¨R™Þ.ðŒ,T@è08@Æ߆{Þ&SNÅଠO¬ÿfÐséÔs;CÔðD9ýnEf5À-Ú´‹ò)]Èî·à”¼‚¸‚›€$«kI“õæû‘~Ï1·38È ólÃÎlÞ”üì®–ËN–Œ6@)ºØêM¡àQ ¶®uÕ\dñÈÆ$x¯"+Þ¨Æûöh7uzÞÈ'ò÷RgM 4ˆÅ¶jƹ¤+®#sM¸+›]8-„FG˜ a£CŽ·;7‘ë(£Û®\þ¼ «j¥ÙjÿÈÔ¸ Ï ;¬q×Y°{%Ò“¢c«W/ÖÄ—ë(ˆ®Ñ¾TŠC¨£Þ `,Oùe+³¨xÕ;iªŽ‘Ãñ|fsšF‚ÈñEZ…ΑW•³¦RTÚ­¶¬S¾„+#'i¯»ZLǼ°MÎôBë\gš H¢ð”²§”×Zí¶„S®SOÈÂÇ[Sç鸎mÙ˜ú–²Gæéÿ åð ‰r2FÁ“|)#ÁÑîÂê:ç'<%ˆt½I; Æ7êûNÈÉØšpÔç ‘L<ÛPÏŸã' ˆGAìæ'?²øì úÿOåë³'€”S®Kb»½å:&NVL–S,mâQû w\NVlöÚJ•3‰Ùអ‰Íž µ‚/Ÿ}œ‚ŽúGU\áçzˆÏù‰~¹ú‹Å'S*ÂÍ!C™nŽ\lñÂ)ÂûôýaMº!V™#Ј¸ï&«9CQndÈÂÏ=!A9£d…DA| ¿#dñÉ”Š8„G9²ÿ{Iëºmt*ÎbòÈt[¦Œ¡|J20ýÜ06{BÝ"ûì‰ Yt2E « æÕ!‹8¥(c†¥Û]rÄÍÊ‹œ~Êu‰=ƒî%3/†”,ýN5TDV|ö„’•}ö$憿"ω’Å&S+Â͹ÂÚžc0ˆ;¥Ð˽åçºE¾Þ—Ó)=Ëè³^œ]@®‹ßsÌž<¨£Pà1éÂócB²ÀÙdÊcE¸9D­ò Æf]bbV© =ãÀ~'ÂQ™ w4}d¹±”áfO²âKƒA5•Ä=<…" õI$%‘öŠ‘ßr8ÀÍ9£)ëzÄëÅÔÙVx„Žâ á/‚^CS±õÚ•ã!“3~÷…áoÔÂ’KŽ 6cÊAÕzóLÕ=[0öÝ)åB‘/ÿG‘R.œ±™ØѤ”‹ÅAdìÈRÊÅâ«NùWè» ¾â”µ¾ïDN§üûõ}'ä •Úß’~R±ÅÉé{¦âàéþòj¤(ÿËP¥Ê*c''Y™Š#ø­_ÍÑGŽªÈV¥Ê c''Y™Š#œwýó˜2'¤íqÊ“K9d*ŽŠž”‘r/S¥ K5±ÓÓ÷Lùþ ©RÁ1sùýJ:eÏкJá}·ßFVÒûè\da…JÛèhíêé‘•¡8RÁ…xçq–ã„´‚ŒµÈ³N™Š#VQT™*ÕN4j5ä”hPOͶ2â…0}Ãè/%ë Uª*ÍÂÖ |fÅ_ÌÒ?’ûû*`¥ª8…òWá²V©ÖOk-,Q¢D‰%J”(qBÈ8 ‚ÓÙágO¹„.ï›c˜âùÏÈúl@äB9ƒcÍ#Kx‚ ~!×dN™Dèã8vrŠÈ< BX±ë 2äi yž sBÈ8óŠDžÈ±ã 2ÍÜO9!dùM<±€'Èœ2ˆü„ °O¹Êÿ™QüÊomdBx%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPGraph.html0000644000175000017500000047063014030601040024166 0ustar rusconirusconi QCPGraph Class Reference
Public Types | Public Functions | Protected Functions
QCPGraph Class Reference

A plottable representing a graph in a plot. More...

Inheritance diagram for QCPGraph:
Inheritance graph

Public Types

enum  LineStyle
 

Public Functions

 QCPGraph (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QSharedPointer< QCPGraphDataContainer > data () const
 
LineStyle lineStyle () const
 
QCPScatterStyle scatterStyle () const
 
int scatterSkip () const
 
QCPGraph * channelFillGraph () const
 
bool adaptiveSampling () const
 
void setData (QSharedPointer< QCPGraphDataContainer > data)
 
void setData (const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void setLineStyle (LineStyle ls)
 
void setScatterStyle (const QCPScatterStyle &style)
 
void setScatterSkip (int skip)
 
void setChannelFillGraph (QCPGraph *targetGraph)
 
void setAdaptiveSampling (bool enabled)
 
void addData (const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false)
 
void addData (double key, double value)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
- Public Functions inherited from QCPAbstractPlottable1D< QCPGraphData >
 QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual QPointF dataPixelPosition (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
virtual void drawFill (QCPPainter *painter, QVector< QPointF > *lines) const
 
virtual void drawScatterPlot (QCPPainter *painter, const QVector< QPointF > &scatters, const QCPScatterStyle &style) const
 
virtual void drawLinePlot (QCPPainter *painter, const QVector< QPointF > &lines) const
 
virtual void drawImpulsePlot (QCPPainter *painter, const QVector< QPointF > &lines) const
 
virtual void getOptimizedLineData (QVector< QCPGraphData > *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const
 
virtual void getOptimizedScatterData (QVector< QCPGraphData > *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const
 
void getVisibleDataBounds (QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const
 
void getLines (QVector< QPointF > *lines, const QCPDataRange &dataRange) const
 
void getScatters (QVector< QPointF > *scatters, const QCPDataRange &dataRange) const
 
QVector< QPointF > dataToLines (const QVector< QCPGraphData > &data) const
 
QVector< QPointF > dataToStepLeftLines (const QVector< QCPGraphData > &data) const
 
QVector< QPointF > dataToStepRightLines (const QVector< QCPGraphData > &data) const
 
QVector< QPointF > dataToStepCenterLines (const QVector< QCPGraphData > &data) const
 
QVector< QPointF > dataToImpulseLines (const QVector< QCPGraphData > &data) const
 
QVector< QCPDataRange > getNonNanSegments (const QVector< QPointF > *lineData, Qt::Orientation keyOrientation) const
 
QVector< QPair< QCPDataRange, QCPDataRange > > getOverlappingSegments (QVector< QCPDataRange > thisSegments, const QVector< QPointF > *thisData, QVector< QCPDataRange > otherSegments, const QVector< QPointF > *otherData) const
 
bool segmentsIntersect (double aLower, double aUpper, double bLower, double bUpper, int &bPrecedence) const
 
QPointF getFillBasePoint (QPointF matchingDataPoint) const
 
const QPolygonF getFillPolygon (const QVector< QPointF > *lineData, QCPDataRange segment) const
 
const QPolygonF getChannelFillPolygon (const QVector< QPointF > *thisData, QCPDataRange thisSegment, const QVector< QPointF > *otherData, QCPDataRange otherSegment) const
 
int findIndexBelowX (const QVector< QPointF > *data, double x) const
 
int findIndexAboveX (const QVector< QPointF > *data, double x) const
 
int findIndexBelowY (const QVector< QPointF > *data, double y) const
 
int findIndexAboveY (const QVector< QPointF > *data, double y) const
 
double pointDistance (const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const
 
- Protected Functions inherited from QCPAbstractPlottable1D< QCPGraphData >
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
void drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A plottable representing a graph in a plot.

QCPGraph.png

Usually you create new graphs by calling QCustomPlot::addGraph. The resulting instance can be accessed via QCustomPlot::graph.

To plot data, assign it with the setData or addData functions. Alternatively, you can also access and modify the data via the data method, which returns a pointer to the internal QCPGraphDataContainer.

Graphs are used to display single-valued data. Single-valued means that there should only be one data point per unique key coordinate. In other words, the graph can't have loops. If you do want to plot non-single-valued curves, rather use the QCPCurve plottable.

Gaps in the graph line can be created by adding data points with NaN as value (qQNaN() or std::numeric_limits<double>::quiet_NaN()) in between the two data points that shall be separated.

Changing the appearance

The appearance of the graph is mainly determined by the line style, scatter style, brush and pen of the graph (setLineStyle, setScatterStyle, setBrush, setPen).

Filling under or between graphs

QCPGraph knows two types of fills: Normal graph fills towards the zero-value-line parallel to the key axis of the graph, and fills between two graphs, called channel fills. To enable a fill, just set a brush with setBrush which is neither Qt::NoBrush nor fully transparent.

By default, a normal fill towards the zero-value-line will be drawn. To set up a channel fill between this graph and another one, call setChannelFillGraph with the other graph as parameter.

See also
QCustomPlot::addGraph, QCustomPlot::graph

Member Enumeration Documentation

§ LineStyle

enum QCPGraph::LineStyle

Defines how the graph's line is represented visually in the plot. The line is drawn with the current pen of the graph (setPen).

See also
setLineStyle
Enumerator
lsNone 

data points are not connected with any lines (e.g. data only represented with symbols according to the scatter style, see setScatterStyle)

lsLine 

data points are connected by a straight line

lsStepLeft 

line is drawn as steps where the step height is the value of the left data point

lsStepRight 

line is drawn as steps where the step height is the value of the right data point

lsStepCenter 

line is drawn as steps where the step is in between two data points

lsImpulse 

each data point is represented by a line parallel to the value axis, which reaches from the data point to the zero-value-line

Constructor & Destructor Documentation

§ QCPGraph()

QCPGraph::QCPGraph ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs a graph which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

The created QCPGraph is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPGraph, so do not delete it manually but use QCustomPlot::removePlottable() instead.

To directly create a graph inside a plot, you can also use the simpler QCustomPlot::addGraph function.

Member Function Documentation

§ data()

QSharedPointer< QCPGraphDataContainer > QCPGraph::data ( ) const
inline

Returns a shared pointer to the internal data storage of type QCPGraphDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular setData or addData methods.

§ setData() [1/2]

void QCPGraph::setData ( QSharedPointer< QCPGraphDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPGraphs may share the same data container safely. Modifying the data in the container will then affect all graphs that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

graph2->setData(graph1->data()); // graph1 and graph2 now share data container

If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the graph's data container directly:

graph2->data()->set(*graph1->data()); // graph2 now has copy of graph1's data in its container
See also
addData

§ setData() [2/2]

void QCPGraph::setData ( const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Replaces the current data with the provided points in keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

See also
addData

§ setLineStyle()

void QCPGraph::setLineStyle ( LineStyle  ls)

Sets how the single data points are connected in the plot. For scatter-only plots, set ls to lsNone and setScatterStyle to the desired scatter style.

See also
setScatterStyle

§ setScatterStyle()

void QCPGraph::setScatterStyle ( const QCPScatterStyle &  style)

Sets the visual appearance of single data points in the plot. If set to QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only-plots with appropriate line style).

See also
QCPScatterStyle, setLineStyle

§ setScatterSkip()

void QCPGraph::setScatterSkip ( int  skip)

If scatters are displayed (scatter style not QCPScatterStyle::ssNone), skip number of scatter points are skipped/not drawn after every drawn scatter point.

This can be used to make the data appear sparser while for example still having a smooth line, and to improve performance for very high density plots.

If skip is set to 0 (default), all scatter points are drawn.

See also
setScatterStyle

§ setChannelFillGraph()

void QCPGraph::setChannelFillGraph ( QCPGraph *  targetGraph)

Sets the target graph for filling the area between this graph and targetGraph with the current brush (setBrush).

When targetGraph is set to 0, a normal graph fill to the zero-value-line will be shown. To disable any filling, set the brush to Qt::NoBrush.

See also
setBrush

§ setAdaptiveSampling()

void QCPGraph::setAdaptiveSampling ( bool  enabled)

Sets whether adaptive sampling shall be used when plotting this graph. QCustomPlot's adaptive sampling technique can drastically improve the replot performance for graphs with a larger number of points (e.g. above 10,000), without notably changing the appearance of the graph.

By default, adaptive sampling is enabled. Even if enabled, QCustomPlot decides whether adaptive sampling shall actually be used on a per-graph basis. So leaving adaptive sampling enabled has no disadvantage in almost all cases.

adaptive-sampling-line.png
A line plot of 500,000 points without and with adaptive sampling

As can be seen, line plots experience no visual degradation from adaptive sampling. Outliers are reproduced reliably, as well as the overall shape of the data set. The replot time reduces dramatically though. This allows QCustomPlot to display large amounts of data in realtime.

adaptive-sampling-scatter.png
A scatter plot of 100,000 points without and with adaptive sampling

Care must be taken when using high-density scatter plots in combination with adaptive sampling. The adaptive sampling algorithm treats scatter plots more carefully than line plots which still gives a significant reduction of replot times, but not quite as much as for line plots. This is because scatter plots inherently need more data points to be preserved in order to still resemble the original, non-adaptive-sampling plot. As shown above, the results still aren't quite identical, as banding occurs for the outer data points. This is in fact intentional, such that the boundaries of the data cloud stay visible to the viewer. How strong the banding appears, depends on the point density, i.e. the number of points in the plot.

For some situations with scatter plots it might thus be desirable to manually turn adaptive sampling off. For example, when saving the plot to disk. This can be achieved by setting enabled to false before issuing a command like QCustomPlot::savePng, and setting enabled back to true afterwards.

§ addData() [1/2]

void QCPGraph::addData ( const QVector< double > &  keys,
const QVector< double > &  values,
bool  alreadySorted = false 
)

This is an overloaded function.

Adds the provided points in keys and values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.

If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ addData() [2/2]

void QCPGraph::addData ( double  key,
double  value 
)

This is an overloaded function.

Adds the provided data point as key and value to the current data.

Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.

§ selectTest()

double QCPGraph::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a selectTest specific to this plottable's point geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation. QCPAbstractPlottable::selectTest

Reimplemented from QCPAbstractPlottable1D< QCPGraphData >.

§ getKeyRange()

QCPRange QCPGraph::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
virtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPGraph::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
virtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ draw()

void QCPGraph::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPGraph::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

§ drawFill()

void QCPGraph::drawFill ( QCPPainter *  painter,
QVector< QPointF > *  lines 
) const
protectedvirtual

Draws the fill of the graph using the specified painter, with the currently set brush.

Depending on whether a normal fill or a channel fill (setChannelFillGraph) is needed, getFillPolygon or getChannelFillPolygon are used to find the according fill polygons.

In order to handle NaN Data points correctly (the fill needs to be split into disjoint areas), this method first determines a list of non-NaN segments with getNonNanSegments, on which to operate. In the channel fill case, getOverlappingSegments is used to consolidate the non-NaN segments of the two involved graphs, before passing the overlapping pairs to getChannelFillPolygon.

Pass the points of this graph's line as lines, in pixel coordinates.

See also
drawLinePlot, drawImpulsePlot, drawScatterPlot

§ drawScatterPlot()

void QCPGraph::drawScatterPlot ( QCPPainter *  painter,
const QVector< QPointF > &  scatters,
const QCPScatterStyle &  style 
) const
protectedvirtual

Draws scatter symbols at every point passed in scatters, given in pixel coordinates. The scatters will be drawn with painter and have the appearance as specified in style.

See also
drawLinePlot, drawImpulsePlot

§ drawLinePlot()

void QCPGraph::drawLinePlot ( QCPPainter *  painter,
const QVector< QPointF > &  lines 
) const
protectedvirtual

Draws lines between the points in lines, given in pixel coordinates.

See also
drawScatterPlot, drawImpulsePlot, QCPAbstractPlottable1D::drawPolyline

§ drawImpulsePlot()

void QCPGraph::drawImpulsePlot ( QCPPainter *  painter,
const QVector< QPointF > &  lines 
) const
protectedvirtual

Draws impulses from the provided data, i.e. it connects all line pairs in lines, given in pixel coordinates. The lines necessary for impulses are generated by dataToImpulseLines from the regular graph data points.

See also
drawLinePlot, drawScatterPlot

§ getOptimizedLineData()

void QCPGraph::getOptimizedLineData ( QVector< QCPGraphData > *  lineData,
const QCPGraphDataContainer::const_iterator &  begin,
const QCPGraphDataContainer::const_iterator &  end 
) const
protectedvirtual

Returns via lineData the data points that need to be visualized for this graph when plotting graph lines, taking into consideration the currently visible axis ranges and, if setAdaptiveSampling is enabled, local point densities. The considered data can be restricted further by begin and end, e.g. to only plot a certain segment of the data (see getDataSegments).

This method is used by getLines to retrieve the basic working set of data.

See also
getOptimizedScatterData

§ getOptimizedScatterData()

void QCPGraph::getOptimizedScatterData ( QVector< QCPGraphData > *  scatterData,
QCPGraphDataContainer::const_iterator  begin,
QCPGraphDataContainer::const_iterator  end 
) const
protectedvirtual

Returns via scatterData the data points that need to be visualized for this graph when plotting scatter points, taking into consideration the currently visible axis ranges and, if setAdaptiveSampling is enabled, local point densities. The considered data can be restricted further by begin and end, e.g. to only plot a certain segment of the data (see getDataSegments).

This method is used by getScatters to retrieve the basic working set of data.

See also
getOptimizedLineData

§ getVisibleDataBounds()

void QCPGraph::getVisibleDataBounds ( QCPGraphDataContainer::const_iterator &  begin,
QCPGraphDataContainer::const_iterator &  end,
const QCPDataRange &  rangeRestriction 
) const
protected

This method outputs the currently visible data range via begin and end. The returned range will also never exceed rangeRestriction.

This method takes into account that the drawing of data lines at the axis rect border always requires the points just outside the visible axis range. So begin and end may actually indicate a range that contains one additional data point to the left and right of the visible axis range.

§ getLines()

void QCPGraph::getLines ( QVector< QPointF > *  lines,
const QCPDataRange &  dataRange 
) const
protected

This method retrieves an optimized set of data points via getOptimizedLineData, and branches out to the line style specific functions such as dataToLines, dataToStepLeftLines, etc. according to the line style of the graph.

lines will be filled with points in pixel coordinates, that can be drawn with the according draw functions like drawLinePlot and drawImpulsePlot. The points returned in lines aren't necessarily the original data points. For example, step line styles require additional points to form the steps when drawn. If the line style of the graph is lsNone, the lines vector will be empty.

dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in dataRange, e.g. when extending ranges coming from getDataSegments.

See also
getScatters

§ getScatters()

void QCPGraph::getScatters ( QVector< QPointF > *  scatters,
const QCPDataRange &  dataRange 
) const
protected

This method retrieves an optimized set of data points via getOptimizedScatterData and then converts them to pixel coordinates. The resulting points are returned in scatters, and can be passed to drawScatterPlot.

dataRange specifies the beginning and ending data indices that will be taken into account for conversion. In this function, the specified range may exceed the total data bounds without harm: a correspondingly trimmed data range will be used. This takes the burden off the user of this function to check for valid indices in dataRange, e.g. when extending ranges coming from getDataSegments.

§ dataToLines()

QVector< QPointF > QCPGraph::dataToLines ( const QVector< QCPGraphData > &  data) const
protected

Takes raw data points in plot coordinates as data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style lsLine.

The source of data is usually getOptimizedLineData, and this method is called in getLines if the line style is set accordingly.

See also
dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot

§ dataToStepLeftLines()

QVector< QPointF > QCPGraph::dataToStepLeftLines ( const QVector< QCPGraphData > &  data) const
protected

Takes raw data points in plot coordinates as data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style lsStepLeft.

The source of data is usually getOptimizedLineData, and this method is called in getLines if the line style is set accordingly.

See also
dataToLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot

§ dataToStepRightLines()

QVector< QPointF > QCPGraph::dataToStepRightLines ( const QVector< QCPGraphData > &  data) const
protected

Takes raw data points in plot coordinates as data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style lsStepRight.

The source of data is usually getOptimizedLineData, and this method is called in getLines if the line style is set accordingly.

See also
dataToLines, dataToStepLeftLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot

§ dataToStepCenterLines()

QVector< QPointF > QCPGraph::dataToStepCenterLines ( const QVector< QCPGraphData > &  data) const
protected

Takes raw data points in plot coordinates as data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style lsStepCenter.

The source of data is usually getOptimizedLineData, and this method is called in getLines if the line style is set accordingly.

See also
dataToLines, dataToStepLeftLines, dataToStepRightLines, dataToImpulseLines, getLines, drawLinePlot

§ dataToImpulseLines()

QVector< QPointF > QCPGraph::dataToImpulseLines ( const QVector< QCPGraphData > &  data) const
protected

Takes raw data points in plot coordinates as data, and returns a vector containing pixel coordinate points which are suitable for drawing the line style lsImpulse.

The source of data is usually getOptimizedLineData, and this method is called in getLines if the line style is set accordingly.

See also
dataToLines, dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, getLines, drawImpulsePlot

§ getNonNanSegments()

QVector< QCPDataRange > QCPGraph::getNonNanSegments ( const QVector< QPointF > *  lineData,
Qt::Orientation  keyOrientation 
) const
protected

This method goes through the passed points in lineData and returns a list of the segments which don't contain NaN data points.

keyOrientation defines whether the x or y member of the passed QPointF is used to check for NaN. If keyOrientation is Qt::Horizontal, the y member is checked, if it is Qt::Vertical, the x member is checked.

See also
getOverlappingSegments, drawFill

§ getOverlappingSegments()

QVector< QPair< QCPDataRange, QCPDataRange > > QCPGraph::getOverlappingSegments ( QVector< QCPDataRange >  thisSegments,
const QVector< QPointF > *  thisData,
QVector< QCPDataRange >  otherSegments,
const QVector< QPointF > *  otherData 
) const
protected

This method takes two segment lists (e.g. created by getNonNanSegments) thisSegments and otherSegments, and their associated point data thisData and otherData.

It returns all pairs of segments (the first from thisSegments, the second from otherSegments), which overlap in plot coordinates.

This method is useful in the case of a channel fill between two graphs, when only those non-NaN segments which actually overlap in their key coordinate shall be considered for drawing a channel fill polygon.

It is assumed that the passed segments in thisSegments are ordered ascending by index, and that the segments don't overlap themselves. The same is assumed for the segments in otherSegments. This is fulfilled when the segments are obtained via getNonNanSegments.

See also
getNonNanSegments, segmentsIntersect, drawFill, getChannelFillPolygon

§ segmentsIntersect()

bool QCPGraph::segmentsIntersect ( double  aLower,
double  aUpper,
double  bLower,
double  bUpper,
int &  bPrecedence 
) const
protected

Returns whether the segments defined by the coordinates (aLower, aUpper) and (bLower, bUpper) have overlap.

The output parameter bPrecedence indicates whether the b segment reaches farther than the a segment or not. If bPrecedence returns 1, segment b reaches the farthest to higher coordinates (i.e. bUpper > aUpper). If it returns -1, segment a reaches the farthest. Only if both segment's upper bounds are identical, 0 is returned as bPrecedence.

It is assumed that the lower bounds always have smaller or equal values than the upper bounds.

See also
getOverlappingSegments

§ getFillBasePoint()

QPointF QCPGraph::getFillBasePoint ( QPointF  matchingDataPoint) const
protected

Returns the point which closes the fill polygon on the zero-value-line parallel to the key axis. The logarithmic axis scale case is a bit special, since the zero-value-line in pixel coordinates is in positive or negative infinity. So this case is handled separately by just closing the fill polygon on the axis which lies in the direction towards the zero value.

matchingDataPoint will provide the key (in pixels) of the returned point. Depending on whether the key axis of this graph is horizontal or vertical, matchingDataPoint will provide the x or y value of the returned point, respectively.

§ getFillPolygon()

const QPolygonF QCPGraph::getFillPolygon ( const QVector< QPointF > *  lineData,
QCPDataRange  segment 
) const
protected

Returns the polygon needed for drawing normal fills between this graph and the key axis.

Pass the graph's data points (in pixel coordinates) as lineData, and specify the segment which shall be used for the fill. The collection of lineData points described by segment must not contain NaN data points (see getNonNanSegments).

The returned fill polygon will be closed at the key axis (the zero-value line) for linear value axes. For logarithmic value axes the polygon will reach just beyond the corresponding axis rect side (see getFillBasePoint).

For increased performance (due to implicit sharing), keep the returned QPolygonF const.

See also
drawFill, getNonNanSegments

§ getChannelFillPolygon()

const QPolygonF QCPGraph::getChannelFillPolygon ( const QVector< QPointF > *  thisData,
QCPDataRange  thisSegment,
const QVector< QPointF > *  otherData,
QCPDataRange  otherSegment 
) const
protected

Returns the polygon needed for drawing (partial) channel fills between this graph and the graph specified by setChannelFillGraph.

The data points of this graph are passed as pixel coordinates via thisData, the data of the other graph as otherData. The returned polygon will be calculated for the specified data segments thisSegment and otherSegment, pertaining to the respective thisData and otherData, respectively.

The passed thisSegment and otherSegment should correspond to the segment pairs returned by getOverlappingSegments, to make sure only segments that actually have key coordinate overlap need to be processed here.

For increased performance due to implicit sharing, keep the returned QPolygonF const.

See also
drawFill, getOverlappingSegments, getNonNanSegments

§ findIndexBelowX()

int QCPGraph::findIndexBelowX ( const QVector< QPointF > *  data,
double  x 
) const
protected

Finds the highest index of data, whose points x value is just below x. Assumes x values in data points are ordered ascending, as is ensured by getLines/getScatters if the key axis is horizontal.

Used to calculate the channel fill polygon, see getChannelFillPolygon.

§ findIndexAboveX()

int QCPGraph::findIndexAboveX ( const QVector< QPointF > *  data,
double  x 
) const
protected

Finds the smallest index of data, whose points x value is just above x. Assumes x values in data points are ordered ascending, as is ensured by getLines/getScatters if the key axis is horizontal.

Used to calculate the channel fill polygon, see getChannelFillPolygon.

§ findIndexBelowY()

int QCPGraph::findIndexBelowY ( const QVector< QPointF > *  data,
double  y 
) const
protected

Finds the highest index of data, whose points y value is just below y. Assumes y values in data points are ordered ascending, as is ensured by getLines/getScatters if the key axis is vertical.

Used to calculate the channel fill polygon, see getChannelFillPolygon.

§ findIndexAboveY()

int QCPGraph::findIndexAboveY ( const QVector< QPointF > *  data,
double  y 
) const
protected

Finds the smallest index of data, whose points y value is just above y. Assumes y values in data points are ordered ascending, as is ensured by getLines/getScatters if the key axis is vertical.

Used to calculate the channel fill polygon, see getChannelFillPolygon.

§ pointDistance()

double QCPGraph::pointDistance ( const QPointF &  pixelPoint,
QCPGraphDataContainer::const_iterator &  closestData 
) const
protected

Calculates the minimum distance in pixels the graph's representation has from the given pixelPoint. This is used to determine whether the graph was clicked or not, e.g. in selectTest. The closest data point to pixelPoint is returned in closestData. Note that if the graph has a line representation, the returned distance may be smaller than the distance to the closestData point, since the distance to the graph line is also taken into account.

If either the graph has no data or if the line style is lsNone and the scatter style's shape is QCPScatterStyle::ssNone (i.e. there is no visual representation of the graph), returns -1.0.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/functions_u.html0000644000175000017500000001014414030601037024063 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- u -

qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_7.png0000644000175000017500000000164514030601042024422 0ustar rusconirusconi‰PNG  IHDRØ#\| ¼gAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>×IDAThÞí›1’Ú0†äИ„”i¸Á)w&¹@ÌÒxË̸ˤΦÚ>M:Ú4Ü!nRÐx+@ó§°,ëi`XÐÌû\¬%==ýø—eaG)ñæÚ”a¨a‘¡†E†ãîtI¿®­F¹§ïî|Ôí§´¥Éµµ)/ØÒ„ž]iì7ù Ê­0e%}†E†jXd¨a‘ÑÓ°%”PB W³d5‰=~°ÒBÌ•ìcy°×ñ ÉÑ~}®=aÇÅ#E ™%j”0(\M+ÛǨqã• dB6³w ?ã!ÌшÓ9Eûe5q_zfÛ³ÜYRrkÏ0 1¡m7¶±¯}™qe[׶uÞ#C THa`ðhÛî\φµ›dá…¢½)—®G ƒ•S²”t½îì'<³a•=«œÜ*ˆï0?º¡ ZÃZž1Å5æö¦ öæå‘)2{¿4m37J ) f(EÆho[Ú‰!uJÚOÀ•tf0¶í• 3l&óè"˜›k+aÌn¼š™‚½yÃHyŒ)rá2¢½mél] Ÿ ìÑR#·zúÖsÓñ-øKôDìhG;úÄêÚ˜¯ô™6´ z„µaFÎT¨“óòÈßVYÃÛÞÏöaÚˆhI4¡BF®ädúÜaý6|–6Ñ™-—¨1có/¬ 3†K¢?ÿå FˆL‘¢ÂZPyhIª½Ë]²u†/‰¾’– -‰@foçlOMhnbç6jn^f 7þe‘3H†µú\P È›ŽS´ûã¦îLÚtäÁhC7ìm=yùûŽþÒF\œ”†gzO_ìƒ!ùÿåˆB_ÆCºþ¹öõ¸q"ú<ÇÏÍ Ã”Ãì”Î…¾KŒ 5,2Ô°ÈPÃ"C ‹ ¶KܾÆ÷9Ê`üß²y†=éïo”{ï|¤ÿ½ú ‹ 5,2Ô°ÈÓÏkKP†ðÏÆÀ©©Ùv%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/ssTriangleInverted.png0000644000175000017500000000050614030601041025157 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+xIDAT(ϵ‘[ €0 EO €fczT fðP$H`ø`),¼>íÏ]ïÉî² ÂcUð¨Mu'OÄÞ°0vKSÞ02ÑÛiØI±N¸¬ɦ ³Š„+@P‚G³Ø,ÅßBD-èp9Æzÿ‡ßvñ ¬ÎÀ3x â%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_m.html0000644000175000017500000002232514030601037025072 0ustar rusconirusconi Data Fields - Functions
 

- m -

qcustomplot-2.1.0+dfsg1/documentation/html/plottable-statisticalbox_8h.html0000644000175000017500000001270614030601036027154 0ustar rusconirusconi src/plottables/plottable-statisticalbox.h File Reference
Data Structures | Typedefs | Functions
plottable-statisticalbox.h File Reference

Data Structures

class  QCPStatisticalBoxData
 Holds the data of one single data point for QCPStatisticalBox. More...
 
class  QCPStatisticalBox
 A plottable representing a single statistical box in a plot. More...
 

Typedefs

typedef QCPDataContainer< QCPStatisticalBoxData > QCPStatisticalBoxDataContainer
 

Functions

 Q_DECLARE_TYPEINFO (QCPStatisticalBoxData, Q_MOVABLE_TYPE)
 

Typedef Documentation

§ QCPStatisticalBoxDataContainer

QCPStatisticalBoxDataContainer

Container for storing QCPStatisticalBoxData points. The data is stored sorted by key.

This template instantiation is the container in which QCPStatisticalBox holds its data. For details about the generic container, see the documentation of the class template QCPDataContainer.

See also
QCPStatisticalBoxData, QCPStatisticalBox::setData
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPErrorBars.html0000644000175000017500000035307414030601040025030 0ustar rusconirusconi QCPErrorBars Class Reference
Public Types | Public Functions | Protected Functions
QCPErrorBars Class Reference

A plottable that adds a set of error bars to other plottables. More...

Inheritance diagram for QCPErrorBars:
Inheritance graph

Public Types

enum  ErrorType
 

Public Functions

 QCPErrorBars (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QSharedPointer< QCPErrorBarsDataContainer > data () const
 
QCPAbstractPlottable * dataPlottable () const
 
ErrorType errorType () const
 
double whiskerWidth () const
 
double symbolGap () const
 
void setData (QSharedPointer< QCPErrorBarsDataContainer > data)
 
void setData (const QVector< double > &error)
 
void setData (const QVector< double > &errorMinus, const QVector< double > &errorPlus)
 
void setDataPlottable (QCPAbstractPlottable *plottable)
 
void setErrorType (ErrorType type)
 
void setWhiskerWidth (double pixels)
 
void setSymbolGap (double pixels)
 
void addData (const QVector< double > &error)
 
void addData (const QVector< double > &errorMinus, const QVector< double > &errorPlus)
 
void addData (double error)
 
void addData (double errorMinus, double errorPlus)
 
virtual int dataCount () const
 
virtual double dataMainKey (int index) const
 
virtual double dataSortKey (int index) const
 
virtual double dataMainValue (int index) const
 
virtual QCPRange dataValueRange (int index) const
 
virtual QPointF dataPixelPosition (int index) const
 
virtual bool sortKeyIsMainKey () const
 
virtual QCPDataSelection selectTestRect (const QRectF &rect, bool onlySelectable) const
 
virtual int findBegin (double sortKey, bool expandedRange=true) const
 
virtual int findEnd (double sortKey, bool expandedRange=true) const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
virtual QCPPlottableInterface1D * interface1D ()
 
- Public Functions inherited from QCPAbstractPlottable
 QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis)
 
QString name () const
 
bool antialiasedFill () const
 
bool antialiasedScatters () const
 
QPen pen () const
 
QBrush brush () const
 
QCPAxis * keyAxis () const
 
QCPAxis * valueAxis () const
 
QCP::SelectionType selectable () const
 
bool selected () const
 
QCPDataSelection selection () const
 
QCPSelectionDecorator * selectionDecorator () const
 
void setName (const QString &name)
 
void setAntialiasedFill (bool enabled)
 
void setAntialiasedScatters (bool enabled)
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setKeyAxis (QCPAxis *axis)
 
void setValueAxis (QCPAxis *axis)
 
Q_SLOT void setSelectable (QCP::SelectionType selectable)
 
Q_SLOT void setSelection (QCPDataSelection selection)
 
void setSelectionDecorator (QCPSelectionDecorator *decorator)
 
void coordsToPixels (double key, double value, double &x, double &y) const
 
const QPointF coordsToPixels (double key, double value) const
 
void pixelsToCoords (double x, double y, double &key, double &value) const
 
void pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const
 
void rescaleAxes (bool onlyEnlarge=false) const
 
void rescaleKeyAxis (bool onlyEnlarge=false) const
 
void rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const
 
bool addToLegend (QCPLegend *legend)
 
bool addToLegend ()
 
bool removeFromLegend (QCPLegend *legend) const
 
bool removeFromLegend () const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
virtual void drawLegendIcon (QCPPainter *painter, const QRectF &rect) const
 
virtual QCPRange getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const
 
virtual QCPRange getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const
 
void getErrorBarLines (QCPErrorBarsDataContainer::const_iterator it, QVector< QLineF > &backbones, QVector< QLineF > &whiskers) const
 
void getVisibleDataBounds (QCPErrorBarsDataContainer::const_iterator &begin, QCPErrorBarsDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const
 
double pointDistance (const QPointF &pixelPoint, QCPErrorBarsDataContainer::const_iterator &closestData) const
 
void getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const
 
bool errorBarVisible (int index) const
 
bool rectIntersectsLine (const QRectF &pixelRect, const QLineF &line) const
 
- Protected Functions inherited from QCPAbstractPlottable
virtual QRect clipRect () const
 
virtual QCP::Interaction selectionCategory () const
 
void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
void applyFillAntialiasingHint (QCPPainter *painter) const
 
void applyScattersAntialiasingHint (QCPPainter *painter) const
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractPlottable
void selectionChanged (bool selected)
 
void selectionChanged (const QCPDataSelection &selection)
 
void selectableChanged (QCP::SelectionType selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A plottable that adds a set of error bars to other plottables.

QCPErrorBars.png

The QCPErrorBars plottable can be attached to other one-dimensional plottables (e.g. QCPGraph, QCPCurve, QCPBars, etc.) and equips them with error bars.

Use setDataPlottable to define for which plottable the QCPErrorBars shall display the error bars. The orientation of the error bars can be controlled with setErrorType.

By using setData, you can supply the actual error data, either as symmetric error or plus/minus asymmetric errors. QCPErrorBars only stores the error data. The absolute key/value position of each error bar will be adopted from the configured data plottable. The error data of the QCPErrorBars are associated one-to-one via their index to the data points of the data plottable. You can directly access and manipulate the error bar data via data.

Set either of the plus/minus errors to NaN (qQNaN() or std::numeric_limits<double>::quiet_NaN()) to not show the respective error bar on the data point at that index.

Changing the appearance

The appearance of the error bars is defined by the pen (setPen), and the width of the whiskers (setWhiskerWidth). Further, the error bar backbones may leave a gap around the data point center to prevent that error bars are drawn too close to or even through scatter points. This gap size can be controlled via setSymbolGap.

Member Enumeration Documentation

§ ErrorType

enum QCPErrorBars::ErrorType

Defines in which orientation the error bars shall appear. If your data needs both error dimensions, create two QCPErrorBars with different ErrorType.

See also
setErrorType
Enumerator
etKeyError 

The errors are for the key dimension (bars appear parallel to the key axis)

etValueError 

The errors are for the value dimension (bars appear parallel to the value axis)

Constructor & Destructor Documentation

§ QCPErrorBars()

QCPErrorBars::QCPErrorBars ( QCPAxis *  keyAxis,
QCPAxis *  valueAxis 
)
explicit

Constructs an error bars plottable which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.

It is also important that the keyAxis and valueAxis are the same for the error bars plottable and the data plottable that the error bars shall be drawn on (setDataPlottable).

The created QCPErrorBars is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPErrorBars, so do not delete it manually but use QCustomPlot::removePlottable() instead.

Member Function Documentation

§ data()

QSharedPointer< QCPErrorBarsDataContainer > QCPErrorBars::data ( ) const
inline

Returns a shared pointer to the internal data storage of type QCPErrorBarsDataContainer. You may use it to directly manipulate the error values, which may be more convenient and faster than using the regular setData methods.

§ setData() [1/3]

void QCPErrorBars::setData ( QSharedPointer< QCPErrorBarsDataContainer >  data)

This is an overloaded function.

Replaces the current data container with the provided data container.

Since a QSharedPointer is used, multiple QCPErrorBars instances may share the same data container safely. Modifying the data in the container will then affect all QCPErrorBars instances that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:

errorBars2->setData(errorBars1->data()); // errorBars1 and errorBars2 now share data container

If you do not wish to share containers, but create a copy from an existing container, assign the data containers directly:

*errorBars2->data() = *errorBars1->data(); // errorBars2 now has copy of errorBars1's data in its container

(This uses different notation compared with other plottables, because the QCPErrorBars uses a QVector<QCPErrorBarsData> as its data container, instead of a QCPDataContainer.)

See also
addData

§ setData() [2/3]

void QCPErrorBars::setData ( const QVector< double > &  error)

This is an overloaded function.

Sets symmetrical error values as specified in error. The errors will be associated one-to-one by the data point index to the associated data plottable (setDataPlottable).

You can directly access and manipulate the error bar data via data.

See also
addData

§ setData() [3/3]

void QCPErrorBars::setData ( const QVector< double > &  errorMinus,
const QVector< double > &  errorPlus 
)

This is an overloaded function.

Sets asymmetrical errors as specified in errorMinus and errorPlus. The errors will be associated one-to-one by the data point index to the associated data plottable (setDataPlottable).

You can directly access and manipulate the error bar data via data.

See also
addData

§ setDataPlottable()

void QCPErrorBars::setDataPlottable ( QCPAbstractPlottable *  plottable)

Sets the data plottable to which the error bars will be applied. The error values specified e.g. via setData will be associated one-to-one by the data point index to the data points of plottable. This means that the error bars will adopt the key/value coordinates of the data point with the same index.

The passed plottable must be a one-dimensional plottable, i.e. it must implement the QCPPlottableInterface1D. Further, it must not be a QCPErrorBars instance itself. If either of these restrictions is violated, a corresponding qDebug output is generated, and the data plottable of this QCPErrorBars instance is set to zero.

For proper display, care must also be taken that the key and value axes of the plottable match those configured for this QCPErrorBars instance.

§ setErrorType()

void QCPErrorBars::setErrorType ( ErrorType  type)

Sets in which orientation the error bars shall appear on the data points. If your data needs both error dimensions, create two QCPErrorBars with different type.

§ setWhiskerWidth()

void QCPErrorBars::setWhiskerWidth ( double  pixels)

Sets the width of the whiskers (the short bars at the end of the actual error bar backbones) to pixels.

§ setSymbolGap()

void QCPErrorBars::setSymbolGap ( double  pixels)

Sets the gap diameter around the data points that will be left out when drawing the error bar backbones. This gap prevents that error bars are drawn too close to or even through scatter points.

§ addData() [1/4]

void QCPErrorBars::addData ( const QVector< double > &  error)

This is an overloaded function.

Adds symmetrical error values as specified in error. The errors will be associated one-to-one by the data point index to the associated data plottable (setDataPlottable).

You can directly access and manipulate the error bar data via data.

See also
setData

§ addData() [2/4]

void QCPErrorBars::addData ( const QVector< double > &  errorMinus,
const QVector< double > &  errorPlus 
)

This is an overloaded function.

Adds asymmetrical errors as specified in errorMinus and errorPlus. The errors will be associated one-to-one by the data point index to the associated data plottable (setDataPlottable).

You can directly access and manipulate the error bar data via data.

See also
setData

§ addData() [3/4]

void QCPErrorBars::addData ( double  error)

This is an overloaded function.

Adds a single symmetrical error bar as specified in error. The errors will be associated one-to-one by the data point index to the associated data plottable (setDataPlottable).

You can directly access and manipulate the error bar data via data.

See also
setData

§ addData() [4/4]

void QCPErrorBars::addData ( double  errorMinus,
double  errorPlus 
)

This is an overloaded function.

Adds a single asymmetrical error bar as specified in errorMinus and errorPlus. The errors will be associated one-to-one by the data point index to the associated data plottable (setDataPlottable).

You can directly access and manipulate the error bar data via data.

See also
setData

§ dataCount()

int QCPErrorBars::dataCount ( ) const
virtual

Returns the number of data points of the plottable.

Implements QCPPlottableInterface1D.

§ dataMainKey()

double QCPErrorBars::dataMainKey ( int  index) const
virtual

Returns the main key of the data point at the given index.

What the main key is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataSortKey()

double QCPErrorBars::dataSortKey ( int  index) const
virtual

Returns the sort key of the data point at the given index.

What the sort key is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataMainValue()

double QCPErrorBars::dataMainValue ( int  index) const
virtual

Returns the main value of the data point at the given index.

What the main value is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataValueRange()

QCPRange QCPErrorBars::dataValueRange ( int  index) const
virtual

Returns the value range of the data point at the given index.

What the value range is, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ dataPixelPosition()

QPointF QCPErrorBars::dataPixelPosition ( int  index) const
virtual

Returns the pixel position on the widget surface at which the data point at the given index appears.

Usually this corresponds to the point of dataMainKey/dataMainValue, in pixel coordinates. However, depending on the plottable, this might be a different apparent position than just a coord-to-pixel transform of those values. For example, QCPBars apparent data values can be shifted depending on their stacking, bar grouping or configured base value.

Implements QCPPlottableInterface1D.

§ sortKeyIsMainKey()

bool QCPErrorBars::sortKeyIsMainKey ( ) const
virtual

Returns whether the sort key (dataSortKey) is identical to the main key (dataMainKey).

What the sort and main keys are, is defined by the plottable's data type. See the QCPDataContainer DataType documentation for details about this naming convention.

Implements QCPPlottableInterface1D.

§ selectTestRect()

QCPDataSelection QCPErrorBars::selectTestRect ( const QRectF &  rect,
bool  onlySelectable 
) const
virtual

Returns a data selection containing all the data points of this plottable which are contained (or hit by) rect. This is used mainly in the selection rect interaction for data selection (data selection mechanism).

If onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not selectable (i.e. if QCPAbstractPlottable::setSelectable is QCP::stNone).

Note
rect must be a normalized rect (positive or zero width and height). This is especially important when using the rect of QCPSelectionRect::accepted, which is not necessarily normalized. Use QRect::normalized() when passing a rect which might not be normalized.

Implements QCPPlottableInterface1D.

§ findBegin()

int QCPErrorBars::findBegin ( double  sortKey,
bool  expandedRange = true 
) const
virtual

Returns the index of the data point with a (sort-)key that is equal to, just below, or just above sortKey. If expandedRange is true, the data point just below sortKey will be considered, otherwise the one just above.

This can be used in conjunction with findEnd to iterate over data points within a given key range, including or excluding the bounding data points that are just beyond the specified range.

If expandedRange is true but there are no data points below sortKey, 0 is returned.

If the container is empty, returns 0 (in that case, findEnd will also return 0, so a loop using these methods will not iterate over the index 0).

See also
findEnd, QCPDataContainer::findBegin

Implements QCPPlottableInterface1D.

§ findEnd()

int QCPErrorBars::findEnd ( double  sortKey,
bool  expandedRange = true 
) const
virtual

Returns the index one after the data point with a (sort-)key that is equal to, just above, or just below sortKey. If expandedRange is true, the data point just above sortKey will be considered, otherwise the one just below.

This can be used in conjunction with findBegin to iterate over data points within a given key range, including the bounding data points that are just below and above the specified range.

If expandedRange is true but there are no data points above sortKey, the index just above the highest data point is returned.

If the container is empty, returns 0.

See also
findBegin, QCPDataContainer::findEnd

Implements QCPPlottableInterface1D.

§ selectTest()

double QCPErrorBars::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

Implements a selectTest specific to this plottable's point geometry.

If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.

For general information about this virtual method, see the base class implementation. QCPAbstractPlottable::selectTest

Implements QCPAbstractPlottable.

§ interface1D()

virtual QCPPlottableInterface1D* QCPErrorBars::interface1D ( )
inlinevirtual

If this plottable is a one-dimensional plottable, i.e. it implements the QCPPlottableInterface1D, returns the this pointer with that type. Otherwise (e.g. in the case of a QCPColorMap) returns zero.

You can use this method to gain read access to data coordinates while holding a pointer to the abstract base class only.

Reimplemented from QCPAbstractPlottable.

§ draw()

void QCPErrorBars::draw ( QCPPainter *  painter)
protectedvirtual

This function draws the layerable with the specified painter. It is only called by QCustomPlot, if the layerable is visible (setVisible).

Before this function is called, the painter's antialiasing state is set via applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was set to clipRect.

Implements QCPAbstractPlottable.

§ drawLegendIcon()

void QCPErrorBars::drawLegendIcon ( QCPPainter *  painter,
const QRectF &  rect 
) const
protectedvirtual

called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation of this plottable inside rect, next to the plottable name.

The passed painter has its cliprect set to rect, so painting outside of rect won't appear outside the legend icon border.

Implements QCPAbstractPlottable.

§ getKeyRange()

QCPRange QCPErrorBars::getKeyRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth 
) const
protectedvirtual

Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getValueRange

Implements QCPAbstractPlottable.

§ getValueRange()

QCPRange QCPErrorBars::getValueRange ( bool &  foundRange,
QCP::SignDomain  inSignDomain = QCP::sdBoth,
const QCPRange &  inKeyRange = QCPRange() 
) const
protectedvirtual

Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).

If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys.

Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.

See also
rescaleAxes, getKeyRange

Implements QCPAbstractPlottable.

§ getErrorBarLines()

void QCPErrorBars::getErrorBarLines ( QCPErrorBarsDataContainer::const_iterator  it,
QVector< QLineF > &  backbones,
QVector< QLineF > &  whiskers 
) const
protected

Calculates the lines that make up the error bar belonging to the data point it.

The resulting lines are added to backbones and whiskers. The vectors are not cleared, so calling this method with different it but the same backbones and whiskers allows to accumulate lines for multiple data points.

This method assumes that it is a valid iterator within the bounds of this QCPErrorBars instance and within the bounds of the associated data plottable.

§ getVisibleDataBounds()

void QCPErrorBars::getVisibleDataBounds ( QCPErrorBarsDataContainer::const_iterator &  begin,
QCPErrorBarsDataContainer::const_iterator &  end,
const QCPDataRange &  rangeRestriction 
) const
protected

This method outputs the currently visible data range via begin and end. The returned range will also never exceed rangeRestriction.

Since error bars with type etKeyError may extend to arbitrarily positive and negative key coordinates relative to their data point key, this method checks all outer error bars whether they truly don't reach into the visible portion of the axis rect, by calling errorBarVisible. On the other hand error bars with type etValueError that are associated with data plottables whose sort key is equal to the main key (see QCPDataContainer DataType) can be handled very efficiently by finding the visible range of error bars through binary search (QCPPlottableInterface1D::findBegin and QCPPlottableInterface1D::findEnd).

If the plottable's sort key is not equal to the main key, this method returns the full data range, only restricted by rangeRestriction. Drawing optimization then has to be done on a point-by-point basis in the draw method.

§ pointDistance()

double QCPErrorBars::pointDistance ( const QPointF &  pixelPoint,
QCPErrorBarsDataContainer::const_iterator &  closestData 
) const
protected

Calculates the minimum distance in pixels the error bars' representation has from the given pixelPoint. This is used to determine whether the error bar was clicked or not, e.g. in selectTest. The closest data point to pixelPoint is returned in closestData.

§ getDataSegments()

void QCPErrorBars::getDataSegments ( QList< QCPDataRange > &  selectedSegments,
QList< QCPDataRange > &  unselectedSegments 
) const
protected
Note
This method is identical to QCPAbstractPlottable1D::getDataSegments but needs to be reproduced here since the QCPErrorBars plottable, as a special case that doesn't have its own key/value data coordinates, doesn't derive from QCPAbstractPlottable1D. See the documentation there for details.

§ errorBarVisible()

bool QCPErrorBars::errorBarVisible ( int  index) const
protected

Returns whether the error bar at the specified index is visible within the current key axis range.

This method assumes for performance reasons without checking that the key axis, the value axis, and the data plottable (setDataPlottable) are not nullptr and that index is within valid bounds of this QCPErrorBars instance and the bounds of the data plottable.

§ rectIntersectsLine()

bool QCPErrorBars::rectIntersectsLine ( const QRectF &  pixelRect,
const QLineF &  line 
) const
protected

Returns whether line intersects (or is contained in) pixelRect.

line is assumed to be either perfectly horizontal or perfectly vertical, as is the case for error bar lines.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/functions_f.html0000644000175000017500000001106314030601037024045 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- f -

qcustomplot-2.1.0+dfsg1/documentation/html/ssCrossCircle.png0000644000175000017500000000050614030601041024124 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+xIDAT(ϵ‘Ñà E/Y§nâ4â2¬á.o†~„Ðjs’ÓàÂõb—¶Á¿Àk Xž‚#Â)ýJ‹¾£Dp:¢b4DÃW@Ñãµf 00,UŒE&…†¨è·‡£µ½ŸMÑÂïgSÜþÛîöÀ²{ë''NÓf ù%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_h.html0000644000175000017500000000400614030601037025061 0ustar rusconirusconi Data Fields - Functions
 

- h -

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemStraightLine.html0000644000175000017500000013315414030601040026336 0ustar rusconirusconi QCPItemStraightLine Class Reference
Public Functions | Public Members | Protected Functions
QCPItemStraightLine Class Reference

A straight line that spans infinitely in both directions. More...

Inheritance diagram for QCPItemStraightLine:
Inheritance graph

Public Functions

 QCPItemStraightLine (QCustomPlot *parentPlot)
 
QPen pen () const
 
QPen selectedPen () const
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
bool clipToAxisRect () const
 
QCPAxisRect * clipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPosition * position (const QString &name) const
 
QCPItemAnchor * anchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Public Members

QCPItemPosition *const point1
 
QCPItemPosition *const point2
 

Protected Functions

virtual void draw (QCPPainter *painter)
 
QLineF getRectClippedStraightLine (const QCPVector2D &base, const QCPVector2D &vec, const QRect &rect) const
 
QPen mainPen () const
 
- Protected Functions inherited from QCPAbstractItem
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual QPointF anchorPixelPosition (int anchorId) const
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPosition * createPosition (const QString &name)
 
QCPItemAnchor * createAnchor (const QString &name, int anchorId)
 
- Protected Functions inherited from QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Additional Inherited Members

- Signals inherited from QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

A straight line that spans infinitely in both directions.

QCPItemStraightLine.png
Straight line example. Blue dotted circles are anchors, solid blue discs are positions.

It has two positions, point1 and point2, which define the straight line.

Constructor & Destructor Documentation

§ QCPItemStraightLine()

QCPItemStraightLine::QCPItemStraightLine ( QCustomPlot *  parentPlot)
explicit

Creates a straight line item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

Member Function Documentation

§ setPen()

void QCPItemStraightLine::setPen ( const QPen &  pen)

Sets the pen that will be used to draw the line

See also
setSelectedPen

§ setSelectedPen()

void QCPItemStraightLine::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used to draw the line when selected

See also
setPen, setSelected

§ selectTest()

double QCPItemStraightLine::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = nullptr 
) const
virtual

This function is used to decide whether a click hits a layerable object or not.

pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).

The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

In the case of 1D Plottables (QCPAbstractPlottable1D, like QCPGraph or QCPBars) details will be set to a QCPDataSelection, describing the closest data point to pos.

You may pass nullptr as details to indicate that you are not interested in those selection details.

See also
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, QCPAbstractPlottable1D::selectTestRect

Implements QCPAbstractItem.

§ draw()

void QCPItemStraightLine::draw ( QCPPainter *  painter)
protectedvirtual

Draws this item with the provided painter.

The cliprect of the provided painter is set to the rect returned by clipRect before this function is called. The clipRect depends on the clipping settings defined by setClipToAxisRect and setClipAxisRect.

Implements QCPAbstractItem.

§ getRectClippedStraightLine()

QLineF QCPItemStraightLine::getRectClippedStraightLine ( const QCPVector2D &  base,
const QCPVector2D &  vec,
const QRect &  rect 
) const
protected

Returns the section of the straight line defined by base and direction vector vec, that is visible in the specified rect.

This is a helper function for draw.

§ mainPen()

QPen QCPItemStraightLine::mainPen ( ) const
protected

Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected and mSelectedPen when it is.

The documentation for this class was generated from the following files:
  • src/items/item-straightline.h
  • src/items/item-straightline.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/AxisNamesOverview.png0000644000175000017500000001054314030601040024763 0ustar rusconirusconi‰PNG  IHDRÂ,gˆC…gAMA† 1è–_ÀPLTEÿÿÿ¿_oóÿò²T[ÓøÿášB  -`«òù÷ý7 ..›øûâJ§çäѲñÿšË§TÅþ“èÿüØrKµúýÕÿÿÿÞÿÿNÀÿ(ÿÿ/ÿïïþ£Uþç’ÿà ÿ(ÿ ÿ--ÿPÿÏÐÿ–ÔýóÈÿi„¥LNÿÐqÿ_þÏbÿpÖþ©§ö“““#d÷ýooÿ““ÿ±±ÿÒ‚Z¾|âÿ¾¦‚ddfqi•œ|BbKGDˆH pHYsÃÃÇo¨dÊIDATxÚí‹Bâ8†+V°r݆J¹)¨#^v×}ÿ·Ú$m¡--$ÐÒ¦þß:+bñüœ“æÒM@z8ËkZ¾P,/tí²T,_%Ý" …q+1 +UÃ0´Z¥Þ¸¾h&Ý( ƒqöWJX+ýb?]–[Z»t“t£å¶c[®Ûûå<ø­ùmÿt4y&a;W,–«Ú¥Ô!“¶…btû„q7Úñ+ µÆ ]nYžóç‹*’Œ††qOZ´Ú(”„„ ¦U·®Í¡âƒSC%´„yèReŽÌ¦õÌ°GÈ }4¦~ªóßßÄ&a»Tu÷…)C- »‰>Õ©„Cö„%êÌ™ô©;}Þ?ïö'ƒ!iÆÒ>êùB¹Å¯HËMas¨X& ïm垥¶T &ZUÓ†æýýmï& éx]ã´™^ ©X{@¸”ìciš&“ƶgsÈ/|¢–0n“¥­L,ø½°º¤ý晼¬½pdÞ¯¥=E«3‡Šmv÷…óí ç=v…Á%lv—LBÚvX_¨¯zŠ$ü“²2‰K¨Ý;W¤ÌûØ3·tÐøf6Y÷è\‘®¢¾œ9Æ0Õ$6PþA-Žxa¬ Nð0Ndõû›¨c%Û<“Õ»q|=»€ÆÌàÝ$O±ÆSH?+2žÆW½jæP³ÍŸ4ž~ÄU9¼ð4 žˆS§ O…Á:Å8â©ŠæP±ÍœWÚ)~F^«È\Gº¼PéÙ™i "é‰<™f´ƒ Í¡b›ÝD<È€&dD6óæ3Ç èÓ £gÝ Ãcúá¿`ò.lnïuŽž,Hh2¢è7æ ý,!« 2[žÁ6Mò]# KB^f1ÓŒ­½Î;êy¯mVœHŽ9hmŒÀ ýf} oÓÏ+' l$4úÕM!H(Bƒ n˜-VB¯±7hÍ{/š¶œ8;˜5cIkxÙÚë=’Оy;*ž²ò;ñbZ¬¾V«± ÚßÝÍ4—„ls]c7ŽTö:oÀÐ>˜÷ã^/O§ÓOÆëçSgÿ{²`jsêþ³„UÚ;~ék }{7 †ñ:>¢StÌñnõ…¢=_šÍµ„|óFBß^çèÉž„öòþa/-º+¡nT&È3¨~·./x¡½×yw="ïÞæ,á›y¬ns°=An¸uEz¥wG¤ÙíTµ‡žÕvX_hô'{ÃëÑÞk_›3…{æmü$ú*Ÿ9^E"ò=‘æžô[âì`ÖøW[{£'³º—÷ÇD4®bŽ4e8Ëû´[Ô¦kæ Ä4TÑ*¶YÚ)ò‚†XµO'Ö@]DCÒTòáÌ” h¨¢9Tl³®)Ïý SÈëxµ2MQ ƒÌaøf a‚læZx&D'ÕÅÎŒtt)¶­ã ôœZÂõª,ÓÓ6v&D;¢;¢ïÌ{ÀÒ½Ï3“‘eÍ þÝzgËz'‚–¤„V&D;íS`ö'FÈҽ߬AÉȲ&á}È:KbÚ©ƒìäk9ؤ–îC’‘ˆSH8š°]$Ïôï™ÓÞïî’ÓIÖu‚|kA¸$<ß΄øçVZ¹ÿúZ9_ãõ-ü÷WëÏŸn¯ÞíÔõÇGú`øõ¨Ñçcÿ:U&Änç÷óJ׌åÝOÄõLšÆë@;Y¾µ=îó±{á~½jÿîZµHFVhƒBôÙÔùŠö¼×›ü}³Ö>O”o-ˆ¼H_(¼t’ŒìDÄ/!ßÉE&ôÑ’¼pÙòf{aRùÖ¸„v Ä™ùÒ½±qÛ3¶“‘}éÚ^ÔñÂyïj:š:ýC;wKž“,É|kV>RqaÀÒ}¸„¡ ô¨#!S‡ÇþdÞ£—k¿ç3mÞYK˜\¾5Qsì_ºIF–`›#ÅèóäòŽ]g?“ 7Îþõ„ó­jL°¥H¨<*š#¥m>E¾µ à…Qq’|kA`ãEdœ"ßZ)5‡šmŽ?ßZ¤Ñs¾µ aÔÄ‘Zf'é6‡šm>þ®O)à…q`yק0&âÉ·„æP³ÍGÜõ)¼0FÈ·ÖX#<ÂÄÐ>^$ìœW‹œðÊJæP³Í±&uf ÆtRçÆ_2Ñž©¤Î—¥b®uy!°“EUs¨Ùfñ|kùJ½]jµKÿDixa$μQñj0­¥–¡^H%<»Þ¯¢9Tl³ƒ'µLðÀÿ’ ,r7ÂU OÍþÔ2¿…/f0´O‚éîÔ2³J©\×PEs¨Øf/»RË×¹‹ïB.ÚAEº¼0 j;RË´KìžéK\‘*@Hj™Z‰ÍŽÒ¡¡h=*šCÅ6oœZ¦Ñh\_üÕø·Pžcƒ&Dpj™ÍJE9R/„„Ñ#—Z&sæP±Í»8r§¼0u\Vr‰@Š¡}ÊÈW.¾Kß•ºøÆ‹¤[|*¶Y:œ¨UZm\ΨK­r“/üÂb“ÊœUµë\‹MjÓøþžþ"_ —º;á¼0¥´K›ó•ªaš;"$L)íà}¤5>®¹“?)iÛ,Kˆ„l®\ÕÜ)Øà…)£ñÇâ;d7wc¿.·Ü‰!aʨUöNs×JU¯:É,Õø:U2Ë4Ó.U¥ûBxajh?êùB¹åN„˜ ß%ëùÁÒñ ?¢×É$¿™ Ÿ]Ôfà1ÇàÉ šÙ ŸÜ Pá…“ ö*~'”ÏfЦÿ˜%$„ÈÕ“m ó:î+^lZ ?lÜ-”Ù–°]z©Uª‡/6J¯®<ç*À ©„gÍZéеWAGjÇ*áÔ›Ñæ ¹Ü9ŸÄ7P>} µŽVxÛÌíó߆Öþ/Ò¾0V/´÷áÉÔ“e º&´Äûc`®›8%tö4HÔ“a k¥s{7ðÁIKN’®È󆄌é"E…µ9S[ö’ð¸pÊîy%ì6ô©x=Y–^‘–™ÿ]|Ej%eˆQÂO¦¡ÿ¦Ÿâõd[BzEZoЇÞ_HNœÑÖzSÉòÙ–mç.–gâÅýÍ8ǽRA$ëɸ„ùB±$á„[&0Í =Ô*å+êˆÎjà~|eiÖ‡öyží"ÿ}èéÖ9¾ì4iî{ŽÍ†FKíûÐÝÜëA…ûØì@ ÞFHþºTR‘¬zHz)ƒ×柎È=éòBÌÎøHüž ôHDnN‹r\›:ðBå„jâÊZ"2.Œ"Yz²Yú“–•‡¦w/‘ÔA0u¸óè¥ÁD²|Úœ0îl–N&Ä$!âE‘ ÑBÖ HSGh_¸ŸX¦P‰dyH¨¹³YÊyaxÒBxái ²1ëShŽH˜ræð$-Œ Ù:!¡)/Ü‘´^˜Rz“—©Ç‘¬z1‡/iadÛü9‚rWÒB¬Ú'†L õ%- ,#R"Y$ô aÒÂÈ ñµù' á…;“ C\­¤…eDêÙ†HÖ =ˆ›c+iadØÚü#\© eDêñ@$ë„ ¡òHšƒÄÑÙJ!¡™¡½– /ÄÐÞ©ò *¼Py ¡ò *¼Py ¡ò *¼Py0;£<¤Êƒ@ªÓæªÁÈZç¿íòf6‡f“ª9£}a-*&Ý8 ‚Gº< ÃS£û$d…ÿ;y’ê#=Ñ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPBarsGroup.png0000644000175000017500000000450414030601040023614 0ustar rusconirusconi‰PNG  IHDRÂÈL*¥gAMA† 1è–_½PLTEÿÿÿ“““á›O T¯ëòùðšD^ÿÔœ ?Uªãòä¤íþùüúõ“3ûÌnÏdýí§2šçYkÔöÞí§§ÿ ÿôÿVVÿœœÿˆˆÿÿˈÿµ`““ÿooÿÓŽƒþ®TÞœÆòЕýfü‘*ÿzÿؤ P¡$lÏt­¦…ZþX**ÿy6œaZzµ=„½L‘ÿq ݘÅ| E’yˆØ‹¼NNÿ¨d\’к“QŽ0bKGDˆH pHYsÃÃÇo¨d®IDATxÚí SÚJ…³D‚?ÚÊ­ J JÛë½½÷ÿÿ¬’ð±»aMÞMö…óL†a˜á åxN’òfãyN"Šþ +°=°=”–l|À5º-j€¨Ræ …n‹ Ý55ÊÊ}!Ÿ¿m>¢ HÝ5EʤÐmQ`¡Û¢àÔž=H¡Û¢ÀB·E @²§ön‹ê•E¥š<ókeQ÷“§(R·E5ŽÍV­~2Ö®UªíöâU)#N+'^§Çpñ¸)t[T#¨·¼nåÌ‹Í Eù|ÃTö.z ¿>¢Á|ï× Ïãg¢Ù:-/’(J%ï=ÛåÕÕµÜÞ÷^lFÛÆ)L,œïf¦Láå‡k>]Ûý3óú y8“æÔ)ÌMÔ©Û¢ HÙƒº-j,t[ÔÊÃPH¡Û¢ÀB·E À){B·E Àÿθ-jŠ”=(R·E €…n‹€S{N¬‡»áܸ,CˆHan¢r±[9kgB„…¹‰jÈÁ‹›¬Cˆ(ÒbCˆ²³Å«î¤ð¯Ï D¢oÀGTC!z=¿[kœ$¯¦Bl6?®¶OTCˆ×ê`ãíúõRáó€.!ÆÜ,cèN‘^«\Zÿ‹æˆÜÆt,X˜­IÞ°Oçå9„ØùÒꆕe‘¦‘‚…¹‰ê¬‡£†X]¦æЩ=Š4%H¡Û¢ÀB·E À){B·E pçW{X˜){P¤n‹ Ý5§öìA Ý5º-jŽHÙƒº-jNíÝÕ‘+!z^?Ó^(ÒbCˆÉ$© ‘BË(ƒí ÂB¢rÑëTª6,ÌŠt'rqþè‡rõ'W†U®0„¸ÑBe%DEÊCTc½/L®ŠY]ƒ"e„Bì wa³•¼Šº-ª#WBôý€…oán‘.-Ø°PýTdB6=…?‡‘d’é«Ü‡²´0’š7“L_%ëÁ ÆEJhaQ …üS˜æM°pû`!Š´Ü=µG A‘ÂBiÑ …H!,üSÔʽ|Ë¢AyÏ&i>¨CˆÕVX'œ`C uQ[XB„…º¨-´!Äv­N¸tŠ4”!DÏ‹”üìCˆ_¦ƒÙlµ==Ñ !ÎF‰à,y|§Bl^i–J¿¼ŒäöW "©ù8)|öÐ|±Ó8§¼¯=Ÿ"}ýˆ'£™©²/”Z‘>Qb í£ÜË·Òlù>ý‡ŽQv)T†“ýߢRa!' 7r`§ö¼‹t3H!ÿ¦y,ÜÄ>Xˆ"-„ûÕ)\ 7±H‘¶?«´Þc¤ðÝ~ÐD?¯_߇ˆ…¿\³§öTRÈ?…iÞ ·[8T/ZŒlY·G¤Št¢\³8üiÅ7¤ÐB '7R4¢´PÞË·”ÏWâgøX(‡ýZ£±¶0ŠtG‘Z²P^øÿýÚ°)´l¡:„Ø……<-”CˆŠ…®!H‡Ÿ_¤æ`:K5„x«}ÒfÉMGÓõöÒ.•&ŠfØBD )S8?ÄÌ’Çi/}!,$¶ð‡"jÓB9„hËÂC="]Z8°n¡z/_¤e 7ƒS{þ¦yŠ´ "µn!R aa* ñ«=Š),:…°¢HQ¤Û-D wZˆS{ö¦yŠEú ‘BX¸ÿî … … … Ež)· Ló~XX´…r2µPÁXYø‡•Û^XX(vZ(^[¸MtñˆŠ×n½ÐD·X(^[¸Eô—&ºÅBñÚÂw}É[QÇa!S å8¢Nb”ÂóÝ^WÑ× YŽ#ý1@ãˆÜB¹t˜ õ¦(dÜ…B¬V—§¤_>/~)¨,¨—“¡Þ…PôįUÈ溡àn¡ré0)«›¢8.Úê!s Õkm(Yß…’»°îKv*UX¸™ˆ~·ÉßÚ(ÿñ>,܈rK ÊZ£>H æ;XX¸ ;zÞ q¶çÇ21äõœ3,ToŠBÆQÕ÷ÉSØ îÂ&ý^;_è-l«7E!#(Çç…ôáÞƒ"›ø SÉYš FÉ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/nav_g.png0000644000175000017500000000035014030601042022433 0ustar rusconirusconi‰PNG  IHDR¨<ºgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>IDAT×c``bxÃÌÀÅÌÀÀÌÀÀÀÀáR=ðŽÖ%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/functions_r.html0000644000175000017500000002261414030601037024065 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- r -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_eval.html0000644000175000017500000006111614030601037024553 0ustar rusconirusconi Data Fields - Enumerator
 

- a -

- b -

- c -

- e -

- f -

- g -

- i -

- l -

- n -

- p -

- r -

- s -

- t -

- u -

- w -

qcustomplot-2.1.0+dfsg1/documentation/html/ssDiamond.png0000644000175000017500000000044014030601041023261 0ustar rusconirusconi‰PNG  IHDRµú7êgAMA† 1è–_bKGDÿ‡Ì¿ pHYsÄÄ•+RIDAT(ϵ‘Ë €0 CŸYˆŒ×];L¸¡Æ´ˆHnö“•¯uÀ.pº Ò¤ÅìNÐ b¶!Û‘[JbH r–ë„YÌða‹éôÃ/v ´&s*ºç%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLineEnding.html0000644000175000017500000006313314030601036025142 0ustar rusconirusconi QCPLineEnding Class Reference
Public Types | Public Functions
QCPLineEnding Class Reference

Handles the different ending decorations for line-like items. More...

Public Types

enum  EndingStyle
 

Public Functions

 QCPLineEnding ()
 
 QCPLineEnding (EndingStyle style, double width=8, double length=10, bool inverted=false)
 
EndingStyle style () const
 
double width () const
 
double length () const
 
bool inverted () const
 
void setStyle (EndingStyle style)
 
void setWidth (double width)
 
void setLength (double length)
 
void setInverted (bool inverted)
 
double boundingDistance () const
 
double realLength () const
 
void draw (QCPPainter *painter, const QCPVector2D &pos, const QCPVector2D &dir) const
 
void draw (QCPPainter *painter, const QCPVector2D &pos, double angle) const
 

Detailed Description

Handles the different ending decorations for line-like items.

QCPLineEnding.png
The various ending styles currently supported

For every ending a line-like item has, an instance of this class exists. For example, QCPItemLine has two endings which can be set with QCPItemLine::setHead and QCPItemLine::setTail.

The styles themselves are defined via the enum QCPLineEnding::EndingStyle. Most decorations can be modified regarding width and length, see setWidth and setLength. The direction of the ending decoration (e.g. direction an arrow is pointing) is controlled by the line-like item. For example, when both endings of a QCPItemLine are set to be arrows, they will point to opposite directions, e.g. "outward". This can be changed by setInverted, which would make the respective arrow point inward.

Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle where actually a QCPLineEnding is expected, e.g.

myItemLine->setHead(QCPLineEnding::esSpikeArrow);

Member Enumeration Documentation

§ EndingStyle

enum QCPLineEnding::EndingStyle

Defines the type of ending decoration for line-like items, e.g. an arrow.

QCPLineEnding.png

The width and length of these decorations can be controlled with the functions setWidth and setLength. Some decorations like esDisc, esSquare, esDiamond and esBar only support a width, the length property is ignored.

See also
QCPItemLine::setHead, QCPItemLine::setTail, QCPItemCurve::setHead, QCPItemCurve::setTail, QCPAxis::setLowerEnding, QCPAxis::setUpperEnding
Enumerator
esNone 

No ending decoration.

esFlatArrow 

A filled arrow head with a straight/flat back (a triangle)

esSpikeArrow 

A filled arrow head with an indented back.

esLineArrow 

A non-filled arrow head with open back.

esDisc 

A filled circle.

esSquare 

A filled square.

esDiamond 

A filled diamond (45 degrees rotated square)

esBar 

A bar perpendicular to the line.

esHalfBar 

A bar perpendicular to the line, pointing out to only one side (to which side can be changed with setInverted)

esSkewedBar 

A bar that is skewed (skew controllable via setLength)

Constructor & Destructor Documentation

§ QCPLineEnding() [1/2]

QCPLineEnding::QCPLineEnding ( )

Creates a QCPLineEnding instance with default values (style esNone).

§ QCPLineEnding() [2/2]

QCPLineEnding::QCPLineEnding ( QCPLineEnding::EndingStyle  style,
double  width = 8,
double  length = 10,
bool  inverted = false 
)

Creates a QCPLineEnding instance with the specified values.

Member Function Documentation

§ setStyle()

void QCPLineEnding::setStyle ( QCPLineEnding::EndingStyle  style)

Sets the style of the ending decoration.

§ setWidth()

void QCPLineEnding::setWidth ( double  width)

Sets the width of the ending decoration, if the style supports it. On arrows, for example, the width defines the size perpendicular to the arrow's pointing direction.

See also
setLength

§ setLength()

void QCPLineEnding::setLength ( double  length)

Sets the length of the ending decoration, if the style supports it. On arrows, for example, the length defines the size in pointing direction.

See also
setWidth

§ setInverted()

void QCPLineEnding::setInverted ( bool  inverted)

Sets whether the ending decoration shall be inverted. For example, an arrow decoration will point inward when inverted is set to true.

Note that also the width direction is inverted. For symmetrical ending styles like arrows or discs, this doesn't make a difference. However, asymmetric styles like esHalfBar are affected by it, which can be used to control to which side the half bar points to.

§ boundingDistance()

double QCPLineEnding::boundingDistance ( ) const

Returns the maximum pixel radius the ending decoration might cover, starting from the position the decoration is drawn at (typically a line ending/QCPItemPosition of an item).

This is relevant for clipping. Only omit painting of the decoration when the position where the decoration is supposed to be drawn is farther away from the clipping rect than the returned distance.

§ realLength()

double QCPLineEnding::realLength ( ) const

Starting from the origin of this line ending (which is style specific), returns the length covered by the line ending symbol, in backward direction.

For example, the esSpikeArrow has a shorter real length than a esFlatArrow, even if both have the same setLength value, because the spike arrow has an inward curved back, which reduces the length along its center axis (the drawing origin for arrows is at the tip).

This function is used for precise, style specific placement of line endings, for example in QCPAxes.

§ draw() [1/2]

void QCPLineEnding::draw ( QCPPainter *  painter,
const QCPVector2D &  pos,
const QCPVector2D &  dir 
) const

Draws the line ending with the specified painter at the position pos. The direction of the line ending is controlled with dir.

§ draw() [2/2]

void QCPLineEnding::draw ( QCPPainter *  painter,
const QCPVector2D &  pos,
double  angle 
) const

This is an overloaded function.

Draws the line ending. The direction is controlled with the angle parameter in radians.

The documentation for this class was generated from the following files:
  • src/lineending.h
  • src/lineending.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPGraphData.html0000644000175000017500000003541514030601036024763 0ustar rusconirusconi QCPGraphData Class Reference
Public Functions | Public Members | Static Public Functions
QCPGraphData Class Reference

Holds the data of one single data point for QCPGraph. More...

Public Functions

 QCPGraphData ()
 
 QCPGraphData (double key, double value)
 
double sortKey () const
 
double mainKey () const
 
double mainValue () const
 
QCPRange valueRange () const
 

Public Members

double key
 
double value
 

Static Public Functions

static QCPGraphData fromSortKey (double sortKey)
 
static bool sortKeyIsMainKey ()
 

Detailed Description

Holds the data of one single data point for QCPGraph.

The stored data is:

  • key: coordinate on the key axis of this data point (this is the mainKey and the sortKey)
  • value: coordinate on the value axis of this data point (this is the mainValue)

The container for storing multiple data points is QCPGraphDataContainer. It is a typedef for QCPDataContainer with QCPGraphData as the DataType template parameter. See the documentation there for an explanation regarding the data type's generic methods.

See also
QCPGraphDataContainer

Constructor & Destructor Documentation

§ QCPGraphData() [1/2]

QCPGraphData::QCPGraphData ( )

Constructs a data point with key and value set to zero.

§ QCPGraphData() [2/2]

QCPGraphData::QCPGraphData ( double  key,
double  value 
)

Constructs a data point with the specified key and value.

Member Function Documentation

§ sortKey()

double QCPGraphData::sortKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ fromSortKey()

static QCPGraphData QCPGraphData::fromSortKey ( double  sortKey)
inlinestatic

Returns a data point with the specified sortKey. All other members are set to zero.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ sortKeyIsMainKey()

static static bool QCPGraphData::sortKeyIsMainKey ( )
inlinestatic

Since the member key is both the data point key coordinate and the data ordering parameter, this method returns true.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainKey()

double QCPGraphData::mainKey ( ) const
inline

Returns the key member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ mainValue()

double QCPGraphData::mainValue ( ) const
inline

Returns the value member of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

§ valueRange()

QCPRange QCPGraphData::valueRange ( ) const
inline

Returns a QCPRange with both lower and upper boundary set to value of this data point.

For a general explanation of what this method is good for in the context of the data container, see the documentation of QCPDataContainer.

The documentation for this class was generated from the following files:
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisTickerFixed__inherit__graph.png0000644000175000017500000000166214030601041031170 0ustar rusconirusconi‰PNG  IHDR‹kµslNgAMA† 1è–_-PLTEÿÿÿÿÿÿ………iii±±´MMN˜˜˜ééê000ÐÐÒP+nn'þ½›tRNSªvå’bKGDˆH pHYsHHFÉk>ŸIDATXÃíÙÏŠÓ@ð=yÿ65K×EdfÙÞ’.‘õÖn­ 'AoÎLúemñ°] xôÊ¢7ArÈ}¡ô"|€< FØðœ$lX·íNj#ïP˜ÌôÇ÷§¥$Ý€*âΆfÔŒÑY>îÏ25yFÌaZË×¢™ËÁJ2›xÔ¹x§‰ˆæ2Œ·GC¼m™õº—dËe#À`¦Ì„wõç/¶£Å²™¼2F`gŒoÌ)˜Übæ™dê¡Ñ:¬ :bæÞ“œy8‚€§Ì|¤Ê¦`ð¨æìÃdl»ïäÌ@Ì”- &ˆg7zxêŒè¥¯fù¼‚ÚkáXí-ŠbÞãÎÇ–šÙº8‡Mÿx«Å¶PäÌD¶ØèÑQ3ñÊÆßþ2hf \>æ07›‹bz²hç`–YÉgå‘Ìfò¥ f'ù^ó>ùVó#IF0Ó$9_©'‰zTjæ¶d¾®ÎìHF9*5óI2ÊQ©9¨$9[™™¦Ìy5ÌñÊŒ,K}D3šÑŒf4£ÍhF3‹å¿—êÇ’ùÛº«7y)ÃÉŠñ¿3sÑY¦}BbŒ($^¼“ÊAÐ_yá:&< ‡»A³M­˜tÛ3ið+ëELŸ48Ò-Ï „5ÚnIDATXÃíØ1oÓ@àükìˆPQ„j$¯nR‰…³ß¹G29u$,®Fv¦äR]ÇHeA,K”l°" î,ÝYظs#äØU® V­ßàáÝ}zïžOQät†X¹ªx£¾tl¦–Çb²|Çá•À¸›àË$ì°X0ßo€q:X`’çŽQ‹QÃÉ”,Æ™Ø tX»ÿ`50oã¤,3@xLà‰ã…¸Ö°1–¸›ÎV°6^Îðæµ ºû ÷P1†íJ°ƒ¦m„WÝ`†Ûò ÙPÜ6šŒ¯µ${奘´ÔÓ8m`=B•Ç$áÊk–¶Ã£ú['Wç¯ !Š®{»UWÌðTÌlM ÈÃY£ÿuÃJ|0hDŠ‡Ýœxø>o%Jqn<ýP¸\Œ¿ÑÇ5!FÚx]ˆm|SˆcmüBˆÚø‡_µñ/!¾éâ5!c¬‰×>ÑÄ·þ©‰ß)üY¿Qø“&–·ä¸p¹Ä%.q‰K\â_:l|Ðhx‹Äÿù*…)× vé1-Ä}p9·Àfàó¸7ßÏäTÙ_ Ç28Þ‹{û~·É†o43%SL;4[Ùå}Êl™ãáÐ'»ß¤I3Te€ÓÐeM‹Ò!ÍV&\f#™Z}êý8¢log†½ˆ—»ʶTå >³-N^o†‰<ª-O«6,<óŸ¶e—ÅóŽ—b—¨'K¿p`v20Î7øàŽoEtÐÓ¶©Õ»4§¯ŠsŸï{™õI˜,.Äœ7¢ y=KüðY~=ot5ãè¼?ËŸÖ—Šß¥qxï³XÕ¬%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/adaptive-sampling-line.png0000644000175000017500000002435014030601037025705 0ustar rusconirusconi‰PNG  IHDRvðºüÙ'ÀPLTE ÿ ÿ !#$"(*' ÿ,-+/1/897&.ÿ?A?CEBHIGJLI4AÿQSPVXUZ\Y_a^SUÿghf_aÿlnkrtqnpÿ}|„…ƒˆŠ‡„€ÿŒ‘“–˜•ÿ ¢ž›ŸÕ¢¡ÿ¨ª§°²¯¯¬þ·¹¶½¿¼ÀÀþÇÉÆÏÑÎÓÕÒÖÑþØÛ×ßâÞãåâæèåèêçééÿìîëñóðöøõùûøþÿüÔ!ºbKGDˆH pHYsÄÄ•+ IDATxÚí‹c“HÀ±éf­][ÚUI<4èq’ƃ“«|Ôºÿÿõí XåHÊØÆ@’N~3³ÙY Ï2ËÁE›U0ËŒÝ,3v³Ì2c7ËŒÝ,³ÌØÍ2c7Ë,3v³ÌØÍ2ËŒÝ,3v³ÌØÍ2ËŒÝ,'Š]x³¸ØÆÏ’“•°»\a᧣u¡KÌxô(õ'Vµ{jÌ e6[u³M}z÷~U‚ÌØÕHÞlmXÿº6=rà‹Ó_»›ìôu¡ª=PŽ]MÊÞ_°í‰õ—í™m»È›±+>¼ Öz- bºì‡ÜÑMq?ûãz âC­èœ¢Mí´þ_k~Ó·VlÛí™m»­Œ°sJ°;e³•ý›Åõê¾ÊÛ9,ÒºúìíŠäbSa¶­¶mHn-øâÌ6wx·) 젃qÖpsؽ覼Ùî{»€éÏE³·“½]n–a;›:8?ƒ]Ž¯ú™üžÏüDEmËf+뉣Å‘Í6‡Ý‹1[ép³Ðn|œÅN®ðvzcg5{»NsfË lN°v/Ælµr-Sì°°k`Æ_`ÇØ­i˜@ÖŒ]FòfKò ÆÞÎI±óÌÙÛÕ`, ùxt „rv&Ã΋²™ñ¤UÅYìl!7[¢¼ÀŽ±cœ9hÆ®»µì;$w\›cmw;È°ƒîìíJ°Cé­ºäŽ %ì\dó°k2ìÄ°Þ)™m{윈ЦC;4,` ƒbGš-ÎÐØi‡½íRc¿=aG CÔÙèˆòH|eØ9äРç@†Ý°Oÿõ±‹"‚°“uŒ ®€`IÈ5ÕÈbדµ¾ySõù´ÒϾ_žÝ<ÔýùeJ{x{ö–^|ñ/ûí!ÈF&ÅŽÜì ‘Ü7¡A±ƒƒb7®[b§i¦v;z‡¢gAì1DÙMŠÚõÓªº¼ôë4V(·†ÏÿüÑÒPÿ=øõpN{…ùoVM± °Í@c’`Ùü>qxzv=Ù‘•Ø;ÈØ!FÅŽ<Âþ‹ŸaPRì`„#—ÁY8ê†Ýjó™Nmþþ¸XnÈçûï~±¸ÿùL›óÅÇߘykÿ2c~ó/þ|±øð‹_x&þO®ø¼X>|^¼þ'¹Xªö×ÅÙõŒŸWü-¨¼ûJn¾¾Ãu)jØišS Lqtì>dì."¤Ø9¨?g7®“'K̶;I |d‚¼ì ¶;‹h’.ä(èb­ÏççϺýùxC>ßÛž}$*Ônþ¼ý”ć«ï¿Â_nŸÞÿɯ¼ùøû?¹â㯿ÎÈïUæbúsÿøëÓ5y‹»0¼*¸x$7üõµ®=Y˜™-Ý·ì¡À`—˜m:Ò×YFW¢x²±·S“b‡H†:‚jØU6éo‰§ß#$ÆòC|¾_¯Ég¢ÇoQ›"ÆuI”^ˆfÉêõâ}(]ñ„ŸéïYæbúCNúu–}‹³gúm%Øá±+Ñå`×%Ý4è)¶ôüÉ+Q<9 v$Î2ìX‹`·î†Ýcü÷üOx¦nçv¡i¤±¥=§X›§Åÿþ·xÂg¯^É.<üóFº'¿ÒÅZÚ Žß¢ÈÛ »¸ËÁQOŒ)(QVš"v¨£ƒaçäîÎio­!Õ€ö*L¬èÍßO¿Ÿ´=CÅï6›÷_>f/gö_!i,k¨â%dCM›%ýÙ21Åÿ.ÿOç½OïŒÝ$”88vF|Ã$ØÙôöå½ýð…´HK‚|¾åÃó÷ôÏ$Çw¤eqþƒîï——¤eòåöÇïß ÿçùÔP“+$‰‹³“›%I'ì€Þ.Óö:ÉtP‡ ; %Ž]ÚùH'7ÄpqàµÃîí?ôöŸ+ÚC:ß0Íœ]|Õx?jEú—…ø›/Xkäëe2Rôpsv~ÿ(]!iL\œÕ}‹Ïq äáòìò‚‘ABØÑÛMB‰‡Ã.Z!z[£ž'w:µW 5]¨|Äa±Û÷|º”?™ ‹æJ<v ‹mMYcÃÇÛ?‡˜“…]¥º_ᛃ;“cgâ%=o‚Ø}y}¾ú5iìÒ$©ÉÚ®Š•'Ç@w‡Ç&ÌâXKù3‚†Ö:‘4Åæ“c±‹,®¿¤wu’Ï¡¼L•´Ž)vpw"jS˜Ëaš7ñ²ØQïç'b¶ƒbvb%AüÞËÁn#Ðœ@Ö«È`gÃÙÛÕJtŠŒ±ƒ)v§º„'ƒèŠ E"(ÇÍØ©:<]Ä°‹¦íí`ÏÞ®+v¬ygÃd5L±;Õ%<=açQìèš3—`t0iìÀÄ°3`;wÒÞN^¶?²·ƒ;:~¼ÃpMsöRì&i­`  ö°ÊÝ lA±Ê‡#O;¶Ãn{©]øýbdzó(v0ƒÝKòv  »ø9P‘£bRæP»)šm;Õ »]nC?ì;6Uæ ‚ä~“Í6¦ d¼ˆ±ªØéIRü©z»ëmÿA6aÏÔ‚áÇ’Y‘ƒÙŒÙ&ØqÆ©—k‚+ º'‡¶Y.Wƒ`'å§ þÇ×a7œ·Ë˜mŒkR$ìdw¨<¨2´ÙÖ¥˜ödCí: ¯6É°rócEØ©Ö©jûC°k{-(©˜¥X»8c¶o'c—¸þ;л‘|ÖÞ.Ôˆµn¯†ôv ïv§d ̶ÀÛù'ƒ*è n¶Vë· ÕTÍV:\; ÑÚ:Á [`¶ìb‡Óæ®hå5ÁÎãEòN'Èâl­ƒagéˆNáE'ƒ]ÙÂL>s?‹±u3fiŸNÅxµ¸K!nèw‰“ëÉfÍî #íó“EÈRk¯¦ƒaYIr ³ÛãÇn€YŠBì õv»¨£ošœ·S1[Xp?…3ã+…‚`b¶6ìÛld„oቪ)½c‡ÐxØ5Ö,º'\`]‡–g}ö?I{ªÞŽ‰O±sÖýÙZì4'Û`µSvuàÅ_rïØ9ð”±ó Xkô½(À(aÇvðŒþƒl-vÇdÙ’n”ÁÎ}©Ø•DÞjì,Ñy³·ëŠúd®ù2‚l]ƒ¯v¹…„]O+|FÆN<!P‚…&æ횯ë¥ãÕ»Ì&5Æd+” Ü#Á®Íʱ^†šö²E•°ëP1jowЕc jÕõ`W…Ý ²y*°sŽ» y;‘`£“ôvC`öË”é0nÓc7Ù²9Z°cÕðfìÊZ"Rn((ÊzŸ½]›­([1ÙJì@v&4<{Æ®årÚÙÛU`WÍ/M˜ƒlKìÐŒ])v"'¯ v³·«’ ÅŽ&Ù@¥àÛ‰Ù83 Í*¢±k,–…€Î»d†^æí-«ºH±ƒ…A¶»aƒl¿“c`Ƕ8ìÀá±Má)vàø½5[X‚lòØ•µð<3ÝD‚ì¤&Ç š1;÷°Ëg­wóv¹ôPQîxöv­FRèþQ¹Ö¤‚lØÁž°°´cáð.mäÍØ5”("Ø!šŒw"ÞÊÑlÚzKa)wbsZ›ð×wŸ{²Š¹Ÿ1vntrØÁÔ]uÁ®ªk¶-7Dðh¼ÝêB;Ä:ÙºZ¯7{ìA6©6¤›=òúÃŽnÏ÷­ÝÏ6ž(v~úËí¸Ø¡Ôë9Çæí¨Ùn²ØÁzì ä õmKwŽ²ãУ ²áåÈØ%^‚¸àB¤ v{f+WK«=%¥ Dý‰dƵéZ‹¢­žÃ…¶ÁÓÀNçØ9Ûþh‚¬l¶ráÄl;‘´)a›9< ;PX4@nÝ% +¦Š]n~2¾7ÆD…lío2öƒ¸ìœê]QìFªo—1[X„]¶‚qÌbkìjêâa^<ÝÓïÉ®VÓðvD¥ë5¹¶š·›BOvÏlÕ°K«h·à®»o¦aB©ì\Yý¹Ì]ßnJر8K°ƒSMõ—­þ_™ZÚ"‡¸GìØŽðž©æíÆ ²j­ÛIaGŽÇÛcW*`¯„{’ÌÙxº¬tÆÌ€S²w íj‹'ƒ]쎻ŒÙ*aW´YJã6^Ýž*S÷vS˜¥È§ä°s£ ÙŒÙ6ÜÆ3ƒ]³h;c׿"‡Žer¬j0¿-ÏPØ•JyÙs²û£;jk­ìô®¾Ý×=PB´Œ]½Ã›½]‚AS?±É2¢ÚYÏ>üœlçMÛûÄ.°PƒbgŸv@`t¸¼j쪼êúÇ y;Ø Ô¦_”`ç"X‹]U ,%³µû ²°hžvËTlº˜‘¼›î½Hì`qz^}nÈe@¾1hKo§¸þ±¯% ±¬÷Ic×æØA†Æ;ÃÅ&­ F¢ˆ,ŽLZL"8Äx Uþ‘x»-oçc—JŠ¿áÎPmšV;PŠ™lÐè™ûAŒd“aeŠváÚÙK´fØÑ„$‚ ­ëÇ›~Án'°óöT3 vÍ'Ç°Œ[„)7÷bìŠÚw{=uoJü">,,âêÓòvqc~°Þå_“bÇ2Šv;O`÷Žéѽ&†nà鈶‹¥ô;eìdNYß‚Råd£…ÜÜËÜWJăª]‹’¼Ò=ìbý ƒòä˜ô¦ìÛØÃÎÞéü <¦¯ä³Ñj°ƒ·ïbEÉôy»æØI_†ƒ}˃ùÚ4+à¨9À¹ØRZ÷£†]®vÈ%“@±à$‚lþMwûŸF7d%¦ŸÍp˜ËƒÀnú‚bÉ™“Åsàö°cÑ•…·H@˜ºG…\xeì€vÃz»vØù…Û•f±Ã‘Døšu÷M}Ðî¬áµÁî@A¶»ìCrÓÏð¼lÊJñ ÅìììˆSõŠ±­±=cW,k«X…»ÖÆÐy)Gâí|\´æ-‹]õªD~°cèYÐ:È‚>ƒl&¥¹Lô]æ0@lh Ý¥=ž [¤3·ô$„‹è`r§Œ÷:ìà$¼]x¿Hë³U€[!ɉtÑÍ°ƒnàb´ó@0Ý k*f›mÃx¼û‹kÆR êH ˜0v«›ÐOJÇànâ‘îíÚÁ¨QRv»FžLØ»á¼]Ÿf+cgVa§2]sÓJ•*<òEy†çÀñ‚,E.©á{Š¡‹¤5§€]ŸfK›‚†‡+sAð*°câŠYᑼ]¨…o®ú±ÖxÊŠ¦Œ¸ñ@Û`]ZŽ]d`‡v ²˜­„jÛÄKK×–ï+0"v>½»½L†•‰ø…üÙßè ú¶4ô›iýEß'Øe>t|ßBµŸÓvè‡-~N±¬âfK‰3ƒêüwy§ž ì@v ²t“¼=ìhÊÀ A¶Bmí…åKÙv9›ÐjFiG ÀÛѼ… «›ƒì fK‡9èùÍo‹±+"Ïâ7>ù!& ²ÆGdOTË7“^ªn¶Jm»ÖÖʱÃ1vC.º€xM—÷Ðt,» ;_»¦Av³…<“€õ0Zcª±‹K3§–÷v¬™~N¿'›ÅnÍæí¡Ž†œ©%p»È¥i Æ(Þn³…‚8vƒÄN¬fôˆgpÍ*ì|UìT{²å]°[³Y ĶM †\íAòêúvÈ>vC˜-dٟù=`—¯–’MJ1vÖA½]ùÃí­u·‹$ì"0tJÜÃŽ´ZŒnAvgu·ë‚“Æ+5Vj8CX’wÌ°ã›Fía‡Fî³$Ø9‡XkA°Û¡2ìš{;æ,ÛÏRt2[ÏåÆØ™åùPû ÆM°“(Îö¥³k/šY–Ã<v;Ž]ÑÖpÀу¦C£]ØEv'ìº;='Ne)–ÜÌCx°jºL»d©…S³äGÁÛ±®Êaƒ¬Œ&Øí - Œ]D;n‚ÎuÈŠ ¶²;L »’…µ=bG‹âõˆ]äŒæí ŠŽÖp08'*r0‘Àˆu¡¢š@á˜{¡·sŒž°ël¶{ØY%³e*K÷Ô°s`»*³­ ²¬ÚÔ(؉Ͱ#úù–5p*žX¹” v´Q·6§âíLþgPðW¾Â§3vbN$‡S¡¿Bo'–5Á.3¬ÜÙZe9v:¿ÙaZ+-ÁŽ¦úÄUÔbG{$>ÃŽ\«ƒ.+Çz“/‘CnâùªghkSJgÊä' ×è„Éãy» vaw€z=˜;“è1àØíx _€é¨Dd—cçÂH·v´ÿ" ´^9Ö»Ù2ì¬ê9 Õ¢ÕØAf±fëÔbç"¾Y\¾Åʱ!$Šv»C`‡<¾Ë’°£;èÑuÝ™EI»ÝZhê68v”^4r•…º¼²Ö]ܾS+ZQ‹Œ± 8ZN\z›®¬ œrìè¶Àš[p”žlщäo7'Ïyì|öHØÄ„u]÷(v6´-Úóáõáv¬{<ì˜Ù²6^vJ•?A=vÃÀ,v†sÁV`ÇË D¼´ ر•'áíÄtmPšLÂn ñΖ°3éX¬¾Žh™Hd0ìL[&çé@ßÅ/3nO¶èÄú  *©x5ØÁ=ì|Gl±cGª‡ M±£^Ž£–žÅeBØ­£CÔ>fa–â…ˆB-IØÑ4…®uÁŽ­³íîd2oZÞNL×OYôŠÌaçYv̹ÑÖ½fØ‘#‰Ýã h˜]°(ÈFX8x:ÇŽV±`Øг8v;Öë¥Øy; 'sç©YL;£tÔX±^EÑ®ï¥Ø1¿çé’ã9+zü)bì˜ßž`ZÞ.ˆç½V‚•€tˆž¼sÄÐ=B6Å.MÙHeŠA–VáöÊKâ)c²Ëo Œ;#žÓÆ}1SgagO »(vM§‹c‡·»w–®'dBVz>Ùô%+SôvŽáÒÄÖêõÛ°nEc\°±;Ãp’¤1O”¼HZ׸‡œZŇÄ¦Ë ânZÃ'¿ðà8°‹«ù쥖bK:\*رwq’ø8€rët´Äî‚6¼âbì¹£”g1jÇóSè´éYœ`ç”b¼€jØí÷`ôÜ[ƒŠÒ-“ ²8©¿ /=l§YŠ¢l vùrÛ ´"vû¢«Ön–bkbñ=6˜¶L/ÈƵ=b °•<)Ò9%o—`Gç«ÜÃlª2vƒš-Ov· øä»´•K“}£^vë5ÇΛ\³·kkK2?ã‚;j-‹t2w*Ø j­Dlº´JâŒ]›&²[lŒ8uoǧ’#´ÆÀ2æ ÛæD•‚7K±SÚW@òŠÅn{©-îÃq°ã}ÚÀ˜½];qäâüÐE[ìöêlŠï‡áÍj kMµ§¤Ÿ‰b7ºÙnõZF5ìàv #v 6ÈÞ¯FT[2gqœØMÀl T•t¬¸ï{; „hÝv©Ýá±±³»I˜mù7¯ZV5·¨±+v⫼]è_n’QvZ(‹™•OìXÜ©ûñ±ê™e?Àƒ i§Vßnf[ZrVq3‹;l¬ŒlŠÝVÓ®ù‹±½­9¤O ±Öq›Ä;Z0 aob þf?\.?>cùkÑÄöy±|ø¼xýN.ì×lau)¼LÙ: åÁ´£!'%C¹ÜÎ^!¼Š >N¬u¢=Ù¬pìÖȘ„·»¯ÀŽz»/·Oïÿ$‡·?Þ~bº}|¼ù´ïí(výuF~¯praÏÜñ·•°“VûdVwËiz™RŠ °Ã›åä»yì ŠöèJ‹Ñ±+5[êÌ–ø’4ï røãoØ9oÒ»{Ø=ágúK¼d|a=Ùüèqå´EAnT®0hv°)vG0ܙÎnZO°‹†OÿTQH™Ù’ƒÿ®ðÙ«W,˜jϘÑDw÷°ÃÉo|aÿýZ£º^E¶6ìv¤¥ì²ØÁ^°›l…®… vàoO[t™¥ Ë_—âPÍÛ¥ØÅ0œB×2Rì ¥MvòØɨ`OÖÛ‘Ž7qìðý__nüþ÷9¼ûùó.mÛÑfÞù*ìâ û²Žé±1¼*‡W‚]Zɸ;x‚ØEv‚]À¼½5]ì¾_ᯗgoxOvõ,÷dñ—…V]|á0ƒÇv¨è×c§7vΩYâètŠŒ0cÎî3Ôîp§”‚ħ¶Ø=}Xœ¢wþ½;{ý7þç5ÍøþæwØC`çž®·cÉl„1ÁÏ€6Øyw·ÛK|j‹Ý‡waøîoŒÿ{ý÷Óã;üöáá-þ}ùЋÙ2ìt:€lô‹òð cdž¢8v.$˜µIDATÄ,Öê@·;sG+ww.–Ÿ~\,7Z:0üûÓÅâ Þ{š=Ër¤žÎÿG>gÓ½ô6$¿ûÊN8ûý|†¿Þöd¶qïÂÁûØ™]B,Ƨd™ì¬ vkŠÕÞé±iîvX•øôéöçã„Ýç›ÿž>⽧ٳ±ù »7œšüÓìYž*ðßÅo¼Ú²GÞ¿Ã÷¯0~Eþ÷'m»¿³^/fKwhÌag¶ÃΊû&NþN»ÈÅ­±½cKÍvN<ZAúsfvCGÝNÞNN|bÙNvô㽧ٳ"1ê~‹/ùYOïËÏKŒÔëÓG~œ?]Ò^¯O`G»›8«[j%§èÈ÷ša—V>¢ w-(l`‡ìpŠÝŽtsYê@;ì&×ws:yÐv`ݤƒZÛNJ|ŠÝÙÙ/šœz»ÜÓ’·Ãþµÿ!}½¯ï1¾cìn¿ò^¯Ø¹Ö6˜/÷IæÍôâ–U‚/wö¼àÒ)³;ƒa‡vÛîB rì °cuáQd;t’—åVµðvZ>….M|útGlä±ëO¿ÿÛv٧ٕ"G _߈(úþñiûš„ã¿yÅøáíoÖÂëÑlƒx@…º8'3¢ã„cç‡ÒnCü¬0?É‚¬-|ö‚° °XÏ "“y?‚Ý@^‘JÅzv¬62Mh€tˆÉ±Ó»½ƒ4ñéyµ8§]Õ×g±žìkÖ“Í=÷diŽ~x-^ëï×g·ÿÒ;ŸÎïŸÈÅo¾c\Þ¶ëäô,¿5e;Œr=;›{G;à:…ú;µžl1v\+¶VχÝC v ìÈ5ö‰Þv½`׃üõçáÍ6ÎÆ£Éï¼Ú;ážo*¥ÓC÷°sDPƱ;bog¤Ø!Jër8»È‹ÖÀaGâ°Å±Kô> ì~]þlwa³•°Kv‘âûúˆCG^ÿ#Æúvº‡}š1ÿ±K WèYì„VÉà$ØÖ‹a±„AîzhØiÚW<’·³¼;ÄC.F®À΋ØÖðVŠrÅÀŸ4ø‚ì†ÀÐAz¢@`§ó 0H\_Šß…£Ó2[:˜ÇüÈ[ Oø@Ò:q­@9%~ÿzQúŠÛm²+Øæ* ïïKÿf?A}ã‡þbÛEÁ˜íæøͶ»ðÂ×bþÒÍ>Š¾Ó»ÍtTµ‹B(±UÛjÁ_„µç$ª½ö_m‚Ý=QÅö²‚•mÑUmd6ÛB³­Áî~ëËj».ÿâC»Õ}ù÷°Ðþ›û»ÅU]æ1ýzgÆjÛ¬°v[ª¶•"vW¢ìl¶Åf[ƒý$HhÚ²Üo°¤¶ªÏž寈+ÞÔé$ 7ËZµÝ¬â/9TÃßkÚu¨¦¶8—©•Ìf[l¶¥Ø‘/fƒ/ý»í…·EÐý ,aWB{EéÓ¯¨¹\”*e© e\Ö’¸ûyýÂ÷'&j[Ý…áê¦üDIm›Ë°=u³Ù–˜­VmËåB(‹½å²„€-?±^iò§gŸç¢ÞëÚÄ÷w 4‹åR[lêÕFßÕ×TÔ¶¹hIÝJÕlWªf»šÙÞw4[­ÆVx‹ôrÃô_Þ:%'nnø‰Õ=¿ µÖ-;1$ÿo«­Õß’×­1èû›0äS„UïÎÔFO¼#Ý°ÕE vôÄÍÒoïëf³-5ÛÚq;öêT«å¢ò`ÖJ7¤¿‹²³î¼»N_Ñ¿ÔjÚ&¤cµ¸ñk¾Z*„vñ¥•gzâŠH‡Ê_÷†ž¸e'^лwí¹;³]µ0Ûû®f«4Ká«*¾ÿÕG*6£8›mc³'Ç þýh'NÔlgìfAfìf™±›eÆn–Yfìf™±›e–»YŽKþ’?JIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPaintBufferGlPbuffer.html0000644000175000017500000004157414030601040027130 0ustar rusconirusconi QCPPaintBufferGlPbuffer Class Reference
Public Functions | Protected Functions
QCPPaintBufferGlPbuffer Class Reference

A paint buffer based on OpenGL pixel buffers, using hardware accelerated rendering. More...

Inheritance diagram for QCPPaintBufferGlPbuffer:
Inheritance graph

Public Functions

 QCPPaintBufferGlPbuffer (const QSize &size, double devicePixelRatio, int multisamples)
 
virtual QCPPainter * startPainting ()
 
virtual void draw (QCPPainter *painter) const
 
void clear (const QColor &color)
 
- Public Functions inherited from QCPAbstractPaintBuffer
 QCPAbstractPaintBuffer (const QSize &size, double devicePixelRatio)
 
QSize size () const
 
bool invalidated () const
 
double devicePixelRatio () const
 
void setSize (const QSize &size)
 
void setInvalidated (bool invalidated=true)
 
void setDevicePixelRatio (double ratio)
 
virtual void donePainting ()
 

Protected Functions

virtual void reallocateBuffer ()
 

Detailed Description

A paint buffer based on OpenGL pixel buffers, using hardware accelerated rendering.

This paint buffer is one of the OpenGL paint buffers which facilitate hardware accelerated plot rendering. It is based on OpenGL pixel buffers (pbuffer) and is used in Qt versions before 5.0. (See QCPPaintBufferGlFbo used in newer Qt versions.)

The OpenGL paint buffers are used if QCustomPlot::setOpenGl is set to true, and if they are supported by the system.

Constructor & Destructor Documentation

§ QCPPaintBufferGlPbuffer()

QCPPaintBufferGlPbuffer::QCPPaintBufferGlPbuffer ( const QSize &  size,
double  devicePixelRatio,
int  multisamples 
)
explicit

Creates a QCPPaintBufferGlPbuffer instance with the specified size and devicePixelRatio, if applicable.

The parameter multisamples defines how many samples are used per pixel. Higher values thus result in higher quality antialiasing. If the specified multisamples value exceeds the capability of the graphics hardware, the highest supported multisampling is used.

Member Function Documentation

§ startPainting()

QCPPainter * QCPPaintBufferGlPbuffer::startPainting ( )
virtual

Returns a QCPPainter which is ready to draw to this buffer. The ownership and thus the responsibility to delete the painter after the painting operations are complete is given to the caller of this method.

Once you are done using the painter, delete the painter and call donePainting.

While a painter generated with this method is active, you must not call setSize, setDevicePixelRatio or clear.

This method may return 0, if a painter couldn't be activated on the buffer. This usually indicates a problem with the respective painting backend.

Implements QCPAbstractPaintBuffer.

§ draw()

void QCPPaintBufferGlPbuffer::draw ( QCPPainter *  painter) const
virtual

Draws the contents of this buffer with the provided painter. This is the method that is used to finally join all paint buffers and draw them onto the screen.

Implements QCPAbstractPaintBuffer.

§ clear()

void QCPPaintBufferGlPbuffer::clear ( const QColor &  color)
virtual

Fills the entire buffer with the provided color. To have an empty transparent buffer, use the named color Qt::transparent.

This method must not be called if there is currently a painter (acquired with startPainting) active.

Implements QCPAbstractPaintBuffer.

§ reallocateBuffer()

void QCPPaintBufferGlPbuffer::reallocateBuffer ( )
protectedvirtual

Reallocates the internal buffer with the currently configured size (setSize) and device pixel ratio, if applicable (setDevicePixelRatio). It is called as soon as any of those properties are changed on this paint buffer.

Note
Subclasses of QCPAbstractPaintBuffer must call their reimplementation of this method in their constructor, to perform the first allocation (this can not be done by the base class because calling pure virtual methods in base class constructors is not possible).

Implements QCPAbstractPaintBuffer.

The documentation for this class was generated from the following files:
  • src/paintbuffer.h
  • src/paintbuffer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_n.html0000644000175000017500000000245214030601037025072 0ustar rusconirusconi Data Fields - Functions
 

- n -

qcustomplot-2.1.0+dfsg1/documentation/html/functions_x.html0000644000175000017500000000250514030601037024070 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- x -

qcustomplot-2.1.0+dfsg1/documentation/html/bdwn.png0000644000175000017500000000041614030601042022276 0ustar rusconirusconi‰PNG  IHDRHj •gAMA† 1è–_ PLTE2JŽ2JŽÿÿÿ“‘tRNS€›+NbKGD Lò pHYsHHFÉk>IDAT×c`b`€ '†I i) RرvÚÐ!%tEXtdate:create2021-03-30T12:49:02+02:00gq È%tEXtdate:modify2021-03-30T12:49:02+02:00,²tIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/layoutsystem-multipleaxisrects.png0000644000175000017500000000553414030601040027711 0ustar rusconirusconi‰PNG  IHDR,ÚiðgAMA† 1è–_½PLTEÿÿÿÿö½Lxåûÿÿï¥+/›êúüøÿå„bËòýØtE’ÛÖÑÓùóÌŽ: ‘Ø÷“““5¦ïöÆmkƒ¯Óðøw0 7°òÿç§U'g»ï OÂTÈh TrWÀýþâæΛ?˜H $-dë—(‘éÿÖýÿæ> |¨Ð¦Jÿí¼L°ïcÂV°ííîƒå}â¨d\’кÐeCÿé—ÌÌŠõbKGDˆH pHYsÃÃÇo¨d ÆIDATxÚíwÒ:ÆŽ±Â€KÙDv7Ce^½çdS§ßÿcÉ`”p$º¦äIúüÎŽÎÓ¤>/ïRÚ¤R!„B!„BÕZEu×2èxÍaã(Žc×*è8¥Ù:v-ŽEÚ(êþãZoèÕ“~÷dùk´äô´ÀŽ¥4[G+y®ß{Üq»õ*›¼SÛ ­ŸPÓPëøÔÙÁëaröï¹Z^A/K'T44rì. ‹!îÍåê÷E95õë19.G†9v—!Fò ~Y¬ò‚Ü13Dß}¿b:Ä…™c€˜º pÇ,Yúz`#{šTàŽ™!úî,Y…6 % Áî˜ó}÷}tFÏò½,{ˆÞ±Ë€$ãH'/0°ÇW“qVy~gˆ‰c‡2x{ùN'¯ˆ—¥Øªš8vdü~šÊ+Å]'8Žw±Hßói©2Ä̱³ IjË÷ÈêV×RÄ̱³€Ä½^ïzüaXQÊ ‹Õ¬‡ÏbæسK'¾Dïس€¸cfˆ¾;æTá$1$À³dé»cfRè½¼`wÌA]ß3C Hæî˜ pÇÌ}÷Â4ÿÛ<µ]Ž1ÄȱÇ>?ž$ý¬}zŽ?uÿÏ&Ïë 1rìtP¿ܨåô²xBuC½c‡ù<.ÁM8Že$ýî±úýbô—6Üs†è»‡4;Wþð= zÇîrñ¥žÜfͯw|5>•›vò:CŒƒ\:)ÅÄÐÈ1H@Lݸãr”,#ÇžeRè<쇄 Ü13Dß%«Ð†¡$Às¢ïŽ™!á$swÌ€¸cfˆ¾;æ<$œ€à!_ÏfQ÷îYž©[¯w<øø%9›”j©qÇnKÖ§7¥»ëDçØi@âÛIÆ»N|ÜñÅlõ³ù=§¶oÀ°~Bu†dw\„R™ÄAëÛóYe)YŽ–¬Ac^¯hä…¶ãvc>¼¿³Éó:CŒ;ËøvYEVòÊ014s 2S7u àŽËQ²Œ{–! H¡6ò°¿ò/pÇÌ}w–¬B†`wÌ ÑwÇÔà '†X€;fÉÒwÇ̤ÀñÕìûZö4ÉØŽ§ýn'•gÚÉë 1rì.C¦?~ÖJÇ.Çjö€x¸cA^Inrxã}Þäð‚÷‹×%ËÈ1KÖ>wÌ ÉÒ3CB¤N“ ÜqY2ÄÀ1H†8zY¬ò‚Ü1¿ ÒwÇÌp’¹;f@‚Ü13DßsN@C‚Ü1K–¾;f†0 …ÐË+¼¡«ÿ9<ð¹#.MïäeÙs@L» H³1OúY—Öð: FŽÝxZd¢Ý¹Ûj!û[Û°ƒc§üÅãä¦rØxðåõµ¿C$~<¸©T­¾A‹BB ÇÚ÷K9w,VÔrîøwc>]o"WÐ/>•waß.tL‘ \QP#<ð¢D\þS…¸9­ŽAgdЪZ[|¨<¨ëšIËJ©,ì–¬—(^QP">ð¢~ñ„å?Õí6›ÓjHÆÑÈ Ùaã(Žc]+©c©C©#…‰d½DãOƒâ/ZÖËjÛuMÚÅW“ñÈ ]³ul¨m§c¥C©£Ýd’õ3Ì—ªÆI—ÿÔnN«fðöòÝÈ ]»cRŽå¥Ž$d’µ·®(h0Hºü§asZ%ÉøýÔ( •^=éwOÔmTŽå%Ždä’µ‹ÈÍòŸÒÍi•¯àÕäÜ0 •§š {/¼$CäŽvZPKVKÌpEÁ4 ÂòŸÚ—¯£O¥¤¶¼$§ÿô´¤Ýz¥i¡p,s¨r´Ë‚Z²Zb†+ †—ÿT!nN«"îõz×ãCýÿó8¹©6PU–. ñãÁM¥úkõaDöÊ®€le@C¿óézÛ<‚ÀbÒe‚B|C¸†’á |ˆ+¦æBÜð77ƒÎÈÂYªµÅçÞƒº¢…x %â#@9­ +¦æ<ÑfÃß¼$ãhdá4‡£8ŽU-¬}þÊÏzÅÔü'êZ9Q|5,œ§Ù:Ö´°8C¬Ú Hºbj^Ò s2x{ùndá<펦Šn]Cɉŀ¤+¦æCØð7ÉøýÔJ@*½zÒïž(@fÈfÅÔ¼¤þæbQ°Î-¤òT¶Tï6‹×P¬DX15¿ûŽ…\KjË«‚vTµ[¯G-^C±qÅÔ\ˆþæ"îõz×ãÃüg¼&gê—ÛÞ5KÙZ15↿¹±S².ƒºaB!„BH üWºŸOLœ%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_11.png0000644000175000017500000000132614030601042024471 0ustar rusconirusconi‰PNG  IHDRƒ#ˆqgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>IDAThÞí™?nÛ0‡¿Ô–-CŠ.=ƒr†AçIÐè®ÁÞ<Ô‹s‚p†l‰Ç.™:¤s Uƒ¼ø^‡ÐùDKBKIÀ“ïý(>ýÙ!ê~è ^‡" b°Š0›Î_¾]KÏúÈ¿:†[V]YZ±rFÆM-‡®­G]1wFñÚD VðÆ0$;;r' $$$\T‘+/’ØöË%/*;iÈèj^Žª†1 &LX0¶‘9¿ùc=k >ó½mÚóµnÌd,¶€x–ÄêRŒ„eäRyŒŒ”CD¤¬²~ÜH*Æ™cœ‘Ÿ{”#1ê(¾ÛÍŒc›žY—÷ï:aÈm/¯È•C¤”oy·œTJuüÁÜ‘¤RzµÛÍä í ÃSû© Ù¸Kg4RˆJÏ™«¹ÚÂòèh†N—Èkõ 7µÝºfÍ·-ó?8ýE0W—v»ºiô4ͬ«†Œ9S–L™“ÙÈŒ1KZþDXÀ—`æ³Ú }ؽdʬzô=­ëÔ¾)DÎíéu¾%âϬo wô43 æk'wÈmT5¾'µGð£m›¢©(å½ÈÇ`ºž58OçïOoêfzwŠ€ˆÁ*b"«ˆP¯dw÷Z㵫Â0º’ÞõÉéïÅ/ÚÄ/ÚE @Ä`e¸º„áu|úûx¬ÌÝ®e%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemCurve__inherit__graph.png0000644000175000017500000000211714030601041030041 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii222OOQ™™™………ççè±±µÓÓÕ*P4nn]L&GtRNSªvå’bKGDˆH pHYsHHFÉk>9IDAThÞíØ1OÛ@p>B/Ái„h®ÂV7UíµÄÈÙ~‰)E:òrÕ1‚`h‡J¨R—N±T];T5Tì|†JÝúΗ„£íØ®DiïYëñù| â?ArÕ í± Ôµ ú¢›ÚÃ5o¥ž¹ùÿyJˆëKÐÂØ0 -.NíÍV-8o,£ÜÉäR FU\u^ uJ>4Û¤âÁ¡AŽa+Ò¯“ 5Žöï?E²Y|a›Œxû–A÷h²—ÏoedÕÀ‚ø‰£€Ž1ÿða×Ô¨Yâ)1æ¤_gý¤÷÷élŸ¼~Ç–óo|´’ßžã<;%.©4ô%°ëWÙ?öîõWV~µ™ÆÛ°‘ÏG—öÒCúRýÝZDÝ?©«>²¦ÏâÇ“üÛ`+—¿ Îsù‹àK_‚oyüLœæñÓAìæðŸÐÿÈá/ÑŸçðè¿f÷äñ/ ÞÏ–Ý—¾‹Êñü„Äoíµ×^{íµ×^û,>>ûùŸ¡Ïý\e@Â[$k™ÿ®§i½šý°êÀSõ©ãÕì§i¥÷JöS^]YEZPýžR€J³Csà ãÊ+ÙOÁZ ³’—"8‘ÑÏ®¼¿ƒ¼=o˜ðÐ.VgEV3éŠeèG?ýù‹0h 3rp„ž¼w’ÑÏÀ…'#¼’ýl’âοxÈȳ~ôƒóÇSãP†A£¼’ýødŠâú•pÝl*£Ÿ§“ àQþ÷ì'×þÓþÖø ÙÏ0B™ýÄç?2ÒùOì°Îtþ£óíµ×^{íµ×þoôËòŸÇŠÏò¿‡£x§/íõ=Àß6¬0hqŸ)—boßyÞYyÕª=b]ûš½q¼Ç{>Ã;1nr ‹Ópaçö÷Àáf »Þá]ŸÕñZyÿí%›»sîœìááÖ¼!ºI^>?À–ÇÞánKtçÏCÌÇð™8{~X„·qýzbýB_ß~8+}Ø[jâiVD7éý ¿ ݦ'½èõ@x\t#÷Os0¹ÙÚß”ÏûýÛ­¥¯ù±þþ$Ôí÷VN©{?Öð`Ï8¶%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPColorScale__inherit__graph.png0000644000175000017500000000213414030601041030163 0ustar rusconirusconi‰PNG  IHDR‹³Kò gAMA† 1è–_-PLTEÿÿÿÿÿÿ222iiiNNP™™™………èèé°°´ÓÓÕP+nnx8KtRNSªvå’bKGDˆH pHYsHHFÉk>IIDAThÞíØÏkÔ@ðþ ¯»Sºm¡Ö›K]=m›Àöæ$yi´xXìB=ö_(›’[ÚC‹7=-âEðàЃGÁýüœ—ì¦?6É$› UçÂd’|˜yÙÒîwª¨¹9Åä`V× W'ÁÂJ»•ÀØ…·RSÌÕâ,SGÀÀÃ-zfVÆ8ô:uûu‹5úeêœuèæÓðìr8}ßÞm0qÈàîɘmXæl$ž¯f‘Ûð²öÊKLz`·<<á¹™¨7rž2Dq¡NGq¥Ìå¦ÂFØgœé-r9°ÍÓˆÙ.Ðâˆqù"îÕž¼%æP‹6µö©%c&/\ŒÅâû& –Û¶`P›´¸#c´£ëï¸qRªÐ§{•0饘?Ã`ñJbzJï¤]&0©|‘Þ’ƒY ¾VÁ¬?ª`Þß«`~ÁQÌy\”gA UræŽ`¾•gV#}Uræ³`¤¯JΈ£ÒÌ91Õ0½ÒŒØ–üÅ(F1ŠQŒb£Ť2²Àï…<þ#¦xà7ÿSüKæõª)&)x›f²?”nM1,É üØ$ê’3‰ß;|.N8bÈ,··ÀÄuìDƒŽXá“øÝ[%f¼)ŠÿÌód<àI«IüFÇ ­†¬gâg<àÙ›ºø ¦3#ºÄãAf‹ájà'6es6 g£øÇ6œf¿%ÑbÃäóö&Šÿx<˜Ohq‘À¯Ð§8=ð+Ää-Åü.f†ÀïfüGLjà'ÍýâøOå~¥•û¥–Êý$L¯4ó—þ{­Å(F1ŠQŒbs»˜úL¹ßã›Lm¦ïuöãú3ÔÿÎx3iÌ>š¾¯aÓC'_>dD§¹˜þN¿yàè¼&ÆW²ô~nÆô÷]¯Iw¾.¡ë…͵ÃSßÃ]šÙÍdlàz]ÁˆÕÐsֆ녇¾fíú–¸t fÌu7#zCŒ-NÃC׬Z4ÕG1ƒèæÜ”n*fÂ&cê4#é6iqØîËMù¾£·iS¬éÙ«‰_øx·˜fj±f¹4Ó”|üÚÝ[ýË ˜[ÆTó—aIŸ¥6o2åêe*©»¿d›è›d"%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_6.png0000644000175000017500000000125414030601042024415 0ustar rusconirusconi‰PNG  IHDRu#ÚÝgAMA† 1è–_bKGDÿ‡Ì¿ pHYsHHFÉk>ÞIDAThÞíY=RÂ@}8|élhBe…ã8W•M¬)íht,8€C!Ãè<ÀÎPi+`ó,ˆËnHHÀh4ìK³ûý?v÷Kvh‘8œÕ]€£ê¨:ª¥ÐÞGx®»šÊqŽ•·¶¸‹5:u×V)Ö>ô¬mª:x¯»ºJ1ÂÔ˜ÐYuT›G5!…Â{Ë#2|%‰+ÉcK+£ª’‘Ò)TÊÂ\Õ,­IµGE²Ç>I²ÏIŸA²Ž¦‡²Š§´¶´ˆjû¸mŸw~&¥l¸pƒkÀ &Ö˜a–ëq‹»ÒÒoÕ²x;Û¿½Í¸ÛˆËŒx‘‘/Þ‰`K‹VµÂ¶dÛÛÚ1û;TCŠþ}úT\Zmn¬ÛÒ&OG˜gH+¡JIr$²×>¢P2¨R·ê¶j¹™/°"ô?[ZDÕºÙ àsÿ¯xC·ªãýãašw³)Âêã?÷aØD8ªM„£ÚDX/›õ±7Áƒê#uWS9.ŒqËý×@8ªMDOu—ð[øƔڲû-‡â%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/QCPLineEnding.png0000644000175000017500000000516114030601040023724 0ustar rusconirusconi‰PNG  IHDRôdG2OgAMA† 1è–_ÀPLTEÿÿÿûàw5£ìöºG *›ìþÿýè¤ht¯ðÿæ–( XÇùqÛýô´Eþð®`/—Ò÷ý 5â|sçýÿõⓉæÿ˜1L¬ÐÐÐ÷øö°O !SøÊf- jÎýõÏLa#±ÇÁ\#,ðª:è±NL³ïñåîÏf¥OË[ m¦Üƒ ^*Ô»QÜóîÞÕJ¤œ887PPPpppèè误¯'''»ÝfbKGDˆH pHYsÃÃÇo¨dØIDATxÚí[‰vÚ:u^â,‚“84˜šä¥iûÿÿÕÓXÞØG¶ŒÌ=Zƒz=£+iÆ3TÓ@ @ @ @ ìg9ÆX^/ÅeéŸsþ~a\&$½âï×>i€¤¼7eÆ W)OÉm%¹‰zµ¸eÌ]ÍTp§˜Âô¢ß?Ô¹ò ÖT@Zj-}œ˜×›­jÑj™éN‰žly ¢'¾¥¶ÁÏŸlÆžÑ;eƒÕZef4¹-?ªçš^-³ü•çƒ«/å|©Q(ÞØy)R½ëݼ÷•w…ý®§_AÆÏšÙ猽Šk}E÷hÏ“NÉk÷*B)M!L䢿vîÇ¡Ÿî 0ޢǹS,\W¹ÆÏí[³d†;ý—vo_>uùNëÝçòšÎš&¼úÝ«R£ÖhÞع0 IuîÆ[­"¾ŠÉ»Â~cw›­“ˆ.¬Zï^‰¦„ºœ! ”§&êÕwî¯øØ÷óݽòŒ{§XøàëŒ5_sÿº¬{É'ý¦ì8,¢wÊÍRãÖÔ u ^Ÿ¦Ö¯þî}UËÍ·š‰#õEçbrIÄW1yWصһ]ýÿü.]XïÒº¥§oÉú×\>¤”§pM¬ëÝܳÿñ…çgÛ½òŒ{§x¢‹9îüÎ…'ñŸ9Û]çËê ¼Þ@œÂûÃÛ~uÛZGê‹î~“w…þ(?GD¿ãwp­Úëc=Ü  ”§&êìgÕ7èÌóS\EDs§XèwZ§ò×ä7ôi|š}–ç—V»VáÇMÞçŽáOwò÷¶1#õD_Åä]ao¹4ýBNH½[/5za=ЊI§ä)—)å)„‰:OYnMñ±ï§¸ãBô8wŠ…R›Ÿéƒ7x ôyʱª=è”Ù£›Tµk_ž8ˆTÿXm˜Ýméè)ĪPt÷«ÿbò®°ó7ž÷tx.äÔL>™ŽÓ«ë-ŒI6%ð e†”òÂDžÈÝÛÏâcßOqÕYhÜ;}kÜÅ;Ê Ç ý‚D'pÊ8Ë5MíÆNÚÉYhg^óð…'k5-Sa®h6^'~h•a’LÝÚFðXÍÿ¾ ïµI×h ˆ¾ÐÎ,µ´ÑµL…¹WÚ½}k®´eSeJ*:4 ÷Ú&]‡hŸð¡ •ÝKQÿZluJÐx½ÂÂO£;pë«a×0YËtÙ\˜Ïëî”á XŸxEÖ3y­Kð}èµÊâ\ˆ.§4uÈ[x†ô^Û¤ëí>¼ØÏ\t·‘ùùµÐê” ñz…l ½õÎ]Ñîa¢–é²¹0Ÿ÷9¨Iº×œL³â92y­KcUú³Üâ\x]N9j·uäóÂÚh{m“®C´OøP¿(¼Ø—¢‘ùmuî4kµWÈÿù“»y¢]ÃD-ÓesC©Üë‰m¾‘Éo]-®hq.DÃKš:Ê+Dßc›t­‘>áC½S~´/½Ff´Õ)C£‰^!÷Å=Ò5LÔ2]6æ³ßuÉàZVôµLAëÒ}q.°¢/QGy}Ñ÷Ö&]‡hŸðë”c—¢‘ùmuÊÐx½B–·Ú½Š{¼‡]ÃD-Óes¡Ùhó8Q(º×p¼ÿŠçxÈ´.=ÑçBt9e©µ(¯/úÞÚ¤ëíÂ/?˜ŸÈEZ»õXí9$r~×0YËtÙ\ È E÷Z:‘[Ç´.=ÑæÂërÊQ_i ¼AL?Å6é)ùB@‚Dÿ† Ñ Âþ0J\¤%ÆŒ$Êt„ƒÅÄ`ÌAí` ŠAlŒ%žŽG™úEËs#F®’l†jLcgC¾–X–Ž9Ã,ï~Ðh1»÷ÅÔʜ鮱ŽˆYS3*Žgéðª„m“³úŒÙ»ÁîÅlõa º¥Ål6k„Œ.²øÙR‚nÊÁgŽðCǨ[Óæ¾;Cup&`6ð »:Ó9›ÿEO~…sôt©ÀŒa-kÈ™áþÎñA’ï4Ü2Çït'<ݼÞPÜ48sûX02†Ø2Á…e@'3䨹˻>`y ×>¦gê qç`Âèdwž˜ò›·I€1#W¾L°7ÃÄàlfØ=˃oìù1F Ùò„Dš@ëŒqÓ`àí†ø{lXüAO ¬CtŠëiƒâ±áŒpëöú9]3ðGöÐ@g5 -tØÔ,8e¦h#éÅÔÁǽ!þ´óQν%†ØÕ˜5FF£2ä° t¹GæÙ½êÕÀÂí]™'d?‰BùtsuæÈÃFVk„ú=Í®J¨ƒ›"øïH/‚ÄhçH+Š8 'ÂÕqÛGFlš&uÒ þ*ðëÅÄx–Õæ:#uFÌö™«ƒr$ÔÁoôt‚¿Hì!>#çOþRtPÇb¸_5¦£Î²<ȤféÀ×e ÁaÓ¹-ä¡ê´pëCJ#JÍ$‚¿Hz1¢ëÚu†¸êX(…dÔI'ø§”šIðBbïx^ Î´R³T‚zu™}B uÆ2ê ÃË©¦fþ‡J á…TðÏZS þ* ¥NJ) ú?#¥¤Õe”x!ü³Nͨ.£Æ‹£JÍŽ)ø+Tj–Fð?u¨.³Ù‹t‚?¥f‡^—QïŤfT—Ùùº Gü©.³Í ôÐã þT—ÙâEÖêœjðWªËP]F‘T—¡ºÌ6HªË¨ÕeÒªËH¤fß®.#^N35£ºÌfP]F ¨.Cu™m º Õe¶z‘µ:§üUàR3ªËP]f3¨.£T—9®à¯™§f¿²W‡ê2[¼È>øŸfjFu™Í ºŒœn]FBªËlDæÁÿTS³Ó¨ËdŸšjðWCHÍŽ)øS]f#¨.“VØTìS3ªËP]f¨.£T—9€ÔŒê2›Au5 º Õe¶!ó઩پë2„ÅÿïÈ$® ¦%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPTextElement__inherit__graph.png0000644000175000017500000000213514030601041030374 0ustar rusconirusconi‰PNG  IHDR‹³Kò gAMA† 1è–_-PLTEÿÿÿÿÿÿ333iiiPPR™™™………èèé°°´ÓÓÕP+nn¨ÒN%tRNSªvå’bKGDˆH pHYsHHFÉk>JIDAThÞíØ¿jÛ@ð¼Âž'¡R»Õ$*¡,p¶Þå~ŠÚÐÁ4†vÌ+Ø:PÆ„xh¡ƒéÖN¦t)tèdèX¨ y€¾Cï$E±kI'Yê¿p?ƒsÑŸw¿Øþ.¡*jiI39˜Í­ÂÕN` °b¶Vx)5ÍLAçaVÀFÈ‚†yÏ¢ŒuÂÛuöª…ý2 Cu‚ÛòâQpt ½3 ¢0Æè=«˜C´NðDÜÍf•0ô¬öÂBûâ Gô¬…Ñýs’› {cáè'êò]œEJæzQA#ØK‚;-é„÷F!sX Å!㜑U8®=|#™#\ÔÖÇVî c1ù>%h­›L0+`\µ¸­b2Ng÷¸q¥T¡§z•0饙¿Ã@ñJbÜNJ]¥'0©åV^’ƒYõ¿TÁløß«`^ûߪ`~øþiÌ…ï_–g¾¯Þ*5sK0_Ë3‚Qn•šù$åV©±Q¾?)Í\H沦WšËR_¢ÍhF3šÑŒf4£™TFø=UÇ’)øÍÅ’)þ#s¶jšI Þ晬À#™nÍ18É üðUÔ¥f¿·ðDüCfÝ<@v¡Úb†sLràwwS2Ñ¢düGÏéy4 I³Iü&"FÎFZÅ+ìEÍ~‚iÄÌDž"ñ ³Åh:ð‹bgƒ£aüGâgl8š üÖD‹-J–!èMÿ‘x°œÐâ"_¡§8=ð+Ää-Íü)fÀï×øO2©Ÿ2÷‹ã?û•btî—Z:÷S0½ÒÌúõZ3šÑŒf4£Íhæ_bê ç~¦™Ú¿ìØ ãx –f<^„õ<šl.v!¼ÐñœyÆIgŒ£~s@;;Ü5âëÄ_'i6 õoÊ›,q ö°90Á  žs“š4ppRæ¹‚Ùð;†k÷»Ñ¢è®Ã·m#dÍ&fÀ–ŒèŽÅ®%­®xEƒ|‹’‹—`?f˜|ã×U‹mÑâ€n[.5º,d¶:NÈD–cÃÆ:lwL'è%s/˜é-ö<³û[ŸbÍÜ0¦šO†µÎ¢µ—ûS3GÝP¦’ºýŠIÂe -%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPItemTracer__inherit__graph.png0000644000175000017500000000211714030601041030175 0ustar rusconirusconi‰PNG  IHDR}³VLÒgAMA† 1è–_0PLTEÿÿÿÿÿÿiii111OOQ™™™………ççè±±µÓÓÕ*P4nn^Ù#tRNSªvå’bKGDˆH pHYsHHFÉk>9IDAThÞíØ1OÛ@p>B/Ái„hFîVÌÒ­’%Fι—˜2Q‰Ž|„W#†v¨!ué„KÕµCUCÅÎg¨Ô¡ïìà˜_b»RK{ÏRrä-ÿ R¨LhUZÈ\‹I_neöpËÛ™wnþžb(}Ú8ëtäâÌÞÜãõ’÷Ö6ªÝ\Þ#%jÔ媣p1X”}p:¤ < gSØJõk¤F„ýóOQl”_š¤…rÂmƒ,ÐÑ>º~('+N”ä+Î:ÆþËõÞP£aË/¤Äx|ùµqúyÿNÁVùé±ô{n´ÿ…öèû‡cÜg—QÒ"5ÇC_÷¦uÅóãîß¾eÕ'iÓxϬóé¥ýïô½’þa#¥æÏÓf¬¤O­é õü(ÿ.Ø*䯃ËBþ*øRÄWƒà[?çEütûü'ô? økô—üú¯ù} ¹ú¨ýŒôù}廬×OˆúñÑ^{íµ×^{íµÏãÕÙÏgu„>Gö3È€¤·IÞ2ÿ]O³údöÃë7ž&¿‘ ŸÌ~;»Od?Õ•U™U” m¢ŸSÀ!¨9œš‹3ŒOd?%{)ÌJ^Éà$Š~÷£óË0ˆ°8â¡S®Ïʬf’É6ô£Ÿþþe´ŠU쟜œ 'ï[EÑÏ? C|"ûÙ åuܹÇÉó~ôƒûǡы a>‘ýødŠbÿ*Ø7—FÑÏÈá$DaÐ07û)ôüio|Žì'΀Чf?êü'Ê€tþ£œÖùÎtþ£½öÚk¯½öÚÿ…þ8WþS½™ëŸ{àEŽâÚÿâ]X»ÀÀ&þ`!özÿº=ÏD÷Ŭðçü¤·Æéž/ W0¹|Ûç|·á0?ñ¹ësØÜÚ‚AŠ·„)<é£ó3|kºMWú&nO¾òg®hY#|ÿú|ná!½%ºò'Ù‹p‰zÿ8ÆO¾É½¬z+îÆ¿÷OBO, øö¬ÜÿNÓLõñý ½ƒý[Nx·å‡ýcé^ìxôùÓþOù‚¿yª7Îߟuÿ}®ÖÅõè'½™./I•ˆ[%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayout__inherit__graph.png0000644000175000017500000000437014030601042027417 0ustar rusconirusconi‰PNG  IHDRüCìn~@gAMA† 1è–_0PLTEóó÷ÿÿÿ111hhhQQW™™™………èèéÓÓש©µ6*!!Vll›"ìtRNS²e‰ ÆbKGDÿ-Þ pHYsHHFÉk>âIDATxÚíÝÏoÓVpдËvzmšvJ¥¡Lå¶ÀŠ&¦2š©åÄsýÒÚ¡Ú"m‡úì«Q¸Ñ® &R„¸LpˆÐvvÜ– í0ÐF êq9ôÞJ{ÏNÓ:µý~ØÏVË÷!!×NòÉ÷ùù9¡_¾ïÊ´øÈvü”t«$Èi}ºœ oI÷ê(ðo2tòyRC¨J ²À¬´ùê5»’³®—B# ÞB9lTrõÈ,F7Þ™^@5‚ˆ…LÒ6Ð=²¤‹¿ˆÆ±Ñ¢n?ú1l¡/G¿©¢yºÓFæjÙ@§×°vÞ;÷U‚mtÞ „ȱ¿éQDˆ6~·óÝmýˆ™2{?s7<þbÿ:‡žÇ×WñY=sñ×J^çŸú©¬‹w/¼½ðè6í䆉Ñ<Ÿ¶(Ÿ'¥¡WÑÅ#TZñï/|öŒTf=²˜)Þ€þ0ðD¾%É/Ï„´îWaGÚ ò¡­»ïùñø1ç¯,ù¢ó*KþŽó2K~ÛqV2ä{Ž³™_pg#;~’òÿfÇ)oèÇâR~=;ž|ÇieÆw¿™ßét;ÅÌxÚýñž<ðÀ<ðÀ<ðÀ<ðÀ¯™ç%ì|3}‡ÃË'ìÈ¥ïpxù_âøïW:À|ëä£v IJ7öñF‚|TÂŽ±“Ê¡LØy—\¢?`B\~|z™ä3Rñ6*´GãƒvNg|¿óYúŽ¹f®õ7p’Ñ'ì´î÷y={èŸþF¢|HÂå ¾ÅáÁ†–¡‡ö&ìÐηV±Ñv÷zé;x°a´“ãv&èЫšx„¸çÞKßÁƒ‘‡žLÂŽ¿išõÂvRáEðÀL^!aG*}‡Ã‡&ìpóvÄÒw oG½AÞN†<äídÇCÞäídÄö×xàxàxàxàŸÎÛùD?*ü ‰ßÀHðõ¦`xüb6›%2e“Zsø ÙúùÒW©+æÌÇör) Þl^©ÛSŒª2Þ&Ô›ÕbÑê„hç­ærÝž¥n?ú«u³yÜþhšñ)D?à½s_"õF³fÏVSâw;¿Éxs¦n¿_wùå4xwèÕèÐóøÚÙúUò5ë|ó¬Û+i]xt›zi¾Þ$Íe:ôèÖ÷ú‡^³9=ë¿Ü–Og:ë‘©7gÒøÔùl?éNør^;ƒÍÞº?{gNïo[γÁö{Î˶âË(ò[ŽóÏà‡IGÙWã·üI]e_‰ßJ`ij¾ ÿ˜é{ó…î¸;VRâ{L{±gGÞQMcPáï:Cù:ãŽj ‹Ò¹gá/ ïP ^¿=œ/óÄQÌS‹¾7ÔÕEÇé-©¼’ _|Qt~óí9æ¼Ê§vîi ½Mÿ®î&R _Ï?§óìŠ߯´Ož§Ã»¼¿×NƒŸ ;ÉÅ?Óà·7ÃŽ¼–_šŸ áwÿÐχ ¯[ºùÉgoK‡/Ëo/F,td×äEOíd×ä¿Ûˆ<<ÞYÑÉOðîk~×É?Þà<`ü©\øRüÄSþüO/ðÚïP•êÙ'ºx¡qŪ¼àUŹ6•yÁ9å˜Løâ¼ðŒ9/+óÂ÷“È»’*/q7¸'+ówÅ?JMŠææe>I‰‡/Ê_>5ñ¯¢¼Ü§è°Ï⪼äwˆ¢hø‚¼ì7(ÑÇ‹ñÂÑ ž Ø[b¼ð¹Ü ¿/q!›&„x‰il§Äæ ^!xÑYR„—¹…í†/tƒàeî`{šÐR€ßÞPâÇE§ü#Nч[H'¸*ϧóœ>éòÕØ…t«òWéZß®VüŸÚUàoèádåH ²d ?£1â®Ãƒ#xNUž}øø\ý–…ªso!|ðö¹[eNôüª<¼Q¡ìuÜ2.ôZ¶lT8ÿ3[€È0fGŒÆ¤Æóªò˜¤Âz÷Yêãññ-tß]çi'zÛ¨äË'ÙòK}vÄ8ƒðè‰PžS•Ç­Âsù[I+(úÞ;÷9BÆ°qÔ]|Êã {mÌÊÜðøª<™¯°š1‘ð•uÖ[ûŠõ¥…Ü:Q<¯*+HóË< 1rèyüµ²ëü¹º„ªç®»|Dçóªò°bßé¬w:™ñ´éžu€xàxàxàxà“⃓wþæ¦ì$ÄK$ïðÖ¾RâÅŸÂ[øÃÈ$­$ËG%ïèç#“wôóCÉ;lÍ«·ÍþX•À¼‰dyò[óêäêÎÒWY#zxïܳE˜XêLé« œMïeÏ´Ë·¼¥¯´óCÉ;lÍ+ÖùÞÒWú;(y‡­yå=wé+ýC/ yÝÄC;Rõ ²”%¿¿üaâ“[ûJ…_“È·i'ÏgԀϒWËöJªýZ ‰ëŸüà%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/doc.png0000644000175000017500000000056314030601042022114 0ustar rusconirusconi‰PNG  IHDR(SA»gAMA† 1è–_PLTEºÆß“¥Ërˆ¹Wn¨Ýãï4M ÿÿÿxI²tRNS@æØfbKGD†Þ•z pHYsHHFÉk>rIDATÓÏM@0`ôÆÏžkéºAfmï ®àúÚ²ôv_æ½Å$ÉߤZϦõPDz)óQÑËAÊ=¢:¶æZ¡n=¶jºP8ËlÈÅK-ÐóÂpŸM„µlðÝx(à­©óÎøûç Yûî\%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/layoutsystem-movinglegend.png0000644000175000017500000000412514030601040026601 0ustar rusconirusconi‰PNG  IHDR,Èe,ggAMA† 1è–_ÀPLTEÿÿÿÿõ¼O vçüüÿï£31êùûøþå‹OÁøþÝtÖÑÓ÷óÈŽ2“éÿ“““.›ëõÎmT™©Ô÷ül+ 4ã£Q'kÔøúÏc QÃÑkRa¨ßmþÿæ¯ñþ¬Æ¬0š +bšØøÿû×ê–(åËž ªJMµò dÒ&R¯T¦êïì†å}â—ekÞ•4 0*$å‰8T5€Äsÿ·Ÿ¯‚Ža™bKGDˆH pHYsÃÃÇo¨d¼IDATxÚí[¢JÅ üBRq»FjŠ¥­m…©åÝ>îÞýÿÿ«; ˆÓÞV8C+ùx~O»;¹æð¾4!„B!dï82-Ë*•‹ÞŒý R­Ù¶]ôVì uç¸èMØŽe5kEožÐ*»íæY´$''¿~OÝù+2«è·4œ(µÌ:Ñé© oªsê¹gÝ8 ÷²;lª'øþyTfˆÑ¾» jŠiˆ˜†Œ,@D³‘Ö¨0²ÍDLBF â< b0 ÍDLCðé¢3Œ LÃT‘kZyÌ:(ld2²2Š—cš•M䎇“Ä,N²nŸdõGWFV6‘kÊhŠÖѬQ«Õú:ž¶d™GÃt˜†:"žÁ"¦!ÓÑ,@ÄyCF ¢Y€ˆIÀÈD<)DLC¦! ¢Y€ˆiÀ>ET77w…1 SDëo7íî•,3 3pÛä½;YEwfÉ“š•&êVÿ2*rÞ0ýæL·ÝŒn cde库õSô`GMõ.Ë7³<‘uHøϳ´D<ƒDLC¦! ¢Y€ˆiÀ1 Ó€‘ˆh â*F ¢Y€ˆIÀÈD<ƒOYVó>*3 Sè\_ºg£“¬…ïî7uÛç$kV‘=å˜d=0zÁzÂBg’õDkSOµÃ¯ßxÕqæñS»™†i¢Îb¹~<Ó0…Æâáññ1 -FÖv‘=“ãÔJ~C³EÀÈD4 1 Y€ˆ¿¢DLC¦! ¢Y€ˆiÀ1 Ó€‘ˆ8f¥‰l?ø;.2 S¸i7\f¿»w×ÔäûW“feå3ë°PÌâ¼aÚ¼aÎÈú¹±Ã¦˜†Œ,@D³´Dœ7`d"šˆ˜„Œ,@Ä_Ñ"¦!ÓÑ,@Ä4àˆ˜†€ˆiÀÈD4 i ðz¹«¥*¾©'Çêïuv×T}±tÛynÎ,¼;l*¼1³ÜÿúÖ{²Bþ¿ðMQðGžQ©®ÐÔ¬R9™²°HBjd‘ä˜åܽû8>®ŸOÒè9ÉC0!£\÷dGY‘šõù7™QßL1p†èö…ï‹.•·ü„zÝ“uEjvÔçߢ͛I\ÓBͪTk¶moû õº'3êŠTŒõóo0QÙþÈDͪ;i¦yvz¤gVòü„äÍ$ƒ‹Ë1jVÃIËxõº@Ó¬äù7ˆ$y3IvÜñp›e´Ên{kï4²6Ï¿z¾~3IvüÑ•†YÆæ½ï£yÝ£e–òü›ìÁ;¸¦¼*.á­5œm¡¯yÝ£c–úü›Ì¨o&ÉN«Õú:ž¶0QçÔsϺ[%z×=f½yþMfÔ7“@ài(œ°úèn!„B!„B!» è•={€bVÑ{ëÓC³hÍ Y4 €f¨YÇZöëy½T¨q‘ešT׬úBž¥Mµ¦ÞS¨TEÍèš- êæùä¥ä=Š?î÷¸•¤ðGÌ2lûµÿÅÖXÒ‘¥G+»·øCûa®M»Ïåi­A ç·Ê‹‚‘çV·:çbK†¶öÚçpϤ]*˪]sn4œ¥]wjQ…QSúf‰¿Ýpm¦HæàXv Öˆ aõÁs†uøñiu®šKfïóšUw–å§@4Ö½| ûä[k³ÂÕ%3­Uõ¢G“ž³Œ«žM˾5òn›?¢ eSš^­R­#KxT_w¯f£E-®P6¥Y¿šµ‰¬MõId‰v¦hrY‹‡hÌ:WȉAÆš×•Ñ †aÖßüÔ‰ãÅUÛ3q‚rô¿Äæ5K=ŠºÎCùî[ Related Pages
Special Pages
 Class Overview
 Data Selection Mechanism
 The Layout System
 Plot Performance Improvement
 Using QCustomPlot with special Qt define flags
qcustomplot-2.1.0+dfsg1/documentation/html/functions_func_v.html0000644000175000017500000000334514030601037025104 0ustar rusconirusconi Data Fields - Functions
 

- v -

qcustomplot-2.1.0+dfsg1/documentation/html/inherit_graph_13.png0000644000175000017500000000143414030601042024473 0ustar rusconirusconi‰PNG  IHDR #ÆNÊ©gAMA† 1è–_0PLTEÿÿÿÿÿÿhhhÑÑÒTTT¡¡¢HH+PèèèÕÕå]]111*ߘtRNSªvå’bKGDˆH pHYsHHFÉk>IDATXÃí—¿KÃ@Çíäê éÕ¡"é$8nZG)HÁÍ‹åZÄR ÒÉÅ¥‹.®n®×NÖAœÿGÁ±SßËõy‘þ(%ß É»æ>ýä~4t Æ,Sÿ- M‚³b—uiËÃx‘[-Z%`„lyÅbÉ×B¾Ýà²B–<Ý3šh!ñ·B9U(¨–Pu¿»ã%eÏ.!ŽGµ 6‹¯=ß… 'Ï ®|‘o*½=qŒÐc7âIDATXÃíY=NÃ0þŠâl,,åíØ;!!–vd+`I'XÒ… º2°0´#ƒ.H,ÉÄX>†Ø&ÏI£´Bh>KÕËûËûülËm;$þ)vê. ¥ÖRÛjžž1¬»–JpŒk-Ù®Ýá½îª*À;¬ì¥ qÝ•}û)ùïµ–Z±íÔFðáÃÇÈj΄Æ×ãV<ù˜¬QˆŸy‡´njŒ©˜€Š!#†T ¬&`Ä9»$IE2â@gH>£‚ŒyHrT®°–AWWD’%¨)ŽCQ¾8ZIMQÙŕΦ,ãäD)=Ü\P[jiiÓ/Ù53”Oh­=ØŸØÔ–¢ŽPL—«ýjɸ]3TgÖMlŠ=;ÿ.57Š9Ú ¨•[îS”òŽœåš`ÎUj¿šâWGIm1µ'ä9f˜"Æ3œkÍ&ˆ±‰§VÞp˜ñèxÄeêîcŠ+œäF- smxB’C±á³·kr&¾™®™c5Vu ¡Ôw­c~9à …“ÐÇ+Þ úô°¯K¾W>ì¥îº×Ķ_´š‰–ZÑRk"Äá¿Ñ·¢?†½,µ‹ºkªGVê´ÿÔ4-µ&ÂÃ}Ý%ü>ùØ€"U”‚x%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/namespaces.html0000644000175000017500000000272114030601036023647 0ustar rusconirusconi Namespace List
Namespace List
Here is a list of all documented namespaces with brief descriptions:
 NQCP
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPolarLegendItem__inherit__graph.png0000644000175000017500000000277214030601042031161 0ustar rusconirusconi‰PNG  IHDR¨û ÂÞgAMA† 1è–_0PLTEúúüÿÿÿ¯¯µhhhQQQ˜˜˜………èèéÒÒÔ222+""Zff—Rä%@*tRNS­è3bKGDÿ-Þ pHYsHHFÉk>äIDATxÚíÚ¿oÛFðäOxµÎˆ4E`¤SÅ–QÄ]›……vèY|cMFk ³w)* 2©µ‹îbZ‚n{m -ØÞ»dïÒ½CïO¿"‘<Êg †ß ’w§îx$|¡p uƒÑËGWVK×ýBÔ+úÅhùÕ2êê¯,îãT°ˆ…+´<÷Ák¬€ü^:CE]Ð`¹¤QôCXÚ9QÓÞ—ë"Þ¹\k—D¡»„š™†¢¾X]?âÀ-)Î^\øÒ›MïiQI7¥êðèß>¨ã¼Ë×7P4ÁߤoQþ ƒϽQ)ú4†° «/«ê"82ËpR>R„".b ¢ 'j‹TWGšòK¢pûáßÝ„Œšÿ­,ó­~÷} P,]ÅèÁVF}úKVO£ͬ¯~µjþý‡{t)IzÎÑ;IòÚ9ún’œ;GH’ßœ£ÿ$ÉŸÎÑÿ’ä/×èr¢êØ1z‡Ð׎Ñ÷ý×1ú#¡¿;F? ô'ǨzúÏ­‡2Ê(£Œ2Ê(£Œ2Êè5B‹þ~¶ŽûGèVÜ?†Z¯.£Y9h^À/Ri˜n.@s~iÒä²èì€ÿÞ JRÜû±oNTs:3àß8ª*t°|Šûϼ3ÏœXÌtfÀ¿»,STÏ”äžúcNÊ,"à'ôp€ê¸_ŒNJlÔxÀOËoÄ°“¶ê¸_ŒNv¬)9𫪨³Xê{ªã~Ó¸h£Jü“UæÊ øçG­‹Ñ«Œ–ø³âþšðæüSq?çüvÅ9?çünQÎùÏ­‡2Ê(£Œ2Ê(£Œ2Êèu@_Ù%î…9¿© âEþÉBúÖ˲*Ñ TÚ 3†£‹Ø¢ljO`Âú`´ÿü AŠ©ÖqÔ{Ö+þ·U±´µª#Ô‡ŠuŠœ—>{ Œ[e )ÑOCþ|üÆ&à‡{Iáÿ0÷ŸBwaYÿî]Í´R]‡ÎQU|MqwSµ…°ÑKgº~ ÎâAÀ¿q¤g:Ìý³Ql/Ôu»I·v—²~ ß5ª“ýþ à×I½åþ9ˇ>â±ï7µDYÿ¥d¿×üæþÙð9,ì©å/Ü u²OY¿Z¾ùW_Viù&à×ËßåþÙ@·¤Ú¨EµA±ÚÊúû˜†ü'XO7Jü´Qª}˜ûÏxøãžÝ¯ž¹¼šï5Åö% Åè•B/šï¿YínYUaÎoj›s~ÛœósÎïåœÿÜz(£Œ2Ê(£Œ2Ê(£Œ^tÅMνðÏ'~„8@#'Ũ f %ãiô ;â£[ãè !§Zg¡OZw¢ý/6£à“ ìÆnÐð4Š£ïªOx‘‡ÛaªYÇú¸‡ºX£CXëD^3C Ò«Z'ÝV’Oh:Ó榲£'A¸FsÚPkµô`úsµ[ æžú4á} T{@êÄKaÚ˜«íÐfùéÍÔìlÑtU‹Oߪ¿TÝ“j®rÐg´Q1mTŠê%¶6 ººõ!-ŸªW÷ùƒ«tøHToTÜ$T-sOi£ÔÚ¨¨˜«<4úÆÏeºµÜîù^ÓôpŒ£W½ŒÿM‹~ÌoY Ôm]wÔÍMÖÿ J…Š‘]’Ë%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classes.html0000644000175000017500000002261314030601037023170 0ustar rusconirusconi Data Structure Index
Data Structure Index
q
  q  
QCPItemEllipse   
QCPItemLine   
QCPAbstractItem   QCPItemPixmap   
QCPAbstractLegendItem   QCPItemPosition   
QCPAbstractPaintBuffer   QCPItemRect   
QCPAbstractPlottable   QCPItemStraightLine   
QCPAbstractPlottable1D   QCPItemText   
QCPAxis   QCPItemTracer   
QCPAxisRect   QCPLayer   
QCPAxisTicker   QCPLayerable   
QCPAxisTickerDateTime   QCPLayout   
QCPAxisTickerFixed   QCPLayoutElement   
QCPAxisTickerLog   QCPLayoutGrid   
QCPAxisTickerPi   QCPLayoutInset   
QCPAxisTickerText   QCPLegend   
QCPAxisTickerTime   QCPLineEnding   
QCPBars   QCPMarginGroup   
QCPBarsData   QCPPaintBufferGlFbo   
QCPBarsGroup   QCPPaintBufferGlPbuffer   
QCPColorGradient   QCPPaintBufferPixmap   
QCPColorMap   QCPPainter   
QCPColorMapData   QCPPlottableInterface1D   
QCPColorScale   QCPPlottableLegendItem   
QCPCurve   QCPPolarAxisAngular   
QCPCurveData   QCPPolarAxisRadial   
QCPDataContainer   QCPPolarGraph   
QCPDataRange   QCPPolarGrid   
QCPDataSelection   QCPPolarLegendItem   
QCPErrorBars   QCPRange   
QCPErrorBarsData   QCPScatterStyle   
QCPFinancial   QCPSelectionDecorator   
QCPFinancialData   QCPSelectionDecoratorBracket   
QCPGraph   QCPSelectionRect   
QCPGraphData   QCPStatisticalBox   
QCPGrid   QCPStatisticalBoxData   
QCPItemAnchor   QCPTextElement   
QCPItemBracket   QCPVector2D   
QCPItemCurve   QCustomPlot   
q
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPPaintBufferPixmap.html0000644000175000017500000003774714030601040026521 0ustar rusconirusconi QCPPaintBufferPixmap Class Reference
Public Functions | Protected Functions
QCPPaintBufferPixmap Class Reference

A paint buffer based on QPixmap, using software raster rendering. More...

Inheritance diagram for QCPPaintBufferPixmap:
Inheritance graph

Public Functions

 QCPPaintBufferPixmap (const QSize &size, double devicePixelRatio)
 
virtual QCPPainter * startPainting ()
 
virtual void draw (QCPPainter *painter) const
 
void clear (const QColor &color)
 
- Public Functions inherited from QCPAbstractPaintBuffer
 QCPAbstractPaintBuffer (const QSize &size, double devicePixelRatio)
 
QSize size () const
 
bool invalidated () const
 
double devicePixelRatio () const
 
void setSize (const QSize &size)
 
void setInvalidated (bool invalidated=true)
 
void setDevicePixelRatio (double ratio)
 
virtual void donePainting ()
 

Protected Functions

virtual void reallocateBuffer ()
 

Detailed Description

A paint buffer based on QPixmap, using software raster rendering.

This paint buffer is the default and fall-back paint buffer which uses software rendering and QPixmap as internal buffer. It is used if QCustomPlot::setOpenGl is false.

Constructor & Destructor Documentation

§ QCPPaintBufferPixmap()

QCPPaintBufferPixmap::QCPPaintBufferPixmap ( const QSize &  size,
double  devicePixelRatio 
)
explicit

Creates a pixmap paint buffer instancen with the specified size and devicePixelRatio, if applicable.

Member Function Documentation

§ startPainting()

QCPPainter * QCPPaintBufferPixmap::startPainting ( )
virtual

Returns a QCPPainter which is ready to draw to this buffer. The ownership and thus the responsibility to delete the painter after the painting operations are complete is given to the caller of this method.

Once you are done using the painter, delete the painter and call donePainting.

While a painter generated with this method is active, you must not call setSize, setDevicePixelRatio or clear.

This method may return 0, if a painter couldn't be activated on the buffer. This usually indicates a problem with the respective painting backend.

Implements QCPAbstractPaintBuffer.

§ draw()

void QCPPaintBufferPixmap::draw ( QCPPainter *  painter) const
virtual

Draws the contents of this buffer with the provided painter. This is the method that is used to finally join all paint buffers and draw them onto the screen.

Implements QCPAbstractPaintBuffer.

§ clear()

void QCPPaintBufferPixmap::clear ( const QColor &  color)
virtual

Fills the entire buffer with the provided color. To have an empty transparent buffer, use the named color Qt::transparent.

This method must not be called if there is currently a painter (acquired with startPainting) active.

Implements QCPAbstractPaintBuffer.

§ reallocateBuffer()

void QCPPaintBufferPixmap::reallocateBuffer ( )
protectedvirtual

Reallocates the internal buffer with the currently configured size (setSize) and device pixel ratio, if applicable (setDevicePixelRatio). It is called as soon as any of those properties are changed on this paint buffer.

Note
Subclasses of QCPAbstractPaintBuffer must call their reimplementation of this method in their constructor, to perform the first allocation (this can not be done by the base class because calling pure virtual methods in base class constructors is not possible).

Implements QCPAbstractPaintBuffer.

The documentation for this class was generated from the following files:
  • src/paintbuffer.h
  • src/paintbuffer.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/classQCPLayout.html0000644000175000017500000022002714030601040024373 0ustar rusconirusconi QCPLayout Class Reference
Public Functions | Protected Functions | Protected Static Functions
QCPLayout Class Referenceabstract

The abstract base class for layouts. More...

Inheritance diagram for QCPLayout:
Inheritance graph

Public Functions

 QCPLayout ()
 
virtual void update (UpdatePhase phase)
 
virtual QList< QCPLayoutElement * > elements (bool recursive) const
 
virtual int elementCount () const =0
 
virtual QCPLayoutElement * elementAt (int index) const =0
 
virtual QCPLayoutElement * takeAt (int index)=0
 
virtual bool take (QCPLayoutElement *element)=0
 
virtual void simplify ()
 
bool removeAt (int index)
 
bool remove (QCPLayoutElement *element)
 
void clear ()
 
- Public Functions inherited from QCPLayoutElement
 QCPLayoutElement (QCustomPlot *parentPlot=nullptr)
 
QCPLayout * layout () const
 
QRect rect () const
 
QRect outerRect () const
 
QMargins margins () const
 
QMargins minimumMargins () const
 
QCP::MarginSides autoMargins () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
SizeConstraintRect sizeConstraintRect () const
 
QCPMarginGroup * marginGroup (QCP::MarginSide side) const
 
QHash< QCP::MarginSide, QCPMarginGroup * > marginGroups () const
 
void setOuterRect (const QRect &rect)
 
void setMargins (const QMargins &margins)
 
void setMinimumMargins (const QMargins &margins)
 
void setAutoMargins (QCP::MarginSides sides)
 
void setMinimumSize (const QSize &size)
 
void setMinimumSize (int width, int height)
 
void setMaximumSize (const QSize &size)
 
void setMaximumSize (int width, int height)
 
void setSizeConstraintRect (SizeConstraintRect constraintRect)
 
void setMarginGroup (QCP::MarginSides sides, QCPMarginGroup *group)
 
virtual QSize minimumOuterSizeHint () const
 
virtual QSize maximumOuterSizeHint () const
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const
 
- Public Functions inherited from QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr)
 
bool visible () const
 
QCustomPlot * parentPlot () const
 
QCPLayerable * parentLayerable () const
 
QCPLayer * layer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Protected Functions

virtual void updateLayout ()
 
void sizeConstraintsChanged () const
 
void adoptElement (QCPLayoutElement *el)
 
void releaseElement (QCPLayoutElement *el)
 
QVector< int > getSectionSizes (QVector< int > maxSizes, QVector< int > minSizes, QVector< double > stretchFactors, int totalSize) const
 
- Protected Functions inherited from QCPLayoutElement
virtual int calculateAutoMargin (QCP::MarginSide side)
 
virtual void layoutChanged ()
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const
 
virtual void draw (QCPPainter *painter)
 
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
- Protected Functions inherited from QCPLayerable
virtual QCP::Interaction selectionCategory () const
 
virtual QRect clipRect () const
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
 
virtual void deselectEvent (bool *selectionStateChanged)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Protected Static Functions

static QSize getFinalMinimumOuterSize (const QCPLayoutElement *el)
 
static QSize getFinalMaximumOuterSize (const QCPLayoutElement *el)
 

Additional Inherited Members

- Public Types inherited from QCPLayoutElement
enum  UpdatePhase
 
enum  SizeConstraintRect
 
- Signals inherited from QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Detailed Description

The abstract base class for layouts.

This is an abstract base class for layout elements whose main purpose is to define the position and size of other child layout elements. In most cases, layouts don't draw anything themselves (but there are exceptions to this, e.g. QCPLegend).

QCPLayout derives from QCPLayoutElement, and thus can itself be nested in other layouts.

QCPLayout introduces a common interface for accessing and manipulating the child elements. Those functions are most notably elementCount, elementAt, takeAt, take, simplify, removeAt, remove and clear. Individual subclasses may add more functions to this interface which are more specialized to the form of the layout. For example, QCPLayoutGrid adds functions that take row and column indices to access cells of the layout grid more conveniently.

Since this is an abstract base class, you can't instantiate it directly. Rather use one of its subclasses like QCPLayoutGrid or QCPLayoutInset.

For a general introduction to the layout system, see the dedicated documentation page The Layout System.

Constructor & Destructor Documentation

§ QCPLayout()

QCPLayout::QCPLayout ( )
explicit

Creates an instance of QCPLayout and sets default values. Note that since QCPLayout is an abstract base class, it can't be instantiated directly.

Member Function Documentation

§ update()

void QCPLayout::update ( UpdatePhase  phase)
virtual

If phase is upLayout, calls updateLayout, which subclasses may reimplement to reposition and resize their cells.

Finally, the call is propagated down to all child QCPLayoutElements.

For details about this method and the update phases, see the documentation of QCPLayoutElement::update.

Reimplemented from QCPLayoutElement.

§ elements()

QList< QCPLayoutElement * > QCPLayout::elements ( bool  recursive) const
virtual

Returns a list of all child elements in this layout element. If recursive is true, all sub-child elements are included in the list, too.

Warning
There may be nullptr entries in the returned list. For example, QCPLayoutGrid may have empty cells which yield nullptr at the respective index.

Reimplemented from QCPLayoutElement.

Reimplemented in QCPLayoutGrid.

§ elementCount()

int QCPLayout::elementCount ( ) const
pure virtual

Returns the number of elements/cells in the layout.

See also
elements, elementAt

Implemented in QCPLayoutInset, and QCPLayoutGrid.

§ elementAt()

QCPLayoutElement * QCPLayout::elementAt ( int  index) const
pure virtual

Returns the element in the cell with the given index. If index is invalid, returns nullptr.

Note that even if index is valid, the respective cell may be empty in some layouts (e.g. QCPLayoutGrid), so this function may return nullptr in those cases. You may use this function to check whether a cell is empty or not.

See also
elements, elementCount, takeAt

Implemented in QCPLayoutInset, and QCPLayoutGrid.

§ takeAt()

QCPLayoutElement * QCPLayout::takeAt ( int  index)
pure virtual

Removes the element with the given index from the layout and returns it.

If the index is invalid or the cell with that index is empty, returns nullptr.

Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
elementAt, take

Implemented in QCPLayoutInset, and QCPLayoutGrid.

§ take()

bool QCPLayout::take ( QCPLayoutElement *  element)
pure virtual

Removes the specified element from the layout and returns true on success.

If the element isn't in this layout, returns false.

Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
takeAt

Implemented in QCPLayoutInset, and QCPLayoutGrid.

§ simplify()

void QCPLayout::simplify ( )
virtual

Simplifies the layout by collapsing empty cells. The exact behavior depends on subclasses, the default implementation does nothing.

Not all layouts need simplification. For example, QCPLayoutInset doesn't use explicit simplification while QCPLayoutGrid does.

Reimplemented in QCPLayoutInset, and QCPLayoutGrid.

§ removeAt()

bool QCPLayout::removeAt ( int  index)

Removes and deletes the element at the provided index. Returns true on success. If index is invalid or points to an empty cell, returns false.

This function internally uses takeAt to remove the element from the layout and then deletes the returned element. Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
remove, takeAt

§ remove()

bool QCPLayout::remove ( QCPLayoutElement *  element)

Removes and deletes the provided element. Returns true on success. If element is not in the layout, returns false.

This function internally uses takeAt to remove the element from the layout and then deletes the element. Note that some layouts don't remove the respective cell right away but leave an empty cell after successful removal of the layout element. To collapse empty cells, use simplify.

See also
removeAt, take

§ clear()

void QCPLayout::clear ( )

Removes and deletes all layout elements in this layout. Finally calls simplify to make sure all empty cells are collapsed.

See also
remove, removeAt

§ updateLayout()

void QCPLayout::updateLayout ( )
protectedvirtual

Subclasses reimplement this method to update the position and sizes of the child elements/cells via calling their QCPLayoutElement::setOuterRect. The default implementation does nothing.

The geometry used as a reference is the inner rect of this layout. Child elements should stay within that rect.

getSectionSizes may help with the reimplementation of this function.

See also
update

Reimplemented in QCPLayoutInset, and QCPLayoutGrid.

§ sizeConstraintsChanged()

void QCPLayout::sizeConstraintsChanged ( ) const
protected

Subclasses call this method to report changed (minimum/maximum) size constraints.

If the parent of this layout is again a QCPLayout, forwards the call to the parent's sizeConstraintsChanged. If the parent is a QWidget (i.e. is the QCustomPlot::plotLayout of QCustomPlot), calls QWidget::updateGeometry, so if the QCustomPlot widget is inside a Qt QLayout, it may update itself and resize cells accordingly.

§ adoptElement()

void QCPLayout::adoptElement ( QCPLayoutElement *  el)
protected

Associates el with this layout. This is done by setting the QCPLayoutElement::layout, the QCPLayerable::parentLayerable and the QObject parent to this layout.

Further, if el didn't previously have a parent plot, calls QCPLayerable::initializeParentPlot on el to set the paret plot.

This method is used by subclass specific methods that add elements to the layout. Note that this method only changes properties in el. The removal from the old layout and the insertion into the new layout must be done additionally.

§ releaseElement()

void QCPLayout::releaseElement ( QCPLayoutElement *  el)
protected

Disassociates el from this layout. This is done by setting the QCPLayoutElement::layout and the QCPLayerable::parentLayerable to zero. The QObject parent is set to the parent QCustomPlot.

This method is used by subclass specific methods that remove elements from the layout (e.g. take or takeAt). Note that this method only changes properties in el. The removal from the old layout must be done additionally.

§ getSectionSizes()

QVector< int > QCPLayout::getSectionSizes ( QVector< int >  maxSizes,
QVector< int >  minSizes,
QVector< double >  stretchFactors,
int  totalSize 
) const
protected

This is a helper function for the implementation of updateLayout in subclasses.

It calculates the sizes of one-dimensional sections with provided constraints on maximum section sizes, minimum section sizes, relative stretch factors and the final total size of all sections.

The QVector entries refer to the sections. Thus all QVectors must have the same size.

maxSizes gives the maximum allowed size of each section. If there shall be no maximum size imposed, set all vector values to Qt's QWIDGETSIZE_MAX.

minSizes gives the minimum allowed size of each section. If there shall be no minimum size imposed, set all vector values to zero. If the minSizes entries add up to a value greater than totalSize, sections will be scaled smaller than the proposed minimum sizes. (In other words, not exceeding the allowed total size is taken to be more important than not going below minimum section sizes.)

stretchFactors give the relative proportions of the sections to each other. If all sections shall be scaled equally, set all values equal. If the first section shall be double the size of each individual other section, set the first number of stretchFactors to double the value of the other individual values (e.g. {2, 1, 1, 1}).

totalSize is the value that the final section sizes will add up to. Due to rounding, the actual sum may differ slightly. If you want the section sizes to sum up to exactly that value, you could distribute the remaining difference on the sections.

The return value is a QVector containing the section sizes.

§ getFinalMinimumOuterSize()

QSize QCPLayout::getFinalMinimumOuterSize ( const QCPLayoutElement *  el)
staticprotected

This is a helper function for the implementation of subclasses.

It returns the minimum size that should finally be used for the outer rect of the passed layout element el.

It takes into account whether a manual minimum size is set (QCPLayoutElement::setMinimumSize), which size constraint is set (QCPLayoutElement::setSizeConstraintRect), as well as the minimum size hint, if no manual minimum size was set (QCPLayoutElement::minimumOuterSizeHint).

§ getFinalMaximumOuterSize()

QSize QCPLayout::getFinalMaximumOuterSize ( const QCPLayoutElement *  el)
staticprotected

This is a helper function for the implementation of subclasses.

It returns the maximum size that should finally be used for the outer rect of the passed layout element el.

It takes into account whether a manual maximum size is set (QCPLayoutElement::setMaximumSize), which size constraint is set (QCPLayoutElement::setSizeConstraintRect), as well as the maximum size hint, if no manual maximum size was set (QCPLayoutElement::maximumOuterSizeHint).

The documentation for this class was generated from the following files:
  • src/layout.h
  • src/layout.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/functions_k.html0000644000175000017500000000320214030601037024046 0ustar rusconirusconi Data Fields
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

- k -

qcustomplot-2.1.0+dfsg1/documentation/html/folderclosed.png0000644000175000017500000000053414030601042024012 0ustar rusconirusconi‰PNG  IHDR(SA»gAMA† 1è–_PLTEBZ˜EZ—¢Ê~“Àt‰ºWo¨¹ÅÞÿÿÿÏòi_tRNSìÕþ^ebKGD†Þ•z pHYsHHFÉk>YIDATÓc` 0 :À9Œ¡¡pNbZš ˆ9âå@`ll惀 ÇÄÅÎ1qq…r\\\BCCÁÑP0€rÂÒ@ ÌQ³Ó’p” “C2K¤,ïuÒ·%tEXtdate:create2021-03-30T12:49:04+02:00¡?ò%tEXtdate:modify2021-03-30T12:49:04+02:00uü‡NIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/dataselection.html0000644000175000017500000003060014030601036024344 0ustar rusconirusconi Data Selection Mechanism
Data Selection Mechanism

In QCustomPlot, each plottable can be selected by the user, or programmatically. If the user shall be able to select data in any way, the interaction flag QCP::iSelectPlottables must be set in QCustomPlot::setInteractions.

Data selection granularity

The selection granularity can be controlled via QCPAbstractPlottable::setSelectable, by specifying an according QCP::SelectionType. For example, when using QCP::stMultipleDataRanges, the user will have full freedom over which data points he selects and which not. On the other hand if we use QCP::stDataRange, the selection mechanism will enforce that the selected data is always one contiguous range. So if the user selects two distant data points (while holding the multi-select modifier, usually Ctrl), all data points in between those two points will also become selected.

These images show the effect of the different selection types, when the indicated selection rect was dragged:

selectiontype-none.png
stNone
selectiontype-whole.png
stWhole
selectiontype-singledata.png
stSingleData
selectiontype-datarange.png
stDataRange
selectiontype-multipledataranges.png
stMultipleDataRanges

Selection by click and selection rect

The user can select data points in two ways:

The first method is to click on the data points with the mouse cursor. In this case, if the user wants to select multiple data points one after the other, he has to press and hold the multi-select modifier (QCustomPlot::setMultiSelectModifier), and QCP::iMultiSelect must be set in QCustomPlot::setInteractions.

The other method is by dragging a selection rect over the data points that shall be selected. This is possible if QCustomPlot::setSelectionRectMode is set to QCP::srmSelect. Note that while the selection rect mode is set (is not QCP::srmNone), mouse dragging will not be forwarded to underlying layout elements. This also means that axis ranges can't be dragged with the mouse anymore. If you wish to provide your user both with axis range dragging and data selection/range zooming, use QCustomPlot::setSelectionRectMode to switch between the modes just before the interaction is processed, e.g. in reaction to the QCustomPlot::mousePress or QCustomPlot::mouseMove signals. For example you could check whether the user is holding a certain keyboard modifier, and then decide which mode shall be set.

Retrieving the selected data

Once the selection state of a plottable changes either by user interaction or programmatically, the affected plottable emits the signal QCPAbstractPlottable::selectionChanged, carrying the currently selected data points in the form of a QCPDataSelection. An overload of this signal is available, which just indicates in a bool whether the plottable has any selected data points.

By calling QCustomPlot::selectedPlottables you can retrieve a list of plottables which currently have selected data points. The current selection of a plottable can be retrieved via QCPAbstractPlottable::selection. There is also a method dedicated to QCPGraph plottables specifically, called QCustomPlot::selectedGraphs.

Accessing a data selection

A QCPDataSelection is a list of QCPDataRange instances, which themselves hold the begin and end index of the respective data range. In the case of a one-dimensional plottable (deriving from QCPAbstractPlottable1D, e.g. QCPGraph, QCPCurve, QCPBars, etc.) you can access the data points by index, using the data container's at(int index) method. Alternatively you can simply add the integer index to the data container's begin() iterator.

As an example, the following code snippet calculates the average value of a graph's data selection:

QCPDataSelection selection = graph->selection();
double sum = 0;
foreach (QCPDataRange dataRange, selection.dataRanges())
{
QCPGraphDataContainer::const_iterator begin = graph->data()->at(dataRange.begin()); // get range begin iterator from index
QCPGraphDataContainer::const_iterator end = graph->data()->at(dataRange.end()); // get range end iterator from index
for (QCPGraphDataContainer::const_iterator it=begin; it!=end; ++it)
{
// iterator "it" will go through all selected data points, as an example, we calculate the value average
sum += it->value;
}
}
double average = sum/selection.dataPointCount();

Since QCPDataSelection instances are not tightly bound to a specific plottable, it is possible that the indices they contain exceed the valid data range of a plottable. The valid data range can be retrieved by accessing the plottable's data container and calling QCPDataContainer::dataRange. With this, you can check whether a given QCPDataSelection is contained in the valid range, and trim it if necessary, by using QCPDataSelection::contains, and QCPDataSelection::intersection, respectively.

Of course, the data selections returned by QCPAbstractPlottable::selection are always within the plottable's data bounds, as long as they aren't changed after retrieving the selection.

Retrieving the data point at a given pixel position

If you only want to find out which data point of a plottable is at or close to a given pixel position (without the need for a click or actual selection event), you can use QCPAbstractPlottable::selectTest. For example, the following code retrieves an iterator to the data point closest to a given QPoint in pixel coordinates:

QCPGraphDataContainer::const_iterator it = graph->data()->constEnd();
QVariant details;
if (graph->selectTest(QPoint(123, 456), false, &details)) // QPoint could be e.g. event->pos() of a mouse event
{
QCPDataSelection dataPoints = details.value<QCPDataSelection>();
if (dataPoints.dataPointCount() > 0)
it = graph->data()->at(dataPoints.dataRange().begin());
}
// iterator "it" now carries the data point at pixel coordinates (123, 456), or constEnd if no data point was hit.







qcustomplot-2.1.0+dfsg1/documentation/html/classQCPSelectionDecoratorBracket.html0000644000175000017500000011152714030601040030206 0ustar rusconirusconi QCPSelectionDecoratorBracket Class Reference
Public Types | Public Functions | Protected Functions
QCPSelectionDecoratorBracket Class Reference

A selection decorator which draws brackets around each selected data segment. More...

Inheritance diagram for QCPSelectionDecoratorBracket:
Inheritance graph

Public Types

enum  BracketStyle
 

Public Functions

 QCPSelectionDecoratorBracket ()
 
QPen bracketPen () const
 
QBrush bracketBrush () const
 
int bracketWidth () const
 
int bracketHeight () const
 
BracketStyle bracketStyle () const
 
bool tangentToData () const
 
int tangentAverage () const
 
void setBracketPen (const QPen &pen)
 
void setBracketBrush (const QBrush &brush)
 
void setBracketWidth (int width)
 
void setBracketHeight (int height)
 
void setBracketStyle (BracketStyle style)
 
void setTangentToData (bool enabled)
 
void setTangentAverage (int pointCount)
 
virtual void drawBracket (QCPPainter *painter, int direction) const
 
virtual void drawDecoration (QCPPainter *painter, QCPDataSelection selection)
 
- Public Functions inherited from QCPSelectionDecorator
 QCPSelectionDecorator ()
 
QPen pen () const
 
QBrush brush () const
 
QCPScatterStyle scatterStyle () const
 
QCPScatterStyle::ScatterProperties usedScatterProperties () const
 
void setPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setScatterStyle (const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties=QCPScatterStyle::spPen)
 
void setUsedScatterProperties (const QCPScatterStyle::ScatterProperties &properties)
 
void applyPen (QCPPainter *painter) const
 
void applyBrush (QCPPainter *painter) const
 
QCPScatterStyle getFinalScatterStyle (const QCPScatterStyle &unselectedStyle) const
 
virtual void copyFrom (const QCPSelectionDecorator *other)
 

Protected Functions

double getTangentAngle (const QCPPlottableInterface1D *interface1d, int dataIndex, int direction) const
 
QPointF getPixelCoordinates (const QCPPlottableInterface1D *interface1d, int dataIndex) const
 
- Protected Functions inherited from QCPSelectionDecorator
virtual bool registerWithPlottable (QCPAbstractPlottable *plottable)
 

Detailed Description

A selection decorator which draws brackets around each selected data segment.

Additionally to the regular highlighting of selected segments via color, fill and scatter style, this QCPSelectionDecorator subclass draws markers at the begin and end of each selected data segment of the plottable.

The shape of the markers can be controlled with setBracketStyle, setBracketWidth and setBracketHeight. The color/fill can be controlled with setBracketPen and setBracketBrush.

To introduce custom bracket styles, it is only necessary to sublcass QCPSelectionDecoratorBracket and reimplement drawBracket. The rest will be managed by the base class.

Member Enumeration Documentation

§ BracketStyle

enum QCPSelectionDecoratorBracket::BracketStyle

Defines which shape is drawn at the boundaries of selected data ranges.

Some of the bracket styles further allow specifying a height and/or width, see setBracketHeight and setBracketWidth.

Enumerator
bsSquareBracket 

A square bracket is drawn.

bsHalfEllipse 

A half ellipse is drawn. The size of the ellipse is given by the bracket width/height properties.

bsEllipse 

An ellipse is drawn. The size of the ellipse is given by the bracket width/height properties.

bsPlus 

A plus is drawn.

bsUserStyle 

Start custom bracket styles at this index when subclassing and reimplementing drawBracket.

Constructor & Destructor Documentation

§ QCPSelectionDecoratorBracket()

QCPSelectionDecoratorBracket::QCPSelectionDecoratorBracket ( )

Creates a new QCPSelectionDecoratorBracket instance with default values.

Member Function Documentation

§ setBracketPen()

void QCPSelectionDecoratorBracket::setBracketPen ( const QPen &  pen)

Sets the pen that will be used to draw the brackets at the beginning and end of each selected data segment.

§ setBracketBrush()

void QCPSelectionDecoratorBracket::setBracketBrush ( const QBrush &  brush)

Sets the brush that will be used to draw the brackets at the beginning and end of each selected data segment.

§ setBracketWidth()

void QCPSelectionDecoratorBracket::setBracketWidth ( int  width)

Sets the width of the drawn bracket. The width dimension is always parallel to the key axis of the data, or the tangent direction of the current data slope, if setTangentToData is enabled.

§ setBracketHeight()

void QCPSelectionDecoratorBracket::setBracketHeight ( int  height)

Sets the height of the drawn bracket. The height dimension is always perpendicular to the key axis of the data, or the tangent direction of the current data slope, if setTangentToData is enabled.

§ setBracketStyle()

void QCPSelectionDecoratorBracket::setBracketStyle ( QCPSelectionDecoratorBracket::BracketStyle  style)

Sets the shape that the bracket/marker will have.

See also
setBracketWidth, setBracketHeight

§ setTangentToData()

void QCPSelectionDecoratorBracket::setTangentToData ( bool  enabled)

Sets whether the brackets will be rotated such that they align with the slope of the data at the position that they appear in.

For noisy data, it might be more visually appealing to average the slope over multiple data points. This can be configured via setTangentAverage.

§ setTangentAverage()

void QCPSelectionDecoratorBracket::setTangentAverage ( int  pointCount)

Controls over how many data points the slope shall be averaged, when brackets shall be aligned with the data (if setTangentToData is true).

From the position of the bracket, pointCount points towards the selected data range will be taken into account. The smallest value of pointCount is 1, which is effectively equivalent to disabling setTangentToData.

§ drawBracket()

void QCPSelectionDecoratorBracket::drawBracket ( QCPPainter *  painter,
int  direction 
) const
virtual

Draws the bracket shape with painter. The parameter direction is either -1 or 1 and indicates whether the bracket shall point to the left or the right (i.e. is a closing or opening bracket, respectively).

The passed painter already contains all transformations that are necessary to position and rotate the bracket appropriately. Painting operations can be performed as if drawing upright brackets on flat data with horizontal key axis, with (0, 0) being the center of the bracket.

If you wish to sublcass QCPSelectionDecoratorBracket in order to provide custom bracket shapes (see QCPSelectionDecoratorBracket::bsUserStyle), this is the method you should reimplement.

§ drawDecoration()

void QCPSelectionDecoratorBracket::drawDecoration ( QCPPainter *  painter,
QCPDataSelection  selection 
)
virtual

Draws the bracket decoration on the data points at the begin and end of each selected data segment given in seletion.

It uses the method drawBracket to actually draw the shapes.

For general information about this virtual method, see the base class implementation.

Reimplemented from QCPSelectionDecorator.

§ getTangentAngle()

double QCPSelectionDecoratorBracket::getTangentAngle ( const QCPPlottableInterface1D *  interface1d,
int  dataIndex,
int  direction 
) const
protected

If setTangentToData is enabled, brackets need to be rotated according to the data slope. This method returns the angle in radians by which a bracket at the given dataIndex must be rotated.

The parameter direction must be set to either -1 or 1, representing whether it is an opening or closing bracket. Since for slope calculation multiple data points are required, this defines the direction in which the algorithm walks, starting at dataIndex, to average those data points. (see setTangentToData and setTangentAverage)

interface1d is the interface to the plottable's data which is used to query data coordinates.

§ getPixelCoordinates()

QPointF QCPSelectionDecoratorBracket::getPixelCoordinates ( const QCPPlottableInterface1D *  interface1d,
int  dataIndex 
) const
protected

Returns the pixel coordinates of the data point at dataIndex, using interface1d to access the data points.

The documentation for this class was generated from the following files:
  • src/selectiondecorator-bracket.h
  • src/selectiondecorator-bracket.cpp
qcustomplot-2.1.0+dfsg1/documentation/html/tabs.css0000644000175000017500000002207514030601035022310 0ustar rusconirusconi.sm{position:relative;z-index:9999}.sm,.sm ul,.sm li{display:block;list-style:none;margin:0;padding:0;line-height:normal;direction:ltr;text-align:left;-webkit-tap-highlight-color:rgba(0,0,0,0)}.sm-rtl,.sm-rtl ul,.sm-rtl li{direction:rtl;text-align:right}.sm>li>h1,.sm>li>h2,.sm>li>h3,.sm>li>h4,.sm>li>h5,.sm>li>h6{margin:0;padding:0}.sm ul{display:none}.sm li,.sm a{position:relative}.sm a{display:block}.sm a.disabled{cursor:not-allowed}.sm:after{content:"\00a0";display:block;height:0;font:0/0 serif;clear:both;visibility:hidden;overflow:hidden}.sm,.sm *,.sm *:before,.sm *:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}#doc-content{overflow:auto;display:block;padding:0;margin:0;-webkit-overflow-scrolling:touch}.sm-dox{background-image:url("tab_b.png")}.sm-dox a,.sm-dox a:focus,.sm-dox a:hover,.sm-dox a:active{padding:0 12px;padding-right:43px;font-family:"Lucida Grande","Geneva","Helvetica",Arial,sans-serif;font-size:13px;font-weight:bold;line-height:36px;text-decoration:none;text-shadow:0 1px 1px rgba(255,255,255,0.9);color:#283a5d;outline:0}.sm-dox a:hover{background-image:url("tab_a.png");background-repeat:repeat-x;color:white;text-shadow:0 1px 1px black}.sm-dox a.current{color:#d23600}.sm-dox a.disabled{color:#bbb}.sm-dox a span.sub-arrow{position:absolute;top:50%;margin-top:-14px;left:auto;right:3px;width:28px;height:28px;overflow:hidden;font:bold 12px/28px monospace!important;text-align:center;text-shadow:none;background:rgba(255,255,255,0.5);-moz-border-radius:5px;-webkit-border-radius:5px;border-radius:5px}.sm-dox a.highlighted span.sub-arrow:before{display:block;content:'-'}.sm-dox>li:first-child>a,.sm-dox>li:first-child>:not(ul) a{-moz-border-radius:5px 5px 0 0;-webkit-border-radius:5px;border-radius:5px 5px 0 0}.sm-dox>li:last-child>a,.sm-dox>li:last-child>*:not(ul) a,.sm-dox>li:last-child>ul,.sm-dox>li:last-child>ul>li:last-child>a,.sm-dox>li:last-child>ul>li:last-child>*:not(ul) a,.sm-dox>li:last-child>ul>li:last-child>ul,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>a,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>*:not(ul) a,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>a,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>*:not(ul) a,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>a,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>*:not(ul) a,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul{-moz-border-radius:0 0 5px 5px;-webkit-border-radius:0;border-radius:0 0 5px 5px}.sm-dox>li:last-child>a.highlighted,.sm-dox>li:last-child>*:not(ul) a.highlighted,.sm-dox>li:last-child>ul>li:last-child>a.highlighted,.sm-dox>li:last-child>ul>li:last-child>*:not(ul) a.highlighted,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>a.highlighted,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>*:not(ul) a.highlighted,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>a.highlighted,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>*:not(ul) a.highlighted,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>a.highlighted,.sm-dox>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>ul>li:last-child>*:not(ul) a.highlighted{-moz-border-radius:0;-webkit-border-radius:0;border-radius:0}.sm-dox ul{background:rgba(162,162,162,0.1)}.sm-dox ul a,.sm-dox ul a:focus,.sm-dox ul a:hover,.sm-dox ul a:active{font-size:12px;border-left:8px solid transparent;line-height:36px;text-shadow:none;background-color:white;background-image:none}.sm-dox ul a:hover{background-image:url("tab_a.png");background-repeat:repeat-x;color:white;text-shadow:0 1px 1px black}.sm-dox ul ul a,.sm-dox ul ul a:hover,.sm-dox ul ul a:focus,.sm-dox ul ul a:active{border-left:16px solid transparent}.sm-dox ul ul ul a,.sm-dox ul ul ul a:hover,.sm-dox ul ul ul a:focus,.sm-dox ul ul ul a:active{border-left:24px solid transparent}.sm-dox ul ul ul ul a,.sm-dox ul ul ul ul a:hover,.sm-dox ul ul ul ul a:focus,.sm-dox ul ul ul ul a:active{border-left:32px solid transparent}.sm-dox ul ul ul ul ul a,.sm-dox ul ul ul ul ul a:hover,.sm-dox ul ul ul ul ul a:focus,.sm-dox ul ul ul ul ul a:active{border-left:40px solid transparent}@media(min-width:768px){.sm-dox ul{position:absolute;width:12em}.sm-dox li{float:left}.sm-dox.sm-rtl li{float:right}.sm-dox ul li,.sm-dox.sm-rtl ul li,.sm-dox.sm-vertical li{float:none}.sm-dox a{white-space:nowrap}.sm-dox ul a,.sm-dox.sm-vertical a{white-space:normal}.sm-dox .sm-nowrap>li>a,.sm-dox .sm-nowrap>li>:not(ul) a{white-space:nowrap}.sm-dox{padding:0 10px;background-image:url("tab_b.png");line-height:36px}.sm-dox a span.sub-arrow{top:50%;margin-top:-2px;right:12px;width:0;height:0;border-width:4px;border-style:solid dashed dashed dashed;border-color:#283a5d transparent transparent transparent;background:transparent;-moz-border-radius:0;-webkit-border-radius:0;border-radius:0}.sm-dox a,.sm-dox a:focus,.sm-dox a:active,.sm-dox a:hover,.sm-dox a.highlighted{padding:0 12px;background-image:url("tab_s.png");background-repeat:no-repeat;background-position:right;-moz-border-radius:0!important;-webkit-border-radius:0;border-radius:0!important}.sm-dox a:hover{background-image:url("tab_a.png");background-repeat:repeat-x;color:white;text-shadow:0 1px 1px black}.sm-dox a:hover span.sub-arrow{border-color:white transparent transparent transparent}.sm-dox a.has-submenu{padding-right:24px}.sm-dox li{border-top:0}.sm-dox>li>ul:before,.sm-dox>li>ul:after{content:'';position:absolute;top:-18px;left:30px;width:0;height:0;overflow:hidden;border-width:9px;border-style:dashed dashed solid dashed;border-color:transparent transparent #bbb transparent}.sm-dox>li>ul:after{top:-16px;left:31px;border-width:8px;border-color:transparent transparent #fff transparent}.sm-dox ul{border:1px solid #bbb;padding:5px 0;background:#fff;-moz-border-radius:5px!important;-webkit-border-radius:5px;border-radius:5px!important;-moz-box-shadow:0 5px 9px rgba(0,0,0,0.2);-webkit-box-shadow:0 5px 9px rgba(0,0,0,0.2);box-shadow:0 5px 9px rgba(0,0,0,0.2)}.sm-dox ul a span.sub-arrow{right:8px;top:50%;margin-top:-5px;border-width:5px;border-color:transparent transparent transparent #555;border-style:dashed dashed dashed solid}.sm-dox ul a,.sm-dox ul a:hover,.sm-dox ul a:focus,.sm-dox ul a:active,.sm-dox ul a.highlighted{color:#555;background-image:none;border:0!important;color:#555;background-image:none}.sm-dox ul a:hover{background-image:url("tab_a.png");background-repeat:repeat-x;color:white;text-shadow:0 1px 1px black}.sm-dox ul a:hover span.sub-arrow{border-color:transparent transparent transparent white}.sm-dox span.scroll-up,.sm-dox span.scroll-down{position:absolute;display:none;visibility:hidden;overflow:hidden;background:#fff;height:36px}.sm-dox span.scroll-up:hover,.sm-dox span.scroll-down:hover{background:#eee}.sm-dox span.scroll-up:hover span.scroll-up-arrow,.sm-dox span.scroll-up:hover span.scroll-down-arrow{border-color:transparent transparent #d23600 transparent}.sm-dox span.scroll-down:hover span.scroll-down-arrow{border-color:#d23600 transparent transparent transparent}.sm-dox span.scroll-up-arrow,.sm-dox span.scroll-down-arrow{position:absolute;top:0;left:50%;margin-left:-6px;width:0;height:0;overflow:hidden;border-width:6px;border-style:dashed dashed solid dashed;border-color:transparent transparent #555 transparent}.sm-dox span.scroll-down-arrow{top:8px;border-style:solid dashed dashed dashed;border-color:#555 transparent transparent transparent}.sm-dox.sm-rtl a.has-submenu{padding-right:12px;padding-left:24px}.sm-dox.sm-rtl a span.sub-arrow{right:auto;left:12px}.sm-dox.sm-rtl.sm-vertical a.has-submenu{padding:10px 20px}.sm-dox.sm-rtl.sm-vertical a span.sub-arrow{right:auto;left:8px;border-style:dashed solid dashed dashed;border-color:transparent #555 transparent transparent}.sm-dox.sm-rtl>li>ul:before{left:auto;right:30px}.sm-dox.sm-rtl>li>ul:after{left:auto;right:31px}.sm-dox.sm-rtl ul a.has-submenu{padding:10px 20px!important}.sm-dox.sm-rtl ul a span.sub-arrow{right:auto;left:8px;border-style:dashed solid dashed dashed;border-color:transparent #555 transparent transparent}.sm-dox.sm-vertical{padding:10px 0;-moz-border-radius:5px;-webkit-border-radius:5px;border-radius:5px}.sm-dox.sm-vertical a{padding:10px 20px}.sm-dox.sm-vertical a:hover,.sm-dox.sm-vertical a:focus,.sm-dox.sm-vertical a:active,.sm-dox.sm-vertical a.highlighted{background:#fff}.sm-dox.sm-vertical a.disabled{background-image:url("tab_b.png")}.sm-dox.sm-vertical a span.sub-arrow{right:8px;top:50%;margin-top:-5px;border-width:5px;border-style:dashed dashed dashed solid;border-color:transparent transparent transparent #555}.sm-dox.sm-vertical>li>ul:before,.sm-dox.sm-vertical>li>ul:after{display:none}.sm-dox.sm-vertical ul a{padding:10px 20px}.sm-dox.sm-vertical ul a:hover,.sm-dox.sm-vertical ul a:focus,.sm-dox.sm-vertical ul a:active,.sm-dox.sm-vertical ul a.highlighted{background:#eee}.sm-dox.sm-vertical ul a.disabled{background:#fff}}qcustomplot-2.1.0+dfsg1/documentation/html/QCPColorGradient.png0000644000175000017500000045550314030601037024463 0ustar rusconirusconi‰PNG  IHDRXX1‹sBITÛáOà pHYsÄÄ•+ IDATxœì½yœmEu6ü¬ª³O÷½p.2 1E„¨M’ øéçéKŒJ”AIDA™‚Š(*ò⛇hF ¾I$&šhœ ƒ¢ÄQD ^†Ë½Ý}ÎÙµÞ?VÕÚk×Þgêî{o7œõëßîÚujﳇuÖSÏZ«ªˆ™1“™Ìd&3™É½UÜ®¾€™Ìd&3™ÉLv¥Ì€p&3™ÉLfr¯–Îd&3™ÉLîÕ2™Ìd&3™É½Zf@8“™Ìd&3¹WË g2“™Ìd&÷j™áLf2“™Ìä^-3 œÉLf2“™Ü«e„«*ÛÿãäƒöxÚ?Þµ«¯c&3™É½L†Ÿþw.>rñﻹÜ%µ^d½!/|ï¾è„nîuö8ø觽áS?½ó™ìláŸþÙ£ç?óºÅªê®zú¦}_ôùm#»ûºè+wΦwšI›„;¯ùàé'>t¿.í~èq/þÀw{»ú¢î‰²®·]sáòÌ?-ŸþÎÏÞxûÝ[öƒÿüË7=ç ¿°·ßÕW6“™L$¼å_ÞxÆe_¹+ìê ™ÉÚ¾ãógìÉ_¸ÿéWÜpÛÖ­·ÝøÅ?>ýY¿tPwW_×=QÖ.|ëÿ{ÜþÑüǽì=—þÚþÇ¿ïæÛÿãäÃïÿÒw¼þéÇ<øþï»ÏO|Ý•?èç½/=ç»ÏüØþôô:x¯Ývß|ЃûŒç>ñà¶ÿÇÉ÷?òìüËS³Ñ¿ûoÛÁÿöô'>xÿM狹ýŽý|÷îo]ô°ù_øÃb‹o»âÄ=öyî§î\ºñ£§œp¿=ç»bãþчoì½}⬧>x/"¢ ‡<õÿ|·ß8ÛRí^ú?þ‡³~í{t|±Û¡'œö7?˜õãÖ›L§ã¤ó?œýÔïå‰hÓž|Æ7.¡üé•'?ñùwë—_}ä}6ôË—~§¿Ãïi&»R¦Ó¨Þ —þî%[^øñzçK{ÿ}vß}ŸÃŽ~Êoø€ùV]ª o¿á¿}ì~ù ûý‚?úÖRëÕÌÄ ¯Y¼îì¿ä£ß[ý-ÿõž÷ùÇ?ð¶«^y_øcßrõÖÀÜ»é¯~ë>»=þ}?è÷¿ÿž£ýÁ§~y{ûÙ¶]õʃÜî‡<þõû[·Ü¾µÏ̼ýÛŸ¼ò+·,„°ø­ÿ}†=ãS[~ôÁv;ìt9Gùã?~ãA'ÿû¶­ÿü››÷{îßÝ:`Üù½¯\ó“/}ã£æxöû¯ûÙRoë¾~Ãmý–³ÝÉÛ®z回úÉ;yé›?rÃÏÿ³ooýŸ|òäÃ7ý––vÞ£œÉŠeJmäpëG~qî~¯»v¡:ÅÿxÒîû¼ðsw3óâ7.ö¤ûýö·Í€ðÞ#˲o{çws«1T—’ñY¼öÌà 5Œ¼ý?^u`g„cd ¹Fû·ßtG÷Àûí|ž÷ß·HŸ¹¹=7o )wö>doÞòã»hσö–Ü.þ¤ ¼àóßüî7®|ÅÛî\Œ·ÛáG ç@¸óê¼ö7÷ˆ£~Ì#;é­_[díýø×{õ5ÿõ•«®8õççþÊ—ôùK?ñoù'ß?ö”gݯ¿ù˜½õã×Ýú£¿Áí>íEÿ÷ö=Ù³wËw”ãΖîeóý6Ïÿâå߸mË–-[¶l¹}koû×Î}X­ÉLÖ´L«¨³é>÷=@å¾ûlˆ¿¯î¾اÿãïßâí7ÿî=Å>Ì’Fïù2½}{Ü“úáG?|õÖºvŒÐ¥Ö/l½uë$Aì{·¬! œÿ¹g=ëàkßzѧo郾û·o{ŸI.¯~ÛEŸüá‡;¯~ïþì®Ç¼ô„}ÝÜ‘§\ö;þ=¿þ«§àóß¾m{oñŽ÷Û?Þ>$û·ßº­»ÿýÜÍóâ>yéûoˆ‰îݾàô£®=ïu—ÿôñ§žx пùKŸûúm=FqŸ_xÔ‘›ya©ó g¿à_ûóþò¿·–añ¶o]û­Ÿý¬ýl"s?÷¼ß=ò«o:óÏ®¿c„…[oø¯oÞ1#„ëH¦ÖÆ‘gë>蹯xø·Þ|ö_{[ज़®<ï¬/Ü÷¿sôFøMûïÍ7}ñk·ðl‰ì{´L­QóG~ño.¼ëħŸý±«o¾»ß߾妯ýû5?uÃt©ú¢ßø_^ó–7òGK¶}ëo.úÀ3×ÃXÙÕ¾Y+áîëÿøÅØ·ps›8æùgüs’ýà½÷š“ŸxÄ0wè/ÿþßßœçƒÿùÒ{^þÄïÓ‘»)6ßÿ¸ÿuþ¿ÝLèXϾõšKþ¿l¤În{rÜËÞûþçþè?¹¹df?ûûgnÂ>/üLl¼ýêsžpÈnDÅü†=yôï~è›Û™yñ{{ÍØ º‡<í¾³¥ílæKû?ùôÏ|¨\Xw¿G¼ø#7¶G+g²FeJm,ÃÜÿɧÏæC÷óÎï~ø/ŸúWß‘†å–Ͻá—îãÐÙü‹^¿¸ ns&;M–aßoºòügwHD¹Ý=ᬯl¦K•ñ [¯»üùGmvp÷Ä /zËã÷yÔ,F8Zˆ×j?téëçyìg.¸és¿µñ?O~à“nú“ýý¯î±c¾*üä/~õç^÷ùïK¹aÇ|ÃLÖ¹ìDmœÉ½Bfµ¦d ¹F…ï}ö³×ÿt1áîÿþ« Þûƒôð=iüq+“þ-Ÿ<çÌ?òu¯>z†‚SHÿGÚÃç÷|槷îê+ÙA²k´ñ^/÷`½šiÔ.”1zµ¦€ppË?{Òƒ6y"¿ç±oºåYüØï=h‡æ;-]áñ{o¼ßK®9ññÛ‡wväWÝ£$ÜqÕ›ýÑg|çÐûÞƒg¹ØéÚ8“{¸^Í4jÉzµv]£3Y»ÂÛ¾þ×Wl}Âc¯9ñ?}á·¯xÒ¦]}A3¹GÈL¯f²#d½ZSŒp&ëDh·‡üÖ Žßì¬5“U”™^ÍdGÈz5;hæÑ^£2‚Ù¯ð­íŸÁL¯Ö¬Ìôj&;BÖš^M;餓¤@I>þñ?ãÏÐ]ùè£ýèoþæoÚfññ¼ç=Oˆ|èCzÉK^Buù£?ú£—¿üåRvÎpνûÝï>õÔS¥F[^tÑEgžy¦=öüóÏ?çœs²¾á oxó›ßœ]ágœñö·¿]/Fnê´ÓN{ç;ß ó2ˆèÕ¯~õ»ßýnû²yô§œrŠ ó2N;í´w¼ãYåk^óš‹/¾XÒvõ£?øƒ?xË[Þbk^ÿú×_pÁº+½ño<çœsl3f>ÿüóG¿µÁ`™Cj;9ýÆa2´D ú>¾}q— þmÜøÀª†€ƒ¿‰[~¾VCû~ [—*vû/l;p€y?à Oqp€¯êç¯(ŸíA OÒ~ÞË )ÃÁ¡xg¯ÿš.<@ ù2‡ÎKƒ7ÎÁŠÖbyá<ÇÏKÁ¿n±|˼}y €?3 ÄzöâàܹªY€ÎyKƒ³çt \¼µ×?£ N£öŠKzýSº8žF÷ò~ïe…¢õs£6ÌËLi!ÚYnÏþº(ߎø¶¼ž¸%àÛ‡ã7V5 |ó`üü-µGøÚ¾xØK:8Âí†ã¶ezÅŸÙèž²éUyżö¢Õ«Á犗õ2½ê½³è¾¦ŸéÕÒ¹72½Z<ËÏ_X5½Z|ŸKmÐr^ðxf:•Â,žíçÎTÍ,×™;{éUï­E÷Œ¾Õ«Þ%E÷”~¦WýË»ÅËz™^ >8fn‘­Ëí$mZ.ˆîš‘˜Ÿ!%A>©´(˜µÔfY›Ñ•ÙwÙ¯³×)-­Ø…¥¬™ÔK%3ËÙ¤R¿Ñ¡sÎîÚi¯'¬†¿˜+!eyÏÍŸÝ:™ÊÚèÖ%ãâSd n­ “Ä8Š ¤¨íºtl'íâ "Õ¹ŽNUÖ¨Èß]UæoÛ‰5ñK9µT3¤†ÆpÑ Å߈'fŽ)Þ2ÁHæ)KD`7¡%Z˜¬Ùz“ü7E¦†jmfzµôjçkÕtÉ2D”1B´A—µÎ”X]+}ðƒ|éK_Jm¢Ðe1¬YÎjÞô¦7 ‹ÊÏ¢ivÙèekù•¯|åå—_nŸCöÐZwíVëe÷ÔSO½ä’KPGAŶæn³lÏÏÌçž{îhWÃöíÛ‡}:Z6nÜ8ỗ\vü£þåÍßYyReŒ Õ2FXµUô1Ò¾tø>_ÃGÕè`41>vºcÙ7Ê>µñÆŠytßÛｪ JõT?•ôÓ=Uf‹’Q@²2ÉR¨¸S»ëCv²'êõl¬ÃZ+iéß°Xž7ÑPÿ4µ©>âªÛÎí®~Ú}_´^1oÂWÜ8öˆ£W FˆTF¨m@ WÑG¡}Hªöµ}pÔ5:¸2½ê¿·[¼ª·ºzµpŠÛðîúüZ+Ó«Å7øùóJ¬ž^õß×­Wß[.#<‚†#ÚH½ÚáŒp_i­oÅQ­±å&ÃË ®Ù`˜Øov…Ã>Rz§ KËøŸ¾{_–çiûlWO¨ÙÂäÂ:XùU»•“H“ 6J¦™n©²&-j§¬µ+SY4ÛycG¤f«böÆTÙ+¶„4§C¸^à ®:ì±·n\ ±· A ¦Ø_Ï:øLu[6Q"ݺ`„ÓhV“ ÖÿךÍô ;D¯v¾V­­½n•ÐҬ϶M¬j›’B­G₺՚aç´_7ìj½¯iV‡,“½›ùK-”*ÚúÌYŠº—uôóWÙ!@Ø9ìä¯ÜzòêŸÌ sT—V£„†#2•6¸’•}Í ¥Î+êPež:õÞ¸¶Œ›+öÓ}Ý&R²eµ«¬ÊÔ­[¬`^´í¡« Ùþ8@4Bød†(™6gz딜T 1\•…B²e!=®‰Tfq|“ie‡éÕxÅjïFT¬]­WÖe«eß­]0›WɆb­êÕЪ1z5µkT 'tÒ,V™ùH[Qª `ÙÖ¶÷ÞSÉÚÜ6¿qķޯȰgÕê Í<™Íf£¡­•ÍòYg5úÚä.î¸ãŽ¯u„ìµ×^Ó²Ïeˆ>ç«Œ 5¶êuÆ#j¢Ž€´ëÎü¢jnÈ”ÕZuê]õN*d®-OÈzôYtÇ)½2ŽÆ̺š^Ù:¯HËÚ1¯Ê\9²¬» •Ÿ*ÿÈÖ‡I+»—öÓ¥Ò+æ/Nÿ¶åØÇîL½Âa7ôáu¦’jI1Q“Ä#ê¢ží ½Òë’ëØÄk·Ïªq?9™R΋–9iËŽÖ«þ¥Ýtm£ôê‹ËÕÇNï-‹_:->íiOSõjbÉ ´É,hàŒÿIaì +47uª÷5ú9dØÖ,´n›¼p¼em„ÏÀųÏ>{´bmÙ²eüÛm“Í›7ïƒõõC“EJð6!j¹ *Šùjº¤¬Êl“7&L;ïÍO5œcË΂0¸ºÄtWz¿¹Éa£8 qú(¤ÊÀ•Ëš§dwòðŒ†m¬…*‡´L†¬{ÙØ᧗ûÆŸ´“€ðЯGÕAR¬IPË®R, ÂÌ¥¹#õJ!D¯=c„ÃõªzÒÁÔ0ÀÄ\Õ3ƒ5Ü¡zÕ¿lLŒðÓËÕ'-W-F¨_?E2±˜dÏ [Ë›Hi ÍÊ&¢Áö2š×–Ý]ó–íG£1Ow)½­ˆˆhhX.ØÖdß8É_/Y£œ;§ÀZ;Ö­•¤BÓŸˆ­bÑüù4¥$TÝód­ª‚oØ/g Ð;B<é×%Zu‰éN˜IïXûàó¢J$„Ã1œ“€ƒ¹ra¥MônißÜEcDœÂ<%à‘rR‡M–àw÷D¯d×K›f%½šT±M>w¼^‘9cò Êé̱Wh®¯R+4õªŽyQ¯HžCôÊ!±êv¶^í|­ZfÆ·i‹GXg r­Ÿ6[k}†p#€°í9µ<â²»³÷h1êi2Š^£w‡Û„v’ÐúH–©C@`ív›Ö,IlÖüTëåOc0Ѧ#Eµt†èÔê˜^|‘Çx’Ù"8b)‘’BÝÂøB©~•öÝUŽÐ„yH˜ç)v±ÅØTfE‚.ÇÄ$ö/Z¨hâA¡‘Å öÈ×-TŒíÔjF¿/ë#Y& r~Ãõ*9T›õi»ÃôŠ<È<“.J Ê;k\£ñJjwh½ ÉZa"æ‘ÔäÀVÁØ„5î\½ZÉ2cQÐÖå+ÙÅ'ý¨Õ›š 5Øa-:Ú¯žµÐÜÍmÚ’b,e´Ÿ†¨-qfÂË^ûŒ0³E¹íª7a¸D”†E;SVË¥ÁµSY€Çº­:õO'A t1åÝ("bå­¬Uãªs_h å…‰ Ny}œ@Ql™AÊŽ£cJÌqH}seâ1Ò…§dÝÉf1ªíÙ!i «*ue¦X“k–BãÓ+ò òìÒPŠˆ…¾îMz5B­"ÿT¯8¾„‹!&¿)T½¢fP 戈‚Ž;G¯v¾VM „ŸøÄ'æ—™Ð/×*MØËÊ6]£­ñ?#¶âb³½ž³y%™´º@³Ý 3 lÖ[A…ÃIMA½£™œy晓<íe0ƒ>xÚCV"GÞß8¬N#µ‰b¡3c+ÏRê¶SLíÓa^Ô¡ª‡ÞubÖƒ"ÄŽÐqJ ãÖi¦ b¸#­k´P\mµÆ8mù„)‚ÄIÅÁÁ20cw\n³Œ¦¯ê×GÕ2úDßÀ`÷0‘LÝw'Ú! ¡Cå¦#™_¦A§’¦bí½"*@Ž]Ç’BñŽÊ9QåË`¼^Å\˜,;Æ"þ Ú%ï(ªW”À2¶ÄËÖ«ÞÅ-·± Fxò²ß,LŸ,óÔ§>Õò§&¢dè2,2çy¡’e–!Ü0ñÞgÇó—fW«7˜Ýrö|šØ† °µ €7 Ù¤Édù2™œyæ™#Þ#ÝtÓM“¿e+‡zèT²+»›òÑm·½ÊS÷uØ3wAAî8tˆ<¡tèT¤#”3“ 2¥þr-)&vÉ ¼AR`” "2$ ÈT‡ÀÌ; CrRF`±öÑH%ÖRuØÕy%¡yâ’[z‹¬‡a‹wTëÚ¼Š“(Öjë•+à:L'W€<œu`H!G.8N¯XËI¯l Œ²@: a„©&Ö+GLY3A”";äû§;B¯ÖSŒÛ¢€ ŠžÍB‘­ÌÊøFDï½Â&¹ÌΠçv¿ºEÎe•Ã02ãyÔð‚zï¥ Ð(mt+ÙŠg“<íu#LöGñ궫Y9Bb¿–¨i¬†qdU¶|•ï~ˆ}v‰ëŽ ‡Qá D°Cè8ÙJ² 9¢V×hSêãI1m hrrr¹X™¡ÐôQAÄRƒ‹~­’ã½” bñª©%"J‘5a½ )Ëc¼¬ù¬Q«XÿZAqbÅÊøýŠõÊä ¦\AN¯×I[I–Iz•»F›·› ¤T¨R@ÕÉI©^*#(¦­"¢è•s”é—àè–Ye½ZY£Éó´’n…ÌVÑ>µâVÓç9Ì5*õT,Ž`„Ù]´b ¼émfÈC.-ò)æ ¶ Û³Î9©Ñí°8 S\Œ RØÚBÆ8F*½XJIw±@¦ ³a)þIŸ½+€GÔuè8tŠÈ¹S:“,£œ#&ãé]0@ÆωèÆj¡>G±SÏŒ@Ä)a=‘¿´›*‰‘ºç$¾/’œ@‚J 0t€ªÃ.6Ë¥<@=çØ÷Åk?YFdœš0@ÚfRÍZ¹^¹.‘`^—œ _a„Ô©G I–Q4©ë•Àºú9¥ ÐhC}ä"YL´äu ÌôŠ˜¢7éÖôŠE—VO¯w¼Û<“Usb2j29f ˆ!®Ñ&æ)*/Ì<¥­aBý¢ WZ]c9߈2Á¶¬`!w¨nWfk5ÂÇHÞž6"Øt_phÅ“À)ÿ•±VÒ]]oWe÷Q‡Ð!.\ä‚Eüã¡p$¼ÐF ½‰pê7rº#è@cãµ[¨Ï5ŸgŒùe\PwKÀEw(‚$õ1æ’!$Ó”éGÉfUωrÛ#ž+­}×h–#ÃV¯VªX+Ö+êÀ,\Ðñ:ì P'Do¤‘f™oLz2ã}R©A2# ¤TjX‚\¬½âÕ+1œ _-½ZXYæË2dj ¼òÊ+<õ©OµœO¥Y9 òV.سŒf@hË”B†£é`ÿ´Ò–•çYÂg›e^P)»´ŽRVP´#ãÕ“[,ÔÊ×¾öµ“<Ƶï}ØàúCsDiVÆNû$ÎRj+XÿÕf:®ýu€ó¨p:Øuè* :)F(pXBû­É\©S4´GûÒÀ,ªÕH'3s ”L– &¿¨vÃA€c”DiÚH¦êY‘]³Y rÄÌs–&ykÌkø08ôú"Š4+ ‰kÅz•0\®×…ëFt’;Óy¸N„#´«ä¥:j´/¾n®×0À$ú@9ö¥ Alè;P)M`Ï<«@£õj霉gaí3ÂO<ãàë¾ÐÖ‚bFvžaÈÔÄB…Àa¼p(6q´yýÙE6YÝXÚ—¤VZhTQ„Ë Qý¥ÖG ã8•µ…_óš×Œ~kkŸ~õ`°E8D4=µèOòi¥àHíe;ïY½k붧™É;öU,0¢`×QQQÃø©4s¨2YóÐ!vÛ`„†J¨­$9ÄQJ—)E 'ô ‘åyÉφC`ªž^Å µÃ΀—î? ΙC@ç¼1p¸á!_Æö˜8jLÔ¢†bE¶ÅIÿŒ,W¯œ'ò¬±@AA×eWRCùT°Îä±fWÏ0Q@ãmlkmòÊè5•4Qq™F¿(ƒKá‚à.õ÷ED£W9yÖFèÕÜ9,7wÖ#´`&5dr,© l-óÏj&ò¡Ùî0´B&›T±CH-h¡Áð¦BÄf ™ÔPÝ:³Ö®M±,PÊzµú¨‡=@+kŸZãShj^¬Z/˜šÖÍÑÐU«~WVŒ*ËeûïâE‡¨ãPøè-^1rÄ‚bàЛáM'›Ž‘(­W3‚ò?eCòb$4&…F—)‘>ŽH)¢SP‚ÈéÔ’ñ¾ìÓ/—ójÔãËd=&Ëäz…VͲݫI4kJ½Š¡Áy…½‚½°Cù“xa•ƒ4ìÈîOÇHpYy5µÀAó?k0Ù’ÌÁä2é.!0òÑ€ åN2Ea4‹i…zµ>’ex‚L™&ºÐð|™ /[Ï™µÉ tõlÒa@˜a˜"·"¢6³ÐØt~få¬Æò#D‚ÀQývQ}›¬Yûï+Äiu!5Ä¥­µYU‚± D,wuæ\„4šB§‰ H–&q»’áÓni üB¹-¢ ½ IDATó«¼ 6Y&Ú @L[g¢ÔfîH㸬xõÄ­U‚Ç~†K Žk‚ÃxYÉ2Ìu´kmPW¬Ñšµb½ŠÇ(p]v]rsJ ác¼0åÎ8ÄéFSÖj (+’•`Ÿ ­¬ 5ðÓ8Ÿ×4ªò…JPPÔŒL3½r)ÌMñÙV^P(i%zµf–i­Œj³Vü Š#¤Õ5j!ê¹£­¼Ð¥ ÒV¿hFû¤ÀÆÃI W§8!)Ô¼˜Œÿ)þq=dØDD[žð1® L‡a¬P½ó®Èã8Rmzüâ±™"¼ ONÓj(Sd¥˜ŽC‡¸ Ê#:'¤Ð£k|¤Ô@xsÝi)áûà€2Q@/xFð+•ù•¡Æ›±d¸ŠGR âˆÄ)½£ˆ¡¡’õVÖS:ªY²àäiOòó\ó®Qs«ÃôªB¾šzYEš©sB§W1àç“ó³¨<¢~® /p˜Èb‡PP¦U`­Bߣd„¸LÄ΃¨ûX©Ì/”u.Ø$ˆ%ØU<%Q@L\#­²Kû Ó”ârõjŒ#üä'?iw[³f2€´ÛVP¶;BZAq#ìt: Eìe[èRG¥^³‰n3Tk‚Ÿ2 T´_‘¡à0v¨ˆÈ̯zÕ«¦zkËÂc=vÚCV"GÝ\ÛÕ¬™Ì#ª5±/ŒØ‰çº'’¿ÛÅ©±3Bõ4¿Ý!bOä“óH'º>â_×c>a¡ßlº@ðÌ>Y\W=1Y Ô‡ë¨à‚LZ^É gBƒ —iÉ‘*j’dÐ8.9æÅCf´P‚ì \<þô)ûâa™ØÌ£ö×L{ÈŠäæ£j»UÖ jѪ&ñ,Q,4'ìæ•ëyviNQ—üŸ>áŸïÂÍÇòo´ ðÚó&2Z…’Ð'ôÊBš8»¼ŽYä6—iò1T¨IàÎÉXxŽÔ°M¯@±ÐA„‹§û©^Zoú~û5~:Z•ÉÔ@øk¿ökRìFµ}+*T4é#ꤪU, b$ " fXؤƒçtÜž-Xº&—gGj¥òãÌ5Êm¾PÔ‡ ¢ÍÎ]vÙe–SžvÚi£ßÚ2b„W]u€ã?~Ú—'פ±vã  †:"&_—%7±œxaÕLõˆÓ߉ã¢*³•¬˜'tˆÅùÕ BAè:Ì;ÌyÌu@›€Ý€ Ì€.Qa4kÀ<J GÔz@(@=ø>h1O PóˉBåu\w&ü*“×TÎ@2Š+N>“sãT‚)á%ÉjãŒðŽ \¦i±Jø³Æábj‹Å‹G ùë¦=p™rеñIÚË"båohSâ…©ÙrõŠtö™;Æqœ_­p‚‚sèÌaa7`°¹ TEÀ€¹zI±ú@ô}EÌ‹ãÿ’^‰ZUŽÐÜ垆I¤öñ Ò©Åég2Ͳ7^SÄK" 9E7¼#X½Z-4˜|¤.ºI#)Ü ØƒyÑF`Eר|wÉ<b©˜€"Á¡<\Ô‹¦ŠRªK„a×p‡‚›Ù`!X¨!1S ²q_¬™µT=Ö/•ew¸Öë!ƒµ®Wµa–/£~Q[¯¥Hëv_ݤ+Ó«´Ê`ô‘ºä&Rè»èÌa/ÂÀ&æD€‚¨ÒªÔ½êõæ"Á¡xô{=ŠH”FÄ ‹ ×Ý¡5‚ªžh5‚5 Ä„@Œ’²ûâô(¨Rªôƒ^¯Â`â÷»J²ü…yyˆÓ’¡¬bCÖ€ÛavÔXÉP°ÕMš‘B=ÖÎÞ’äkz&³/U¼Ô]-Ø+·ì°uPD3)Ô™ eZ;­¹UÖ~Ö¨ˆPºÖŸJŽ‚õ”™Ê¼£ê¬Ç³…Za°$[bL/>¢*¥á€5LC)„ÒîÀ&æ½€=݉6siìX ôö˜{À‘c.˜eÅqý*‚ëE*‡d8*ç/iÃtQ‚XvèR8\Š BÚÙ^'@ðbÅ2 Aa™m+yå˜ fYŽk×ç}¥ê“: f)3lìzå^®É2õ*ò:ª¡ N«&¤pwÂ&`/æ=ÝD5­R÷óàˆ fÇìÔzDè¹HäRUåú%®®Iôª"ˆ¥a‡.…)Úê¯TžŸóñö‰e@…#’ÝéõjzûJe9Œ†—ÀX[Îx¡~Š:Ì¡~ªÇ69Ö°Ó*Ú²õŽZQFã ‘z©tfþ‹UÖ À† ›>ÒaL±9•š¥wz# ‡‘±om0B$ÚgÝ›Yç=ußåÓ˜Õ­ºá“Ÿüd$H@Ž ,ʇôŒ0YcóÆŠ½°a¸(pXE§Ó ! ‹¸zG­ÒÄxÔ±Pw3\·Ü—+Î+ïTï¨ÅT=\ïÂ^Ò¥—^ÊÌcápíáWH½m‹| +PPeÎ)RV‘BÉOX(IŒ”5U±¦dò¤æŒ™IU× éÔÖyfOTsÀ&`_`` ¸=ÈäÕ09J¦x1‘Âh؉3ÀΨ ±f“ ”ÆQH¦Œ;ø†Jb°£è¹ "-$HÑ;š¤|Û<üŒƒÃµŸ,sÀW’Õ7Èg±°*È#µi”œbe顆Kåä\†^éêðœuÑ’x"Ï\M¡Ub”˜Z½£±7å ¬³F£WBw‘–žd°J"=í@„ª ÓÑPòŽ&™[‰€Å?—5ºöaF0œfX˜yu«¾AAA 6WK«X4Íê[k´ev=ö¦,”Z4Íî}Ä,Ž6Nvñêÿäº6c±­phO;¬Ï‘ÉÚO–‰Óí®c!ÛLÞ|ü!+X¤`DœeXSKÊDÃL'ÑlÙšt`s`ŠI›ið»/™DeòE   ôÒ•‰£i›(™Õw¥×Žtx Êý‡D~å鮚ÛÁ…:p¾:§dsˆ;4%Ô„”\ª6²LÆK¿ŸÃ9¯Wë Y†¹©W5,gz•´ª®YU¤0½8‰B—4­^…À.ÍðÂ%80â4þJsI4V%óp­Šl/Þ}ˆL1>ãÔµƒ uà¼Ñ* ÀyŽü•5³&)êUTcL­Wë YñP?ÕÊŒiÝf è½‡AK’”9!1Hu3Úö*Íš²,ƒD˲äÌ[\Ìv-êØr«ß2ƒ.®sA›#@ÕêÍj&D¾LÖ>BLVrSeѬ  ÿ´k M(•Ÿ½ú¯J&".™\Ü¢4f«LÝü’¨d.™Ê„|eÀ @vŒÎ"ÑvæE¢mÀV` à»l˜Ž ôê©É"¤r¨›Ï„v".”ñ ¹>ï’­‰ªI^O‚rÄD¤92eÊŠt&b²ö]£¨+VæÍ*S¸þ¥¿ø)ÇnÊôzÅ%qÉ\’ _(à\‚Xì`;Ñ"ó6¢é´ Ð~YC«ÚH ¨Ï€|"ÆŒV½Š{âõéÇè@Žˆâ™äÀÉÁ¿B½Z®Ñ&)ÑÝV⢘åƒ4GÎeCšîDÅùTëQŠaöÄZ–¥…@½$@U8”m†¦M¢©7Þ¿LæåKíäjz H¨°y8×°ÓÊÚwV²É ‡'ÎÀœæÆ='Ž";&2]x{ñÑ< ˜<¡D,t€AÀÀÉ–ú…ÀÑètº ðww0w‰ €íÀ€€°˜Ò¶Û€EæE¢æ%¢% ôSdg â¬þl8ŸHûÜ%­0l²ŒÐ ‚Ge!©=!Eƒ9§b¡¥öL"kß5ªŠÕä…#g†æ4î‘Sž ÇÇ8­^…Ü mûä ð¡ÐCèb¡‹»=îºÌÑ­™ˆ–˜—ˆZ•ô‚Óí'i]ã^|âVš,Ãâ˜`ÀÇQ’Ú¡Ôè•ÅBëȨ½‚ d¸FÿùŸÿÀŸøDLƒ…hØtnsfȇäPÍH!¥|K-dR–¥@Na0ØКœÄ‚bÆÿ”2¶¢`F 3ô²=$;ˆ:´©•cÉßïýÞïMòÖ–„OúÓ§=d%ò¨[à?÷ô'4 •#²©Ži¥?—€P “X®’Ø3 ˆÓ Íý1{EA°gî}â^ N@ÐX*á o'rÌÄ< Z0ù}HYî=@Àoh¹G´úñ²eeoì —EêU´¨ë¡sòy¥±ƒ`ŠÃíãRPrçÙ™°“î^;Ùtý©tü§=dErë£`ÿÿGÇb¡ fš•Ró&Èð‚éõ* ˆú ¢>BC‡BÐG¹ò¸}#1˜ˆÚµ Xb^ Z ê1/5´ªêY½Š‹Ô«(/”ʤWvì ¥áö²TÄB›;™^-¼v’Ñ©àéá_>OÀ2€ðW~åW0Ò+8¢m\0 øY"LüLë-”‘Vƒ½‹y“:ÚÓ6‰`h¬Ç”I+™³…ŒÎ6%;jBÙqÉ2ÿøÇ<ãϘöÀåÉUûü±äOeiLÒ¤cBÌD¼ÏÓ䪑HC5ƒÔÁ¦Ýç—LBÜgÈÒqýOX*áˆ:—J8D >æo#W2/0o“_Dò³b™‹¨O´Ä¼HÔ3\° À}p¨RrÝötoj«[€”«gm · ˜;Saaz:B[…kå “exzF¾x÷؛Ƕ\Ùïª ÿDjŽÐ¤Yÿ\ä‚1ÉRîÎh–꜔8  éô*ôAåÈ!t¨\â8Ð BŸpÛO¤0”rð‹1,CÜ\s±A\aÍDCLf¶ÖYÖ¨¡†#ܤU½î‡hÎÕ5\Ê ~Z½ 9æò˜ÔÔ¸r :$ í™GÍhúf$F\€Ð&·fïÑèUÌ#M[Õ*8¢O¿ÇVlèU…¸RÐ þ¦Ô«u“5* ~\ú†:* ã…@Ëdž­³z6/ÀÒÁ "ø'!CqŠÚåy3NÖÊü†¹CU,³Ì®ÄÂa“Mf_”Ufåìb,H•õÅm!füYwVÂÂŒÂ%¤H°¤,¸trqÆ J½u»j*,&†äySêÀA¥¼?b¦À8*ú}F¯Ä’¬__Â÷ªEêíí…ÄùØ03;ŠØ_É¿ˆ™À’5*™?b¯Òp2  ¥xªÚ™MQ4²)qB?RfÔþ&‘uÆMÓèÉ&æ¼+ö€˜µ }Ú¤}*½* Ì$–ƒCI¾î£ìÁ/Á( ôÌ"õµ›´ ©l)`›^Åþ€KîAf” OV«KUç¯:³¢¬~dÕÊêgJ5™^­¬ÑÌ5Jõp u“ZxfØx ¥å0¤ä ÕkÈ ­×)ÜNÎË6[Ò`Œagh~E+Ôe®N{³ö¡éµñÄ¢Ç6o,\_ŒÐöÝÉØ/fÛÒô)‘2¥ÈŒÑDÍWØDÍÝÔ±N ™†:%Æà‡$2˜%sŸ©Ðs膸H}ÇÁÎ!³YÈ g"y¯\òp É“ñõHã“ÝätSºM9%f9_üÙÌÌæNðÌñÀ ^Ûz™b ©«¥uŠV.Sux"Í-@ ‡R\ %šØ¦W2ÃTzib\â? .Á}}r=„nZ¾88‡azUA´¿»h·4ç“â(À8¬”`ààÉjUréL®W`fÄiýBÑ+f£YËЫu0ÅÚ¿þë¿xž »Mþ×DǦS´‰…H¬Åba+1ÒsŠèÔ0¨ÃŒ%…l%…“KæüÌ ÐÞ,Q-Çgøg1Owqšbí±·À—îS9¥ŒGk5Ts$XXÅ ÊÕ”))ÅÁ¾úˆvJ{ñj¿Äf¥µcHæÔç@¹d’EÁûLóû…£"  t\Z§1W…†Àa«h„0EûÄ)©Ï—p p’B8À`€¾à(CþÅûZê ÿ¤† X*HÝyÿº{Êk·=îó¥¨15Oéhj˜4+baŠŠ”“GTD“²àQúiõJ4‹Kö}AA„yò}vBATÀuâ:quûª3hdœ^Å s‚ÀˆˆV¯J‡ž­Â`€Ð¯8Æ!ÿeôJè Àÿʸœ“‚eS¯_wO™bí„N€ápl j("Qº`æ³võerµ  ØJ†Dd~V)x#,0ƒÀŒ*hé팸—ì 3 Ì‚ŽR°AA{mÍÑ\çˆÒÞö ZÑñ]ïzW˜`aÞµ„_Ü@L>h'‚©¦Þ{¯:åÂÿdZiiæÒˆ(qq±fÿ¥¹Ìd†j‹aŠýw&­1hÒMËúsúžŠ€Â¡ë¸C(ù´B…ÌÍÄX3©»“5íu+§ G( žâêƒŽà‚€yÄ¿A@?` £þÊ  ÈŠ|e°dQ¯½uå›ç'Z˜wí#Üç‹€¦KµÁjÀÍŠüS’%#¸¨X1Y‹cÙ¥¨;-šP¯%B~Àa¾O¡ WÀuAv(­h/ssË-´Œ¤z1_Õ^·r*É)_{OúHh7@1ŽR(*PdA¾PÖÉb`0d1ŒL¯æß\N´0ïÚg„œâsŠIjåuWlô0¤$3¸Þr&]ÒA—}G²ø2ûZVi/i˜Ø¸ B fÊX洞C{_­•lgà—ñÂ@Ø¿ßÅÐ6Ó>ðѽ•uàžqCõêz­ ¦¦š†ÚÆ)Î;Š”Gƒ'ãàò%L YU.n9N ©¦ŠWÙ.n@?PÏs7P׉G” Báà…cyÈJ­”ò9¡=sS@)ùEeÀƒ]xx—ËH$O`O°Ÿ qÀ0 ),–ŒÀ$•¡â‹SøE^ûÉ2U*í¶éU储j‚©Q¿ÌÂäa18ˆ€4§ä‘N­W¡‹Ð‡ïQè²ë’xD© W€\;Op I“"Íò¬¥ƒÆËn@ Ì2œ`O–¼ÀÎÇ‚ªWœ`Oû9þ‘ÂØRyaœFËÓ«ÐÛÙ.÷e.Ì›áÅ<6®QnD í DÚÌF •#ÊáÙ@ •[¿Za’dK!PËrMßôŽ6á l…ÀŒÂÀªmoáYAÚ^¶½‹V, tÖ¬O0LÖ>#ÔYDŽ¦IÙ¡v×cAgŠN½w±:ÑÇÃ1û=¢LîÃ1¸žá¸dªŸ.Š8üAÆ¥9¬Ò8À.0(Ñ+ÑuÜq(éš½Ž2^Èl”zésõñ£”½!0”ºTïBœòÔÔZ&,,# ò Ä)âS3!úHCà29H­å6âÐÈ:>¡A³˜™©)›l4‹uH]Ò¬2dÀűKaºàbþtõ+ŸÂ×ìÜ2ôª ìÁuá„ v(®Ùë¼X/–€L¯Èl54X¨:ÔÃ5¡7QÆ?ÁB.# †Aœ".¢£6 çZ–^­×álRHFလbqBQÄ¢£~‘"¢Z36ËV讈n/­¹†è÷Ú‹i-ØmÖ@%˜‰oš8Š:†)àéd§#3ì´ j+Ǿµu„õ’â%·J–>“Á!ë°™Y0/€ÄM%^S' c5‰É0z†± ¦’ªÕÔT €"-{ÓOf«:@/ dåzîÄ0!yY7b!Yo§3°G€“µc%i3¯@H‘YJÙ+¿¤ê‘ƒ…FP2÷LÂ… –Ì%#Í¡o0˜n{™LØXYû®QÕ¬ŠêÜ_\ƒC‹‹ ‡â=²2Nb sI;ŽŸÊ ÉjJWŽ=Ø/O¯B¡£+׳„ Eµˆ4ƒ”ÔÛ Š‚’Áš*E¯d¦PJƒâ…YƲO5öÁƒ…„ˆˆÌ„’*jXÍ•Ê\"Ρº½Z®Ñ/|á v÷q{œðd· ‡ZoÃf"ÁL#mÔMªçd3#“ap('‚d¼£­ðÖZFÿª›ŸÂ`¡%pùZ ,-ìÉy&Ì‘QY†kô¯xÅ´‡¬DNØRÛýüæÔ•oÀa-dH•+˜5’W „ ”ô™ä&•P¢ŒAÉðAæ‘ŠÖ*®pZ¦ü¹A²V´í #–KàÔ!tˆ}òd ;$ex†ç¥-Y€tÄ^ëJAIaä¹éd‡d”1e†!B$Ñ Ô㼚tÂ$<ýkîU“MÞ¶Z²å„ÚîæÏGÅ"4àЄ ^%iC³BÂ¼àŒ›4ÍK-±Ã¸\‰G åéwÀ’#Ó!ê€<“¢—¬h©–…LVHé9(:Wã®ÂQ¨7µ!A ß B]L¢T\0¢ d½Ú$šÀ.C¨² ½ZxÕÐüÿIdº¥ ˆè1yŒ–mÁÛ0¥…ap"Ò§&zY±ù/vWü¢”Ö œ›7âš‘`»õv²Ç‚D …Ÿ5I^ÆöZÉ_kågœ1â=Ñe—]6ù[¶ròÉ'O¥!Ë"úì^Z®¨QŽ?WK«tk]ŒÉ/TùG\Uã]ZmÞEÒå=¨tÒ€Ô¡|[´M[R‡â > ð #…¬NN"r \t êÈPÉ&.zAÔ'Â'RÈà2(ÛIóçù IDAT³1È’1àØC·ýw-3:,Ö«pɆå½qwÚÂÎÑ+ìõYÝ©¨QÖO)ßÖv]zþ |ôÏ™œ‹`—è›÷P=Y±^9—ÀÌqtr ísù¥A±0QÉ&.Æ©ŠêñE¤Qù -Û«b GéÕÒÑzµá’ezNsËÓ«eÆa|¤‹ˆ.eÀPJÄâ”y)ƒò\ÊE¯iH#õ(û4šX˜a[+r=.89®ƒ¬Q{µ0E2\Hf'ùHc†*7)'ï(’3‹28L™%NlÅÕe™{™žÆ\ ÈwÀWv*ÎÀÑÄžãœ4ý™të@Lœ@QìT€#6@H¹/”«r öäŒH^8ÄQót˜¸`+£ ” ±f¡BÃZiýXÙéSaM-V±êzU))L&]8¬Ü¤šPƒJ³,"F˜á$ç„Óz ./äQ:`õ ž2½ ü¸Bu¥ê‚º E»êŒHC%X€˜“VLa% Y3ò­+½Zr=(ˆ:"*Ì+"R}BmÅÛÀnƒŒß3‹sâU8¤äm…À±Ôp4_œœÚ烶`çX\VûÖÖ#„%…Éàsbd†U¿Ù8J91ÂÔ²ò—¦•"ì‚X9&]œÈÓ|¢‰Äð%üð, èÀÉL¢•µB{îðˆw-¸4W•SFh—8b¤É å*MT,”ÍIÎßæŒ>R2ˆ8YL¨X DGY¨´Þù„I ë‰ÂÂ*‰T;P„¦fÅ$šä/­Z&©®Å °ÓJÓbEÑGš¦ò$ö‰&JgQ¡ W‚s¢?•TBŒZOU~[žŸÎ#ºÀÓH‰*"¸®õjE@˜Õ[P†—º«Ài –{‘q“6qQ`Oø™BýÈzGm›apÆ­dqb#Ìž^›¸ˆF(±)“¼µu„Ù}ÿŒÅjakîŒñ—ª×Ôi„)Ëô !ÁÀ‘J GFîE8”Ý_ÂõÀF/Ù,_ë¿W5YÁ·[+Ò^¼±çPô;‚'Ò˜"êsÐèã ©À! €”–Ì)YŸ«€MÍlÙ¿I4k§g÷M-™b‘­7 XíÖk(Í®®þÒÊkê¢Ú)B'}‘²’BªÆîqÊÎ%‚CéÑs;T¯š ˜"…L¢WQ•Ú¼£¢W CœŠ";\ÿz55^uÕUŽ?þxÙm™sj§O…5µÜõ$ØãSq· xU¥Ñ¬8‰­Žc5%ˆªX PH•.–‰"J.8 edŠ!Ñ1çQœçžÛÑz¥ëRì]é5òRÈÑß@uÑ)õª÷öb¢·¶ö§X;î¸ãÐÆ -¼ÙÂ0$ÈOk,Rcº– ù,V Ã3ë&Õ6­NÑÑžÒa4#ÇÑÛÏDÑ,ÏSlåˆR¸à‚ œuÖY£ßÚjÇÃí_zë ^xþ•ß[Ú÷Ø—½ç¯ßõ[÷ë®ðŒÿ´ ¨wߣY¢ª^m¬_´Šº[ÅÑLB©pª@y¹ŠÊ9P¨òK]‚CIO($ɧ¼›Ñ Gðà"à«ÊÜ„i™ê…d¶"Y$3hÚµ©VZ΢š»$ÆEÁ¥©ÑÎ{hX.JôOéràî¥c Òj»°V_¯°éŸ€ŒjïIëGj–‚¢îj$MA1ßMYãrÎ!¨¿”4¦9Íȃ ‡9–Ùv¼^E²hôªeÚ6TËY¬P¯º§ô9pÿÒ1¯uçëÕq¢á l2B[ik,¢-MP´´¯ukQ³Õ#ÚÈa° CF-(†útáÚ8»»Ö'™¡à°òhûÖVïþÒëž}IçÜ«ï~Á}®ýç<ý9ÿçØÏ¿êˆÉºzÃdØMT™2†¢•¦mŽˆÉG*qD»x{@‚@ËS¤Pˆ£K“zÚh¢'”!¤€zð’×@±‹ Ù× ’Å+}½Ò¥²úµ¢ƒìÓóò€I@1=2Ëu›L³™ì±LÆK;ï¡ÞyÏjÆÊê&5콚H±À5ŦY"ª4ÆÍòíHÙV0E—ˆ£B ‰&’G(#LÕó.}ZÂ\e­@ÍkàÂ$8$–M…Ï;ò¶ÛnþH7OÆ«~ÛGÉù_mŠçÔ…jªxä+ѯZÕžûŽÐ«Q·Q)µ+V*‰¬çV’fÍHe!Áa}ÜEÅ©¢†v bLô¤41}T:ãž,l2Ó«©e½Z#lZÞa†^>²æÞ¶g“\ª•Ù¶¹;G¶&àiA±ÖºR©Î[‘u4"6¯Ä#mnDzÃìÓѲª@ÈÛpý÷}ù¡ó@»q̾·|ù¦E±ûŠN:ÉÏÔÉØ®ŠQl§X¨•–&ê6(qÔØacKÄ>t¨ÊŠ…^kpqé8®ŒT3ÀÓ°V±;Ÿ¹¶4ÀãÌÜ9ÑÀ¨o<)ÖU“_«f§¸n¹ÊÜåµÓ“vˆ^M¤XöV­b)9¢¢Y6°‡2¬|§)/³ÂH—&}0áC˜r……>Ö ¼([ð›éÕ™H¯¦Â/ùËùÈGÖ¾j¸¶q}Eë§Hx™áâhhŠ­p5,L˜e“Žu¥j³ GGÀa¶mÞ~Æ톡]³òÜsÏä­M„çwÞØ“-m]ÄÜîsr+n~béÎ…•í¯o€ØmÒöÍh"Ì/·–¦¡÷0phËÂk‘Æ] JÈС”–‰z%ˆ.íöd¶ZÖƒº°¨“\^Ö©“EY\ðê]x)3Ò:éÙÏKŸˆ5U™;K}\¨ºï›(]aò©°æ>0Ö¶í½Â¶_€ÝþaÒöÍh"P=_ Š‹0CïaAÑ–C- (¸¨¢€G”ù›™%ef„L„YÞMÛ™ÝÜhéî%K[ûÝ=æÛ"ìÓÈ•”ê1¹ä¿SM¬ªãëR7iµURØà‹S´S„’B³›á_U#pX&Žèë馼óžïê–Ž,û×|ú¸^hz´`ìWˆFméÅ0æ>4½&î¹/½ fjæ>ÜÕ&øi›i„Xe×(ívøÃ÷ùéÕ?\zÞ~óÀöï_ý?ûýÒÁcûec„S_|%ºEæøÚc6ƒ1„#µf£™²ˆ¨Išu—©bÙiKÿBî5õ7€ïË2ÆkZÿ«ºð”ÊÍVÍZ¹dfÝG–>Y€Á5ÛÓOG»SkYÕXÎÑ+!,±°‚k3äÐò¼û\ùù_8è9¶ÂܾÈGÀõ´HîφêHéR¿¢‰\µ¬â;ó¢I¥ñ®wè2\tqx~\d^‡ç¨ƒZ²Ÿ¸¶\#ëO3ýtÄ}òb`¹Õ:9‰ÒôóÕͳ鿫Ký]ceU³ûv„^%.¸zšÅM’Ju¤t€ÁÈ@? SÌ"ˆ6•ÆùjÜa&,dç²ÑáùäС™^©L¢W«„­í—Ý`j¬a1ÃÂ&¼e3±eå±¼°¹̪„Ù%¸£aO¦5|Ø,–U>±ñ‘çýõ/zÎÑ_´}¯‡=ÿmyêƒW<ÜKGhû•5orìm¾aW?!Óï]C$M?jåE9’±ö{J|BO(]¬÷!¡¦ƒÑeʆ êùî)Á!Z.›à ¡ÀhhÞÌñØf¹jvŠ'E‡UïµôjhVí)pØÔ¬¦U) 44Hp>n•Æ‚Ã-\™ê}DÍXvpn¦WÀDzµšã'l¹*_—IÓýØ*MG¨Jsòni© g—¹›™ÄÉŒkD}ˆ}vUÙ5Or×M,Ä”Œpµg–¡MÇœvÅ·N[Å3†FA¤y‡ÃîdUîPÍUU–Är4ÕŽ"›tMRhrd¼3Ó³9ø€Òʼn‚….ÄU/\€pMs€¯g4h‡]’t@˜¨,›æ0úYIµ²¸Î$²Ê3€¬¾^­]ÍÊùeÊ6YË XV92ÎWÓ³9àáÊ801baZõ"Èä5n¦Wcõjj ¼öÚk}ôÑÖ Oå)mµò«(kzG‡9B3RèÒ’”¦3mÊ&#´sßPcâanÒÑ2Œ¸è¢‹&9ÃÚŸbí™ ð± µ_Š½hÎúóœÿ¦šv®U±¦z¶3ïL!9–ÐAKŒPøŸAAÄAÂBH™æT–¹pÉ­*95˜LwÍ€Ï\X²Kì†H3FiWõ‹³dÉößù+&s!¬ý¹Fž >† 5‹›Š³5‹5‰¥Ó#ôpe"‚‚yƒ„… â&•NVšÎ­ôpŽm#+v®^•WÌOôxÖþ\£Gu†Ó‘aè8 œ¶ýhQˆz&Kí”ùYRÈišoED‹(›òÍ^FÓ;:b¾öµ¯eæ·¿ýí£]û@øÑ € % Ûr­F• ¥¥Ù¢^δª4ÉÓ1]÷h½ª=FÈêêG ¨à'¦I ô!˜õ.8.>X:xNö½€R¤'õÖs–æ¾k’’!!C¢[8É!`Ã'Æ<˜u°úĆªYœÕ¬†fÕlÔÊ4‹=P«‹PÇ.R@?éLÉRÎGÅŠp袹ìã€}O°ÓÐì\½r'- |bÌzÎëuõ‰Œ¦ kÙúéˆfSµÉ¤ŠœY¡7suf‹¶~$eõ‹¶:H©19xëÅØël-~˜co?“µ¿ah+kô¡ýÓTh5<#N¢¿Ö§Öíw)š¨(h–ÍAÁ(Ôêà‚CÉð OðŠ‚ŒRÒgdeDÉ£qði%Op "¸2Á¡ua¥É±HSdp˜ BÕt)sj™§ÙÞ‹ÇÄôfí¯Gت;Ü|ó˜Z³ZN²2ÍŠÑÄ6Íâ\D_h¤€² ’y°(ÈT‚}\Qfw’Pñ{Å$. šé•ÊʦÅ2¼Ùf˜áyÍÓŽ8[ë·S]Z¡ÎÒAÅ<ï=ɘ¢Â¡]QËÖAê†LÃm¥˜ŒŽ}†#dí3B ‡®vŽØøH¹cKeãOÏ`³UC£±=‰ˆÚgÆkE Ylœ1'tÐÁ3¼ÆkÞ¹^H‹¹æp˜æ8u.Âatay``FF§Î{\°7]bžò7BFӡч®}F ‡®i4‹[•b¸fÕ²UWI³¸ƒ0'˜'p˜è ó`®b¾LÈáPÜ­â8-ㆄah³RÙ/¨fW¸Ý&¡m· {¡žã ÄÅ‹¸ÑÌJÓ\uÀ-ïÿû§eŸË"úÈ| €5ûíŒÊù9ì Àle³7ÎŒV+eW­L×ÌŒ¹ê:@— æªK˜#Ìs”v‚ª ÒŽ$”šœR—₾>yw6g[5?¥ªÁÙdV“ãW/Ô»íÍnRyãçy´^ÝqÔoÙÊ^×MíÕX†æ?ÒÖ5jÓ,¡S¦%ŒÖ,f´jgjÒ—Ñ,êPT+P4Ìæâ.æ@E•Aê:pš\êS®)Å];yw6g›a„Že_ÄŽÒ+þüÆÑz…£î˜â5[¹n¯åéÕ*L±6 ÔeõSñ¿aäOקåºØ9¡'õp /T:ؼ;åzB—VÔóË9µ¬Qy¡^€½2s«¶¶ÑˇӾìµïµ¥5¨W¶:6al'$CÝAA.§†|æÀ L½Ô”ˆ[‹¯sEè0 `èªN^"Ž#d3 Ì⟖pAÀ<|'"èQ1B¦8Ó#†{˜«‰oj¿ê9°ºDuƒeeJ5YFÇ}§ËšÕîØD®Y£øŸž§M³b½Ñ,®t$­f[ÇBò` Î}ÐÀœ¼ŒãIÔ¨0WèÁÉ /\ òpŒ aBÀFÈq¦7¤µ(t¦];O¯–ãjX™¬(kt*\Ì ±‰sÍzAǬ^Ðz5ü²+o½Á6ýHÁO3ndWAN]£rˆ4€¬,2Œ®\ÖKÖ¨í®O\oÖì¥k]-ÛZ\´+þ•©Ai,™:K¥ë.=ö( Ái«Ì•ä(BWÍÅÛØ«ÐÑ„ ½‹°ÇH³Ø$vHˆÆ*ÎÆ…„…¡Š€í§³N:7¡~MÐ×Z@8R³FA ×› ×, ²hg4‹ùÊÔÀhVå,­k•àâ´ÕÒD)ñÍ&ØSt´aBç#ìÓÔn‰‚R6 BDAP\±ZA;\¯ÖŠ¬:ff€7¬Ü”&*5Éß°û²»ö:µRI›B 3£ïÙ°C®3D#Xˆ!@¸Bj¸ö¡5TlÿŽÐI 0d‡¬ŒV› ÔB`™ ЖÉnɃ÷À¼!‚")+F Ô„*XèÙLÈ•â…O`NNÑ4¦‚.cf)«½B*¨ L ÄéJªëkz´š2‘Z­# lhV‹#t¬kV S¹Ýj!°LhËI³â/Úó†@DAbÕ+PHô; ÙC§d¤xáÿcïËã-)ªû¿§ú¾™D6AWÄP‰k¢&**ŠÑ¸ü¢AEQ#Dd5â†Äa“Íq¿¸ÄDBÔÄü²˜h4 q_QAE™y·ëüþ¨:§NUu÷½÷Í›á=æžyŸžêêêîêêsÏ·¾§NU‡1Â&*VœeÈp0Z–ÈRQ,PR,691 Ä–¶€^­ œˆ‚}Ðhv"_Q`ùlf°ò5­ õj"Ÿ«=“¶æZ+ë®Ô]öƒEgÖT+"H;¹ %‘ŠÙ}UZ²¬| DGw½$‚Ö\YžW­Y *U ôŠsÀX@q xÆXMcŒ¸»VLRÀ¡HÝdš<é!`#bzAŸÁ¥J«;Á¼H¤ etIò 鎤~,6ˆÈ¤soLS¦VëfM!«Ñ¡Y%ìÒ,®Ö,¥fõ²@£Y<†j{¨fqеqŒ…‰PG±Šë¨…¨V@Ú(Åj½JîPä"@zŽ ï¢b>쥷Åõ³‹>˜b8«¬| üÆ7¾à>÷¹z8_‚u™ó¦„À½ÆÅ,¬¡4Li˜Æ[H²p6êlBÓÛm¢Ï;ZðBÛ’¶Jv÷‚ .˜øX ®ÑÃ6À…&X´Žv±UZÆZ#[˜9Y/{4Ó­Él"8–£ ¶R˜Ca&€“Fƒ/¦ ¤0£qÀ„ÆEPd#d 7+äl)R4iFe0‰PŠÆ<ê‘èEÑçºÍt±í”ü[P6ëBtAòú5«Ä9S˜-.š£v /áb «YÌ°š‘Ï¢ Ñ,nAc¨fqXjˆ 4Êüä{ ã—`¸Ý¥F@‘eŒ#ƒŒ»$#…^|¤Mj ¢ "L‚‹QÉ)T_$׬K³ïÂ÷ ¯x ¼ï}ï[^' Ö»E±ú¬ÎT,Ž†[[t)°°¾”^m6f‘9€©ÔúE¹ßAŠõ5;äœ5~øá˜bªÃÊg„ïYgúç]îPMÛ2Ö\ÙbÅGЈ`Ê$w(Ðr:ÊÆÿéÌ6Ô'„ÆP SÀC¼ÃŒ®iÿÝ@Cha jhãeÔ@WXh‚»2Ž˜P0$ò· ª÷ëýà¶_™ðÖV¼ZëÞ“t¤ÛškV†s(5‹íî0´ hGu€0©ØôŒ Íb–И1 Í ÐWÒµ\¯@ác÷ F:È üb¼Œ(WXh‚»ž—¢ ØÝì-¨bíÿkøÊm'¼µ­®X›û¦[;¯¬Ò‰g¶p½:¶. ƒœÖ¢<Ïb'™ÕGIBfô¾µ›” wTëôÓÚ›9QV>#,ºåE_½@Au‡vwÚ«y5 z)iýVZ¦Íw½©X0“Œã5ãh"aÌp„q˜ö'àä€E9e º¸u>ÆŽÆ¢á¢ê5aUBÜ™ÓÌ ûqzA8¤æ"sB™ÞxåáLšÅVk€B³ØwòÕ  ›(ùËp±8ÓjV\Am rà1H&ÿšÅk":Õ.'±£™^I@M®YšŒ;ª·È5‹ezX³–¦X~kϨ_¶•ejس»A±(9€‚} [ä®Å{êš[P´ÀfQ°ÅP’ûaí­PÓŠ‚íeµæÓ°ÕBV>#„˜ja—²oP°îÕk\Œ=T£ 7%•²™,XÜ]ÅbL\&™Ò€›ëk8`ðm£!,æ¤-·Vf‹r€P9¢#ã&õÉÊȸ Þê5Ÿ f±]I“¤ðL²JÆ=€®…]rÍÊP°Ò,öèÔ¬:4&‹  ì±Í"E- i¨/f¤­_¯ªB¥‰.¹I½K¾Ppî¥Ò;Ê0ÞQhO©âKP¬•?FXp‘‹£(g £`ç¥ê{uÒ£K ¬ë_‹uŸ*Fj:@‹ŽÚ%ÖXL¥ücLl-)´uS´S€T˜,ÒSÊÊBEAäÖÆ`(¨%íÑ„|ÆbÕ\‘™–"Ç"®k™b?œ"Ïb«aÖ„iMœ ª­>”Ú/g*VD°‡‹ø‚rÚe˜„+.ýXág4“ÑZ @¨(ˆ!Í*¹`®Yet¨(KͧÑ,®[­Ò,ÒµÖŠg1ÕÈE³¸Mq.@µ•‡R\Ö¬è 5\PA±Ð,í^qåyöyÍZù@øíoÀ¾ûîÛH¶ù5™Ót‚EºÈ±÷ R;5S#± IDATXh/XàŸž¢XâœkÛ6¬»m/Ëyਓ/]P%õ—ëmZ¯VÚºÚ>𠿯 K‹.ºhÖS6G^ºÞµZÑðäÞ&¸ÌÉÒù4Áì,lç?•úêºPRØÕëw¡x‹1àcŠ1¥c91LPnóλ“¯21RàLÈôÌ٨̈́ØQHÏ ÿÊtÁL€Û}}ª·¶„`™^5ó)›%^ kß…ÍâZ×ìQ«8F³:P°«°ÿЧYA·Ò’fuôwÃGõFc°cL©j;€àÛŒÆ5eZÀ΄Ì0iTg8vŠˆ0ø—§ÙT>$¿~»©ÞÚ‚e®zà̧™÷Ýw_T˜§2L×jž§™Ãùœ¯3†EY¬Á¦¸ŽÞŽª ýÜ’­’b!ÉH!å…z#»èvíe3%Ñ‚¢­Áíc8ôÐC|ðƒìl •%á“žô$_|ñ¬'.MÞ½. …é®Ãr>“У#Ùœ•,Vþý^›iÿ¬ôµT > ”ãä§y¡ýkóÃðI8¯FX.>ao…ç#“sHCƒŒ £-RüÎÃg(š^z‘¸ö~°Ç7zÚBŸqvFø•½`ÿ«g>q‰²îÝy(fÓ,6¬1ƒ·BqlæR5+ýÒ—ªYÜf‡L@ ¨Ñ«ø ûL‚›”"/LCƒœÃ!`5+^>:¬Y÷»¾±GOSh gW¬½¾Wï?ó‰6ç3L5ÿë;„ ;‘Oóû®ïv*Œ]ÜK p«2,öãJd¾²¤` ÁBMp>…‘ÍŒë*é®Í´Ò)eËÈÓô¸®âØ!Œ9QËdÓ…‘K¼0/Y*ÎïnEVœ$2VJVê7¦†ÑÈ;ì †@8ä|f}'¬+?QV>¢Ëu¥ùáÑ­Q±?bÏ&jJ­*Jºô³ŽknxÉ÷ùï؉}j(!¢Îègj<ÐÈ"Á­1x·FzBN,2#t«p-% fBZ*¹€C(;´  ©ûðe5DbH³˜M>JÍJ‰åÔ¬°JÐDÍ"Ã5p†R_+Ó¬ð™’Z³˜¢‘¯ô*ÃBU,¼µ ƒ=vq÷Ñ¡Y™KѬU5ŠA„[,€§3]ס FµGÔ–¬Gã¦yÀš£ b!º!›éEøÌIÕ'ÒmÑ™æqV~°LÂ,F9þuvÑmNßèà°I‹¸"»j¨ŠL.X8° ƒ1ZÞ Ö´'ÆÏ*!ò9~,d±u.€B—-à݈h·,¸‹MaµV#Œ²¬šÕ;:¸|šEÚÑšQ³¸Yà3ò9ß‹…ÁÍb8D2£pÏÔ,U,ä=¯YŒ°S¶4 Býë­XJ§™6aÁf"r—Ë”dø° nv[c¡Íé¼K‡Å3Ú»,ÙGºº€U¾óí4Íybz!ùµ¦€ k~æH½_™‘Ê–ª—7§«{ŽÅ zéÆëEù(&ÁsÄ€—ðѪA~jÄÔSZÂa¼nŒuþO–×4`œ¥S4â*Q+,E³Ø–\ªfÕŠ•H!£O³"älͲ£˜ÁYêÍôUq„æš(BF ê Ú'Ñ3“’ktE*Ö£F÷ÙgŸ>ig΀L,\x‹|½È°Ãr)rêÃyø ~kÉÚ5j±°àö²5#,Ø¡}4ª¦R0óG>ò‘áÖÓjLSì”?ÞçTQ£l~8 4ÆÄ$´?h[ÖÉ5#ß"tè“œèÌQ¾›—¡ž<ÇoJ„„Ž ¶AZ> ÂžOã‚ùÙ§ðùõÁa Ô3 D„´Æ]¾;¡õ‚¬‚%Ö6þ1¬=§‚@6*2‹fM6nÓi¡Ò{ºQ%*-+®o”}ü¦DLèb#H‹'RØ XH‚…)ò¥G³ºáA$Tˆˆ¸ûÝ»Lj½ðP+žÞûÞ÷Æ,P7‘H'ÿ³4È‚GçÅ .Ø~u;/X“B[OÊÃg†¯¯f*³&#,ZàÙÏ~6M„Õ„ç­º" ¬pOºÞ–ÚDAFa“6QHršx™ÂUFÎ,ÔVxÙœ˜‘Àc™ða ˆ…)p†Ìuu(ŠM~ æÁ3‚ˆ„ˆ±0pÅ> )àp¸Fמà–Ô,Ò/Œ,I³ÈjYgaÌ Y8ÊÅ Ê‘ÍšN¯`5ËD°ADâ}®h2® ×耕ŸÕÕ9 }(hù ÿ³¤Ð–·[‹ˆÛΩýŸlÂDµ&:(¨éú¡X>U¨S,¦¡ƒ5#´ôwš6_Á20»³jU_y±9dNQ_•µ1Å‹´aEAÒ°—žÃúYXìS`½ž0À!RFÖPŠédG ’¹/ôÃ55´«"¢«£Ð)«3Xfwù4+¢ˆÉÙ|ÍJ#…o1«fqøï `$”‘c›D­Ñ¬ )Ý×C뫨¡zAëD‰ˆ˜V³VK°L!ÃÞÑ% c§´fE,Iq#‹((8L -âvÂdy–ØX¨È2 C35Q<šÒÁbtÐ>i'üײò¡®*¾']Hç¯Íš%ˆEñ¦›[ Kß\¾-`º¬”Û]wb.Øb3QÄ™òÎT^±0à\èÖ«é÷ÂaÆ A´ˆ[i²Z­F˜É-¤Y%ºôÝ(׬öfÑ,–ÏÍ[ÍbÝÔ¬rî(r?vjV‰ˆˆ 8QV#Ü¢RCà€w´/; xG§{»º|AR‘³Cû E~Mp;y ôîò*ág¬Ž*ýɪ‰Òèí®³D©ë¹°f  ¸¨wœ¨Xœ6¨qŠþ'ã '£EjÀÄ쨋+Ù^0ã|kƒ›ÔdÚ"òªúW[H¦Ó¬3f•ã‚ÎLœØlͲRÖÂF³‚;—ŒS>©2¼!½2N†ªŸ0f­ü`™ï|ç;v÷^÷º×fÖ  v&îÖRUáö,àÐ(rú.®ÛÀV×ù¤JëÇWò×É­kôoþæoú*Ù)K`„—^:Ý'é–IŽØ˜íž¹vs/¨ƒôÅhŒ¼9¤]ôÔ+¦B*l~¾$½[Û1®G C1’ Ôjeé KÈL0]P×%Ä)ªp(´µÆÂx».,LÝx‰—!ã¸RRx¯ÌÖÈ‹“û`¥üþÍ3Ÿ²Y²ñˆlwí™›{ÁýQiys¨Ò,B¡$¹f•*dPÐhé¡.Å*4+†ÌÂŒcÁ¼¨,´µÂÂp;ͱX¨š¥ñ2¤\‰þ`F˜àÅÙʸù÷g>ÅÈT#L©4ѽï}ï"fÒ}=4œSŒ· 껚­Uß#ô!"Éב4Q¬j3í¡:§ó 닆[ë} H€çÎúÏõ‰O|bà=Ñ~ûí×wtX¾úÕ¯.ã¸oŸÑy/êÅ´hÖ~BË°®¾ÍëÍ!Í·'&àÉïh·èrÅÚÊ–r•A¾QØ!ûé×äF”•I~#e¹É·I$À3i²ß@¶…ɺdžË¤ïùƒ!}l»Á÷Ú/Ϻy9ã ú„ˆ°ö<ôiVö=ŠJ³:¾ÍëÍ!ôjVy"–A³¨Õ,A5‹\úN!ò2¢Y”Ô*^ŠH¾>èLB/j†ÍÌ×[˜]t$®çéÜsX¯°ÝÇ^ëÜü¬¥éÕ–rÒA4É1X°0‘ÚYDéD)Xæð.r`®gú‡í¼ˆÍD' Õ5F8 ÖÕ'ꪱq1…‹Å®øÔµÎdÀVõš+Š7Š™²«'ߢˆ)d3\Gbe!<•d¼&tñÙ–³OXQCt&l­;k’lÚâX¶ÕdÍÊâb¶¼fQŽàwõÄá[䚥Še5‹å¬H…ó©3¡K¯rj¸œzÞ4]¹e“->F8§A¾?ì:¯_p)MtaÓ*Äb^1d8à- ûYÓ\…ÉÔ%;Ÿt@n}c„ö·¦¦Èþâ4Sm€Ú')LhŒ¯ŒV§]tyž¥†jÉ[¬ÎWŹ­j m%㤵˜Ë ÈYi/Ç#K°`è;]LÃÆÉEVl¶fQð@.“fu‡Ì,‡f%'­Á¼P^AÎúHû°ÐºÚk§¨V,6!÷Tµ­­YË„l¦³ 9¦A¾>Ø€âP'òà×çì‹‚ÜDÃyDhßóÖiÛ8öyûr¦!…«”öu1­(í³Q ¨Ha ý—®ï•'œÜ¢°U;„À$z,–Þ_çÚ'eB=ƒSJY ©YÆBˆ­³|™íR!šªUV-#œB³íëÒ¬Ž£9bºŒÒ¥Yd‘O}¤&!0‰ š¥síU³X>Ö¬úû>Ú?BŒÌ›†øZ‚؇…ºËyŒŒÞȶ@]™NY]Œ°ðRÕFËöÉ}Uy1ªÖt1ÊuÔ\N…ÉQ"Xü)4Â`aç­xS½h±ÌêT–&Û¢ÆHOë·YÁ.¥e°L™d¥í’ÿlP¶¶¹Ú\ÙºšU®£6‹f¥ïN˜¿Ø,ͲŠeI¡ö†fÑ+éIéìT[F»`yÏn²¬x Q£ûì³Ï@™N³‰:³fBä……ôÑÄšöõA=ZäLskËü:óõ" o} ¢gx_ÃaÈüÔ§>5P7••Ï%Öj±¾;î2Qöe=Q[XpΣã"¾o¸”Ï]‚v ÈŠÿÓ»M1TŠ‹õ_Ÿ°ùCN G5ì²YÚ;w%‰?"S,uý ÷½¢¿rFfíÛê¢FמÓq(óÝuiV¤}=šcD5‹”yL£YÙøß$Í"›9»fe:‘»Ëµq&éU¦€8T󹪠D¸â¾ýu³²µ5k–X›Ò;g¥“õåמÃB H×°×yÙ‰«“­væëÕj\ìÄBtµmç-ÂöC0W>êkÝÎJêÎ|a«`v;gÊ»üÊ”ýÌùŠ.†×‰p}°Ï:·:‘¯§wÖu«yaíÈàĶªýŒ%t;°ª\£ý΢¿]X&6¤Ðvȵ€þ`mƒô]3«õÏ{t¡°Udû핧´ ƒ°voPbÝŒ‹¬]’LÛFC“èë&#Y«Ù¶»-9…¬ª`™%iV"…=š»³hV¯ôkVí)-éàÔŠé`¥X‰*4jƒÑ –zW߆¹ˆ-9•¬ø`™NCÜg‡x'HXÑ2µLƒNç§Ý­ÑÑž»4Dœ’ö caç.Pvf‚ÕÏ;Go’­ªûÕxå56Ÿ{Bc¬ÑÒœ‰õ´‰ä®ªˆ æ ·X…µ6ÈÇRyK «>yA™ ZS5ú¯F8¬YT1å%hVGhÌòiVË­YJ×âÓKºÖ“‰ Êtô.´3!7Ä´zµjaí&…~á ìóˆN!ÒéöìóŽÖÑ­+PH' œ¾ªZ¬Æþå‚Õ„A¬½éþq ­ÆQc¡q“² c`sñ©Mü“Ó[[åò¨™â½`Ÿ„¢8„éb,^*¡¬è$jˆi{î«`Œ0ÊfhœÏ^ÐhVr“.ŸfUã…ÁMjápY5KIá1x©„²î®ÂvߤÔT²âÇÃ÷ÃHá€ÃZš‰Êèw²¨N0°°4 $¶u¢`M§G²:]ì2¨+Jw/ºè¢‰uÃ’€ð§?ý鬧lŽ„ïžg‚e(ÿÕÁ9—G¬'ãdÆõ"È-–æj\Œ½Âp3¹*Ýá ­PÐvãƒ^LÙiGÞ69ÈÅ‹V¤°ƒ;ÂØvˈF ‰ð€«¦¨Ü’áY[ù»ñ{„癬\³bÈÌ fecz”šm½ÇækVGÔh‚F³¨Å‰bZ Æt¤Êb0½Ñ,3jH¸êSÔmIŒp|Ö̧™y‰µ}÷Ýbí¶Þ é2EÉÎœÎÄL¶‰N,vë´æ„µÓÂ!»XZ]¸ï á"Å}‡Aº/Ç^䢋.h"Ú}÷Ýgmº ?ûÙÏ–Ðì³ ½Ë|P·lº¯iï* )¬+«unõaÔ2Ù¯2Mi®œÁ3ˆMÊÌÅòšÓH>™O‡œ‘)6"X;—Î wÌ×]³ÈêÄSµ¬Z¬¤-ŸgÂ\Gÿ#¯úÑÑË—cpþx)?çY…ˆ°ö]&h[-ë×,îÓ©ÍʾÊ4f‘ò¿ÍJa¥¹fEà4šEV³âêk¹fÅÔÂë7ë®YduR¥˜o #?WÓe’ŽoW=pX¯0zù`sõËøü¥éÕrÎ#¤.¢Vp>Ô™îêáÃášô%CŽÝ탥ú 3IßÙ”ûE<¢¶&5‰ì“•ïÕ e,Ð’ýP puÁ”t9wä| )¬Þ+ý^DíkMEDìì´wuã&]÷a—™šaªóå£Ï³r–²i;²gIÕÉÐAØ0x¡†e ‹nomÑ hÙ¦é׬4/p:ÍÒïEÄ0Ñ~ÍJonIšEš‰eЬÔ0ýŠ•ý&å,­xFé#LPòDY¢ۛ'Ë0FH3Žù `¡^¤otpʺu¦‘Ã[xoësT%XÀKÍ$Ÿ« 3³E9š¡A3Q6LUj%È$ÍêpviV#D)´—¬”,Æa»¸á“F5„ì"ï¢sn:ÅÚMdF«BA­QV²óâ+äˆeØ^]ŒòЇpb¢} ®y>çe†e0B ‹viV6دY€ò’[^³:PPQ¶(Üyñé4«À¼>Íbé:Ø)&°šçkæ4šµZ!*0vrÖŽÍ‚ÿõQC{JßÑáJÖg87 ŠõÕ–ì#Ué#Á}ýƒ‰=†‰²*€0ÌKÝÐ<¿ u›]Ç,Ÿæ«Ÿ ç.-äÌV æÜ^sUÅŽ&»euþ¹ªnK6†,á_NËDE-N”UµÄÚšÕ…]š•-Ÿ¶…5‹É*ÍŠ3Õ)Ë«YÊó²ŽU8c ¡½ʼn²µ5kšžB&ßþö·Cà(* Ñ2Ã96ÿŠ+®€€P턤¨ÞÕW_=pJÙ‰‚6“ˆ¾ýíoO¼ï4¢¡CŸÿüç;óuW·z´.äâ‹/¾øâ‹'ÞÚ/U6󑧗—nÀK7dK—Õ[²9ƒ%ß°)–wŸ¤°1(ÒM¾[øžÞ¾Ø}–Sœ3ç­q@Á—mìíÃÏ$ŒFôØëM¦ù´Ž–©áO ²,½¶ÿÕØÿêÉ·^\êßÖ“ /ņ—æK— jÖpÉMoòò ¿xh©šµøöž³\Ĺlâ|®Y}(¸ñeX.Í aD×?Öäq‚·T¦J°ÙÕ³À¸z\½ÿ·ÞÚš53Þç>÷ £Ã2=öaRqµ<«±­†Ì>\¬ï¸ù€×)õ`^'¶ÙÂÃq³!}ÐA=ñ‰Oœx÷- „‹?ú»cX·Ó3>{Ãtå;äÂu¸`w’û¶XH¹mH™”ü–Δ¯ÍLçŸ-\Ä|kÇ”&Í|wÂ[.%«Çˆ™ó.7§25ùš¾dO\ºçä»oâ%þM'Ë WXw!Ö]`ÍêÆÂÍ";z·|šUB`¥YÙw'¶€fu*–Õ,F©XÈÁÏækzÏK°ç¥SÜ}Óÿ¦’½ZŠk”¦ž7à5¥ŠüuÞ«ÀYQªÆ<{¨ÈìÄÚúЬÒéÀ,2ƵLÚ³¦‰—Ù‚Á2þú/¼ýYÏ~ÿºî°f3¯DÆÑÒ'Ã>Ò䆑Ú‚!á5~Rü¥ñ!L™>±å5д"¹y£x´ãOP|ÉÖ+ø<©Ê,œ¢”§µ@9@Ø5L8Q¶àBX˧WQe&<Ò°t’f‘ä$i| sbŸ˜òh:¬YÙ,‹ül÷oIšÅÅ´BͤŽš.«ö‘b&×èÓ¬½š™Öˆ¾GQäï{ß+2/»ì2tѵœ®¸âŠšê]uÕU5œ\uUǼßúÜ+¯¼²FµË/¿ÜÞ=djµû/äík_+jà’K.©Ëñ‹_´» „Aúý×-}îsŸ« ö³Ÿ­yáDi—*“/M ;Þýùý·w>q÷frá~±ÝïЮ/ßØñC?z#›‡6Å´í´kŽíT¿a“É¡HæÞ¼)ý{Ëb™%”Ê¿qSG‡ÿD­º£7f% û¤‡ž·!ÝNå›Ë¶bà ÊœBtïQ¿È¤~mFþBâÀŸvð‰²á2éU¦YA±6¾¼?6îš o:AÒ“4kÓ “Ž¸øf¡tæoñ-Œ\ú ™›ÞØA%7ïn§n<ºâ‹]šµáyF‘En>¤j+Æ •9¥*Èî/•9H\ûðŒü…ÄOìà…eË1½Z:#œ•v^ÁîÐÅ¥jpÎé;:̇¯?¥Ô•ï#yÃ'vrÄ:øhX¶àhíp¿çŠñÿ3¥Š÷‹3! Ê¥¸êÓ:í …<@TK²³]ú¢ÓN†á¥»Ô9ù)6ÓÚT Ö™‰Dô„zZé+Pº91²RÚKîPÓT•¡éLÖ iX>½Ê4+q©)4+Ψ¡–œN³(ǽfy_sJ–Y)Q¹â 2Í¢i(`OÍT¬aÍ*xádÙbšÕ§W<‹l©ÊÍe³e˽µ©4cñ‡çÃ4—¹Ìe.s™Ë­LæŒp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MËç2—¹Ìe.Û´Ìp.s™Ë\æ²MË6„7é˜}îøô¿ý9÷¸é‹GîuÛ§þ㯷f¥æ²­Éâ÷×ß»/¼º½¥+2—mLæö À6„|í_>‚h‡ƒÞ{åXónøì3v»û —nÖÞûEï8ûUØ™f¿îo¾úÁ÷ùW½:—[³ø_]ú¾c~Àkˆˆè6wyè ß{Ù¦[ºRsYqÂ7ÿàïßö‚Gßk×Ñè¶wÚÿ©¯ý̵óþÎJ“mÐÈÑ?uØ{._¬¹Û>àiÏ|ø£™¯É×ýóN8÷Ë¿öËQÁ¹¬*áëÿ턇xä¿ßãØO|ëç7ÜðóþÇÇ>ë·÷ZsK×k.+KøÆKßöØû=ãíÓÎü—þò77üâŠÿþ«“þð±÷Ý¥¹¥k6—BV%Þüݾ졷_ ZwLJ¾ôœ³Ÿtû‡]xu‹›¾xäÝîñ¢Ó_ó´ï{;Ýn·»?îÕý8r@Þþ·Þ´þ·ÿ瘾û² g û²¨Ùté™ÏyàîÛ5´°ÇC^ü¾ïnh¯½èÈÇýѧ®ùÒQ÷ß}×½~÷ìï×;—U$³iÔ¦oý²3®{þß|úÌÃuÝns›ÝöÞÿ ç|Ïuÿø“Ç>nßÛï¸ýº…µ{ø’]¶¸é‹GÞíîÏ?åU‡êéÏ}ÜÂÕü¯{Ò½n;jv¸Ë£ùë+Ä£°xõ?¼þ)ûîÜÑŽ÷| ŸøáÆ w¿Çý_ÿõÊGîAtÇ—ýçMèÕÃóXÛ·mPyÕɆ¯¾~ß…;ö±Üì¯ûŸsÞxÈ?ó_8âh<å’<ó¦+?òœÝwxÌ…W,²¿æC¿ÍC.øá•~ÚÎÛ=âŒïldæ_æé»ÞíøKnf¾ñ Gì¹ãS.þÕÐeïÜëÈO^~“÷7ÿ}OÝyû'|ôZÏ›¾ûöû®NRÊ IDAT}ÐùWŽoéö˜ËæÊŒµøƒ³ØìuÔßT_é¦ï]|Ñ—r³÷¾{Þ£·Û陟ùU¸ö;é¿®o™ÛkÿþÐ=nó„]ëùæKO¼çèÎ/þÄ7øñõ_9ÿ);¹àGô¾Gï°÷±_º‰™¹ýñ³ý^Gþ×[»AæÒ)³êÉåçìßÜéè/uè 3óÆï¬Èv{þÑ_~ï&¿øÓ‹¼ÛvûŸò­Ì¼á›oÛÝ^ðáïÜж7þàoÜgݽ^õ¥ï¾—»ÍóšO~óšë~yÃ"s¿v˜Çnû¶¸­éáê _}ÍÝtÞ€núÒÑw©:.<âƒ?õáÀÍ_>öÎkùŸ´þš=|‡åxüãþÁ®k|Ç77táàeG^ð£xàûíîyÒ×7ÌðV#³jÔ—¾jïÑϼlq袋—ñ€í~ë=W·7~áˆ;,<ì}?nCþuôgÃWN¼ÛÂçþPnúÅWì9zÈ?ûë.zÖn·Áç~Í<¾â]Ýûß [êÁç2“,IOôßøù#î±ÝÂÂÂÂÂ.ÿðO[Þøõ7ÞkÍçÄ£›¾}ò}Ö<àôï/ò†ÿ}ý=Ö<ø|¹‹ÿÙÇ¿ý‡ÿǃw§ûœüíM•Îõ°Ã<öØ·mMWŸktñ—W^¿fÏ»îÝì ·»Çíä˜[»Ó®ÛÅ°—Ñ.wÞ…¯ûñ¯Ó¸tsÇgœûO¿üµtÆ76ШxòÁË®Ûc¯ãfÁÁ烷"™U£è¶w܉yå/Çå…ü¯.yïñÏüíwÀƒòÐCÞþµ \InÝn{ìõÍ5A¯¿êWköº›Œ-ìv·Ý€vyÌqÏ]û©3?÷‹M—üü¯í{ä ÷]»Åž|.³ÈÌz²Ó^;ãº+~†M¶{È[þí;—}ó¢—ßñÆ_mðÀâÏ/ûù¦KOØ÷]wÝu×]oÿ°·~¿áëol±xÝå¿\¸ÃÞrÚþŽw½Í¯.ÿÅâàÝw¸Û~wÔ½~=ì1]öm[ÓÃÕ„£öºíâ5?€ksí Šuþæk®¼>îmúé·®Á®{ídÇ¥›ÛòÎ÷>ûG'=ïôï¸5ù£]D]A¥·b¯ù¶"³jÔÚ=ç {]õ±^rCþòoø×?y‘ÿùÐ3þå’KÿçË_øÄÑ÷I–£ÖŸâ¦ã®¹!ëöñÇ{ýÛÙÿŸõ—øÊgÝu¡ë৽þã—\ý›ÅÅ›®»òkÿué57ÿòš×Üþ®{îÐð†+.>û=ßÚ0xÓgþÁž—žròÅ?ÚÈþÆïþõ©ïý¡\­¹×¡Çî÷•7¿úüksôÁ{Î WŠÌ¬'kïÿÊs_Òœóä'ûÞûÞÏoÚ´áú_ö½ß ÏÚ{?ïe÷ÿß“Nü˯_?üÍ×|ë¾s} ¬Ùç¹/?à»'¿þ£ß»ÑóÆ+/zóëþý‡¾dÿí§6P¼Ø«‡Íc&Û”®> Äv:éSçýöçÝ{ݺîñœ¿»Ë3î½íü;OÇYÙcm³ó#ÎrG~ôCÏ¿sõþÜn­ÿKvßضS_¶SÜO}Û ÷ùÌ!»¯Ý푧|sã2=Ü\n™Y£š;>ë—\tÜíÿéØß¾ÓŽkÖì°Û}Ÿrâ'~t›'œzòc¿þ½¶»Ínû<ç¢û¿ú¹wêDo÷à7~òìG|þ{¯íx?üÌÇ>f7ù16{=íøGÿì‹Ÿ|ôïÞnöù­sÙR2³ž¸ÛtÞ—ÿãäý¾~ê3î»ûk·Ûe¯ýÿw9ä©ûî@Àš{ó÷û’Þñ˜ÝˆšøGç|ùWÀ½^ñÉ¿}Ù'?b·5£îwÔ7žüϼå·v˜Þ@Ñ.}z8y´²Méá-=H¹¹²áë'Ýs»ßþ«Ÿùÿ¹¼—Ë6&[H£f‘ö'~ümïÒo8—• ·¬žÌl –RÉmHW!#ÄÍ?ø—ùúµ<àóí¼å]WìsÈ;m~e ]öÖ*‹?ú»cX·Ó3>{Ã-]“Í—•õêrñOü¯û¿ú¨ý‡}·NYÉzuËêÉÖ¾û­K'èÕjÂñO>ý¦CöÙ±!jv:ð¤Ÿ<ë}ÿ“}–a$w ]öÖ(þú/œüäGœðý»ÜáÖ±˜ÊŠyõ¿þ¶‡í²ý]»ôà÷þßÃï6ûrG«\Vº^ݲz²ï~+ÓÃ)ôŠxè1—Y…oüÆG?qÃcuéÁÿìÛ¾÷‰ÇïxKWh.· ™ëÕ\¶„L¡W«‘Îå–Úá~Ï9ôa»:?ïEÍee®WsÙ2…^ÍÆz»çÓÍeȳßÌ·¶|s½Z±2׫¹l Yiz5³û÷!‡½8V”bÿû ú’—QÌ!"à?Ï?ÿGAÄ<üûÙçþÎ+_!?wúY¿wüÑD.EŽøô)§=é5'„á}êM§üþ›N$—rô±×üÙÿyûI 8)ù¡ãNzþFG"GÂ_üÉk^rîÉzAtþË^uäïÕ ODï|ñqG½ç´ðpˆ™8ó°c~ï鶊œÐòg½èØp.çÙ3óÙ‡ÿ'®—bñ û’Žx÷©ÌàXÌüç/õKÏ?K1pá‘'¾øì·…2Ìñü÷½òu/8óÏÂÚxñ>Ì:î¤á·vS{Ól¯Ydûfû¥8«|æ)&m!౟¤ý}i"8þqúÂ3Yw xðGè+Èq—@€s¸Ïè;/àÆeçî}!ýè¥ì\,òow]w;Ë„íöëiãŸ2™÷Vâ7xÛ?zýZ~ëÍ ™ ?½ Ÿúk@òƒ$¦ãvæÓ¯i}d:f>ã—¶ꜘÎ…¬ßÀDÇïÄ뎃c>½ê¶|êod—–NÜžßv³,ü@`ÐëÖñ›7˜â¹oñ|<1êÜ['˜$Þ04Wr@hݺ¥8«¾þuùª|áño;|ýkBZ·Êáë_çœzøúô,É<íðõÇæçò…ÇŸuøú£ª žsøú#ªÌw¾þ¥ù/|ÉúÃUyç÷®WœvEK!qú±gwúQ„`< o?æÌWŸq Œ½pò1§ŸxƱ¶êœÎ¢!bàÔcÎ<áôWšgf§ûÎãN?ŠÁZŒ™Ï:îÜ£N;’¥m|ÎqçqÚ«] ‡þüøw¿dýá4]xü…õ›²rÉ¥W è“°÷ÒNÜjã Ù/*"a~(ÂkO²Š.˜4(VSHxéŒÂÙbr®såt>AŠéиä.Ö\çJ²ÍQ„Ós£6p¬0@$0§%9ë£i ÙNÌ1HlÀDбcÙ’JZëüZñèV­Š„n¥@‚Z2î:„×W!8ù{$ˆäBN{13 §ÌBRU™”ÌN¸5Dô>äåiL±F>+ÎUå!S¼ G} ¿‹ÉÒÞšìcu>÷äׇxp ¢}p¤}9¸ŠQCfC.¢£y7iUµW •öÊ樽r24Ʀ>¡¤`‰}"Ýr4lpD̹ZbÏŠ™Dû\Ñé™Zë«õ ·°Ì,CD5# ÓF³qJI1€ˆˆ>wÚ™;áK\ §srYGD.¡ £XLÉÞôë_tö[õD)14ÔÃðÓL©­ô­ŒXè+OøÐ;m;”Æú¿°·¼Œàb,ðÎ÷Š ×CúVZ&ÓYþ‹Å‘¦M(‰óúaWÃuJž1¥ìºn—Þ+¯8÷a¿õÏ'󃈨`„œa‡–Bv·BIgøß¾ ïÆöD%‚Šyj:]ÍÅ­X†czSÃoÞ0—p¡M‰&Bt‰L:düÉíøœŸ-‘í%sj—ó3i&[€ŽÝYh"„êQJ3¥sYó¥SÊŒ,“èφìñ Kœä@;î¸uôªf„Uš«C½0&Œ0ÑÁ®bSæÃÞ}ü/_ÿ²hØb¿KŒ–ü,@Œ9DyÓѧžtæ«šÅÒ¸T?6é¼À)Çœñª3Ž†%{TáÍÒü"SáÂã/Ö«/|é;õ‡xï¥éÕR!3'5IÊ‚Š]Ù„¾üää$ÝId1¡ 3P¨üÏ‚¢\Õܽ«æ®ç)„ßAþ'fÝqqŽ˜D©S¨éï#6iìF1˜@’Ëáj¡t(”Î ·›$«‚ä–+%±RrÁŠÚ]K¡øš³À µN‚|Øæá,ì.h°ˆˆ QÐÄâG[êSJØã‰ÿ廪§GYÚ1(;k¨ÄQt+»÷ ´3t£W›ôAæ4D°>¥#ù#ñ;d,°ÕM ƒ|&‘Äõüt’™Bây(ìUØåòaˆƒ*vè!šDÑeµˆ¢ímÒòU-†dë3ÂÍrNˆÔ½Óu–íà@9›°@5íˆÄ*®QR¾HÁ-)Ç þ ; 0(@˜8a¬gã²µˆì›¥I¬òîI 7“ŘÓ8(`ÒJ€)â(«ž¦D(L &&3H6Ó(ÖÂÑÞG~ùš#—ïzŠ|ݽKAA‹s:Q0š%w¨ŒkÔºCçøW‘ÂLir×"d³ü¢Á®¨Ž²˜–Æ îMëm˜¥pB:NW#¡ƒ4Üñ[À5ºÜzµe¤¶*y´%q‡F{%éD S:š¨˜°¤TÞÙ¼0ÇÙ»ãª@êÊG¢– ‹ËS]£NzXÁ/õ[zöÁ^…‘ÅóÖ¶W3»FCâÀž±¨^×hìÒ@„—*^P À4¿-'"rÎ9ÃêœËPPý¨ åZSM?­8´ÚÕó)ÚªC‹ˆ&&¿p*Á틈S”۳ί=¥ïyÅk;ëV¼µ«oøñ´ï8—½vÜskF÷ýÓSÙ²7u‡RîÐ%HÖäôÎIfr–ºèJUÂgqk=¥M9AA§[ƒ‚™e„ñ ‘á_a J[JùÉ;ª8ו£x©†2ùE‘;Ba½ r48H‰Þ§jOpþüº¾£ÃB·ÛukêÕáë_k²;ª/`['t·³L‰‚±»Ó%’qŠFðÅÐÎUVëIjU¦¼LÜR˜zI™ŸSõù?‡3Ï?þÏãeõêÿýç¥}G‡å18`iz5ûá _$} ¡Þ@èô9Áð3$Ð’Lƒjaã¸Á‘‹t@Î%täâ~vA—‚ªÆ‘ž Æc©Û¤b˜ä˜NÍg,Tˆ˜Ãay©ÀÌž‡°ï=êµÃŠu寮šþ-[¹ËNwÞ:ëÓOa´ò¶i€ÐåøQPCC‘ .Kçh¡1FÇ8ƒ 8DŽ…ê2…!‚ÝŒ°W¯J³¤9œwÿ³ñ¿ 8´øgú!,4š„×þbøÍöž»Çn[G¯_ÿ:=­¼ì@81 r!tòGÎÂ!òH™èA•ž•Þ?ÃB}Þ®‡ì,ÁÅ Tfˆ8ŒpÈó=ü0@¾ëø?Ö«ÏýÇ—úŽËï>êÀ¥éÕ]£µS”c˜+ N!Š7S/@DE§¦ƒ…5 wháµÔÌÌ u†*©‹ÔKŸ.{R«‡êüD|ë”à æb|¢¼1Ú*d…¡ÄÐ#!ff&_j¸…+§žRøèÓ§œ5$‹íÖö¹/Mj§hll†šéÔÊrJé‡INî-˜% ¡ B`Ø…Á¿œ †˜»Så 5´.¬ÌsfœŠ±hÖ2ÐPƒ£»U:(*ä O)¥JLtO¹UEK… XØËÓ – …CÅ¿@µsÕ &M&êÜò@Ruœ‰6YXw‚y‹~QJ8'ªäÁ1L´ÃSªnÒ 2^c„Õ¤ÀÅ¢µ­”6¡8ªÃ‚ñ?¹Ú ~Ñ„’±O¥”ÑÅCGŠv5•jÊ2.˜!x綗Áv 'î² ç²fʘKüM„i 4òŧf ãe¤y¦£ 'I»%Ær–[ÔDën°Õ©@¿qVðë;Jf›ÊCTË°Iáv &^˜o:ÅB$ LS ÍSN¦ƒf—õçDqtPz€@—ͤí8ê‰tÒb.X»W&GBn7QVƒ^m¶t¶C'Ö¯3mêàÿ#×DäËà0ƒÀÿ (ZéµùïªÄ/»Æ;ª¨aBÁ£nÕphž3&ÔPÙCTÚ[Fn`¥Œâe‚@±j ^Âç`®ìœÏk8 #ôS€åŠ²¼%¥ ƒqK€>§Û&‚ŸS¿h ê-áÐ$-l^¸Úez•=„í„ "Z8l@L¬_%÷b«ô±¶dN®­H»%‚ee‰Á29ìÅqwp˜PI !*’i"e’ÛRØ[Ä­’á!ÀË¡NÁ¯qN2]8ÝÉࢎ)R‚ÔTm‚V¹÷Ù£TÇ5m0Sf<’F˜óqA–a0ü…ƒÞKŽ™z4ŽzfàÝ/5LeúÞÚ×ú­éßrûßá>¯¼\¢zõ™§°p}A©®aB’Q@’1Âbš`cbA³ˆ3(Ø8CãäjÁ)Úx8Ÿè`†‚&¡Ð8,°’žF²™‚ˆi›Ì©Ádo5m‘æê¡'s.€7s³?ÐkâŠBƯøÉtgÎÚûŽ¯¼\¢zÕ?›°äm]™}»E›]ûA»&`!\#à×sp®†@Å?¹RÂÅéZ ó©6Y:ˆ<]²ùiô9àûÇÃ_(ðÎãÎÔ«¿ûçšîù’<õ÷7ñÊ23>ø/Jj ¡@(€Ÿ“¸˜„ciL¸„)Ÿ9jˆÈeÔÐ&Re‘† í#¦—Z»lÁ "Öp(0A·ªÌ$,ó»8qX±¾úãoLÿ–­ì·çý¶ŽÁúǃ%^TÁoY°11‹9Dhš„ùj Ìád¥˜&§†‰VªM2Z%ÚõdZ„+2 j¢ŠšñTʱ0 ‹ ôÚí&á–LwßJÑÈ,ƒ)€°Ø y 'ô²"ÚÅDÜm";tŽãúEqi ŸA`J›Êv:H“ 4ß™]8—íjšÊb13Ëá°(ŸÆÂøØŸOXh (Xž}ÜyÃzõÉÏ|ºïè°<í m½`™Nï(GŸ^ù£Ÿ8®#;PLŠÇ(bS´}ˆàT^ÿ$D&ÐÇ&CÊlÔ0E¦Kfµ¡b|¤ƒBž …dÑŽå±ã2«Ë”L˜ÁiäˆÙ§¡/õñÁmå³!C8ÀO5£~å»FÑ¡WÁs\8f¸°;¬¨€ší†±@‰£Éœ¢ä£ê@AÁÂF¡ÒAu:1W$ÖVuøçDÕjƒÌv×cŠ•íEîüÔÌF• `-Cqz˜—Ä`];dÕ¸F1íÍ&õK¤T§(%8L hQ0B`‘A’KNøµ[˜Ì‘/•Dxÿ!§ÃAªù”JjˆdZb„‘°Ì;,ÔÊüÄQ €o·¶½šSK„g¢¢ùf ’˜ö¤/"]CíÔøÉ)#l§@¨DP@Ñip©a°É5Úõ¸è$a}.Z´JP´ˆQDôºë™ï@@€Ã0=Ú{vŽ˜áˆ!ñ  §ÅxÅ¡ÆÅ0ªñ|µÿS«•Ç,‡Òe¥k¥Å8Ÿ™¡(ØX,”ÂÅŠRÿ¯^´(íÚ¾w†Žvp8ÅN⪛´'EÊtíJ›MjæU5ÚrÓв+ÿÄŸ\*É;&‘¢Æ#Jf[°@Í‘«%çÛ°½bÎTÈ& Õ³>‹  “^9Êâ¹1n€‡!<+/v§Oâ” Ó:Vw Þ²ºù‘êBÁü‚ñ—no[YYŒ0ÄAªia>—Ë~CÌzŠ_™ôÙ3¤äÇR𠃈â U¶ˆ`ãšH]¤‰aܧvfµ*µ*>oNû,4´OA±Děٟ #sŒõŒÆEjèÄ*zböŽÀ #ï#­t’¬üéœkKrMúgrjQ.¡ƒ)açj°Lâ…fEÓ……ŸÈþäâ–lµ¿®ü ót(Y;Eµ¤=êÌ®G²fN|¤~Š_iïeÀ3¹ ÅÍ„ÃôÎLNÄ{ïز‹ø§[ ôÆæš„f<¨ìÔ$%R(‹5ZAMXq4ˆ¨1ev†st´ÔPÔŠ@ÞòBQ+h1©A·zÇ}f ¼äïð༈„Òü\ÌÖ4ꌒÆð¨3Aª+.N% ˜þœ¡¸IÄ0—0.×VÆÈ„^wr2èŠmŠˆþAˆ™Þ‚ib0‘—™%ˆÞÇ>yêC v^>°A!ÖJ'ë¼—-3¯²òáÁÿ@þñ`í¸fïÃö'cfׯ´Sê:@(þRƒyYä§a– * 60¼h*¬ë–ð/ß²èë/†Ì!鄳ؾrH\aÅmý­–ÌQ­V§›`u¸N˜îË+ßw›£F§—ÍÁE ‡ÐÁè4AÐPCëÕ­Aç¹&ôëS½ø÷3k… ÿÈ€Ÿ¬ˆ Ô•È¢z¡t偺–ü•»f2>sŒ·`0,/ HAŒõÇž5M#®Fø ç¿˜Ð¾æ+ÅŽääùâUü“™ò. :#Mã×4 5䚦Çit“¦Ù„¥‰ éQe:If9–&摉K‚ÈÌäÞû†"d3yfýr——Á¿Ä “ÚÕ ß>÷%'”Í•ËÊg„=™QÍ /„)v&é•Ip`Ë(AÈrþò@‰…¹S´˜;¡XØ0â6ü‘l F˜@¶%þufæ>Ò"³&…ÿK»[$R@Ãÿ8÷m²ÐA€ßñk0Ñ«&ÁáŠÂç¿ãM¾eÈHaaÉm¢/½D\ ï?ÅÅ:ç Ú±@Ë ‰\Ó8׸¦‰X'_$*n“zê%þÍ” ˆÚÔnæé f£ç)/„øHppÞú+|Ú±ÙWíjñ+Ÿ4Ó0Xï(lÅàem¶ê2™ø­2/“2Aà I–Xs䈚Æ5Î" º‘sMãFN€0PäU5åäö4®„ðšU"b¢‰Ò-c|ÖeêÙ+†é.ÒD¶.+ }ID,4Íû›Ì“¥ã­ÞÚU¬z€Ä‹ÚtR+Ë9q§ª?Ó!ªPÉždÓt¨OG5j¦ÉQ°AÜ.h±]@h©B1å,äÌ„ˆË´†Cu~ºh¢À gÁ/!X|X4Ðx•¬tµBË  ü$çAÚ-æÊq7Fʧ¨úÝ}r:ç\3r£‘#G£Q°XѺ‰Õ³wQc0{Âhy¯Œ¬¹êÌôž+—i†ùnü¥VK‘jeNÑ:ì¦[üxUËp\ãr €8^ı§ñ2èè–³\ìQجGŸw²bËD‡6âUŒ[3jèÌRkúX‚oö "L£D÷‚®ÉHŸZ¡À‡c.ǵÄíÄN. bxŽžR¸¸^•“SÆÉG*NªÀ™!YùŒ‚íèÿ¡µŠø§¿½N­±=µ\`f,ÃPCED ¬PÐÍ$ ä|›*BžY,c>SŽèŸ—‚/ÔqœJ¯7ú¤×%sýXçþ€¥BV<#ÀŒ–hô‘ÂYeÚ¥ És“…‰(ØŒšf䚆š¦• ¦Þ¸¡$Bø“?ïAÆYq”A‘ÉÄóce+×(Å’_ÔþB凅èE:krÓ­F¨ Åqõ°R˜¶Ql3‚¸"aº_[ü±’øµ;Ÿ{4LFæ×7Î5MÓ4ÍB㚦 šÕD©sˆkÐ(}•·ÃÌBûÀÞ§mÈMI^ÓèØì'ˆlh!ƒÙƒˆ¼Ïì« IDATg&öž"5 ËÎGµ”¹¼|„>DdéX¦U¬•„õô‰‚f¨V¥‘ó¢éÔJ;B EAkŸäãÎxDdÉAšû0`!Ðú-ó¿ah„=j½£6GÖ¶jÂ4yŽm¡“¹8”öbÉÈæÄßç´¦~¥«•2–ÁýQ3ŸÉ ~QfJ l=Ø« u¶Ž…À˜ rͨ-¸Ñ¨8t½„ 0¹`kBÛ{fÇÌÄžK¤0F»^‚˜ì³vSo)=!ÉnÙvéWIÁ)*G©+én¾•?Fxé‡Þow5j†RX .£ À4§³ž—ae¯ÄÏí©žÑ$6^tdP0þ¹Fg(¯3Âʪì}Ð bÏža¢Ÿg¯¨ç=9£P%"z £€ìØ37žAŽ|œ<˜Rï##I]rï]CÃÞQà fï½ÂaÜR²Ó ¬°0¸¿‚Z½õ˜õS¶X%Ëö¢—ÍzŠ•™—X;àyÏX¯q&YøJB'dAŸò¿.´– ²O&¥5B£o<›)ß8×4:AÂFíšÑÈšfÔ¸Ñh4jܨYhF£¦š5ÍhÔ4šÓ¢èâr·úhŒˆvA›¼÷‚ˆÞ3û˜Á )òl÷©µƒÅÞÇÓãÕ㨡ä'69rëP'›.ûÎ7ð‰èo¾²Ä%‹ž¾ÿ—,šIˆè“±CEN劄~€ óÂF?ºk>À;j²œÆ¡iÒ²¢£Nr\Ömã*££GÓ¢ñy³eŒÂh#Ä¿ˆ…„rËŠ*nù¾Dõ‡jÔ°…~¤K 4²|qG´i9äeM5Ÿox¢ãvÖ+þü–øÆy÷­£WÏzû© Z‡¶¡–ˆø&Mxc³EÅÇ‹m_Ówþy \C.lGp#jFp 5 ;Òm[„tÓ4n´ÐŒš…5ÍÂBÒJ Y—T%™Ÿ PlUL˜2c!Ø–¸ Ê %'^MÛ",ÉWl‘¥í!f°‡÷²Üš‡û1gëÕ_\xÞÒÞø‹?bizµ¤¯O õÒÃ0•u‚bgÅ’B,,»îƯ¥êäQ-Y@!døY?Mظ8:((8Z‚Z5scÏFшٳo½÷Dž™¼÷LÄž<‘ îLÖ-ƒAhd íÀ!ŒŽé¤ÁêätÇÁ…ï<¼s/l9}h·+2k&ó0ct5Œ†õõ*3‘2ÑSjH!)¹ÊµCGYJ2eËÊö¸ bÓç* jÖ#:F„Á,t„âxTê&“^b@Š—ÞµÏý¥v¶z,°Më-œ _ †áC]ÎòÂP%8Aé1;zõÓÍøZéj °ú–‰*©exÃÞÑZ â?Y¢‹Q¸ T¿È¹¦iF£`¨šÑB€C,–ŒçÄ:å(èÛ6°À`«˜ˆ‰¼'äÃ0 ³£œD”Cõž2¼'®æãR6µ/TŸ°‹2Q®œF±VÁô‰(œùB‹#dÃG &ÓäÄ’²Æé×S="®ëÈQMìhšDþš…¦YzY:Ήøç¥å‰@ž©õž\^sÎù0X§³ËêA,_Y HEDqt0h8ˆ @¡ÓàÞ§5­‚#ÔbaËLDÎÁû C  Í”&œ¬XíŠ_ +‹ GÕ÷ ¦ ˜œ¢‚s^8lðÏ3ÛePx2v‹L,Œýk(þÂRßk¯[oP8ÌA¢Ze!'ªdˆ ^mÆ#ˆÊ·vÓ²D IÚýÌ0Ïn»zž²â£F=š--;¤ÑÛ"j]»ufñ²çPp‡é.Kw+® &K4Î5.Àáš0d¦RÄ+p°VBþȃˆ½÷hãµ=à­•Lº‚sj–ØÇè)1Êb«Bo1R…"ö.,‚lÂJ‹ç§¼—¥ÍB³Ó×i€påG2sÕ‹°&…)jFŽ *¬±Øu¹LüÚ.‡ÑFHßšY=ÕY•Äòè^ ‰Šˆ#×,ŒFáoÍha¡Ü(DË úB½÷¾õ¾å¶ D̃Á`”XȃYd=dáq‰ê!ÈÃËaö†‚Û"t¨-Á¹0ÐÍáÂBîäpâK[ùŒ0XlR,D‚=˜¨¿Ð½HœOBC²©tœ¸ §nU|1PšÈŠx]BúÇ)íL¼èˆ°@94.}C¯î-Ã1Z$Ó†ñú°P±Í’B üP¤9ò CŸ¼ îf‡½¤pš×6E™[TZ¸Á¡mÃ%Ò´Â áÐÕ š_ŸS +ýA$dEt–‚Ø«¸8–kG £ÁÂf!x¹ÀðýöÖ·-û6§Hu88ÃÂà-HPG.„œ[hà0šîÄ=¼—ž{‰…é™HLó$R8ñ­­FÈ,:ˆ…ÑèêÂÌDµÚR(_egi1`a…ĵÉR, ‚ûóòBòK‹›4®,g\³ÐŒÖ4 kFkBÔLp´ÜzïÇÔµ L&f °GÎ9ö§±ƒóìCK¡qChÁ©Ê_êÙsèX…µ³ÃÏ2vÛSdœ[%t"¹ …Ó9D“¬| T.8Œ…º²JÊQ"”“B/lGЂ"Û~kLP|›Rbaðˆ†G‡QG,Ãï pÿ€Q^#Rá¼aœœcaa`¨Ë [,æ †ó”a!‰w4@ 9*HᬲÒÕ ž2‡Ö³‹]Hv ù¼ekæWïÖˆXH* _ßU4^µ#-Eý9 ‡n´Ð,¬YhÖ†àw1{Õ¶+˜"|±†D çÄ0“sÎ{UƒóÉb…®;j©÷ž˜Ø{ç®!jÝbaä=HÖ)ÚƒÊöœ,«`‰µ¯þßØÿeñŒ´3ìO2ó©Ò-ÊH!Å77jDbqèµD.¨(hÌ— aìeõ$‰æ  èˆ׌Üha´°v´°f´fäF öÞýxc{öŽˆÉ9 @*&Æø¯ü‰†Ê[å""²” 8Õ«Øu#Ȥ®ð=% 3nB,5É–H¢ŽYRm×é/8fš·¶òð>K>ñvb“ë1B²és±ÉTR¤]è¼;îø‹=Ø0Ó03¬‹õI¦ÔÐF MŒÃA ‚²ˆ2Ëx¯"h+lC–„À$”üY8´ùÐùòŠZ1ëYµ‡°@ 4ÊRž^¹ëT¯m¥«þîÄ£rÊ~d+ÏMÌŽ Ú7¼‹.â¨Òaëʵ¡êÆæ÷›$‰£%_ hF£fÍÂhíÂhmC#€={j[PH—e´XŽY'­ ÆGæ¢5Ž´ÏX,R×V¬©sbp˜ÂpŽü˜ÀjOrE†ãϵ5˜~~Û1§MóÖV#ÜïÿüÈðB¤A«8¿;¾ùè õÞ;ç8:©‘Þ…àe°[ÁÊÇ È»/fBž“›1fè‹SV©”Òh¦ö·r ͺ…µ Í‚÷~S» °õm“Nþe/¼dé`pý*Ch‰Ð.b&\ûÎyŽôÒyö Gäáȵì%62Råð³ 8+S¼â³ó¾3œñ p¸òç~ìñì /,LºCãR;Ç>ZÆ! !…Þƒœ¬,ÆÚñÍ©!"mkù€ˆˆQ AäüO%Ä[ië£ÞcÜ‚Éõ”Î’-w%j3ÛGQ(¯•7CŒ:^qŠÚaœ”ЉW+äu˜èè]&¼¶•®VxâÉç6ð†<âœÂ°fðø UHá@ØÃüä/"O,IvúÔŠ…ócÿÝ9jFÍšѺ…f÷íb»‰™™}ºÊy?ƉxNÏf>î¦ñÒ là0i´¿ 2OÃ…G4GAÍ òÚ3Žc`"®’ õáwCÝXî,„Ò™{‰†Wâcç&fèʱ:… #9­+ H˜p(ŸväI c9raŒN kFwæ„ú¡ØË ;,#¡É¨p$‘éB>Ž :À{ç“o™!LÕmä ñB“*\4­%M•ÿ=Bæ´¼W…^: uŒ0}Ùúšð Ý^#@;xa·¥èNdCZ†BÓibîTÔ6Å£{ˆ¨J3çF)d‘Éa“©i‹‚q‘G¹»,JÁ8œHŠÐR“ØÕ’Cf¿SVºZ-94bA[’ÀDpYàÌ4¤=½•b7@û0è–è 3…Ÿz<Á˜µ8#ÐP¨+"¸ÐÜÚ— 'Kmœ1¹eA©(‰Ñ2¿Ðq¾¸PŸmƒ¨`ÄŒ–s¾•9¤œ+gW›IMi¯VÇkܵ¸Œùý[Ç• lQj|6| ï]A˜‘a¡¬P3C¨';'iÕ%æ–}b`â,?ö¾õí¸mÇíxãx-¶‹`ŒýxìÇcßJa–)9Q«¼Yg ¹jeÖ/¢¾ì (r糖ƒóÄqÁOìˆØ‘|n0xGc­ø`¥KÇ Äný¬²ò!l_2ÇÂШuàLÁ+K© )tÜA 5ßq 2Gœ¿âäkÈGð:?O.­Óõ¼ ·ZFë1nA@Û‚ïá=|)Ôž ;†‰F¡“uÔ¶&ã‚›ej!ÌCI!ãTšòÎœ~ñS—¼…Ä£ôO™Û19}¾Ð*mwàŒÅ9kà‘§'GÃíà™=\ô.tx—"€àïæªõíØûÖÇãÑââx#ÁÛE·~ÜúÅÖô‰`±ÂP´À .®&Ø&b»ôê/Õ]'j`d²vh˦^]©êË(3)Q-«€†–UÕ2Ú7³ÐËT¹%ó 'ü™ž çc7› >`H˜ ÃLÞ9vÒ…òΨ ¡ÅÎGäsók×.º±sÎ-:}Û8G /:nÇ­÷c?nC<–÷­÷2¹Ð{Ï0k­i¯ËönjŸø…E‡å¶ŸÅs»ô!Æ‹SUQO4t#–„€vů © YóÂ:p&6¾‰/ sç¤((ö^Áâõ^„ òqpº%&ò$ç8‰11Ì=£•H“V†[`VMˆÀc´Î ˜3Z†÷hY1äèœ C-:¢ ü ±æ:…ÉHfZY›ámŽ Åéj5µ[ñŒ°å°ÖNè^ñK£mŠ†ÚžÖé$A„É·Œ{øV|“ž½'ò`G@è;p˜àç½oǾmüxÜ6ÛÅÅ0‰ž­ok`°÷mëÇ­û¶õí˜[±Xm—܈“×óE7*\,'¿E8†)ÂË$ÂpņØHˆÃ‰ ¡UÊ’)Ô’qŒþïG? àÏ~®ëÉX!4ÄYirŠÍãÐs÷`—b}kRž¸%"?½óÞSÛ’sä¼sa.„ \X˜;*&sËíb3@ Π[™Dá=·¾5kÊ€6j•wµ, Rêg…;jä¬óžçwS_YÇÈ™3ý!‹‡ýrú ¦Zkm Á2G=þy³ž²9òœ&ù½è†°0.ŸÉâHÈ#HI§^Rhdï…Q¢ƒ†ÆX^´ òñ;XLð­Ì7üÏ †À½èiÁœ€ˆÈÇŒV`ÏW(]¬–#šF)ŒHaPÔ>Û0™ÐÅTo_ÁKéµRSËÌläèwõ”͑Ͻö%~÷­‘²0WÍÒ‹…}‰ LQÅü0ÓÊ÷LDä?Jfõ3ƒÃØv@Á¶mÇ‹ay-ˆÓ’}ë›MÔ4Ñè#Gæ|f窿5¢ µWâÒ“Z««.úèB!'“ƒG4“ŒMJ°‚‘)0ï-GOµÖÚ4îÓBNxÃ)³žbeæ%Öð¬? K$ˆ8`E² [VT‹+\‡¯MR´0b ÒÂÙDˆŸÐµëh7amçäëóÍH–m\X>&.¥6 ³›…ÑhÍh´0­]­-„ô‚Ì©—•eÂo#ùEèâ¡:Ú pFg‹4dO$œ®ÔÖûà°èë½o[ß²o[ŽÄàþðž™&§tLðîŒ3ð‰èÌOpú·låèƒ]‚RÎ*Dôáß1*Ž¤1)zœ8²šhâZkp.%ìBk Á9ŒÂšj’Óüœ$Âk£üQXkmÔ¢iãZk££#ÿÂ*kŒÆâŸ..32«Àa¡† ´x='ühf2[äæƺC½üµ&í)´’] UÊkWYs!MGï2¬WüñNý’ósŸy×­£W|ËûGÔaqµÖ!,´Æ µ#´ßP»@ã†Z?Š>Rη}»}¾H8P–X£&¬µ¶@͈›°¸škáZP Gn´fÍhaÍhÍÚÑšµÍšÑšfaÁšÑ(XC@ iþ³$ë¨Åæ¨ é/ É€kaÛ[ª“ãDFf]P-\»›ÒÖZkÙ3ð¶cNÖ«SÿìÕK{ã¯zý)KÓ«%-±FŒ@t„ÝQ”!Fô7QøUè@Ž¼÷ŽÂ ¼'礷Â`F™¤žöäWûãÚл§–@D­÷DäÒH·\[iò3ƒÁéµÑAªzÄ>|ÌÂP¢ç–˜Z@'à(E‘‘:fö~Ô6~Ü´ñ;½¤ßŸÐH&VDTØóªL]ã‚z‰a±¡Ä,^OÑ­°0 W•´M›á_ÂC©ƒÊÏš$+‰5/SÕ“å ¢SdÒ9éd9ùHã.øeA$Ž FI¤-²Y©Î5ã˜Îƛ߽p»8p>Ò$`‰TJx[Îÿ†¹ Z]ta xi—‚8fÒg«‚Y”£Ö¤McµÚ„ìB´¯għð2ȳkÈØyržG ­iè ‘ç5-¤&ÙƒÛ@·C<(.&ìnáÃ{€…ìGÞsÛ¶£±k׌œsѦëºÚeü/¬—-Œ5üè”û1›¢µ Þ;ÄeC2K(,UiU+{ÒŠÅ[]­–6}P"-äĉê×2^Øó$L9ô>Œ{†,í =!¨48Eš uDèsTóܲ_ðMëýÈ7£¶išà^ ¾Q²îò̧nùŸü+D⬠Ñ14:v¤£@À Ÿb±Ãó„öAtX{sÐD(ÏH©)e0BĶ yÍW†QZÅ*/dG€C2ãã÷º†A-DÌ9PÚ¦ª¢â–DŽd¼0}•Ð¬>cÏå*¡Û>±µ&ˆòQ© }·ë`ÅB*ËL”Ï[4qÒÜ\CÜz&G¾É €¤ËN#Œûya§Ô‡RÀ’`JŒšÉú4.,…Fš€ì½ß¸¡iGܶm;nÆáë£ü“„z[Ãü¢ÝŠ¹áhYÍÄÅVQœ°Èi¢ôÜ 9 åÌt(kŸ¿è\©6I‚§W«UÁ!”G˜` ìWäc@"Ht“¢`´PuÀ% 8á=‘‹Î-g–¹âHT¯Ñ³D”ÒÑùÄ‹Þ{Ï÷ܶþÿ³÷îѺ-U}àoÎúö>÷\Œ1Œvz(‰’4!±c«øŠ¶Á¨†‰&€†§‘¶Q†òÈZ%ˆ/"z•6^Ü–¨|miµ`Œš´±Á´ÃØ1¢÷ž³¿¯jöóQ³ÖZßcïsÎuï7ï¾ßY«V­w­úÕïW³fmJ[•Ê•5À­ö]Îܧý3Ë’vlÏ=‚]%hQ…ݳ†Mc÷|é­8Z*ÄaÐ>I/e½8§.Êà€±Ó^k·¾?æ­y1ØÌLFÆòÀAI!IY;!š× *ébNPÇÅÝvùP§[€ÕJêõ(ë°©"*…ûó“ÚˆN°áÔB^¢ƒ{-ë¦ÞVUIÓé‘V %†ÚEKÜ ›M«•7›¶ZëDÌÞ-韒k Wê¾0fÈÊÝ7´ýÞؽ90© bn¦ÔNï*Ô£í.Ék‡]~Føo_ÿ}>ð3ž$8-”ÒÝÔúÞ½µý…ª‘JôMˆ›FÏÓ %÷ÿè‘´‡ÍÛùâ|¢t5ÁJÐDZá&h"µIe.­mªÎÊKî—c`ˆåÒµl.‡\0¸ŸºX1À `i•u'ˆÊècí/švêf8â£óÔ@åä³óõŸýüCÞÚåGøŒŸ&¯ù8Ñw®ò¹R–¨¡6ÓÉå@ö± fÍ¢–±Â¨ `ž¼· Á* ®1o ú‡^mAõe´6NR/ç¤ðpë”%ô8m1‚²mÃ?×Rã<`Rc‘C èyûbÊØ¿ì@øŽ—< À‡~Å÷éj.Ôˆ¥i—¼RÃFƒLêM¢êñHqQ,œ „lt€˜;)ꊀÂÔR› "m³n›uLÌËî[˜\ºí«°¢ p¨±Økh…XFÛ1“õ>ú¨Œ>ĺÙ<Àzº±¹6å|A Kü³ç½â€‡v;H£ãï?€´}¥ƒü–{ µðÅÙ‘f¬4Ǥq]­QÂÔš6Œ‚I„[ƒX’sRh7#5²G—&,[“Ö¸´V™ ªªF{w$„¶˜h^º{B<¢….%°µ°D 5&"ã²¢:móAŠêDjÒƒ¸{Ž7¼S÷·ûç|Ç+Dä?çŸì~k—áwümlT_…úX ŠZ'†p0BO4RÄj#ã ” P¬²^å_'æÝýÖniÔÑÎôÐî¢ÛÈBªe‡R¥†ÚïÊ,$ðwÜû ýão°¦‰º,5i*õÓ³ˆMÂaõ›á‚Ž!ED¤i"­Hi­Z¿ •b΢F ™ >?/+ýè]†½vÊ›µªÈAÓ Q#ò£‘ƒ"‘:µz‹@Rk5a ÒšHM«!E4cŠ20Å.‹„p—ßY&DqøP²phÓ3DÔ0§†ºoQ‡ÿÌuS3 ØÀœõ³\1¨õÎe—Óm•…Š2¬hŽ…B( ­¡4óŽ)v¡„+Ïlö,eÄÎŒ|Râf2øU8‘Åé`KÈ×Rû4@ã!ŒçÒ3ÂÂP›¶sb>8@¨‚µ"T«”‚ÚPq“R¨Š¬H°iÄ+Q™t7 ¤ÄÄsƒ‹üõt8¬h¢Î(d%p8,¼"j „bš—ã³ Õì²2TL“…pETXQwKkY«î*DÔ¼R|âÃ<^B‡O¨ÂÄ3؃³À”­ú¼;ä­ÝŒÐ« ñgÕÑÞyrV(è}„J mx³rJ6Jî]†Â fiŠ£L°h‰6²ž•J,Ò û) 2‹@§}×à2•¹4.Ì¥HiT¸pm†UL6ŠÑ=HözqÒUØJÇ?÷ñ–â_S<¤ðÃé­Imšä R£uÃuœ꘠ †*E¨t¦ƒú„éÿ»üÒ¨}0.,hyáÄsÇ¡É9©³P‹“#Ÿþªvî^Z ¸”XœùµôWl˜–Á!ˆ ³‚GiÆkµÉx›^MB™A6’È ÿœÚ¯ôÄ(hV‰$GPN =Czv™ðµ-( ‘'°p*¨Ž’é»ôŒÓsk¢%F´˜„¨‚‹µ² ‚FŠA(`Ù4¢‚zBu†…; ‘Ç:‰Û¤¡6‘X[U ®h:â‹6¥Abc"r‰7ý›±+,\Mª»¢–J¤P'`†6å³3N´ÇuÂòZ›Ù’Ž0¶šý<½XÉ!õÕíÀ £ÞKzã IDATee£ˆ0CÃÇ ‡†¶ªƒ{Ì¥¸Ùt|"‡È F™˜DXÃË°ˆ°°ÑÂq­piÌ:¿CkܘkåR˜¹ŸíK]F™Âc =‘§}@ǶÈÍ"Æ¡uáÔŸ”Ìvx³A°­Õh{I$.ˆ¥:ˆ>vô½/íòK£-ˆ“7°~˜Â¡¢eÀ¡À`,Áº ê)ÅÜÛ!9ÿ£±‘Ì=@±‰Æ¨ ÷Îà˜AÌ`i0È"<a"… í§*±l|e$‘Þ±UÝe†‘šîVÙh—N O\Â<,-dQôÀiâìp{és_~Þ]²;ÄÚ£>õøJOÔü΢ìëT Iôܲ¯ú+Y$6Oq¬Š®bíÞ 0sµ“¸wþ±õúù†óL¥ÎŽl}yäq7½‰Õ1³« ¡¹»Þ €S:“JGEÍWZÅöîD¼úyáŽ÷HDwÝû ‡¿ålw?í9ç*!3"zõG[ÿõr¸´•éS¤ë²År!k3±/sÌè¿9ú{èµÂ6Ã|^ÖèkCH¶Ò—¹È*&«uFH³_8(bF1òEN¬qB%M¡ Zçiº ż6‚_$ιà„ Ñ‹Þcw¹’Wýç ¾ñ/x¯§\}ô×¾ÞÐC€xXÓBY®2IA-T²¢ZP m Õ‚vB›‚zBëm µ6dØ’ÕäÉr^]ôëÍè¨(0ƒ 1ƒ‹ÆÞVú Bª:Ù€…ñ{`J_ŸX~€ùeñäÑÔ”½±+¢žÇ¹ ÇÿN¼P ¯xþ«v—«—|ý }Ç£}ùs¿öbåêü}„Õî1üˆÂå!ôRk3yT*›mDQð©dóÀ›‡‰‘Ä2°2]46iô&aSA çKabV—T‹Vjt¸q†Oo e0S$ãQpÒMáTÍEKLk@ ÃÉüo‚pÉ÷uŠ|<¤ÿùöPojÌ@œjÐ'$ì #…ìí_vl{Z¥ 슄"hd.ÂeP¥¡1*aUŒ VÅæ3¯ŠBâªÅI¨¦…@Áæ¤ ÐÈ[’É3PÂKJhþ좷Æ.ÀŒ…X€ÀéjT{ûìò;ËýúìyŠ œ‘® …¤6ccØH-TWR Õ‚º¡²¢ÚÀYª§D-…dCâ“å'Î3þ‰3K ¢UÑX¨€Yˆ‰‹h˜QÒUmò1 Ê[Ÿ“ÕÆäçœÃ^gÒÈ?:³+“(Žy£GèÈÿ\UØÓîÀ9 T_Ƀ]_]¼IÉ%Iˆ“Eõ£¥î5czOhbŸŸ¹! ˆu† C>"EÀ,Žœ$B:£ob!Ö1AÌ „Îü¤YünáÄ,™"f$S×xЙ |¬Šks)u‘,†ýÉIæ…‰JÒ?S_`Ëý‚‚&Sô­{ìòaîÄT(é3foPéVq\põ½—*cPlc˜‰,îLtÚDŸj©xœ6 ¡áÙŠ³ÃVPE$ÛÜÁ™‰-6ƒ˜Ã{¤¦‘6» Œ‚4_Æì—<Ä€Ž# Xƒ ³‰âø”ÅÏ@Äþ‹Œ‚z¶ô½V/{¡~΢ñÕ´]ÁÖchÚ¸#¢–«&e#…¤¤5áF…¤ÔjÃZ=kV¨UÊŠ6…ê Ö+Úý}…¿èd:ûŸºÒÀ b[Ü\*—> ð3Z[ªÔn0„3äêŸô òOK¶«@ÁpèËùD†eIË{ßZÅ¥Âá.Ä}Gáív}ÑG׳, |vfým‰Ud"ˆ£‰ Ã#jJ= 5!nD,"D„©1s#ñ™+ˆ¹9ò1/ì,Ð~© ¤‡;K¦Dp*Ã<®iÙuÝ#œê ý±u‰F2.&DDŒµèÜqŠ—F(q@Áj·‰³ŒšdH@ÄûtŽ—F¨2©˜ïh°CÍYØ)á9¶)”&”‚âéƒ@ê[M#Uqµ€ÈQ1OA1†¥GÄÄ•&-/¸ØxµÄá8”1FœŠ§'‰¿Î;ìFNÑ?ƒÎ2 õ •¾‚Bü•4@‚&êr“ÒkYmPYZ¡ZP*juvX¨žÑj%õ”Ök:Q½t…ª5@"é혥,ü ¤¢é´ô‡N Ù5Òüd1çên#Ž…[©¡§,WÑáçì°‹¢‰2†*@ð¿Ìcyï[»Í!rÓtŠ!œBºj’©P¯ØÈkï± Dã³ ¼'€¹¡u½”|캆0#jlñØæsó¾F&rÄ¡—±ƒ;Žq/ADèH w+ÕÕj«IDMóM!ºDGFÏø\ç…}Á Š“BnÑao²Ëa ¬ÛføD,÷ÁRJ I#ŒM”<+áØfñ¬È£ÉŠƒ¶¨ˆØTmêSJDÂBÖ™g¸á¨QË`f2i³\Üm'£}­“ÅDô‹bâPIM4è¼é?êO'ž$–7“œ àLÑäÓÀÈ€ÌÏyÕËò_ð%»ßÚÍf„í¿üÜËŸú´¯ø—¿uý/|øç~Ó}ßð¤÷?½Á#¾â#ô®{ŠM…äNË‹»"ëg¬HÌ ]p4°êìŒØ²±¹„ç‹­üå!‰ Шâ'K`^‡L‹ æG« ³ïLµU¤oË33&4þ—ð g(¨;íæ2Âûí_üøé“à³õ°|ô¾ä£¾ù¥?ü®Ï{î#.·¶ÛŽ{9Ð PEï)„OÉ€„„‡Ÿì^{ «gXø˃ýwÄÒàŽ™Dfov,ε•æ½‰™ .báèG3ÂyáŠGN¤Hø—áPvBàƒî,s+ÊU™ß„§xÛ‹Äg#‰V¥«2:ÜD „MuÔ&¨^»×VZ+gˆ\—+Œº¢ª¾3ÅAñDÿ°^ÑfE›U¦=±ˆmKºè,ìË:7ŠÒDÓè_š©a÷¬«½“aÙùI¡¡Ýx; ðÁw–9¤\]h†úYÍ;©ë‡íD}Ý°w%&*Ùq]^4´¦8Ç"GÄìµÉd½ŠÝ´ÿÈG>*ŸÀ}’7Móª*áh^Èp¤ß$¤ÞÈñF‚8ÅÅHÑ1CàAÎ2‡d:Ôäþßùµ?ü‹ÏúKw=ìþ ¿÷¯ßy x9h yÎ6ÿ")oŠbåè¨ù#MpDŒýˆä݇p½´3Åq~ ’È€ÆLWu“…î¡ê«šrDCD¢&½ȇùþ³e “ìó—ÇM 1I£Šû_ÛMÂ[R®˜ge(6¥åÖCü@õШ‚ªš`“ŽÐf•OѤ´VÖÀµR·jõ”ÖˆŠ‘§t¶â ª>÷ûØh\]ÈÅ ¶,‰Ze×A`ì0¡ i¤Ký9ýúÜ¿!ÛÿÁ?‡Å)Þû¼zÈ[;<Öèw?ÿ%û²´ëﾆ+ïqEo…ïxÏ“ëÿõ-¸/úEðÕ®s^¬d\Ê“° ìlÒNÙy!e€ÌÚ)¡láˆAûWŒõj8éJôÄêÙñÒ~uD@Œ–¥žÁ» Põé)«»NVUPQ¤•Ú°ÜßZAcïJ<¡Í ›U3\<¥õ)­OhíLw“¿mjêVŽ4±)à©Fªu”t\´JÝ相€Ûï¹ëžCÞÚáÍöxP¹:7*"Çí²'…ñ¯K¦ŽŽ4 Ê u…òX¯W£lDasvØbB¦É(ÃΨLl“9cÎ °lU狈^_O`0Fz&½|-á_UÀƒ#b8š.SC×HKÒHW%i¤³X¦ìcóÙGëĘǩ×X*F‘áP†ÛúˆFF$"Å?«·pè'~S»žoI¹*¹Æ[ªØy§»mœ=ŽêT8>¬ÖìeYM$@'³€Âª: V)µ•Öä¬á´Z°ÑX¦Wèì”Ï”#žÒÙ:sítÎÑöMyuXˆW -BC»}O±Šú üzžn‡ÂÛyrî?Ô!åê¢^£Û¿“Cëæ¸Ì) ˜~ÕNA4ä%qÔ»­ϓKãL•t8kà…ÃÂÌÒÌ#F4[K®4¿FÉ¥zªŠª *¥ i8¸†¡§P·õ Îw–?Ë‘"#5&ø§?‰*ô¸ÛM˜÷ê>åÓÚã_vßç}÷“ßû×^ý?û¾Ÿõ5ùÆ|ûü6wàõyo€—¾ÂAJ š˜°‰Î9¢)¢ÊÛ( ¹Ê‡ÕP°£#÷<™5Ö>îÐÇ#6°ÎQ®qØÑ:\”cŠ<šÂäP‡X-—S2)DàÐ!ðð†î¦îÏs¸ÝŠrµ…ÕÜèAŠÃgGJOQ—ù`ÍF µ—±5i‚Ú¨64‘M]ÕVj»r½âODh³ ¼ƒ¯]¡õº~…¯¯lBD;ü ÿ&àGK«‘HiÓȃŽÞRSÿ†Ñ2)\|‚³…Ýv3°)WBý™Ýï–'°÷£Ú œXùu +Q¯ ‚ D©)•+:¦‹m¬E!"æÂT5B GÓH)Æ)2™)ù”^>Qxª"hj€t¾Ø­$gŠüôyeõ°Jë&¨¿óþü¾<ý³>øΧßÿç?è)_û½Ï}Ô÷2Œ¯¢¸ýŽ2"dæˆ{ífG–¡?÷èçýàoœoNÄÝ5êä†æ¾íNÎw‹Û®“:ÍØ¡³FE©•wÚ°B294caü’Í_¡’ix–êŸÍáæ͸`3öò©–ž ‰H——ݲ–oº—«¾*ã-©"Ükõ¦2Â[Q®:üïÜzËlæÑK×c‹…šÔ:‘ Š‚´©²®´®²Þ¬Îj¹}õÝ›÷¸ƒ®ÒÙüÀU¾v•®]åkÅbƶ˜‹s ã–3)ÌéXJ?×wE[VÏûœoî{Ù_®Î „¿ý–ð÷¸¡ÂJ+ûqnŠ ÛÚüû3OrB¨ÿÀt$¦è)¬LL­ÆMÌ•šÎdX™˜¥Hãf›XˆHtR ‚Øg¦fþ¥0«Íø§jížE¯G¼/»» §7èÈ×_÷Å_±ç1¸b~Ù/€—ü2¸'¤ “Úy^YOÊ‘l)AçÂË`‡ÑûÉ; ›±Àù_@£NçÔµôˆÞƒßMˆ¥‰ Œ¸qÎCéXxž $aïñ¸óîƒtS÷[bßóŒOð™ßõ/R½öÒqŽG¹ŸŒ/žÇG¼6 œ°œ@hMjúÊÙFÎÖ8ÛÐõÍï^_½sõ¾®@x'?p…®ŸÒÚ{·ÑÁm¼Ké”V§d71Ù—Bî¹ë;àá,íÖÚ¹ðýó8 »r`’mAÇaq{µ·¸ïô ³öVj'wrS+¹÷ &Ž™ìI¸PkÍæóeä^lzCñŽC±uoRR9´%žj?H¯ øÏ®sÛÝM…WU‰#BþÁW}‰~ðÅ_µû—?Öè‹?H .3ž’;£çË–{òÈRþyú!'º)ûË2V+ÆIÁ‰®V±Ì¨þ§éªaÅ6Í…b¡ê¢+éAm¢³0Ha ?¿ä×J ±3g»ÍšYÃÓ{÷óEïùÊ=Gºôí+|æw½qÇV{[¿Á·õÉ ùw~Ý#?7n¨)IJb¬VrçiÛT\ßȵ3¹¾–kë+÷o®Ð ñ™w€{îzõù÷½µvcóÎ!jqkÿw±NÚ ¨éÛ5á—±B$Ó0Ö4î3טÆW¨1³HnMŠÏjXDš7)ÌÌ"®‘êJh¤Šˆbî3>O”©¨½ƒÄAQ#u’v2©Á—x#rvûìòÏG˜ï£{â-½ä6Ë&3øÜ–-Î%ûN$[-{嶢NãTUÌ;iüN6Å—GŽh Ø°*àæž5bŠhagºL!rœFdP„_ÞÐ?3Ö*Ë-6Ø}qse4lƒ¨Eä[®”sU3Û´õàÛ“û³'±þ!PYÉÊ\=‘kk¹¾‘kk¹¶>½ÿìäþzõª\»Ÿ®]•kwÒWùÚ)Ÿ-=c!Í–)­.Ýýpœ Ø^¦xà^·Ö.¾hþÍ‘#ƒ‰œóƒL1o`?¹êO)ñÞ£[ï5$øè¿>Ñ|¢ÞVbA˜Ig¸oÂE„…E„… ‹ˆ†ùÖÉœtÄvD1[0Egaö%²@rÝ»È#ÊùÅbOQ›5Üëa•Kϱ–zƒvd-™ÕÉöt8ÿ“qkÆBûÍG@/RùØháÊQ°!ã„qZÌSfÓpÂ8)¨ ›ËGP+A³P–607´‡5BØèdõK]†™ækCu÷Úü«€â»üÒh¶-ø7̳ðÔÛ·g°tš¤lëBC~üD€ä8xB$Drµ´+MîX˵µ\[ɵõÉýg'×Û•399ã“39½*,õÒ–UŒ)—‘óÕž·&¹¤]z EÎeüKtm)[>θïX%RÅqOò!ú‡;â«'@Äõá\Šc 3‹3‰‘E‘ÂÜD”ª+“!16Èl±ÀmpE Ÿt@ÄpßwN\Hûï|úã“>´é~ù¥Ñ–Õfø7_ˆ Û1⟮Îa/Æ/6Ç¿æ»4ÒÑ1[Bu„9e‡ÀSƦaUpE™_AÃÅSAcÿ+Ä+UD"`%…>ñaLˆÈd*Xü7K£Šóï°ÊÎ.»-€p ÃæÌoÎê4y Öç=šdËy–@±ïJö›€Ðf’$f¹ãJ;YÉi‘U‘“"×Ö§ÿu}z&÷¯éäLNÖrr•¸BgãÐC,á_Ešý"­æ;¸^Õ.=þÎϾ9¯þ¥ùD`„1¤§4ƒÀÿFð‹äÀ¿`<Ëà—‚¬Œ§ý(‹b3±@„SaH±UiEl² f€…DÀB,Ä ±@»µJbi~ÚN„.ê(lP}JáAãåì#ÒS/Ö[é1þÐK¿zÇ;šÛœeÞüòWœw—±ö«Ã-ßõ‚S1B†Sü›€_ÎøÈ—Á/oµñ^K›Â4ÖŒzÊ dœ06 ›‚Æ1§˜*Ø0N‹® NÄxae¬ØN¡ìp¥S 3D‡jܧ”ͳ4«£¼Ä 3ÔßÊÞëUç«€.„ðíj÷½Ïøä¼ú¤×ü8À áß2ømÙ:ÞM}H#º ¹Ïzk$$(Eî¼£­V¸v†U¡U‘kgwþa;]ãd-«39¹“E¨£. IDAT¸Bg§¼N˜—±mb=Ï·Ë=w}ó9îq„÷ÜõÊóî’tι‰þòÿôw1c‹úçø· ü`Õ[ÉI„1x8Îa¡M/ÚP‡Ù† ²yÊ0*æ C̼*êGª|161“-§Ñ÷æqC6<Ñf}"> 0cn:zÏ¥WRy@ÅäëÛ^_ ~ô+^¾ã=Ñ'¾à‚.é?ùµ¯¼Ñpz½ðíµéÉ2NôÏ É[Ä?IÄ. r ð‚öÅj›,ÄVotéåDHÒ“‚á”q¥àÔa,ŸÄ¯ûÑœ”….Ã>q"‹@A¿s7!€ìp å׬ñ¿ý–]õýæg_°lüÕï<_Ís1#¢'½æÇb Ã=ž ÿh[¶à'=‘Æô1qȯ©’ÑXh, $ µÊgrm-œÉg²Þ´+týNzલ8å³q¾ŒËóÄÉ/&åS;×K´GtÏ]¯Ú]®žy÷óÏsØn÷ÜõŠ‹•«è#ìÕSZ=ÏÅÿ¶‘?›2a0ÂIÐ'"H!f*…EZÎ9¦‘:À+4*`DPÅ©an ¸pCSQbˆûÖ-È HsATÿ´œ<ØLÌ šØ?…ø–+®ó†ï¹üÒ(Fö†‘ðÍ)àœêM0o‘ÿÅ^-[Éßf‚‚¿£„«.£' '„+ë†; ª 4A-h@W;2£•´*XùVa;/9\B épØ"ỄI5êé ‡[ðð¼uÈíã,³Œjj·ižî¸H³”áŒþÙ‹@H„t¶\5n‹”ÒvGç~mÍ××wü±ÐY;YËÉšO®âÚU~à”67ƒóÉøèrmuÓíÒK£24_Þ 3 t ÿ€F>¹è@fü³8¨‰Þÿc-¬ý0T ‰ X$ "¬a‹ ë‚nÒ9™‰5Ö£I©>Q“ ØøyNØT?5—˜XŠî8£«&ˆÌyáyo›ÝÜk·Â @à$Qᛤ„ûÎ)`m=¥::®.Âð ãT]`J:Kq>Z@@\)@j~ëVÕE;„“k¤„¢]†®‘þI¾U  Fˆ¾l «C@qsÙ‹vÁ @àyñ/“&ˆ¸°:ºi× ƒ¬€wDr\$’;¯4K…äÚúŽ?©'¸¸ ¯éì*_ãå^ü Žv9=:'åæ‚êávéð&C 3¸p»ê[m¾Ú¦9¢ íODàÂ\ZXù¦¿ï& l9‡.$BB!a²_¢&`V6ØŒ ÅL|1º^ ¢Е¬35Îç‹7D oê|„·ÄæZh Å$匽2Õ϶CÍh Ø4ƒÃMÂE+ÂºàŠ³ÀÜ®—ñî(îBÒ_ª™š`E~© 4în¥‰Í{ ¾¸˜Ñ ºm«o,.—ŸžÇl=ÏB™¢ãN ”h˜1„bJ‘Ù&;1ZÀžúgAˆýWq±øŽSKGçÇõu¹sgkÜ„+ó)4ð)ÒÚjš8DZÝrŠ·Ú.?‚‚ ¬1õ"ÎY v¡àÀíß)ÿóß6M!f+ŽÞ Str•²ÁBÐ4›l”¢žÕ@”zÊ&Ì„T ÕýYÌ DÇNpvçC¸”ŠÀÕQéQîíÂTÊæMÄ ›\úq„8€Jâs‘ØqÑsÎc÷½,P7Íüª`Ó ׂM³ô˜Î…4[§A÷¶IK‚¿PV{C_ À Ü;BïP!°þ ›ªéŠ‚ÅëCò”ÎÅÏ®g“~=a;z¢±K/4„í@ÁC„Ð) ¦­Ã¦·¤¤Õ-ˆH‚ÆÂqØS‰” j"ÄS®œ´É,Ä×ëM¸6^Óº¯ÐIãN¡³^Ø$=¥Eùô¦Ø¥Âwþ«Ÿðð¿õ À÷un!‚ý3–ˆ HKi¶kM—ó!+3”À]»:AkBd¿QŽ‰ÌCE±°XãÇ+_!aÖÖ}aF³*ª  5Ô.Ã]]†¤ ©»Ì>à"AãëóÔôl1­ºÞüÕ_wÈ[»ü}„¯øwà9Ì6Lˆ œêa†s”5'Ž v5ãbë‰Ñ#Xë† ÔæXèX]'¨Ž”ÁºyôÑ$W²/ ½ÀÅ\äDpÂ~¿bÒ¨0X â¾£" ýÝ\,è¢ÍK ‡Lêg‡$òU¯ãýóí¼üÒè}O€'¾æM‘2ù=7̹ŸŽ)êtkß”Ò=³€˜¤©sABA‚6¡… %ŽxRšœP”ZãÚúJj| ©5nôÀ ­Oh“¨á¢í¦†ñ0&åde¼ç®¯ß~´ùq<;7>ü£?¡Ë˜‹rèD0ÁShFç$‚9ô̺üŒp€@ì—C÷Áé¦IzOôãLSF^8ᔘcïNÎÿˆ„A ÂBMS ,<]5¯RÌgJ®¯OhhTÔˆ+±ÎîtŠ5w!VòI—l7"f›£c·gÞý<4ÔáÒaVD{Ú-CA?XFÁX'•±÷¼Ë¬#Êä6T§Tî‹dÜ Å´5`¨¡¼'ÑqQ'ÈAù ‚°V{­5’Üo£gUì/ZàÞ¢”Î4½Úîk~1-«]úÎœ¬ˆÊ¸:GÁîíâûfä ´‹MË‚³ÞÁ†…œâ׃˜Ô×áMMÏ^Y7‡;Ô¦ÑmîØ’ožº3!¬e ¢,°IË ™4ZœJx$½ÐÁUS=ÉDÍìÂÃùÞÚú²«ÑlÄ$%m¤ÿŽo"®buHÌ}8À’@:2Y×!:]™_„N6›Ókjã;‰s·Æ®òÚWD«,Wx“«šT=ó Ããše>—ÝÌù±‹ônUDÀ%Š¶'Ò舂}Œ:u”8WèŸé*Cr„µ§2þøá iŠƒ!iÒ˜HDÙ IkÂ_h,€¤qô䤣ƒ6Ð>ˆ¡NÚ„è3tâQà—Ö«…ËxöÀÂË?ûfŠèƒ"ižH¾0’—Ó¦9øÕèJt.8pÇì\3ƒ’*}yÂzµ8BøÚlE°PC![è\@²%Ã,ÐLX¡©£0À R¨˜×òàBxlîìq(…-§”¸µóÚå—FÃö*¢'þŸy÷©kè.¤1%í8­‹tC¢ƒ2™—ê†ß~=‹ jWV€Ní×!g›“³Æi±0 ¨¶rJg+ªc¯áäojFbÎ|.» áÔUHÊ…à‚ž5/;òÅ‹ý‚鼦ž8ØÔ(5ªiþ­Ç1ÅØ!qPÔŽ g‡ ¨ŸLkâUŽ[°d…HfiBN sHµ3-ZßÕâmr—A ÿÄdØDùÙž§Þ’K¯aM¦Õ€¢ Âó´´5{‡Ê±‹•³K„ïzëOx¿ü;=Ék©ýŠ(¬VË\¾¼€‚ ; ´"º›*0Z½ [l Óa´ZµápÔ†¸Wiµ¡p«˜AhЩ{›…Û††¬„4…/fîØ {›=(¡D?¡xÕÕob´·¼âv¾.³ 0·ßû]çÝåFìU¿Nžý×DÆw› bOñ ykFA.nBe2 "*æè’#Š¿ó…qož½šL.›÷nœj°4õ¸ªÉ}Fé`FE©¡ÓA°a<Â{¢-4'…ê)“GSÄ÷@þEt^˜¾õoüïÕDÂOyãƒZÇÝ÷ôÇx½òâŠè–a‚æAŒß1Eç\°7çÓ6ÁÂohU[¯U•öDfœ”¨€ ½Ö›rf"þ0Q4¢ƒXGA$:(¼mwÁ„î2ã»øBŒáºa¬Ðƶ3؃ŽF$îø#¢’V™˜Ìq|Gn­·ô bÑ(Œ‰‰z45»¦Ë§¾I·®Ò<%…[Óøj'>µSñ k}Ú^_¦43p°@˜b}!C PÄÒ€ÿá»÷„Xû¡Ç^°l<þMRˆµ'¾æM¹o½n˜£Pý;”}é#4Np4eR€eñP¾¬QÖHdÛ*,[¬ I;Û`½‘ëYW¬7rm-ëŠÖÚ Òú ÒÙ mNi}Jg+ÚœÐfE5nqécõ:y‰‹ïtšxÏ]wï.WOxù×lÛºÛ^÷¢^¬\]|ö‰¢è° ‰.ÆQÍî ³õìýˆsó(eóéÀ(ǽ&Ü?]ÄkJ›LÄœKEБŽm/!ŠZ7"yO"‘É^ê‰C ¦Ötâzg~ÊýœÚ•)ìplÆî±ËßGxˆ(ša2»MH¤Ä@ÁèGÌ›,§/Í?(’Ê@ûÈãnÇlõŒ¡³0+CS@€€ÄŠLØ/5ƒT/å¸C[&_X±£Õ¥Q¸C  Å‹¼µ«¦”¾¿»®Ò`—_ÝROÓ¶ “­©×p’e)}Fþ–«+{Äâ>¼F¥D°ÓAJš•Œ5BüÒŒäl›Ò'ET•8º"d ^·“tÐ@§à&Üx}J›¤ˆÎ/¯×@ã2&W7K<ÔîoWÏ»Ë Ú…œe¢–òÕ ¸ìæG8ÀÇœ” µ/ãñB %Ö 2ª+Ç$#–d=…¢…ŠM„ ©5‰Q©ƒÐêc]°“´¨–Leˆ³á½êˆþú½ŸÓÚ寱RI T­-´œµ±hH’O9iÎYüCî@ïîãÔر°pÒi`IïËt0&8’ÞœkÑ@Œ^YlÝ„”!¶³£%¯@*ˆL#ÕŠy*€$¨f#HJ|~©÷Ùig—ßktíu“ÆêKd[úB>YXÎX˜(€GôèˆØ¡qr$·}U›8c%ÒŠO¤ØéÖ(gHÛ` ÔÀÒ¨ŸP-”ßî68\Ü4&çciÜv®ü7n ¢Mèžæ¶î¤ƒ»{çøª¦žÃýDáQ2oÐRî‹ÃŽ‚k¯T‘PôÔBBÒ„ IÓ0ÜíVÚŠ…¥@дrrWwE>°•î9bZ–Äz$Ý%Œ¤F o‹È2HtÍV3·é F´Ï“wÙÖ;²êr¹rR¥ÆÔ]"{ "ì¤Ð{ 8Æ¥êpÀ&î/ÓÀì\P@0'Âû¯ÓA Àÿµƒ“7ìƒfu07ü¸Ó¨ËÅqQü9ìµÛ¡}5·—÷ÓAYJ_&Û¬ónY|Ì‚;üeÆ:"Œ¢ ÚX‹Â8)$"²R¯‡ÀBÞ´“hœ·Æ§LQ̧´«S™UžSŽºŠØQå.ÚíƱTimK˜×:ç ƒf &é$Ò%hô­þO„ÙXv M¢Frªs½TÑÙÆZÀad°M†îá[AkÄÖÔ)Âä¨Ör=”àÐÛuzKbV |R®dr»;ìòÝV‹[ Â7¯_æäožá|¥j©\) ETRf8$¤h2ÔÑ(KTº<¦äÞJUâÕÏÅôÌz«ca_v·-½õP¥T /K/eÊ µ‘&Éq44ˆ.Ξó6[ßÅê ÛG/b4=¬Õ1¤\b±­ÑNDÉ>oqÖs“I¤„²R,,Þ ,$"𺀠¤š€íü ¥``…V¨Žéâ–tÑyÊAvMî¸È-߀÷moð¾ñq[zÇ¥)q\°ýoY,el¨Ã(¡÷˜IG¶ÅâÁÍÜAÅh✠z5(4ü1M""Ô]ODzƒ½¡±Âí)Ä[íÌ€ôÕ-p˜ûjì¾D„‚âÏ}óA3^^~FøÍÿž<ë‘ÒƲ“yÛ&ç«ÛfS ’D3uÎõEÏÖ¥Ñí%"ÏŠ¡8k.]ªLjƒqÈÆT4 pÄB!S¬xxÐQN¨¥,ÃaÍqDÄꌀ¿ï Úÿò3Â×=í“<áÞŸˆÖqlÚS@¦ÕÈœ.?¢øÙ~“A«b¶š5®‘üeó‹7ž·-@$L(…°ò®Y‘làu[ œ ­t‚M³žëºT¦tÂaazÙ;ñž»^¾ý–»Ýqn§Ñµs¡œ8Ü3gÚ:?OëÆxÞ4 1ã‚9· ýô—è †·'Þ±"æ‘ «’Ѐ+Á¤íyÒ RH\%@|”X炾J½¼Š‘@±yí]êðž q%ØÀÇ<ûóÚ ‡—ßYæóÙéô6Ëow‚…‹"Õ6£…6UgrM ¶ÙC-sœ­ìAãÃppPTM ]é­i‘aƒÌè·)îÚ£_›E"mÑ£) dqm8_DAOŒø¶'>b^~ L'vÍ·=»h À ·›„qðY=á„ @´*"@khLµÉÉŠ°Ý«Ô†3DM † @X„3S‘ †ù2ò ¦˜/_<óîá8¼ãä/â†ì&æÅb•s!¿lKM«Nˆ,„"î ߬[dDA„@ŠD Ç}§º…( ¡“ÂÆb®}J…b‘ÀS,tlÕ¸€qŒÔ0á-2Ê;EDMÜû(åÒ‡XCvÜyÅ¡mÙõUO 0Ð!ö‘|2Ŷ ’s"H¾5§&½SHœÿ™?²r²0V0iÞe4±pPæ5š.RG35ì×Ⱥ$9«êêhFD„±Ï®ßÅj»Ò ºß’Ú¹”äÚdî3'Oè(Ø{ {úâE ¬jZº8kÌ–VHD°¢³0S±È]XS©"kHÎDN3ÐÊšO§+ª­m 5”t»‹p8YÞz§ÛìÎ+·.ØîÂsÖb]v|†®Žv,BÀœ7fýÊvqˆ‡À².:Þ„—Æádvw6s4Y06&í,´K°¨3 µN"f±Ž ~[”R?×@DRÂ.»üA·³Él¡oJI;ØÈbë@½Tr ¾ "Ö#hÎ,‰ëƒ†1äòäÜ_¦;Ž.ùËä[?‘ªâ§ÅFiàDˆ¥‘ábÜ…ÊžÖK ˜ûcü\½¬9¬Ñ+éÕðŸ]g™»©Ÿ‡¤7ØK™xÇDùZÀ? ×V4rÏÓÞFŠdà™™°bH¡Ñ(µpT ¶ÕÆæ¸ :ÕÒ¨3®"’5¢‚VP]UÛ~Ã]`Ì°ÕnFx‹m¨Äfêè ³.šŸ^ÿŽ Ž€‡rÍOqÐuy]%i—è8 ÔZá Ú2‘ˆ¹Ït=×uÑY Œ<’žÅG]8÷ÍEì€ë¿ü}„·Ú‡U/2ä[³wLçX2|$á)c¤0£ G™Ñ÷Á|ñJv»:>5~ âª)y×sqñÓà™Àþˆï% ¤Y)Õ½”,òy=–«®CÂß&Î2·¨V)œ3©W2ã'<;ð€‚´;óá×GÄÚYHhl®x­éä"‚ˆœ§$g©T[]Bh%lÓÍ¡ K+ÔzÑÆe,mÊ[wÙ•Ë„ê,ö¾ö˜¼‚®ÆLˆ ™¦ù&àgq£¢Ìô åƒÿP_VÒšMV±Qʼ`búk Ÿ]‰ˆt”Ù|xÀçX¨•¥cøˆ…¹¹–7B/}Û·ýós=ä Äý­·¼ñ¼»Üˆ}Ëo ý™õâmtrB£/ ¨žš¢‚m"ƒø¡ÏŽ+q¸±Š‹BĈ û˜B˜Fº­XõþÈ›_$œ¥5?‘Èx#~A:Q¨³U…ϸ÷¡@%vh,з>æ ç«€.0ûÄ—þòƒZÇ©³LØ?¼÷'oð€4Öô³FºÚBw 5imeé!LÕ„‚]#í ˜gWÙeÒ®ŽBˆ´!E,RMP Ò„ /„` љР­µ\)S„‹° ª:G+¥Ø‡÷Üõ²ÅËÜf¥œ»|Ï3>õ¼»d;wˆµ÷ûÈ¿ÓcÊØ«ÞYMBH1iÜëdÌŒA¸´û"¿âž¸x¹éÂ{JÄZÓ6’ýzd4įKcxÔ4[Ðùh „S “Ê °M™•’ò,ÅfÀÎOñûÖþ­»C½ÿc·mënû?ýã Yt.#¢Ï¤ÄЂ–Ê—¤Xk9ÜhÄZ›Ç]Ë1ÕàÑgZÚQ‹ ˜ÅQÛÖv°Ñès)âhDA[¥ßÂÃꊰbÓ©;mÅ}Fa Û¦w ¥±ÖC$`“ôƈ~JÜ4:ÉÛPß'm¿HŒ”¿ýú=!Ö^üA,_ù+Rˆµ'Üûf$;ÇŽÈj»·žÇ!ÃaÖQÐÒS²鈑$±—GYëyl¯Z¥ ÖYWÔ&›ŠMæʦ¡êoF=¡MA]Q]Q]a]¨®¨jJA-T *‘ª2z?½‘‰Ýs×Ëv—«Ïü® ¶Â¿÷Ÿ|±ru«¤ÑÔ"ÙŸiȼÔâê©ÖþÜÊÛb"‰¢‰î.§ÅC²K±jÿ*m3åÉgXRŸ„gè.QTSüƬq1ˆ¢®—î~ºÃüY‘F)W4>µXÎíÕ9a("ËÚ ¥£üoŽ@œPg>¬0ŸbrF¡¾JiÓx7ŽÖÁó"…£k3Bþ%¥wB »cKS"ÓEqÛH£û+ìm™w;‚Ž®1prp0çË(¨ÙéàîýÇBgDMËWaH…zÊÔDJ4:,¢&e*D•¥1 I; ¹H²¸Ð>—Ó#<ÏÓpPwÏ͵[ÞGHi˜Ö²ªÐ붮~öe2tè,LpØ›D“óÒt)Xaˆ¢ŠK¢èò‹¨¿@§ŒîÞ4èHˆÖEÑ©Fº Cu¥TŸ„Õ‹& Ÿ[½­Ýûläॉ’rh± ±rÈ4I®1ѯͤE£¶!»×Lê,  ThK¹’4šÂš÷žnœØo-O; !}+0`¡ê½”oßÑPJAË&5ÒÛ¯c‡û6»½½FlÏÐgÚØÍ[¾r+6åÊ'lèZW\³QÁ˜aغë~âD$…ÑšMW"d¸(ìul#®ê¯55‰0šPõ.C bDMZ£Ê$bÔ¨nÇ[‹«8¨¾ÚÒ ½…v“€0ÙÖ[‰ÎÅÑS†=QK©ÈôÏ1?Zø¨ì6a„‡³±nK­ö~œ´u{w`ÓÑ5œ+ç´Ä^â†ÎØá®×åWfàT­‚™X¤05&)(Íg„¸¶B@•ÀB©*DB6Â5ÊURJçtð°úê6c„{…Žo 9I¡‹¡˜a¡¥.0¡íO-áD€ß¸_¢ƒûø ™z¬tQÿÕá™vÆåÄÃ…ìÀBÄtš))¥}S43å ¦ûí%N<<;Ž’&íª­‘R–@Ó øÐuŒ>¢]ÌÜÒ¾Ê`Ö;äÐÿx¤ƒ<ÛkÑT¨¤’}0…øôˆFNÁö±P|Ç ƒñ Åé&ì·žÁn Üb»9ßyv_HJÑ” í?Óà5Ó)`Ãmp b\aB# T+ºÌ±Ð}‚²I(©$%¢˜ÌQ„ˆËT);>øjíªÝ@ˆµ™eQÇ]Íúf&ˆ‰+"e^ˆb†ÚñA¥£Nž`o ì˱C¢ƒcÏaúÝb¡Ž:B;)L;•ˆã G,„…¨z§p(¢_üÎoßqmý"/=ª×è³¹ðµ°Á«ì)ÛKc!0’Âæô¤ˆ†ØÆYÈêëä’¼F{¿`‚ÆL#âZÆËÝHcu^â…HáÙ$´\²eÓ¶ u˜ RC ´süËÏVEÑOúуj¢Ë„bm¾iÒ8_ };ûi”@SL¨!¼U¿ëB£{%%yŠD?ì<ó~™4Ý*„babHÑL %R8,™BÌÂQó IDATw¨ð²DÄ+izM,ÚÐÂL)µë½ç®¯Ü{u‘ùÁ´›b-÷j¡ˆFÒ)/ìD0 ÝdÄ?š,fiÔWí'®gØï[ñS÷ô¯#h¢;É(j}j,*ü"‚`PÙ+m-·¥D·öÙŸ`/^~ Œkÿ9¤-–-JUN®{b_ÈôÇŠq°`€AËMñÉ„QX’vtvˆ ôü;L þ Š¡òàóâWÞ° ѵӸ_¦~Fò¢M°7ªà8<»ìÅjbíBäo˶`áÂY1+Ï[®fŠ‚”Ò'9Ïy?3ZõO#"óÄG*×£6v.ÈÆÉGôÛ}[¡ i 4‘B­<(¥xæÝ/Æp(tõNúm&òæHøœî$Rè=~ mç/D¼ëxÛ{žóÑ!:ÑEQ_It0®äÀò•ÔѾŠN ýr3òaÇQ¬ÓMð¶á^»]fŸÀ ÿz3#^ÊÆ,&Haï)ÜFU!$;²Œ€7´é– @4Ÿ 5ÒɈF_ÅÁå*°c±jéj³›(ÒÄE,Ô†dó‡‰p:õËÒè`qû8ËL£½xòut‰Ž¦X,QÃÉ.»/Õ³ª.¯tÑ%‚8^cÎåPñLÄ6ç½¹ÒØU x¡³Ch­Ô wW|0@^”ÒývH£SÓºÜ+epL"éÈôfXè©''ÁÐô9 6¡üoÂø·£à¼w0„Sì*_ÔQÌHáTÝŠ…&ž2Q²&›pp‰¹üŒp±ätQt‚Ž Õ0ë œÈ¡9±?,F8Tkû^x÷%;õ„R ´FcæL w³Ã\+gutN %*]êÍC \LX¨"‡4êO³ß²->qùán b[PìÃôÏì3ƒÃ|¹É,GjŒ%—:Ž‰»8»k  „¼é¦}„ì±ÝµWaè òšË«%Ú ¬{ÛÑÑGÚkLèp8¼mar9€ZRï)ìà7YMõ_–Igº(öTYè¢A#u€C£\‰Fâr¤»„å ¡2)Ü}÷¶!¡ÔR?ȤÈ^£ ÷ÿÒ¡ZvÙK m—-œ‹X˜dR „ð¶÷D Û@g¤°#â,î"g:ö É¿©rΤ0·Ñç«ùÞPÂù¨K°voKn,Ú"Ëü)š—¨m8—­ç¡)ç[Ö?ç®1^R¬ÝqmÓ 3—ZÊõζ#o3fTWGUSg"™º@Z s…Rá“~ @(v¤A#y2wÌ&4Pèbûì6`„ê,£=…fã­eC¸ÀÌR¿$*ö’)‰b€¨¡“rnó.ÃL{Ò=ÂËä QÛð‚ ÷’B¸+Í„Z†´9Fø¥{¿sÿµ]ÿ¿_ÿ¥óîr#¦ó~~r–Yleíà|ÀtNÚ&ȇ„@‹¨óv?¦ÜLí$`µ yùš `&ˆÝkÑiG#þã-oHCpï£$g]†¡6tçRÂ'¿ñ šèŒðÿøýµŽsg™7OñÏm )œå±K˜jÔ"µÉ·\ãì„˱Ö|a`“SœüÈ«$"!YXtÇÂhgBƒˆ”Î0ÑôÉ±Ô •¬ì2j•RUP¨~ç ^zÈ…]`øÄ=ùcÏ»K¶‹„X‹Õ…XkšÚ™£¯éI0ø=Ç<%-ŒWºû²çØ™ˆ F„cÎ-æõ`fL‘1muîH°èk9òaAÐ(k@?j>`ö½/X6~öÌk=½âèUí]ÀRà4LkçåCmÏØ/<“m(˜Ò§ãîRF%ŠÔ†&¨ ›*MК¬«¥´&5švGcT&)he U]UÑ‚¦ +T@=e¤ ¹.*…Ú½/øÒÝåêÓ^ûsç}tj?üäyB¬å)UÙìROá szÂÀ cŸI ’p‘Dx‰2°õ"gKA‘PÐ/~'§8Háœø¯´wÍs)Sô›ò—yaäéüñ w™Ë/v—, S;Cø)yà"OlÀSBü”ÔsÆ©\•í“RÈáF#=P0rN{f?ÂîÎk‚ÏÈÌ„‹ç¡q¯aL=¶òBk£ù×z¯]þáÉÛ»Há(¦Ò”¶§Åj—_L`ý³XìªË|¿Þ%´„‚ÓÝ—¡tÑbG-B¤.3úôîåL Y Íâ톜evôz9 X÷|ðÀ 1Þ|/CKOdOÝ?Êš¾‹¯"ná‚ó{ŒßM²ŸÏlÂ@é‰úÈ>PtQ¨(LñlüÜ.^£”z—{ 'i®—HȇqhDŒ‹ÐtQϳíMÏuÑ "q¾ F"Fyx±Ò—-ËÅÊéÞütÇæ×A.\I‘š!“b×n‹>ÂC@nÀB{Ìû²ÁÙÕÄ/fV‡Äe|ÅiG_Þ‚‚t\¾‚E#ÒëŸÔ—””ß|@ÍÙ´÷" *dEµª˜*µ¢(V)Ú‚·"¨=ìÜ!Öö“Â-X¨;/`!°@ =íb¹s{z‰qQCÊÌ]êÜz¢ƒØ!Ìw4HáòNÖYˆáþ‰”Ž…HC º˜KϱD ímEM=z»"ê-ª#³×KqdDP¶7,(Î2RC]`æ(ï&èà6üÛQÜrU'㨠½Á|÷Ñ"oÞËŸ±™hf"èlò¾-¼Fix­Øf wX6 ,z ãßs4Ó‰ÒYòêXß9M_>à¢éhBhшwJŒ)Dï)”fÝí AuœYQ­`U’œnÀ+´*\¨Up9 •u›1BLHá>,tCˆFTwW^¦†v–Üë¸ï ›·J£š3¡`E·ÙûónÐfZhNDÄ ;È$tqXýþ3Þ@¨–Iá îÀÂxÉNõ‚Jf9tqÔ|®í°¥æÈ(ˆ´œ!œvDA±«©#5Dâ‘;lYÔ›äI¤RâÄq†J#%î<Üg,V×o—b5¥qËÞÖu›SŒåD.ÑÊÊ»L?¿¬-92"Og: n‰Ä–ßÜÞ2£…V‚§ô á±Â¬Cì!̔͢Bµ6RVT,¥ ‚ U)„¶!Z…4Š¤Ñ‹4#nÈÎÍ@ßõÖŸz×[jz×ÉVO¸YN!ðûÿæçmc´–SÑÛÏé|TüâßüÛ_XÞ NÉál; ÔÍ¿û¶· mû‹šˆÒ?ùõý!1ù‰d÷"‰½ žÇ~Ô?DÞñÚ{ßñÚ{8u»ØßÞóÁöª_§Wýz8èbcünK¿H¹ïöƳ·Hà û_.#Ì–sþG„ýiÈÉ9Ý¥û¤LP0Žá›þýîvס&î+ô¬Õy‰–šìžG’÷ò}ëH=ÿ&zü›ö_ÙY»à߃f÷=ý±÷=ý±ó;Y€Mð_xlùŸúwòÈ¿ÖÙ.’+¥¼iüÞòÏ6 ±ˆÐê NÜW_÷ôÇ.>ŠÝ–ê×i™|Û‹þ>3é¢9Š6¥*¨J°)nš"T¥4p ¸ oPxÝ‹^øº½ð˹èßíÜ@øð¿õ ÿ¨ß›íp,ìR$&8œ"âduþ7níé5P¿¶) ƕߊæȬ-ãWµ‘yÀÂȃ„…ÀÖS?ø=mÿÉ[»Øßa÷¶þÝyÞ‡Üñß|ÆO¼û°ü öœGÉ>jøžcyø= ;þ%@"OïΖ1(~_±ŠÌ3°ôSPxlf—Qôë¡ñvnÜƺp„ k’ËOÇBÊ°P€ü$yÃc÷S³zÁ¿Ãì&”«'¾æMO|Í›ìƺm[¦Xˆ„… ¶‘o{µ-)gÞuHPç(¸|Æ|›Ëñ@#u`fÊsÅço§i!@•ÒPØ+(6š¡‚jBåñ_ýÊÏøê¯Û{v!¾Øßa7·P®.$Rt~ù[™ ¤v÷öFY¯!B)Õ½í‘LƒŠî¿ºÉ¥¦Ô)<ö;Ön27.qÎ v¿Ea0”RGi`ÔHaÃSrï“v˼Ú¾õåOxâkîø¿xzƒG"×È£S† þ´]#Í@›0Š¢öL—Æäí~Á9,/ÒÖì8ƒ€Ø¼ÚlÏe’¢…j ¸Šj›?]itK¹:¿sN&s¡vÀ°Oÿ?þâOcžß{ûÏúþ½£Ô×~ÿßü|j5Ù¦ßÿÕ·b&Šþ§_}ë$ÅŽ8ˆPøý_ùùÐBáÜÿ÷Þñs–;¡àüÅŸÖ“.wú5þÎϾy® üÖO½q’]ÿÏÿÐ$eŠ[¾úïÞpß ¿öýß#¹º ò+ß÷Ú9/Ük·ÒÉŸ{ÄÓîû™o|Ü{ï/ß»3#v:Å?îùMšd~ÍoFÙ38ám÷½“²(ª‰?ø.šk¡oøÝi"&,`àûß9dÓñÚßî×?×=¿iå…(æ{×»{ù¯Ñ¼³ðŸ¾cZxþ/ ‰ÁI¢4Œý㟡ÉÐɧ¼ÅR‚‰ˆà‰?I^xˆ]¯üÛo7©\ ‡ ¢Cìdª÷ýOûÄIæxÚ'.’Hê«–2ÕKyýS>nNÚ^ÿ”[¸*å Ó%ŽùOýøÈûêe÷¢°àSß÷ŒOžŸ÷{žñ©“ÞøìOÃÇö¨ÿêK>½ùüÖ?¥¢¸I0Âò_ü¬* ªRêc'pKá–ru1Fˆh™O: ‡ÑJÿ‚úó¨¡íèo°3G‚Öò“W2E )y‘&Ù’Šm\0ßÑÂñ´8¦ù›Ë6)tŽ¤F}ì=á…û¯åÖ9ËÐÃ>ðIOÅæw~éüòËôH#Õ‹”Æ°Š)&h!T¢\qZúŽq`žùó””?^§RðƉçEÁʉÛÊÖŽ2·M\eu/3³e\Å$`ÛÈ ÷Ú-ìí»yåj8ê4aÿ”“ùu1<í=×6ÇÂ%Isшàl÷™^:Ý}‹|ºÓˆ‘‰Ó—@z´'PwÐ,È6†ÔDw¥9há­c„ÛÊ•œÇnÕÅí†íÖ½µƒJÆú?|Ó£ßçÓßüGç*NÇruùíX®Žv+첕«ó1ÂcÙºíf¿µko¿ë‘þºwøÐW¿óžõ𗮎åêv´c¹:Ú­°?•ruÃÓ0í!gw|èÝï”»ÿ´¯âhÖìX®Žv+ì rõ`G²9ÚÑŽv´£íRÙv´£íhi{0&C9ÚÑŽv´£íÒÚ‘íhG;ÚÑÒv£íhG;ÚCÚŽ@x´£íhG{HÛv´£íhi;áÑŽv´£í!mG <ÚÑŽv´£=¤í„G;ÚÑŽv´‡´ðhG;ÚÑŽö¶#íhG;ÚÑÒv£íhG;ÚCÚŽ@x´£íhG{HÛv´£íhi;áÑŽv´£í!mG <ÚÑŽv´£=¤í„G;ÚÑŽv´‡´ðhG;ÚÑŽö¶#íhG;ÚÑÒv£íhG;ÚCÚŽ@x´£íhG{HÛv´sÚýo{öû¾çßûñ?zhúh—ÖŽ¥â†í!„›ßýž§þÍ?OD'ï÷˜ÿâýÚ—s´Kk÷¿íÙÿÍìÿgïÍãeKª2Ñï[±3óœ{oÍEQÅŒŒŠ-ƒÒ((Ò­ÐñãÃVAq|²û¯UšÑÄnŸÝ¨ýk'd°q AQp [PÀ eh¦)ªêçœÌ±Þ+Vìµ3󞩪n[ïÆ/yvîÜ™'÷Þ+Öß·ÖŠ¸øÞxê¶þeÚíºé'_þðfoÓ+ïÿèõâwžÒÛúWÝ®Ûÿ°»Ë¿|éÿÂ#gw{Úoÿîs¿àØmýs.´#ÛŽ=ì§?®ªª§ÿÇw^µù/~çUU½éWÿù‰Ûú—]h·û6»Ç3þrK5ŸùàkŸ~Ù+žòØg½më¶þI·çv;­¿éw?ìŽr㚇}׋þócïø…?ÿÑŒ3o½öž÷ú¶ÿøÌ'|þýïu—+¯ø¬/Æk?Ö¯ûøâ£ÿýÙ_yÿKÉ‹îý˜ï{õwàÌ[¯½çg=ùùßÿøÏ¿ÿ½îvÇË®þü§üÒßoŸÛóºÐnñv3M¥6¦ù_ü¿Oü¼;l&N®ú‚oq5ŒÅÇþû³{Ÿ‹»49~·/}ú¯h8óÖkïõ¹Ï~ý¯þ߸Š¼æ»ÿç3­'=÷i}ðý?ëšK/¹û?ÿþ—ÿês¾úóïï»Ýá’«öÔWý¯€þc¿ù½_~ÿ;^tlc2»ê¡ßù²÷ïÜúWçB»uÚ¡­N6ïô°'=í wøÄŸ¿ï”žÍS mͬšß…¶ÚôvжÿêÙ÷ŸÜå)¯üÀVY\ÿö=îRà ~î#½ž~ËS¯Fzèóßq²¨Î?ükO¼ÃñGýü‡ªzý«9»Û¿yÇ–}üoìAwù–_ù»“9ŸþÀk®½ïÆ}¾ÿÏO«}|ΟÞUó'çIWxÌ+?YnÛs½ÐnV;¸©¨.1BÕÓoyê5À}®ýÍ8SÊÖû^ü¿_zì1¯ødÑ¿û‰/ؼÓ7¿ü½gÊ⯻öž›zþ»wìø;ˉ»>ꙿù·×]ÿ™“‹jZÝþÄ_Ÿ.Z®ÿýﺸò_õ‘¹êâC¿ôe'îøío>¥ªgÞûº×¾íã[¥lÿýÏ|éæ%_÷{7êé·<õN}åën¼m®Þ…v¸vP«+׽싌–ëß÷Æÿð•WLòÂ÷ììæ©Ü*ÖÛÌ’ù]h+íö„ÛõÌÏš<äg>ÔÛË3þ´»tÍÎ&é'*vm½í{ï:{ÄK>žÇ@¸ý×Ͼ×ôóÖ?^>õªG»ê;Þ|Ú>þ…/þX¶7®ÿõGnÞû9ïÜ>קw¡Ýrí¦¢º¯îús©ßòéWšaì¼ó‡î3}ð‹>h»çïyÞgOÿÉ|_…=~öóÞ3o¿cüï>óš^ù”?9Õ>·ùð—_7p-Þÿ“ÿdóŸþâGó <Û­®\÷²/r¦2¹ü>_úm?ùÇŸìw÷T«VmfÉü.´•ÖÝ–lôj‹Ï|ø†éîqi²—“+ïuåäÍõ=™]rù&m»»ì®—éë>vSÆÕ£_ÿŸ™\}wÿ8]s7~àÓ +®:^åcI‚Ò—[ýt.´[¯ÂTÖdãª;_T¿%MÌ0׿ÿçñ}ºÃ³ º8•îqÃélǿ篙Œ¿á²+ê¿£H:vÅñúu"DɪåÆ¿øåù±_zã{Or";ý›í»^H—8?ÛÁ­îR`vg¼õÝÏ{àFøž­]<•µrã;ÖÚ̪ù]hãv{ˆv—ÜùâÅu¹É\ò©OžÌþ^ÙºîÃ7ÔWóO¼û:\~çKÒøãÓ+ï}Åâcÿð™z”žùè?œºäžWT³!oퟡ»v3M%4®Fwù=.ßø¢ŸýÛ¼þú믿þúÏœœŸù›þ¼Y=^VŽßÝ´NþÑ÷<æÚÿù°Ÿ|Ó;þâío{Ë«ŸöÙ³}œß…vÛ-eu»{*ìf3kÌïB‹íö„÷ûú¯¿Ë_¾àÇßðñtëý¿ùŸÿ¼½™ßñÂÝÿÚÑrã;þË¿{ùMø¶/½r霧÷ýÆÿëÁÿ¼g¿â½§‹î|øµÿþYrõ“¾óAÒIo‡ífšÊîmv¿oúîÏýëçüÛ—¿ó†([×½ûíwCÞûsk›.>sÝééïq§ãI·?ôºÿü‹ï¾§u¾¶[ÊêöòTlæðíö„Ø|Ès~ëg¾ä<éî—Ü뉿}·¯¹ß¦¿Õ]úȯÆO=êªYºôá?%×¾âeO¾«~äW¿åQßõÇ;þO_õØ|û0¹Ï¿úÍ×|÷éç=üŠiwüÿú]_ñ’ß{î?=~[žÐ…vkµƒ™ÊÙ áÚ6½ßÓç5ßyò…ºÃ„L—~Þ7¿èm7VJçeùñçý³w~ë7O\qß'¾ösŸñ÷¼ m¯í–²º=<Õ›9|£êí-ò°ó®ú܇¾ñ¹þ£'û³kïóèÿÂG~û»ø¶þQÚQlLåB;÷í‚ÕÁv»`„ØúÀ›ÞôÎOn œzϯ=÷¿|è¾ð%Dñ[µ->òÛOðÆ%_󆓷õ/9P»`*G¼§vµ{»`u·yÛîn@Øüwøñ÷½(‘é’‡>çã_ÿâW}Ï}/ˆ·^+7¼åy_ñðï{ßÝ®žÞÖ?å í‚©ávÛÕîí‚Õݦmvu;”F/´[½ééw½âÕ'ÿÙÿÅã¾è ?öÞW?ú¢Ûú]h·‹vÁ®.´[£íînŒðB;·ÇðÄ'}áåR.Œ¢.´[°]°« íÖhû°«ƒÔ¯)žºÐŽFÛ…ÙßÌ»v4ƒ vudÛ»ºÐnvÔìêÀ3Ë<ûÄUY@€ ð§¿äûŽ¿Y!EYÀ)à‹Î<ô©ÇÞ¦*=˜!|ñÖç}óÆ»ìÝ^ÙC ä·vîõ˜é R*2W¾½¿ãç¦O/à\S.4}Z7fè"D:@€ÓÄ &@ðAâ~Z·;ßùVâZ?’x=ñ•Z· àUÄÿ¡Ðr˜x9ñMã‹ÛöØn{þoþYÅŸ_M|•©@x-ñX^ o"9Þùâ¡::¦ï$î¯u»üÁ½LG›–Æs´ÈÙkîô»3$ˆ/ÿÈ÷¿ñ.?žÀD$€TRö¡xë=žG(˜ÉêCßÿCo¿Ï³É(™ÉBêßýý€§Ù6êÎü9ùsïyÈS((",d¾÷[^ù‡¥Ø1”L”»þáïôËI*™í­;¾þÏ>õ" ¥€EXÀ|ÙkÞ{ÃW%“JPÉrâ?ýÄ«H…ýw(›¿rÃö7]¬õ¤Î^zjçI£…,Æ{h=zãe'ëgU»Ñ²ù+ןù—WØ6Ôöóø¯]wê‰×@¡*¡PÈůúð_{O?F\úïûÌîg/„R•WþÎß|êqR%Tª €;¾þÏv¿kª×îv“—îƒmÿ ÈÞ!3P¶·¿}cã¿EÕög ìì|ïlöB ¨.lÏ|þÃÓé3íÕÈ@^,~z2ù;À\ôý«SzP€X½j.åOEô@¯º@Qýp…}ÊÞ²9ªÎÝU|¸39iîŠLÀß–ò@Ûcî*ZÊ#RÂØ]ýaÎJ£Œ¶'º«?Îù~˜Q¥ üY)_ ‚±gú›R ¢@¶ªø€êÝÈè™®S½Òɾs ˜ 7€®AîQ^«'x¸ÛÍ‹þêp¼§XSõNÕS»ë€~WX€¢(`  ‡d°WÉàBÓ°Œ‚ŸA<Û3 6Õ›úΆ…¶SüÑ,g㶱dm{Ô-Ë>Ûö¨÷¾iØÓvNÆHÖvf@Âû©ÅM¨í´®`û÷5:t]ä\í³]p´Si—eèï Ö·0R² ’¥n Ròh'ÛžÜ0| ©§C² @Ò¢þÇ !²p“Gع¼ÄEØÃ6´±i´DëþìGR5Û´!†‘Â^AÚG•P­;I(µkCÉõ]%(6É ™ Qªª:ººgm·§¥Ë:­¡‡·ç¢ÅwÚg{ «Ú ýeì&6쉢ÀÌ}Õ„¬îJut6"t7`Ã|¹ä®" ¶K­íYï®ÒÌl[UÒL$;g³rÕ©#Üà®HŠš©ÕÏvî«2T‘÷eW[çz*ËC¡@K=ýþã²êŠŸzìm¡À“7ÞÙW/U}•B(DÁlÏJ…< }zöÊf¥1 ò`Ìðï* ¥æµlãÑc:hÏOÔJ=+|›ÛÃo_±¬ïÖüØ]û­öž¤ƒ™d·&8r·®¤Àc7Ÿ<Ò™ðŽ9 ­"±±ñs«ƒG£ƒqÏtú, £`ÃèUíeª àÀØa/Ð °LÍ{9œ÷i.ÍüD"¿8¥¥?„ý› IDATa|›RuW.'ڟͱºø„®‹çfüïq)Å3±Ç—¥T= – tcØ{€ˆ Ú³ª}ÉÝÈê™H:^â¾*»o+؇vyê°32¶G£Å½8I=Ò1‚¨W³x( Øv)%ƒìÁR±âF¤„I@;{‰¡!RC  ž±Ž¿yõ2èºUþgæ“ÂÒ¡Ëjòl Šá¡ã—yŸhí<˜)g‰ƒìNIBOÖgÒá0r·—4££*Wkl¯…Èr¦‘š·®«m\ÀûavµÁaï…£`ï(˜  'dódo·hGe¼ëè Ö XˆH>ŒýÄœÿµSR ó S²¨¦±òi>©3ÈTm•]1\TeÀBø÷ïѶö%sÝ‚ífJ£{ê'\}©Z}CìR2ƒÙu[²aaã‚iÌ#.NÆÒh‡KˆQ°aaÚã$ð#P ÏKÈ_.mLÚE4R@ £Ì¸Ÿ~]T¾€°»ûµo»îÚ[îûš1•Ð½×·ñ‰;(F³j‡Y¯7þWY }§/ ·^é ùŒ’}ÃÅD™þ5, (þkÅ÷`WÊéøLÆãv@›<ª@®<ðHT«#‚H¯áS•V"¥Ð@ *ÕRÕ°•„¡¦¢Pî‹Þ @xKÛU«& C5R¦ÖjÏ ï–Ð¥³GSìCP°¢ ®§î«&ä¤É¤@Z@£ÃzOXb„-[RÏæ®,ÆÞFìªí°A%m讪à°‚iìPœü5vX Û ØÞ Òè®vu°:–Ïó¬ão*±(`—’e ¨Z·3¤¯o¥,Ê)ƒ½'ÂØ˹r4×´€X\pGÓ\ei©ØÖB}“~“~)ì´ò•Bâ üelK}¡Œ7–ž[׈Ýc`ko-ÞÒc—wßá °{–>vÿwyüá×Ëì¾ß¾Ó Y‰qüŒ’eZ¯r/dR-ÿ%È›("9Ä+z‰0“Yz—)¹Êž /Û[᰸ǾY‚(jÄü„6tÚðÅ k»Òa{Y|Ût”ÊO¨°ô¨š˜IU Š†ˆÚò_”ª– #–£a?@ÕdÛ—ÿÖßÖŸ°«]©¾ê°wüëÎ¥]ml¼,t¹âÙ.#2ç”®x2K%vªÙã\8¼Õk×’bÚþ°í±Ç<S÷X 676!Sôg,P0ÐÁè®–† 笵íŸuaSǨA`ñ+²|ùÂÅ:ÛEŒ´7´ß¶»]½ù>‡¹ß¿ø½ç(kô9'þ  ÅâyÿÙÆí¢áÙvf × š*4×LÈX¸j°ìƸŸe »±Yq [‹–‡1Kx6-tÕ¸VÉ_ãy%h¡²r@{·]KÛ~ˆ¢¹çP÷¨K£¿~Í ’阪[ûÊe @WþçoÏówÑè`UJÿBÖ(+È ((}ÀÎÞS΄UÌ;™Š…íw®Âè«Ô‰ËÈ®]?³Ø…*J’Zj¾(EÕ$Q¬¨ Jõ jÁø!³m_ÿøÏQðŠßz×^Wÿ¨K£¿¼ú>EÑ¥¦ãþl­„í:´  gŠ¶í…ŒQpPpæÛÑHas]–>I!讲ÿÜÁ‘pYJ}h0òO¤:Œµ“¬*¨³=u%ãýö}È^õR {Ïžw¾$˘4S–ºhWΦl‚9Š‚ê²_«¬¦)¬Y£Ž8\K+n\°aÞtwç…«XˆqšL;¿„ƒÖîÏ{¢à’p‚³Ð»´ŽÿõÍî Ë!ºó¡“eÎiS,[B³DÚ ueÛJ{Ê šÖ4NõôN5‚è’æ°“’E šÚ/ÑÄ!Ë”™¢4[9¬ÁÆ=Ÿaøÿغ­5ÄÙÈV-Pã…¬1†b/EAPK#|ªR%ÓÊü’ë¥ö%b (T-Y -$E‘ ž¤Ñö>䨴!_&ìÑuû[[²+uE°v¿ ‰SßÊ-³eÇL›ªENK 5œ6v褰ɤ ›"Êu1Â%ww ;[:¨W¤Žy¹½@öD˜´Äö<§FT Í]e’!@XÓGÉ~Ÿtí|L–AÍËFÛy¶Üë:–tœA «ù|O“QÉ°Œ(Ó^–BƒÓuÛ —ÒjVÄ»1¶¬hVK\pɾJ8¸=º€ˆQkˆ©1‘ÿuá¿3ìGعw;êŒ66âб‹Q œ +˜­y§ŒÈ_‹†Ð±©ší¹fÁT.(,”^¤bÂÌT˜€Ž Ñ±æ‰ +dFGv~f ~Á2{þµj‡²D Å(#­êÈŽ¡D„:AL€(J`~RÙ¡(•É’øíHÒRHÑúkö¼eçËÔØKhÇ8ÄÙ»PìÞmµ<±Æ—Q\l…eP°_å‚¾Ñ pâaÂIÀGF¸D—˜Ç*¸` X ‚CBD8‡CK“I¾_TsŸ7ÿ£±À¬£^Ù…Ãvkç#T [ìz”P2ÏòEÀ2(GCÎC£ƒJ5KBh¹I`„Ó€‚Ó½xac„ÄÊÿÖ86/WY`{Îãý»ð? ñåâãÔfk‘2˜9Ãóí¨¡B 8 àYU‚º«YPÒ¯ vhù2F+ôòÁ ~¥ ¡ÒìÕbAé¥i¤)ײÿä(“ÂÆÇaÂ¥Öàf„¨´ÏäuðS­ º(m$?BÄ¢Žˆ••&Ô¬g“PP¤À“hJ(€}e’G]0FÁµ·ûëEžÇo ô©ÑÁÞÇ É äÔ\”ÃáÌ÷täÆ8q¦¥’ÆÐPrŒIg?ŸèŸÔÆP§.¸í™?Ã@Ý _ ¨Z²^£Õ½³@£†tjhXØ~g_Sö£„?|êË<ûĽ×ÖЇý¡î×9›¬j]»’?…gŠÖ݃]‹E4²„]ÀŠ“€…±Ð>¿³¡à.jPYyŽÌ¯mDØK+ ¸³ÛW{V¿ˆâÃJŒEÑv•ß¼ÏpÚÁÏ:ðGnFûº?ÀkîôŠªputµÇ¸ª´¤…ú†oÃé`it1݆çQö†…bX˜‰˜: ê6]54^b„«mª€Ãª»ªÂiBéЈš>S͉õÝ¢–º-(ª–b=§ ¡ª…*U À P襯þÀ~îšêPä§ú‘›Ó¶·Ÿˆ:¿Lýÿ>Ì´aAÑ=Ç@¨2(AÍ¡Ï—q&Nô-ìgðÖPpPpæÈ·Ñ¡«£UÌ"#¦³Cúðs›‹ò@ "iU„Ðj>lLq9áÅ1{îPzËbUîJ\ÿl|±æ,©øÈ>¥Ñƒ—Oð{>zÐÄv` ü¡oPH eõãßd‹º^¬Z;¦ Ÿ¶¡ Y]TÆÚfT>##œ^ âtL»Fx6 ,ã¥çUå3öˆøV¬Œ9ž„ˆ »ÍèôÀ—*ò~àðà@¨? |ú?x¨öŠkžŸ@sïg?™=±ð¬–E¢é¢5ˆXMQ|*™Såоa¡0³SLˆDL9‚ÃÊ@€»Ú•OÐE6e†j#趧(tå@M®-Z bÕb*ŠØoÓ"1´ÎÊzåƯ½;4]²’–FUŸ €|ÉA?x¸¶¹ùJ§kvÖR fmÛÝ/·ž#kU%ÊÒ}âÂ9sitæX¸á4±9¶˜2ÓRF—„­åð›ÚË6ƒZä…­d¢a‚sjÒèR I 5 @œó5 >ÄhCú €ìUïAöûÃí3Bý‰kðßrCÆ—ÔQTSZvR®òœå[Fî¥ÀŠè—cx±ˆ0ù`i °!âl¼g:†Ì¨2,ÅÓŠ*ˆ´' lüo­Ú1­Ê £¿¤ˆ¶ :ŸûbïvÔ¥Q¬¨£M”5àGUÝ5^8:¶Ý°F ½ò½ÑAŸV´VYô5"8ldaÏ 0Lü&Î'®‹&ÏíjÒhÓE±jW.u¢ò þ¡ ›kX`DDÃÂÖm ðeGJ›Ÿ‰E³)¥ªê“ÌE´vcQªZÈöz=fŒoÙÁámÔÖfʬžàîÊ¥ã58‚µ½}4•h2òç(8 \ÐPpÃœiÁÂi¬©pu4ÝUuZd«ˆÇZwEŽªQÿTÏ‘YÊùÉ–M5"˜]íÛÐÝ©a‹ÐYàèš’½ê%ÂÖŽ¾4*µ„)öiú‹ZÁÔ†í{òKWÈjs~ToÑÃfrÓÁ&c®Btc,ÜðíYHgãTÒXŒ-kµ5ÀÓàƒ4P:¬c„#¡}]‘€nÒhS%²Ã•õΙëÒ˜µÛgŒð°“nŸ«– ’ƒ- Õô`{wH–Ù뜇™ÕJµM#I@ }µdQhH“YzÔ¸`UD§Ä„˜ˆ`å…2¤-k´åˬm ðÔ#‚¥N'ˆç-k¡qâuGAK9³—Õ®  ZZ}D ÄóÜí¥ËYû3+òèg&²ÅÈÚ™5iAÆÉý¤ 9І#£F!JCÁÉih×ðoƒœù³y2H¶ôÑ8z5ï ÿšæ©{#tx+Ž|MÞ \°AÁâU“öczUsWF æåƒÃ,£@çóàîÑΓ¬QÔè -4: Â&´w+1\¯,Ù«9#„GVÚÈgé±6@86WàpêE:M&ºhTGýç]££–8ÖÁÛÚAáZETBŽL$|ô_‡sñ9ù/Á¸ÿîÝÎF'…ô³\=Eõ9ÇìhP yoX$Zü €kBði²›XºTSß Nµâß´=£îYH+:)ÄŠ]UÒA"‚É94F¶§kMΩ¤D3Ó´Ï!m§(¡ÈÚèPEÐòK­oï‡î§$ìÈ´{Úx‹«zƒ÷Ûý †þéØvšƒé<#tÃ8ä¦3ÂMýÔèàhôNÝ øD{~£L’¹±ºaXîÒípÀ:äö«ö>,7.Øû"&}Õ;Ø{ÞiÓ?áþ¬j/ªÉ¯oàö‘,Ó„P`/û«Öéìàñ!Zb}Ëj‹åkU íÆXób"#Œˆ8 ÑçÕ¬Ñè­š'^¥€e¼sé±KRLiQæ ‹6jØû@wœ§ðk÷nGä€ÃiÙä_: 4³<Ž$R}Öé³}•Lë³Áa++„¢•É{°Pj˜0K§èbž ëá… cŒ>Z×Ð]ÔeO 0¶$‡ªÃá*óS]§‹Ú‹(:ÞvE»pŠRj¬°`L¤ X¿Ýˆu^H£Ø*gé-ŒmÌXx–¾×Z‹R`Ђ#0c3Å ™ì®‘š@ºá(h ¸dÒ–AÓI˜(„›•) ÊRjFp)(ŠRÆ5ò-çŹàÚt˜‡°P«GoAÔ©ÔZ^(­¶+è?ËÉÛD2ûuWGðÔ¿ðC'Þà'eøN— ^ ¡€&hYAÄum`÷õz-é¢q;æƌ゛¾1 @8YB®›áœ 횥¬}7¢f¿‡-þ×(`ñ…_†´k1.2Ðúwö%Œ} üÆO<À+®y¾BK•†G†B™ê¹ºeÕÒïØÖ\Õ鹇©Úê’L6[[›8;…ÒSJE»©=³†‚‚©a×"…JüI:˜Ó2 ®f~Ó6dº]-™ý 9ÞS…Ë£Që³ÈE›34´ hŽÿê'öuÛçZÂ:hÛÚú››¯ôROwô\ü-ÛX¥ƒ»÷2 Q2üŒØµç©ëŸÆíq, `K¥™º »„”"!caTªÐR7Š¡`BjÝÖ6¦Šœ¯Œ§ŒY4D i¯$‹« ÒòEÛÚ˜‡ðYfâÁØ]½«ìáž,s3ÛðGNü® AŠu:ƒ ê(ÕÆ´B‹ó $ÒV?C†Í ¼6ChÒhl«ÁÂ4¦wKi2fMÎgþÖP­º¢‹Z‹\ðl$/æÂä³–òÅF Ø6àÈ7 ´Â¯ZºMeHÀãxížpxÔðåW?ŸMÏ;Ë1H ÔAgË—¡Ú¶F]þ–j¢kJ^]B€°MÓ¡‚ÜD*òM3ߨJ©I£²&\þWðb¨Ï·sc„Žy%ðÂÈ9–L-@(6è]´4,´ Ry¡9ÿÊÆ¥h…g¾áªéø¯í‡óƒ ôç¾mn¾ÆÎй2¦€Q¬íuôêî©Kοꢱ °y©6¿ÚFFnä&0M˜L8é0é:$AJg„ÃR7«ñ¶sq²è Xçð Dи`ËX°ýÕι`B8NüDu.åÃ¥\ÊJ ,Ò³'ýÕ' ášÊÃÚ…ŠBœÖ¦À$À·-ц£ùC g£Ë«™,.UPLö"n›&cÊ Wl;ÁUËÍRÆ€w6¼LáS%dÁÈó$@ri;ßhM–€Ù{·£>ÅZVµé¶ÕãTõEÍî‡çŽ:…©ÎÀPP°:GéYCÒV>8¬£ëkÚêóÚ2eD²$EM 3©ø7ÌÆ2i++´jÂ%­¶M SÙÑ.» šmZëŸ&.ɡɵÐ&™6dðöâ{ˆPEG,c¡«¤Åýw+cimç\ÜÞZo±ÆÐå¢*l/›”ÜB«êè.XØ\€" ³“£ˆÑÁ‰?GitÓá1ò0›qÒa:Åd‚I‡.U,ä ,‘æ ~Ù7lO^ÆH¦±pÚ8â(ÕǘO%#‡Œå$Um$a»êŤ„`áíÅš ˜ÛsÍ—ÑU!Qƒ¤|v\D°L X˜B°0&Èl›Ž‚ŒRfLÃX?†±(uFc9"¦ð©ä͈"J¿xyr¸*É{n|¹_ <ꌀªZå/×V²"U!^jˆb—|™:‹ô¦kÚ€…6°c,´/6¤GgtÐj'3bÃQpæì°s´ó²Ÿ6½MA TÚGd›HBëFñåÊ:ªŽœê@‡hƒŸ¿íªÅ˜‹ê'¾B ²"Á5R‹*I¥ýnÕýÖâ¨3Bo é£â—#‚â Š’âS¦ä³XMò0Æ.­ Œ´Óʸ}pT “LjٌSLg˜M1é0™ ëi´EV¼iAÎðr±ïQ ’‰¥yŒ‘"jÑàäÈEH­fE&U;m+–XxPù# Žɺ“ƒ_AMœ9Û8"¶Å|ïcnÙvðò ª­£ëý¤²D AH•!”Tè&¤éVªÂ"uÔ¿ŸÿžÏ†‚Ý:F8Ž™8âD!=0æ®Kª¯YÜèPdà}À³¼ŽêE\BĘ&Ú´ÐH%t+zi`ë€ ø!\Û ƬX›û²†•Ǭóg UQ”ã0!UI‹bðl¨·ÒbA… §#,­Ó§u!"ØÑ b&ØÊg–2ƒ¡š°ln§Uÿ¬ŽGëžžHƒVUy¡è24.Ä–SÆy1$Dë$OÕ˜èÖ;²«!ÅB„¥4y«@±{öQm‹£ÏÍkä1øb„Á?¿ˆ-L(^A.®£Ú×î~q2vuW¶S,¢hŠèÆ7¦ØØÀl†Ù´’Â.Á„”‘Yi_ÂŒ\*ÚåŒ$ÃË’P ’Œ$SƒCË~¤]…V/˜I­ÚUáÐ4åjdyH u%Œ>öï®{3név` |æɯˆ/-k&’B2ŠP|ÀjŠ¨ºRÚ"ôf"šP>¿ab9ëœ÷íÛ›4ÊqqaLœ™ººé(x̶i8 l;^ÓþAòzÃÐA¦ L2kJgCÁHc0P\’R##d+½ t°§ ?²Ý#â/ïÏÑ·VÖ®Y½kKü7¯=åº_ZÖŒ-%dM=eFLµS(škÔš¼Vv©ÂìñìÅ÷µ¹LZsQ²J¡R¾… g†‚ ‚Mb–*;œFÈ8uH¤>µ¼V̨ìPù’v%´ÐUÉt ½« %Øèòï1^Øû°ŠRHN~yë`·íà1BÞëCýÈÍi[[‹/77_˾$“»ëÖW%§ÍcµPŠ=ïA #þÕm_k°­21õHá&*ÜØÀæ&6f˜M±1Ãd‚nŠZ±Úz¥™Á\‘5/P¹Gïø—s†ø)JAߣÈALº,™æŒ¤Ú»‰-€DÒ¹ ı0¦ØªçÕ—¬+Ýš»zC>˜Ô9?8#¼ì­gü™Ð „ϻ赶šÖa§Ë¤u #…ôáVHv,´`$<ì®&(€eA…3íwk2 ˆ8f4ûŠù2Ç€ÍÞÜœN;6šñ¯K^‡1 90CšAºA&ˆ’iì8kÄ ÿrn6WÕ¯;µè[+±R{|»úB¡@¼j/Ð:„Ô`ñêÍs‡?Õó|%^›¨·ÒMÜ´ì“R‰œÙeøêÔ´šX›×Â$ñòTªîRânbF[æ^!¨uÏ#:§ 6ˆMb#a³ñB¯£Ð­ÔF㎽—º÷€¢ƒ˜)Á~â¶sÒp€*z×K%F×-ÑëhdÓûÙ©Qh ÈÅ·LU“jR¥–´ù+{ÕË\Õ÷Ü ïÿáƒ~ðpmsóõA™i¥þ– “¶m“ôÚÜÑ‘Ñ5¥4b!B·0Úig˜L}º ©ÅGö–à0;ΖÀsøå“ gWÆÖÔ”…ηõâ=ÛÎAïò¹nmÝA¢ª6M¦ ¤¢Z£yP*¥]]¶Ô¬‰òpTñÐ[„ÝÕ¾]ãõr² ËêZQDË x²Œ¡à±Š…ÚMÈ>þ’:âŽr´Ín½"9ŠV4j6ܦ™m¶±¤….“B¯zJƒI£YÙ„kL¯¾¨¢ V£­2–OMnSÝígÕíó@E¨=j±SzŸTßÀ˜G7i”΂Ú}J~¹á/[ÙSûGË—ž¨"A”IÛ\ VY8™`:ÅlZ!ðØ&º‹ mº*¾PôŠ¹b¡Ø&&*ó"s•9DÐ Hd‚9ƒDÎÈ„×vI1Í «^Ê\m¸ ›‚^ÏÍÒ«j|±ÕchØnžlPjvmó£/¶õ•Øv4T¢­Så&C…šÖiCw&¨B… @…%)@‚ ˜¨6 ï`KˆªÂûí.Ým-.áÚ àMÀ À?×7'-÷:]àF!3°áìÃ8<Íþ#ÇPל×F§&ÁͱjÔläÚòEøé:jXv‰zÛ>À-¾MZuÈ-â7'”í*6ûÌ2(b…Ä!Lh\°¸.jÓÿÕò'Õ*¨®ý1Œ‹ªÐ”ÒPV¸aÔP4]B^\ kîRuØ&·mÅ)NN!eÌýôÆs½bÂ!‹Ø¬Å ‹ž*‘,@ •ÊYd»ˆž/ZSa"),•:«Ög¾®Y£âîc*R°©G m… lãÐèe`ì/H¡?ïÆ\­×~˜Y{š8™`:ÁtŠéè.".M¸8á"Á1ÁLêýÊŠ…b®˜ÌÛæ4âkB13ËE¹ æêyëJ脘L*#D$!Ž‹"ÌR-tHu,´Tšn¼ÞïÒÞ²Ix{¶s>p?#,Õ×hå‚”ª‚BPJ­u)BŠ€…Å–~!UjîLP ‰–-hɵÃÜlžiå,ˆ-KQi›Mfø ðiàS ·=Ä×y8ñ8p|Œ`ðç£È4­ó€/‘Â(^-mäð#—ŠÎqÀ7¹ZÓòi<®•0 Ý¥ó,¬ƒ¶š Ó²_†\Ï!kÆÖ`ËÕ2*„E •ÁG™ÔäF¢žVC[Æj#ݳ„ñÍû´KÝà°“š,³™4]NÞQõäeªäD5“ `8œR=eåd*§8™~—ãµ!Yd„( %Y³ùäQ¡eÇøZhKìâ™2Ú$_GPuÓ*")Üù:Âà{M¯~ØÝxô/f%µ4É8ö¬ÃÛÀ‹’ ù°:è¥ëÀÆ%Û÷ ºTsDg3LŽ—$\ÚᲄK’O´Ìä¢èUçÊÅvÁVA*@Úœ%R±0Õ;Ÿ3ÐA Hg¬‰¦5ìô rA6àì)Å5 |¸8í°³.bH«I”€«nºÒUc^rùb\'½[û…Ñ[ÁÏøu IDAT(¢~¬²hŒá³û³[;òÒh©. mÞí%,Õ &VÕQPm!Þ@ (ªb“©i}QmqvUÑpí6ª MAu¾4ºº•U†yDmæ«)µÛ®T½¸¸œ<¹0«#oP5c·¼ô9¤GWÃJ«HngzÆÎE|£„|Ñä”ƶu kû“Ö⸪¥ÖÁ¦ ®‹®&€¤„®C×ÇÇ.½¬ãå‰%lJ͇Ú)ÜVœÊ*Îîý¡˜P²ªÖÙ'†3×p1 *æ™k^ÕKÙCì@ ™M6¨ƒˆâWKíÈ^uÀõ@¥£»Ú§Ç:€ðN>Àó/ú-ç…iw^H&Ñ–&Z„ɬ¦°P™ Å\QÕHÅôÒM@¢&µm­ù2±V/’ÂÈÀ4ìi-꥘;Àà$ðiàÀ§€“€›ÀÅS0÷ç6[v[ë<É¡F™QÈŠ*h à âFºhËòß’¬õ…(ðDt|éþLëÈ3Âk?õL?s‡ó9ÀL UÔE(4M 5 Ìv'l0N‰¤p˜þB”š#£T5ÃaÝ0m¾î- R!ºµP&h48\ܼp5p1 ÀàËE$ÀÐÛä\± ì ²vcct2—|»„’fW͇W.è³+—\¸ ±.™“xi#ª‹¢«£Ó—îOL?ò1­­/°¹ùû¾#RØç⟌՘†y‘Ø4vÊC~hAi#ö‘ó€wuи—@ˆ.¡ªî'/M¸b‚ËŽ%¨bGq:C¬HP1%21'z$ÁTa©u‡B e$ŠÒËsTÇ‘ÂR@@½ÿV_ƃÅuäίi×\]Œ&6OFÕ?Ø_úèyP>ñ‹~Ã.Z×@ãPêèËÃÎ}3¡¤ r(P5R+"4,´UÕ³ÍÄ¢$H£F š€\ŠHU¢ˆ2Q‹jRÍ!ö*Z¨ôYUT“æÌ¡à/̽Qg„©åðª=ÙæÀ`ØršÖ Uª=©@Oö¾âR;yߪ7”5Ÿ³b'|âì Ÿ'Œ’H—çðÄí.à_›k­VÜ›ke·}ê~0îÈMÛ)çÚ®,ƒ12,Dä…©šž$³›šûFeNjQV#‰(`-,Y9e.`3؃•yOtçL‹{ÕšBùßÂ<°ÌŽ!]\ lsÇ¿Ó€'‹^œp¼´=¾°a›«&Õç²Îi¬éb!áSC!Wˆ`N#r16¨ýבÂÜVܵÍJÊhLœ!u´ I2EëÌd¢¥¨$ÙŠŠ”’E©ª¥”"Lö¬š«@š“¢+’©KVéU‹Œ^±°GÁ‚X̉¹`§`FlNÏ`öqÕ)PTo"/,TO‘§TmCÄ“Ô3è}(±Ï>ãL[b»Û¥œT©“: `AÍ#M>+©„¯Š¶´fžÃ}»¡##„°Æ_ (6RZÓmZÓ€…6MJŒ¸(ÉdJ)Ù–ðË6±¶ªÁßD±˜C;Õ 9¦æ™Tw€rÌmØwæ˜Î±=ÇtŽéé’nìm‘/UðLÆf^±]t«ðtáVÁéŒmÅVÁVÁ¼`§`¡ºÐ܇I×J˜KC¬uþ*¡¤&°GqYÕ ´3¾(H)ŒwÅa‘úè´°²½{;÷Õ^Âÿçä×øýúÊ;»`! µvÞ:hé@%U‹’@6IUÉÈÌd*‹F ç!tá-;ÀÄ‘oÛmmÇ·gÀ0.º 4•~ ®p „—n8þZAaœ´tZm ?:õðRÆùI˜)A ¿d-².µïϺ„_y 1ÜÍmß÷éà…Wü(,±ßÖXÚ —¨b‹èPªÂª|E›« ªE‹¡B‹ee•ÒY°£¨B3K§9+ûR:)í3ŠyÁ”˜+&Š¹bG1-ضéf2Àõœ-€Sä§TO± ·€-`›,6Yfˆ§[ß*!ªÂRTMˆ”LPWý˜;#é¤jb(2¨E©¤¢¨öö?ìÑCŠrÞK’ƒ§•ËbNL ÝZ+@/8q&—§|Þí–šÒÚ·1(¢Ú +à4"8J|BÃ#U³ÅÝ` + EÓë®q[PK‘@Ø_öçÓ¬yi´ ¦kØ$Њˤ &€Ô^©ÐôU¤g/Ó±ÐJ[µba½bF-NÅf•Q¨–R”,e¸²…,È…,´g.²H©¥ô]˜c¯ýî,X(æ‚íÂéèNšlEY<Ѧ„XãqƒQ‡ˆ¯é3¾SÚÐÝìQ÷êkÐø­¶¥”Wõí]Ýg;úÒ(ŒòxŠ-º_<}¦Uú±5¶Õ‡—¶©aMm¥tm1{—TÕºT 9³ãç8“ Iµ.Ò«šÈ `Òê„<åEÌÀ´” ›—ÙÉ"›=6¼\ÇÔï ›_M{ÕÅòDÛ-ÛÅ *ö·‚X» ü áѱGA­Ç¬çuî*:-Ð]Ò(‡Þc ˜™'²¦Á§PT-#F Š…ª@Y A@ié3 L™=ˆˆ¢¥ ¤›Jú~RÀùvÆŒ¥U?e¦Û–]ÚÜÄl³âŒ0;¬Å,&(D¬ÜЀ‚niæµaxA¨ùУ۬se­Í ŠŠkS\Ú[? ¶_tô§XSÕºÀ®™Z0½j!‹¢P‹²©&Ë,i¤ å¤HíɪZC†  Z „ê©‚…°…y“jWJ¡ "}vDÊpËj dEŸ0WìøbLæ­¢JÒdÏ>蟹±@GÁˆRŒz$¾Njªg4¹âó±­ÚÕ²Á„TYÛÒ¾æXÛ>ò@hÖ`—ÝRD` Ø4{Å;pvHø"ziÌ ãcÃþA,Ná ašXÚoc§ŽØ U`•7mÒ#ûôÔÓ5qf¾ÀÎÓ3˜Í´ë4%¯ÄêlÑÁ¶*aiÉŸX5+û‰To-¨Ù¤ÎöÀåжfPhyÕ]ù¨Á6í®Î\½™íðÉ2•zŸ÷Õ DQ ¬E€Æ í>ZÝgûÖeu¬ö‰-Ø»‹6é“òdßé<¬›ÝTD\iï6Ý"{âÌÜ+&6€™ ;†îØ sY++%‰¾jõî´íVU¹eý%ô/Ýñt²™¾¡Q̈²þ]CÇö¬áîÓ`ŽüÌ2¹RÁ pR«ÖBZ˳ÌÐ&Û†´Tm¼Ð°°B-¬ rPÔšuŽÐˆ ’ÚFµÕ5zY^ý5ÛÛb7@6²¢ÌæZWŸ˜Sˆc<7ñ³èðܾj­]Ácâ·;ðÊ ‹ÿ¥öJh»µÁxü_¨ãîÒ[Ñ®êzsma˜½Úy‘5ÚZM”TXú¨ª­-n'î2©Û Ãjç…Ä@ÛvE]y©ª™u™+la‡ª&*—hRutWó'Nc¾àÎ6¶f˜Í0 ëÐ¥¢k­N“†!X³ƒ"ÛPS(G¾¤H¨Õô ¥þ#E ¶¯ò“.¹«æŠ±¨ŽÍÙ'£ÙO;÷îê@Xì8ø‘¾(!¬XSë-–T¦— $ -ö+«ßè™î– Ø;(Ú—ôþµTÅÉy7Ã@¹¶Á³ù͉;ã<ÐY(ˆX"sK³8>Rü‘&^rãµÕM.‘wÛ~ïlÇ4Ÿ”×=Úù Öû²Fmò´äÉ2Õ ö4\é £JUå´ˆ´µ¸GKé4ÿg·W¥:B×_{ý Ö?;b‡„,}ª¢èŽ/Ì; ËóîaWzv»rås¨|'’WÖ'V¶Vcb#RçšaÉ_ ™8Š!=UÃÎaÌgþÚ¨‰MG·ì‡£„†íT Äeu’…Pêháªìü óØò"â2|>wE‡É´í =¹G¾}/uÕÊò[ÚûöŽ›s¶é„Ó &$[›—ËúdÓ?c±ÄjkÊg£}$©+þ3¡¯"”PÂÂÆ5ÃN¹šL-i®(ú°v"ìܳm}Fø¯oú&ÿéâ_1œÀ‡¬)!eÒ¢%5R\×ú²õäØ$Ëõ[ÕÞT!Tñ_X¿ZqfÑ•6« ê?Iƒ™EÈ&Ýq.x&DtNàVSTt8³5MÆÏiüÜf‡Q@² ™›@‡>µ•|y._ ªýf;‘Þ%Õ2FÁ¥“}ùþFîGŸû™gxöe?R!Þ&謩‘5Ô±LêI…O•*••RaÔO!,Å-2ŒÅ©ÂŠˆ´Dæ±tC_ÚÂ&ÐÝ‘œ±Pôâu„ ;ŠY©‹Ú¶B}jx¸GŠõ^ªþ7×?áœUP«Šh{W9 è3 °(˜ë¨£Wôð/Æ#s ¦Å!Ó¿ÙºßlÏ4kó£.žùÄC»ú€¹+u-Úf!°zfK2)PÏ*Õ_ª¿ÓÊ-¤m“¬“=„x‘}Ê>Z€S˜—ºÊXe‹Èdv´„÷m๩º±àÆBgD—Ø%HBç³>Œ´J¿ÝFV&x:¦A.è Jr+(H ¹G.˜/0_ ÏÈ}FÎè3r?Ì°h勃R¼ä®þpŸY£ºÇ·D;0¾èâ—¡öB¢ÎìdZ(”@ s[¼—¬iì6u™Š–Œ7@0AAö $¨Ê°.P•šrÁö…Ùs\ÐÙJ­J(yÜY©ƒ\‹|yür¿Ao­…yÏmûK@ßPTÀH¤* Tœê˜vud]=KNQ‰žIl"…6%!´yWT)Z…WÛ€R“I„Ozf@h“ÑH™§­É2L¨3"Û,Ó…˜¦ NJ!3!¤R•R‡ÒÔ"*IÒB5Õ|S€ªIÓ\UT“¨$M6›”IÊ“’æ’º”Üî9#&¥açXØ9c«HºKäˆ ò‰ÃaZb„m§ïi¯‚§É¡öúR7â[±ŠÑ´Ó^µD:8ÌK¾÷m;òŒp#¤O,mhT.XçkÀÌÍœPWˆ‹ÔÓà°­Ääk-ì´c¬ÊΖÝUÝñ…™:ÒœB§ÚíàLÅ\uáÑ›m`8l«ž!7ÇÖ˜XI¾¹ÕDJðL²Î]5fÑXe&B[õ)ùòO&–2$ˆÚÁ°°ÏX̱SÔ†ñ;ªmo/cbˆXý–ƒe£{¶ó¨|@ ð5Aêb©åöY‹*]È…‚BØŒ2Z¨„fÕê¢Dµg²I!PÓBèP’¯h(ÐŽeªyªÝÉíIéYo‚=f¾Ñf™™:ØP0bá{‹%P¬¼+cM+ˆ¸äLJ`{MmÈ7ë¥Í¦V§Tý Ê>¨É2¥QÖÙ+l ´1vQd[· TTù¥28Ev᥅䞲`×s-v^JÕNq,l#94àŸmWi´½Œ”€Gþ"æ5DÌs­Ú©íÌN³V,¢ÅNSŠŠ_'mÏväc„CùàqAÔ©Ž- fßòHYêzº$I§†5éIr[•—´SÄÂIÀ(`çF°©Ö:ÕŽìT'gNa{Å&Z3 Üöé< NU§d½WÉÉJÚÉ¥:²öûêO¿[k‹¦‚Ô£#’Ž…Kó®YŽLŸÑg5Ìë}N¸¹c¡ayu].óƨ”öûK–9ÄÌ27³æKØûè•Z’Ÿ¾ø—Q‘¨i ±h|¨„—u»h* B2D!Y%C2¤hê!=R¯©GêUæè*;Ú-¶µÛF·­iK»-íÎhwF»-&r¼Ùü⌡Ӏ‚ÓhV¾ï.4~Ù·—Rf"vZ‹zf“=#\ŒùbƒÉ~ Ÿ=ð’å±Ë}$‰§Ü°~†{~ó-ÕVíêé—ü{ Ò$Ú‚3-Œ›¬?³*¥Í#tĤ¾Å ‘À)1!'DN©"…ì)™,’dé)ö¼é)½H/²ÔS)Í)}Js‘^Ò\¤gvRz‘…¤§dIevÌEl‰0²î­àN9$à8¹´VB"h˜g¸8_AÇ’ÄwÖéüüÁ,äpäÿyñc|Á,ÙÀ:§£ ¼ðî-+p؉ÕeXÿïȉÃáìDÉLfÇ¿,² +˜-DzIÂQ)-$9ॹØ1v@êÅ´~!3ž_®’a¤mF„#œzt°½WJ—2Q›]Å"ý˜8ºŠ=З8Í›fª¦R’‰ÀÎ SÑ•¯øØîvÕëôpw¼{ñüÜØÕ±û¼p¨kC‘A|ÙJÊh#‡ÃØo‹Ë«¨AC¯º ôÀ¶á¢³©mßØRmÏ;ÀÖ!pæˆ8!g¾NG6^8qÌk —ÆèØùÎ¥¼…ÎQppWÆ íºhE[Né†4ÆÈW϶m7°zßÙ‡ƒ3ðîRv·«Ç¥t¸;þÚœgW‡™b µ6½ mÑG­Du¹ÇÊ’éL±(I[þ´®ŸœH› ‹Ô¤(™* hJ,=$¡ôH¢¥c™£tÈ=RB7cžj7Ó2Õ¼É~S»cÿwïlÛ–}ߘkïsÎ}é¾Q’Ø›+‰š˜ Д¡T‚ Bç] …‰–˜¢ªMwìî4PòC"â²”T‚)Ä‚Š"ŒV+Øje"I#þ~ïž³÷Zs ÿcÌ5×Zûœ³Ï¹÷ݾ—Y÷í·öÚkï³öZsÏo~ßøƘNÃõQpÁ°!_œâ‚sŸÚü“îq……=Îm7V‡µXÎܱľ‹­8ßÔýÊVºhú·Jaö^m„ÇÌ#Ï…¬*¬¤^êРîO0¢äc% ¨f^·Aé¿IŒÄž˜ˆb‡añe1©Õ¤P*MT‹H1™Ì&å87˜îDG‘ÑdÒ:q,£È$u¤T¸ùúX IDAT6F˜Z…•R© ’Õ‡(öj§t¹ÚY:]´==YbMó ¶ìˆšF×K+IåjvŽ‚¶AA· #T}ÄâíeõHº;Æ[¿ø^ˆ¾RŽ‡—[”,ÅRªA‹i…‰ÿêH¾úÐ ääÁ?2¢€À‘€Ñl Çék1³ ò XÌ.GFܼ…zav‘¢è%0˜]’M5R³] <æh´Ær(œvN}½Ä6zeíPlºUíâ|=ì¯8ß í^öVšó‡«×À5šf™nOÊfu‰ˆLόؼ*¨šd³ž¤© ½¾µZH¥ÓB©Ðbµ²Œ¦…:¡ìP/0í9ŒV.P¯0=ãð†•kžÝ ÏnŠí¯!ß¾ëCö©ý²5ïLÿo‹v'w®·Œ°%{L8œ:ƒhŠõ®üA÷¶×Æ5 ÅÌÞQl"°âµ‹’_ùÂß“¡ÀJ.'ˆ*·ƒab¬Y²v†±Sî9+׫˜ç¶f“ê$R)£édePNRw.–JðÂQuÖTG}£ºî*¬,“Ð!0p1¶óœ/Ê’/nŸ® ³ýŒ°êW]ýîy1á?[Ôû¶ŠX|ÑŠglN-†3€°>’zIÍ—ÑÂÕ 0mñ†ŸO!„J¤k¹³” 1˜r"TR,-@M¨+À ¹$ïN™±ƒÃX‹ÉìH2ðw4;O2ÙùÆì 8^c¼ÆMîÍöÀ¹3kÓø]?¾œEi’V"\#‚J«Km0™¡Ä-#lÖ”¢ðÂá`Ö2Â".¤‰œ:ͽíeuŽ¹=:}Â34h)ÈÀDD·ÏD·‹ÌÀ9¡‚F[eYˆjRè 5—J µB&”e‡2¢ì!G–½Õ#Ê%§ƒ O0¬\ÛðĆ£É³qx6£/Ð2è÷Ý„ª!bIP\ͬ¶ˆXnÙ¿ ¶œ/°ÄÂ>¢v$oKþꩧÚaç½í•g„­@˜;eZAEA€¢û%Ýï V˜ÿt«³,_“(`5kq2GAÃŽðÕ-÷Ä@Œd!÷º8ˆT“œTªH¡ fu0™T«È¤2ŠNä^ÊÄ$‚!f ‘âÐX)§š¼PS,Õdiì0’TÒ˜ÚÖÚÓDÑ•ÑfÛ¯ÐaK Sg+UX…Ë¡€˜uƒè¬ˆ²I£÷Þ5ÕÝ î/¼IFp¬[‰ÐIa£‰Ú?:ÛviTrÁx;&;ŒeLÿ¦dM®\úS_y×—šðí£ÙÙ²ÆÌ<OI»Ý˜*Æk®1«ÃÒí¾rû :Ý(5ÏíÉ¡ƒÌ’¸Ø‘XMÝã:mƪf{i:ç”ø7u°·z©z#| *Ë,ÇÝø9fÿr† §Ænë9¢%´4ÎX8KiÑQñŽb5jÆ¥² ¨Ê2™L(#ÊåÓÄá`åŠãц‹£à ”žY9ŽòÖq¨"‹îÓ¤ÑýK*}o’<@6=®Ø!nWG±žäéûðÄ*}âo 춹¨¾b%'¨¬9²•L·¯•¨ìÀXi(`‰ùÞ&Ã@Lð,¸Pu°K °«Ã^‘u4Èj¥&.Vå$²S©"£ªï!ÆŒ"²ŠTJÕ/lˆÈ .v*©œ¼Ò·¶ÈçÂ2Ú€KFˆ‘ÙŽˆM&­†X”gI­¤G´hÀ!W¿ÍÒèËj­4g¯ŽJ–Q KPŒ•ŠbÁ’@ÄVpÌš^:X©á®ÑÏ4ÑøÓ]†Æwf’ZèŠ8öL±ÅÚÑü2yñš:ŠŽj?-Ï=+‚ØÃ^ `/¼·½|iô‘®Ñ?øôÌûsé7:û [á¾ô΃tÞ°Å…˜¥­R­(D!¤Z™Pªƒ¢•2bMF+ £•”£•Žkçˆ6PFÊZk_… wù[é¥ýtk+–å̪1“¤°¯>¤ªMÝãIüë÷üðýÞN’øªÇΰ~ð%™e|ãkßø­±'Í2X;hÚ¢9NüŸûÙ;ïŒt‚B `9ÃDºc˜K÷®d‘C¸iœ«M‰gÓì¬Y¸LsOÉÊóøܹä…+üëR”PŠ*¢I1›eúŒÃ[ûUWàÛMÔk:5ðc¨ *€'K4Q4öæÿÑøÔ;ûÕ§~õç?ãþøËìWO~áO9½j×’G["_™hZùN_³"<¥'jV+l¡çôÔh>k™ÎmûÆæô„æ¯i–”cÜl(#pX?±/]qHsiÛ^ÌísOYúkx')œ©¡ã|?uÄÚ&}0'øD^ü»ûÕn—º8¯ýïf/É,óÝOípÝ0+ýÔü™6ÓCþd“:F‘ífŸ‰+_ÿ8'W( QbÁXY ¬(ƒIeQ°:Ad©V&Œ#ÊÄ2BŽ6ŒVFÊÁ†#ʇÆ+G+×Çáp”#Ävœ¡n¿Ô†¥pºÒVé#”%n›æ°U—pØ °‡Æ- ¶¾ÔPÝ×o^0#ÔŸþá~ïÿŽ?õ£‡ÏúÒßô¾ÿ÷ýÚw?:Ví×¾ñ[±œ-JgM†_Nm‰Y˜Ì?]2÷`æº(:jXIÎ…n1°ÜÑŠ§U{ØŽÜÓãŽeW‡"ª•¬êÖP¶Ô þ7MRVtpj˜7oK•ÐB{DL:Ø˧Rµš#"© ÒBlÃÕê¾·u a(ºâp4—=½¸‰C § BL LÔ<›žf姿æ癕¿ýOþ/÷ôƒÌ_|¿zò÷ÿõÍÑõÓ4®g+b-eÖNS´¶½@DzEê:ÀÔÔad\¸@˜qS#}ûI—M|“0%"“IÏâsPœ‡ÆF °!™b?t­¶{vØP0”Åì½o¶®j"¢¶œ’DÄu'!Ð÷|0÷î{áŒðþ~õà~lj›{5¬³ÿ•($ F8›NÃqê î.S7ãP¨J`$ÅÀbÅÍDTzb™àˆ(Ê„2QŽ6Œ,£ÉÈr°a„¬¬QžÙ0šÜŒåzŽ®}¤»ÍÓžî–X¸b„%'=®Û̵ÚöˆÓ¸¸RS[¼·½ØR oþðûÝï~ûÇÞü†Ïþ¿ó—Í{þЗþWÿò<_´¨n¦qÑ«’VQ@o%qÑ+%.z¦´ß aŸq·¦¾Ä"ëÝeRíÈBÛƒŽ‘…¶'w°½qÇa§C¡u`V)“鞬ÚÜ1576X˜ÙŠІ©ÍV¼pŽÛª€R”ê@h¤ð˜"z«q“#ÅàÞÛ¬Úd!x2í0ž3.+t„ñÜáãÍ2§ÚÛЯÖ)âX¸ûæ§f!“Yü#Wj7ƒ”)l4±_ÉrSªB÷¦ €Júï¹I¦Ó}ÛwºqfNÀH7Íä äܤÜ:§0L˜&o0ê¢hË5 €$]&5Ò¶J00´9%Ùîm<Ç+Nèr?&(.˜¢™b)f%LÞÛ^p‰µ3úÕ ÂeIÇ1³›4ñÒôÅvèê\å¤åŠ4Š†R*fÕb˜Ç»‡•R­L”ÉJe!Sô|üÑÊÁʈ’ˆ(76¬MžÝ ”J`Ç W¶š­q¦ýkˆ¸ål½FZ7pX»¾V—¸…Ã{Û b=ûø÷þÀþëþØ{~þ;|Åoþ¶/ÿîßö'⛾ù ž‹´åN¼4ûh8÷* ¦ù¡A i¾ L&Z 2‚yÁR—Lžk\4œVÀaøÛ1¥–€¸'w:ì±Ä–a¿5òÉRG¥Ôȯð›4¶uÂpØ©d ¤yqhP D¦îº9òÁ¾¸’E%Ì9I"±†@žYYæÅšeÞŽ~µX¾/öäÆ<Úvbi/ŸöžÒ"¡ Î;;DTíòñÍ×+¢*t€ªšVØ”AÄjóvs“lÿµEIûêf#Ù'²O†ñˆñˆ˜`—QÃUAÉ!½3ó •öÑYnX6[zWòž)Ný(Õñ—>\Õ¯ÜÉ4tY4n†ù8d$Ú7ùÔ¡‘ ×Zضr> ¶X¶EÍ6¯Ü¦,!¥²TóPb P¤TÌÂé‘Ãd21*Ô­xÁ"­\[9¢\Ûp8–ÃQ&½pº2Ô K8\Å {,ÄÆ2Ó]ÍÅc¿ÑCàÝ/Û,cÏþÚÇÿ滾ñó/€o|Á?øYÿç÷ã7ø‚Ïxž=Ñ«NLæ±¹9’ѤQ3ïU#b5;a&™wOd©FZ­D†² „…ÜçöžÈbϲcكⱽ2ºàéöÑÆù\;%O$Ú§ŽºTGý%VÌ9ˆÖ § _=5 “ÌæÊ ÚÌ2  ¦@êèØ¢4u>à¾öB¥Ñ·¥_`„'[ó‘ƹä%mÐØgúÚïïÆu&²æ*òµšÖTMkšK#Ž˜¨6ã\Š¥p ½ÆõŠ’Y655œ›¾t0•N8uutèœ2C—AÑ›efM/[sÍ ƒ´yBnÖƒbÈXK°Ô3]£gݳ3ÛYýêÁýø_ùäûüާ߹øSÛ?¾ü¾\(¥ì`²ô"jÈXÅ Š¨s‘6O¨Ïmƒ)RQ*DQ*Š‚eD¹D™( G–£•‰å`ÃÑäÀáhå& 1,67Çr},•²Ú{t”Ëo³¶ ×e}Ïêÿ­l5=þoçE•Ï»÷õð©\|ÆEбËw>ïjÿÉõ·ø'®¾íîÃæ^åðÖ=駱Žek…Ù`n 0ZúNr½[Â$ ¶ ¹sð€"mp¦H°]:kvä@Û/8ìëPÄ„ÊðŽVr©¬S_ÅMƒ5Ž5ÔP—ÄjR©ÕXIC†áùÉ ƒëStêh^Ž¦þ5D 4p®Å\p±ƒ@ùœ?ý±sîšÖsáßñ?rýêÙÿYž|Ùÿ{ÏqR€ÞG#óSËXgåϹ r#‹½û´+Ø­TuÊhU¡5 %GRÓDÚÈâMj¤GrLô¦cc'œ¶ÙŒS1UŒŒ1]OátȨm *é8»{¸š±¿6&Y§”ö#Öt )N¶z…o?öžvV¿z0þž§ß@—Jo?›ß²Cœ'­\’©?ÕTMW¸H¶õiÆŽ/",6³ËÔM Qu‚ÈRM*ÊÄ2Y<Ž,c>ºÑô€r´á`rÀàÚéµ GÈa,×cQYÄŠw ¤-~u›FÚ‡ ûÀ¡mqûïÝ~üÅ™e>wÙW?±ýd¹xçoˆy÷2s€LtŒUsŠ+†ô8¢¦‰VØ-’©G\²„)÷Ä^¹g¹dˆp™œ¤î[¢½È¤²[’¦”Ö%Gœ}¤šiæãœ"§‚‘¢´d’Ò¥Rš‹ç%LüókʤŽˆÿ×W™ßõŸý·wß5;›þÔ/ûŠþé»þó¿°9äméWOþáŸ>±·§‰½wæDü¢{Õ –t{׉LÄÆ—¸¸*dZµ!"jà­É¤O’;´ÿwèv–‡ÅþerÆŠ±b<¢êé½’%¹|FÏÙÞ€ö£ë§èÖáŸn&ó5~ËmL¼w<º¼ï€ÛÚ[›=gõ«ç‘FOOÖÎÃüù<ºð!6Ä‚&Îé1] t\B##|ØDÔ@D–j¢(‡j2rèØ¡[LËÁ†‘rcÈ`Šžx°°›Žåú(QO¹'…»¥Fºb„w ¤yeç [v1Ýì\ñÅ{Û‹ÝùÆÏù’Ÿõ7>ö‡¯ûœKàÙ}ìÿþœ¯üÙÏù¡5gÞÏC|˜³dî`3w• ˆî¬q€Œq.PžÂjêIQ¼r…ä¥pO^jÙ±\x(±´Ò3®‹Fµ‘ª:çf¤}fÒ%"‚¶ÖH{i”¾85zjx¢Eý¦ÂÜ`šhÖAÄ“·÷Ô¹½PiôméW3æµå…n;àŽ¶]Hv„èBÙ /D¢cŸ}áXèÔ°:(N± ü:XxHvضI[nþ¸ÌP—¬±%o¨a1˜€:ÓÁŽ¢—IO]7ÍZ]úš³´U‰§½\v/>ú¾oð¬~õH³ŒÝ>ë‡29ñ{“žV¦|J‰°¢OfÕØ EÂS#¥ùkHs^h¢,e‡X¤¢\ Œª/páŠr´áŠÃÑÊžž?ÝX9¢XV,G+×µj²náŠöŒp5Îô—ó¶À¡mpñüá ݯ¾èë¥~͇¿ÿ›¾çë>ûãð;~èsßó;ÿîç5MÔ@Á[íb[[éíä(.>ëÊ¿PBv«eIã–›KI^ÍAÈBóŒÃÙYJîÉKÚNy!¼ /È Å¥ û:ìDE&õ Ý&•2h:kL&F¶~ÒD­”#‘æJ)©P•™v®¤:ÚaˆÖfÁ³”hšKᄹ)¥kµõ–›òB]£oG¿ œkCù‰1ýŒà‚ôJ]§—Æ[.¼IPܧFÚì37‰t2›ºíEA¸UN`hïóÔûž~Õ ¤³ßI£_HÕ¿z÷%!í}d{DŒp†¢&rÚ xµ{u½³g‡§^ÕÍKš˜ª·súÞâæ ’—.<pYxUp!6†€C ‡ÁÊÄa²a`¬Ž,G«{–£ ;ʈa‡:An0Œ(êÎeD1M(#8¢LÆjœªÔÊ *¸€Ct¢ÂjKò²b‡+\¼¯½C$ü^ˆàxFëÏ:ïl{N€Ö|IºIàïÕn Öfäyx—þüôžQŸzÙî}G/ð¯Ú£ðŠ¼.‰K³Ká•ñŠ<ääB÷ƒÓe2(“Ø@­”ɬ’•ZEÔ4ÐV‰»rŽ*úm€Qß~îKßË’-.‡éŠ˜™âÝí—X{[O0?Á¼Ñ˜árèf^ öã9»WÛ¯µùRóf˜ÌUᲹʲëyÉnƒ° iÇw6^à0a±;†ÓsZ}™m‹a.Yߟ†Yø‚Ï ·xK7mˆìèö6¿¸P)|g¯I,gZ ™Àƒ˜ˆ£àye¼$Ÿ(¯…WʃðÚøy GÃHGÃQ0.…V.XŠce)¦•2Ñ„ª/Tj%«i[›¢Fú„ÛGi+ËLšHïÂÏz_Î&¼V+ÏQ˜^ƒõÉø×xg„ãj£“mº*ç@x½)$ßÈ2¿=¶K F³ X‡Ç +Pav„Ðô@»Þéa‡ÃÆÇÆÆÃãÇ‚a`9blÚåš^RÔIá.Í5{ÄâÀ«’ßÓIRØ„ɨs„÷šôVŒ°í9ÓôBÍ2g´GçΨ¶Ä¿&xöf9R͈ÕíD|ùo {¹Àš?µe!‡þàÅ푈JÁP0†û‚ë‚ýW‡ŠCÁ•â8à0ð«‚:QÅT¨‚*¨JéP0L¨Õ„C_ѹàe‚Qšà5Y #Y-"?Š*¨F5¨©SM·àaÞ'CÌ2 À ØÍ}cÖåc¥Ñ—Öj'‚70[±_[NM-fUˆù4v"Þ5ãÁRÌGCÉSO­ÛŸÈÛm&¹z(º(¤ÚðÌÊò†ñ’¼^£ñ‰q"¾-£p4N£¥•ÆÊžELL”V¨C `òÂ9R¨•ô*)v2)€ÎMÚ¾T—\±nN}{ Š÷´óê?mÍ%вĿ QëÑk~ÚøŸ,ö·³{œ÷pFÇÛ«:öoœ›£`¡¡×Ð#ôúVÑë‚›ãÇ”¥  Žc1e É àÆl ÷À`æEÚv-RèˆèÞ™¬ñ6™í“®J§aiR×ùŒO·þ‹É©w5ò•Â~òßèŸþ¶§¿ )o®ð¯Û¿À³-í»ù,qTsgËÄ1øTýKÖç2&#,Â2`W°°°WŒ.wLŠãoTŒ®>éVŠ¡Ó‰¥@%ÙáƒX­,³BPè:Av¨Õd¤Lðô§Á +ˆÜ0 BÑ›/ ãCo‹ñs^`Ó.üúžÙ®ø`‰ó¿ÿ·¾åyÚÇÆEѾ¿¯|+fhZà’2ºæ™ ˆ'ißÌVÀjíMk¡bî¢K:º•Ü@©3ÄpÀ0ªg£rÏ;o#1Gb&b®ˆ=mGÏǯ»½)M¢è „&¤P„¦d )”¦¤Z.^HiF%`ÔH–¤Å!ЯKGóKÄKѳ¾ð/þÑݵóK¬µöEùß|è[ž§=û3 òƯ4 ‹JŠœÛ§I1è¹ K¾k³Á2c¤oÏo/ùi”¹_YåÌo è3è5tz»ô­‚RP ŽGA)‚a‡rló IDATàXlô⸣Ųc³<CŠ¥^Ž»i¤SóŽ’ý*„„Ž§Øü±kЩ[9Ó{ ì­Úƒc„Óô½}Kßìýö§ÿ"’Ša +ýsEò)5Ò6þØ‹ÂÂG—X{t{žk§eÏnÏý¸|Õz¼[m€gQªo ÕÔ`5­õBÙcP¨ù(Àœýrø1¨Ã!BpÓÂKb—iƒƒš@Éf•*b:Qq'È tD€â„RM•‡ªm­РÚ|¤žeàžÂøyÊg´‹WÞ5ºÕB›F{°:OÂáðn“@W°×o˜× rÖ˜s¬Bì;@[‘6ÄÞ¸¶JtÕÒ¨ ù”T¡j èH(1yØ{á¾–""°R¥ÒŠ°VsïLñl¤ti…f®&@ûZ3Í/ÓïÛ…3å¥×À5zJ ]l7š¸r²¬žn6Xf]´Aà-(øÁ7pg,ð½¸Otthìˆú&u° Lç]3˜Pm?Í‘(’$F±êk¨ŒžCNÈ¥éÝ8êŒ!Ÿª—žq)¾[X¢É¤ÆˆäX7 ½¨t«WÞ,ƒ3´Ðû”Ïžù-X ™Rç],Pm P5­ðSS…U„*l+ð’4’È24áªnÝ@€°ú½VÒª™—g&fÂ"0Zú:§Ri4 žYQ JN(ƒ©R<›P-ÖPˆk¡ *Å£—odÓ6OïnÄ™*€ýÃÍ2/¿ùœå-t ŒÉÊmÌoµ½Bï`³:š=¹fï KÍP`‡y$ ! ¶Lˆ1ð™íRÍ4L&È*ØP{ÅÎÒ„ö ª)±v:*AÀTœ#ŠE­5A8eB#Eä  Â `–cÝôÜ68¿g½Òè–ê-µÐu¨/~í]=í Á3‹ 7\3BGÁÁS/å »`Ü;p,Ü›ìÉ=ô-óH­™™R¦0…¤Ò%I8ÌhÏv>®ÍÕp¼…jzd k뎀%WašÈ1Wê!×DZ ÍGÚOV» ÖJOç»qö}{åð·òßðÁ§ïE‡‚'‰ 2˜‡€·;R¸Ø3ìX )j¢c  K£=lì°f±wíU¡VTL˜¡‘‚S83uh‰‹—Bƒ I«0ˆÒp‘T±R¨‚RM Ë¡I¡VÈ)¦•E¡¬&JuTób!®Žª ¤>ªú¬ÞºÔhßßߎ¿8¾ëœ»öê3¿R? àçÈС`-ØÇO’ÂU,pC{µsì0O;h DlLTƒŠóE…&½@¼aøÌŸ8J¨4V$³.(ŒP†jZÉ‘^È {rgƒÐbÅO®‡Pj_eÆh„ZpD`6Î` \#a\ÆlË1ê‹þÒ¿uÎ]³‡»F_r{óÀ;þYë³úÐÁ•ÿ¥Á†ˆ+/LïpI#èL‡™ŠCàû3ÈÇbÜ'GL”¸7z[EÈ=ä‚v4» Œ´j¨´\åÖjº †ýBñ¡k$Ì|ƒ&š bÙAÜ\ê¸Xœ&6±²*w]-2ß™H°LèíuÑ“(Óôs×^ƒÊ2ßöô7l˜ß¬mö1?$Fbiû´ùé,u"Ë°ßNÍ ºÈµª­ctU¸šþ ¦¦ÊªV*kAU›*)(­Tw3v¸ÈJ "ÕŒÒJH«(4+” Z¬L” “Q²B'“Q"Öä…–aB§†•Ä¬Ž6*G]tª·~éîþüø¹wßµÝ+o–ù¹òÆ­ó…vÁ{‰à<9í´PœARÖìà u´µû‘{'aþuOZ¨„34ú6o¬ Q¤`ÎÙ €ÀÕQÔÌ„jPÁ¸ìü œ€Ádo¤;¹ö¬ÄšM˺k%¹sƒó$ý–, •W1áðã_ü/øù»ï¾k¯>#|ǯ¶Órh¢šÎ‰åÓ>(Úé¢-,ævPß#ûîÕŒ80ÔÑ}Ê¡”;ܤiÕÜÒäØ){Ø2Ò.LFº­T|¦?ù¨JÓ]*ÚþQ>m&Ü ’“X•\šÞáÐW„(fáͧšQ;¿L[p×Ó™¼ñÎdöᢠÃט¦ï¹ï¾½òŒ°WD;œ©áOðÂMDÐ9‚}¼ÐQ°ÛßR‹G³mB½otšg(lÍz*¨DLÄQ ŠcR³~wãˆ.AÄb¦põ4.à@£UJµ@i„8MœPÔX`…:AÔLÁ†Q>hYÖõ£A’°phbi¬—ˆþ »vñê›eü1ãW‘ƒ?=›Ps& öÁíÓ¶³'—sã,-²#SÚѵÓè, A&ȱ˜àËãÒ #â+U˜°ª)¡ *ìPp‚§:³Â*°‡£ˆSe1J[›ÂÑÕL’JBϸ2BÎÔ¼iÏôþc>Ím› !Ûk,³ºâ…³Úü/<wR:d\°€%QpXê®ÞüF©YçòôEOš¿fVp„6^‚©Ð*f; ëû­Q0ú`v$iÕs’5,€SB£6ùÊ&¡°ÕîÑÒeÚØÈóçaýê50Ëà„"º%mdÁ6~µí°t ¦þ©žØ••i„ò‰%<°=ø”ŽÜ`áì»±X²TL‰RqÌ%™Bp%¹¶kè§(4s™T[°VM&4…ˆY¥(T@±¢T·ª©ÂÝ~b™Vh`…ºÕ€f (¿ñÀ¨ôî…±ßÆÖ+¢yõ(hÝj‹|\H£¬ýa+ Øê–?ã^Cœ{Hî±ÄÂYbe(«˜°;(D­‚ø L¡w+*.„´ˆºý´{¢æ†‚ €AKDâ«ÃaäÎpŽhmòN·‹i~BBk—÷ÌvoI£OÛ*¢\ à*F¸@Áû4Á©k.È„®Ø. ½d{oþœ3¤hf¨ž¤@›EãTó98›t®9B÷ LÐ PaVfnb†…¥×ÀPJI¢Ò4°ÝÒôd¦†YlÒh¸”c¾jM#Ŧ©.ûÒƒ&M¯¼4ºÌ ìçÑè¦" ô=ÛíÆöPw*Aª×Ôâ“ÍòNü%Ç·I5UŒš*->Ÿ¦¨“ (¦ŠBTb$ 1NÉ ‰R0Â.%xZ‰AØÿ^D ƒ 41óô ¡U“‚0ÍWˆf`”2³@ƒA Õa F߶œ[µx¤ÑÞ³TD½-6:.xb»aÛÖ(¸ú­n¢ŒÁ'û!y|S „ë{ayM\­€tD … qãà˜‘æÀ¨3ºP¬à>6P=ܺ`9“J…Ì”naQAÍH$ a$Zêg·k}ÀÁŸž&ó㬈nK¦mQP(8BCÁÅ¿% ¶ZZ¡ëå¥;Äu·6!ñK_ òÚ—ØÑ|:3éœÀ#è;°Â¦S4 R ˆ¶ƒ0‚`† 1©¡î£¡YA¬ÊäáÃ9"­CDE)\H8"…¯¼4úŸüßúôku ~KÛKbU¾´Ù^âÜŠh7ñU¦üJ]åŸK°Â`n‚)lÍÃ’:mu Dãߨ¸±Q&´€ÂÁlR˜Dyu£Ï#K`0M`j$ŠQ«ÓA°$#4÷”jg˜ü8Ö0hše1w.ð'?÷œ»6<Ü,ó¡7ùCßò<íÇí#>—ïwD´™ß÷Än…‚¶Ýî˜Ü­(Ø+)ìuõ£.dñDºÒE”Í?™óùTóË$FE3ÃË#…á‚WSâ‘âÓÿ€Õ¬¡`¥G©\úe¬K.À2Jæ2Q[Z’ À/ú_×9wíæR*€¯û©÷?ô-ÏÓ>õ}ðÎo0vXØhâöë­¤%[‡‚ë‰mšÄ ùJ¾ööæ:è» V»v*tŒº£«ÎÈbV8‹®û,Ò¡…Vš0ƒ÷Ëç_Šw'æ$'Zõ=“{‰ÍÄ'm¤“™O¡ P—®Ñþ_ü¬ÒD“¿>ë•ÒxÇßÎ]{D­Ñëë_õзôíÁ@ø¯=ýúÎ:G ± gÖÁäÂà×cŸ!{ö£O~]½´E¸-NÖ ®ßdÖ`X`aBòúŸ¢*jÅè¸XQˆc˸Ĩ­cs>A_7ÕÕÑ&O¬6«)*(ÌH„5& 0ö„¯a¶Ïøg.þ*€?vø{ï¾kÃÃáGÞñ§|àSÿøCßø¸öùü@u‹@«©Ýº¾aó$¹ï0«0Þ œ›ðÞIåsÕnÜ…ÉÛž„@.G¸õi°Û˜`Õ0ÅÚx‹stÌQÊå‘=sß~ÖØžŽ±KŽ-ÃÌM2!™:ý›Á/¤mb™´ôøyßàKþÊGo¹ÑÁÿÝÏù€þo|à¡o|\{ç×Z¸ß”îinÌ/å$‡Ò°BAä¤;å!:uîº&ŠúÁñá›fÖõ¸…N›³ S›£<°ìÛöÏ ¸‡U¯ˆ¼DãͶìðd† ýÔ+)fàpH²äòL®:FZD[¥ØÏ €sÊÖLlw»o0Ž¿÷¾ûö`iôêê\_õCßèíñë¶Ð ?Û"_w¤5SL›Œo‘]ä/É|›×÷‡ùŸ9ñ $)æÇÌPÝ•3#ôNÛ}‹HÜzê6…“¢ŠK¦D©bt4Èe*e+,TAçó´L…²:X…©0 "P4ð1ÐàJˆ›-\M=OÈ*¯|úļj`<¶ïµE¾àõóM[ìéÔÛ_}lÉ`ÞUÛ f- µE ·ùyþ×=Ð%ŽÆBLæI[Q9|5‘]“±á½‡€BKM¶Ðhb-bÅô#Gh¨™e,—ß%#Z‹¼å‡uk»~8#|Ù͉ hÔÔÑùú#Ë –saßÊÌÓ#Ü‘H9…yý…gÀæ»ÛZ°@ú2p¬žúœÿZ’"+PÁV LaTó# Å’ f›€t>j¦ÔE‘yòaµK¢ã(ÓñœaBé~š?–öÛô Íeëïi”W^°E}óü½_BgvˆÊõÌ_Þ 8ý7Ü1×ÞÈŒ¤uG"ºhÔ]9¾É\ÈR8ù¢†ŠBˆ‚„T‘DK,ôI<SFA BA Å4D× ƒi¥X¤ HA,:žKì$5Ì‹× etñuO·ã9ùÓÛN‰¢þ¿ÚùFG Ñ«šKD<§­Ž”œÛ 1ón>®Ù‰;u´E Ñ nmš4sÐ ˜ æÁÂV+‡â&#¤¹(c–ŒpH7i1ìH¥Õ£rLÁ Y0è _oúÎ8eëÎý~wÃ[zÿ1ŸæÖ´ÀFΖÐ8çÔsÆ<ö9ø‰ŽÌ_ûä¼ûWØBóÆZÎþº7†šXsa 6Œ3¶_~GRo¤pw°JÔ1 C@ ³Í:HD%| ûŒ?•,ÀÍ\'Òa¯$Æ÷IæW»B­£†ÖwY|‡;ÚÅcð­G¾ï‘i@§†ªØ\¡#:€l¬Pí®èàF5m­¥úSi‰ç\³¨;ÔuZÙLOœ & FµdVTbbpÁ1qT H [^˜f0ÐS3B+Ü:fbVÝ?pè(èˆhÁBL:ukXî}Yñ()¸û'¼ŒÐÛ îúÍSò¸mXp¾Û£ƒqä-êz¨Šíiîì?\r'tp9Fžúfí42rò|{˜€cl`L,d† }ìt*§=.‚«†]Ùp7©»®L 5ýŒ>uŒ°f|¹^#eS/œ,v[aî¾½ftÕÂ=Ûë^–¬¾W;[“StË'[v3Љ8‡µ¿Eu fDl}?XCþ wé-L:0lX*JZI‡Ór_ÿ†SÃB¦¡tÌ0¡$_¬€˜¹.0¿.}BájåÐî—­Ýõ½½í^v ÛGçîÒ>ŠcýKÙú5m¾­”V˜ÓÚnr*UÔºŒm£™e$‰àÖ5“2©ÏUÂ5²¤} Q †Rz: @„öU%¯ŽWeÓœPÂkjû¸æJ©fªb8üLü< ÄèÁš‘‘y¬cvÿ5|]€°ë1ÑGú)Ôfß,ºF£mû€$…¶A¸Ö¯d‰… ®ZÿÉ Ä¤§V Wõ°šp˜¨Ü0 ¬Ì,2¤Ñ}‰šJé ˆÒØ!YŒfÆ(fzúoeV^„•úþëö¤Oxë° ®^ÊÙ8ƒ8ä+ŸGø.¼«°â…‘Q²•´ MÝ0n…ãÙöÃsò4sÁŽnÇ·¶gFtMïÊŒˆÀ«pí)8À8:þùù˜!rd©0f!›Z>uj¨„š)=ÕŠ€C1!ÖFŒ àGÞýaP¿ìÇî¶n^yiôé{·2àæ “ºèæàÓ> 7ÊÑĉ•ÁPÉìO¶@Ÿ@A¦1%£r«·õ#kæ T 5¹`˜ô"P ôØa  •Õ—s.ìKR4ËLSJçÓb3ª¹-Ñ0Ï»J–‹‹õpøÖ[.@¶WÑ¡àʳ²ž«Àœ¹<ïîã1ÌZ“F—ŸãpFÁ>›Ð=œNÎõü35 ´Ô Ð4 ™&›eBüO@ «Xñ¼x@$ «¶¯%í:‚È¡N¼¹¾¦"*¢W6yô¾vóÐ[ðò[‡‚Ö=úÖCûÕǯ °ƒ®µŸ´mUôþî7\‹¶>ÒõWóz3QZЀ½X)§Ážw­ Sº«-N;}U6äJÚ1Â:{)Üíg@Ëâ1¸dÚ!"0G¢ïlo¾úfÌ+]ôÞè äÛ¾Åï†Zfû!¬@apnñЈWjoˆîfj08 Z…éxa+[´9ÛÒ¹oš¼ I }è* NƒILòKcŠù5H¢æ`¦©»‘¬®Ku;5õR‡CéA½›´mœ!+?Ú,óØöœ5so•77¦¾4BÐùkúaÈ¢r† MÁöÔ—[Waô‹†„•((+ôöïféÜñ®×3Åæ,­5F½,L¼”’.HCQV˜HתŸ€šÄßCŠ"T/WäZú ûê“„dŠ`ŠÞß±&\?è¼"íþ©(¬ €.æ7–ê¨ÃŒÏ½ØtÑøÊ0ô  X¨…¢¦j¨N °È¡•¤*ª€€0ÌÖYO¯#|›Ûóúà_àm-Yº7²ûÀ†y 4?ðžûÒ”£¦Ž–N +IÝSJ,0†&³°²Ff Yê¢f4¢˜ùBõÚyj|xsIÌõRÅœ±a1=·½f®ÑÚ¶(ƒTX¤:Î{Z¹£ÍªDƬCÿ’8iO%›ÅÒœ±KÊ1ÞV@ˆÁ´b†=48ÌР%F.62-µ'ˆX‚ÿííÕ7Ë|×'ÿHÿô}Oÿ©çøë1UêÕÎæ¯ih ÃÁ/n×jJÔ†­Õ ¶©º@H²Ë)Ì—¤7ç9ß”I])uÓ}4!u2©©/Ê#( Ô FÕÀBïtbPúb¼¦! þ±^Ä\•„|ªWÍúÝoýâ]èG0Â÷}òÃ}Ëó´ŸÂwõOþÕçüÀnFµ ‚ŒÙø BZ›lì?ûC/é´™»§ìF6ö4͉~Õ±@¯C‹ +d…ÑXaB ŒàdF_E‚¨À˜&R&zŒ°´\‹ –§,„¯ ®°F [# †ô'vÙa–ùs‡ßñз¹M;±ÔB)ô0[Ô M!9©±ìa¡X"z[Lð±ì|>ÞiJã‚6µ§f•1³Û%!Ðý®a•¤œV`Xˆ¢~Ò"Ý€Zr¼L>h-³BZ¹Q’ËÐà}]0¹¹ùv­÷f„Ï~臾¥o1Ët«OœÅs»:ÅýðD k[lŽA:2iÃÂùS々G¦n2d8—(Ø©9iä‰1ˤ:*]Ô°*ŠÄ[-Vg­)FÀœæ\Qƒ¨d^@²D¸³Æâ^¼ÏÜ¡ãsÿ²|ß?„nŽW IDATôßýÖWÜ} Á?òô·øÀ'ÿõ‡¾ñqí]xÿfÑ¥{Û<Š,…„þ¥ž²›ÎB(rLêû3— rówÑ>¤}r{ýcÿ–5úO¨·“ºSFhV3Ï‚¨!5¬ ¢¯Ð“#J왋Ö:ÈÒ,¢Tô…}r1º94MüÙŸý;óÔ à—þäûî¾HŸøòýü7Ç—‡OßkóúgPðw:¤uÈ„½5íãælÚ²¶…ìd iYÊ)Úœ‰5`KR(8Sèñ¹H7î2w+X#…3¬ä3C5x¡¶|{ý—ôboÿ¡µ¬fèàùMâçvyùoçU€››o¼ýx #|òUGÏ~ð‘šêÛ%ò„Õe{L ^K"ض›m!66sêPDoQ fÁ³¼d~3l™…óy-›…ÂÙžÖ¬™\QÔ6Ž˜±l/ó¯™vÚ¬V Ë- ™ÔÌN|nfæ™(P³pÊ´q7'xgé>çö:´;ð©1k v){ËÕ¼”²´ª·œ+"ˆ>°§ƒÝÁ'š-ÿD…„ئ^¢;\žt©îsâØ~ŒóÍŸ…Lj(êÔÐM^OFK씨x®ºg´×B=§­qnÕzWKw°yIób0³šz-tÕ™V ºw¡7Žnà0}¤3jâ¶¿Ϋ¦yùà'‚ê1¦‚¦Äæè*¶|ÕËõa¡÷ó†y 2ˆ/?“Âþñ<]Àþ•—FÚ–T/¶;õÉÝj1*9ùkÖ®\S/Í¿?OZ ×1BÆP5ûe#Œ²ð3Þ5ônR€ãÀ¨†ã2fq tý(è×A„ÚñÂ&©Q¨¹4ïΚ* ²[KóÎêËÝmij{yÝÚŠê­¢}èÉßr»ƒuý³õ²è'gr› ÓL ûüúƱ¸½YMåŠQÔ¬D`/5&CEÛ½Ÿ‚êO3^è9%±Ða„¯²*-ãÈK6‘ÍŠX®Þ¥2ßo{ J¬=¨õw"Á¯ŸlZaŠtý"Xº71ß~³ùGÛûQ­IäˆÁn™M˜t°5t×–S¸v¢t$@æE¸Ä&PMRhÉÜkѹFÏ ¤g3Ï”³æFÌûfƒC[ýïnå3Î9êE¶„'çà«Ö¨^g çæÝ«>»mV…6†ùd®‹¦¢ÞŸOüQÎRg¯ˆ6¿L£ƒ®£Ê\q涯–•Øæ„ŠÌjh¤P¼æ©yñŽç.ïÐBd–6þ ¨‘üO#11'½|‘/Ø+g0$¼¶Œðœ~ÕÍ®æàß©7®ËÄtàÙÁÅ'ŸøkÝFóÄ»÷'t³éþîF Í ×ØÒ‡gêUôè¹T3K"è¸ØDí°°ÌÅgf7M¡gŽÅzj(ÌRðóPC^ÉÒ¯w·W?¡y–»ÎxK{ÒTО5j¡² ša(œƒ…ua“AÄú²-éà†šUZæ:´6y[~¢ à¼ÐgR~Pˆ º.šê(ÓJÓŒ3C(¢³hU*è+ëxÈ°ÿKÉvˆTJW_ï,Œ¹:ÿØÓž 3yöë7zðë4¨6[ZÂloì±ÐÍ{MT𨡟ƶTó‹ñ(Óe¹Sz:¸×nm -( mÞQ‡³ÎDÓX‚f¦éÿlÓ¢6ò6Ú÷8"tjÈ¥RJÄzLpá<×è넽œròåuwZ¾§Ha?ñê±0þPÂáÝcäv’4ÛaÚ\ÓÁ[!°o5Òޣʟz—Ê¥îk㞆&‚¤¡Ò`6È·ÂBO–@Ïÿ J÷p¨áR¾§½fé>È'!›­&ÉÓÅÆö`ÁÿæB3ó`áªpŒõOÚö ·òÄâèÚ“Bë5Ò¹[ “'¤ÑþOÅ KDÞî`„”Ð:)díà0Y#d™|`‹¾d‘2=ÿjä”Rº8£s&îò²¨¬kô[žþšíKœ°NtâÞ–\0ã©Ø0/e&›çg‡Þˆœ«u¾.BAËSj´iv"(àŒl>øÕ㶱³ Šˆ†RÊøâŽú>8ytÐÐTCðÂ.ˆÈ¤†èäS2…ЄCø;ÞüªsîÚ„ã9‡}›»F?'Wmm¸ˆ%@¶IÕ*¢ç‚+"ÈíS,5Ö~ÐêUýÍ)5›»ÊæiO¹|ãi\´|ìPД”°eHϬ!Îú§Ý‚…iè 0æþ»ÀÒGã¿É_õ׿åþ{Ø+_ºÏ]£ŸùWÙ¹ÍP×ÏAšø¹„Ã5v.@‘F‹zûînê‰àŠ¶ÞÔ†±HƒðUïh\pᔩÝa=´MO¶ÆÎY+Ñ!ñ™#ú 4ÏÒ}õUZÈк¯Ñ”ek|¤ÿâ77ï¹ýäºÓ|õaWbm5✆ú“|1À@+0½ ‚³Øå’‰tŠ†0Ø½Ú ó|¿G² ¦YÔåó¼%F87Ë2ÜÙkÌbñÕ˜Ç+XÒ&“|×’·hÀÂ2Ãy»@Ó¨Á‰q{CSô?ô?à;îƒÃW[‰µ®Ý=y<ñj×93§'‚Û§ õOX~¢-ñoÕÇfl;…ˆXn‹·œnî—©f«}9 ` S´d':ǘ¿÷-¼!¥š<Øòwó ßø»> ܇¯>¾ó×geMè ~sªL º‘üR:§t<²v¼°Ú|¡1ë¢h«‰"?jÙšÿ%uQ[*Ef64žbëç\¶Û’†:ê´"cD‘b˜!C´Ñ¨†ë&h%ƒŠZoþiÌŒŽéÀ./¿gÀák„­­ðo5èôE:Ïóá[Ã3û`â)€/H´à nº«m9ßœà ×hÆ›G&1¶Áë^8ôÖ©£Èy¼Oè)ÄR ]C`æÚ#wrþlЩ¡š×?#-àz_Ÿ„úU8píÛN¿€¹¿N{z7´N£¾¿_-± ;ËŠ£ó,úÒ=pØÎÉgU~Nšõ¿)bÁ̵ø:ysƒ…jè.^—a>X’ÈHëýgÀð¬s‰n&"d›l^§šÎ g™Ñ ¤Éù²j ÂåV ûì5/ã9}zs¿ „¥]*°°™h,p±‹-oÄÕ¾µ.ߨY¨£îdèGG¯mÌœr#ü¥k^ècùNBA&¯”›<J›:¿í50ËdØo1µ {‹Ák)l±À ã©em¶Å7pØË]¿ÕÙ/3Ç;i”Í,CÎtùõ3â.Dœ'©ŽZnHGò¼…¡ª+ºÛÈv–õÀ¿îODGm~‰ÞÛ^}FX¼šêš®ƒ|½þ¹‰öD°µÖe ~3Üü4ïÆ€yvÕ>§¿&Š.£ƒÛðó]!¸~ÌQ„ªG(:RèžOí°0VîÝ`¡ ð}„ö|ïâ–/¡]ž5`é+Ï;!`cýX)Ÿí/C†AÔdÆBCvLvt°ûƒ1g™DWOÞsKú¼Á›à©Q£}‘Jaóžù´ï€Ã8Ô> PÄzš`œ§Aó«¾-óŒŠñâ˜2iÍ>¿: ƒÏ×ί^FÈHo)Éw‘Â|uÍ»ºŽk,4³N&g§-yßé-è æûÜäгîvBfÿ–þïÞÒ¢(ŒÎypïLO ›!¨×r{=KÓ²îƒP“DzhÇëD_F‡ w·é5™¹Kdᮋ$œ$…óë§_‡¦†…˜½] hgxkiñǘÞ6)Ä 7ÑAvÇy¿O6ëè -XÕŒœ[<õÏòÕ KHïO4ÁÂ5J`‡÷µW_fó£­²–1Âû§þƒkO¢Ò±Íšt°& =ì⪟¾¬­žç¼ }‹ö¹"ªyJý¿æ5ÕïšÞ5S7XØb#…1{pÌÓ8ræ”hû)ÍÀ·ºè%qqûã=Ý^³Œ¯Gè‘BoÌßÙ–®Ñ|ŠÕSÆt­aaÈúb~šZ¸`‡wœä2dè÷ʉ ›xµEÁ¶ÑA`Îp÷™hm€)TC\F H$!n¯0PͶoì;V£†1¿ýЛ¿ìŽ³jm²áþ™¿ôзñ“ÿÜ=SØ{þâƒÖˆ'ù­O¿Nèj­ôOý°\Â^ó©ÏtÇwØj0gGôËüÞ- v¡ÄŒýtD0ç?²ñŽúciOs»„(C{*صW‰ÿŸ½7·åªêEcΪZkíöœ“œ4„`‚(­@" \@ÑK.‚‚héÄñ‰ÜOž„ž+`h^il/O:Qñ¢ñ!JD@‰€ ¡IwÎÙíjªjÎûÇœcÔ¨ZkíµöNÎÉÞ95¾úÖWk®ªZÕŒ¿1~cÌ9­AB0)o·´Èƒ8jGð¹­ ž‡Ió¼îS6<@=q׊G¯2ˆý 7ÿëÏ‘ˆ~råžs=à1y×ú¿íJCö&Dt=Üwml¬µ òUÂn R˜ÆWY¯ŽPo‘ÆÁ°óÅ6‚FW¡rž5@²@B° ”`‰ ` ‘ ãbH †7°€%Ú, KH(N¥mø>êí £q…ÑÁµáõ°=ýÔ·ž»³^-â‰;Þ®©²…wž½Zy²b¨ÇZ#£¾òOñ¦SsËøÙز¾o°)ÒXµ£Ö8A_(=ÁH»z…‚¾‚C8øQ£ë}žÔ—aŽ{­4÷pÞñ,㜫ZÊÞÁ9^‘ÚÌEž+@®ãÏíkõÎÇaTx[E„pýþì¬WwzçuãÚ'îÑDvÖûÖX©z¦ü“â<Ù™ ;w¨A­’‘º‰YÎÁÇQ]¦œ¡¢4£nj¶³BAÕØ uPX7mÓÄ©Ä'”É.ÙdžÕU—Æ9/ZµÅ{åø†T_x0 gÈþ§F-¨Ds¤z^md õOò ù*½Vê`ÕV3n‰2“ULƒ©·ÔPª±ªÜs\vÀÅñÅ7 i­û<â¼8AÝ+{¯JׄÜ`xE«¤ !GzôÛ±NÑåP£ª ¦"EuP¨7¨Ç‚Í}„[^ü"_Q y¾+óD@©•Éð3óòÉÔ(øU©AÅŽVtõcB­h‘a)S¨ÙÎFúY/(,¬Š=”µªœ~Õ7šáRT–L×¼(…Á”XP{QMŒkÏoªVÎû0kàøFq® ]5î ájZ ¥Þ[)%­ºd€ƒùôÊíû", î)¡9æ‹”ÉôFw‡`ó^'E+ä j*9BÔ|¶JC%ª»«š­PlÄ…Üe0& }Õ}bÂx¤eÁÜìNXX¯-K9Á óÉ;ƃ ŽPŽƒj¥¤rvÊyLP5ŠÉA!)ÿÜë(°Þ5P§+gž@/=w&p:.Ôá 6}ãg§ütª¼ïšW>Ž‚Ê’^ôaÕ“£CvxcIP™Âj9¹`~عØËY'_mÚ‡>³V±ÿ=÷IA!ÅpEÃÛD,Ôosµ1@ÚESQ N+ïæ1届ŒééÛ8 V{%«à§âÞkÜNAê‘oÕçØI)kE5 E¨!œ”̘ƺP¦Áq×Æ‹3‚;[ˆ1Q;9_Û¦º“àP2V¹ÃÈ„Ñ°¸¥z4VM3U  €zPXw¶š5ŸõJñôk¦iR­@¦Zûu‡SS+•Û$-ªF£`¥lµp=$BLÒŽg0U«êÛ„À1^-Þcy#ba@SaAÿ*X8Sö?FCí+^Õ¶Œ¤“ÐnÂÀ¡â_‡c¦(¥×|ƒ•Óhœ[•¹P!VcbÂp’!½éÇãB§âB7_i“˜àvÂØJ½(XÅÊW!ÆÂ]R£§¼jt† <./_{ûË×Þ^+Å„ ”£jŸÝò¦µ+Œ!]º‚*“~Š‹åñ²'-ô{k—-›™Z"Ð(DË+ÖÞ1‰݃DköÌõŸߎˆòÕq/OpÁ8‘ZÇÖ ëþòG_¾ñè™\ ÜÛr‹/y^¹Öÿúµþ×ÇK6dRÉø­†=¨ôV-'ð›Ü"~tG2 *YÞ`²ŽßÕøÕ8BÝyÚå|@„¯ù+n­òÅ›Ö_,`ÇçRÅB%÷g.cRÚ—L\ V74þì —ÿì —Ïþk{[nñEÏ+ï¢õw2ç­]ƒÆàdÓZ|•–ƒÇ /!/N ò¢f„¨~ KÁp%¥+RÀâðÍ_¦°™/ª™è¥ÔjûŠz¸µ ëhµþÎ=éTÃì)Ùþò]£ù íÄ5€hÕÎ+U'mÅ ,€~ÿQýþ£fž‹éíqÙ³ì_°úÔç¯>@=üjÚ£9°P`ÕIPI??‚ÅñEoLµúOs›ì(U†¬Ö'ú‹Cs¸_o©¾ ¢Â¸ ƒe\¿bùýW,ÿùÌÿ>É@˜_÷çϾ¨»úø¿Þ˜oû r¡¹üº¬Iú³~ÓæÅB·UZQ‡7ˆrði ¨‰ p" òÁïÕIÜ*" £Š>¸Jr±zŠanWÁBÏ1I,ïó|´7}Å[ÏzÅÌ?É@x+èÕò¥~ùR/Y•bb>,dÈñ*ºª õéð¼BAWÃ<(ܪ5Rh„·\¥úx@5=¬Z•”uðIª¿r3ÁññüeW"h§0"göPAf0±q/Hå{}qÅözêõ®œýß½=.óɽÚ[Ž0ôfâ>M{Äñý)çÒ"dºZ§ºpH)1mdn¤zp‡Ó«¶¯ºOL‚dùªãBõ„++©ÔÝÞ.‡ÒpܬDg¶„×ÂI_y8Ri`yª—r¿w”üäQ£îÄÇ^ùc?þ¶îEçìqnh‘@a…˜÷41r¥;p¤:_S#N¹1~4JŽç{¨¤ÖL½qk׊¡4\]P&zJì KDÂS7ê×Ã{”'ûõRÀÇE¤±à ¾T©óÞqÕèìsp'¯ùÖÒ+!E©–܉ƒ¥qÉTRU¿¸ðGÑvÁ(Ð [NäE9x¯õ…×Ô¨çWѤ;µ®ƒB‰zÝdúDxk`g`Aci¬X#_M]7à•0Š Qh$tnjô$ËLÑ«]G„u:”üúÚ»0ª ¯^ûµ±ðk-2`8 Dl´½iíà ÓÀ¼uíïëĦ!˜ßZ»ªÑ"¡ø浌‡†¯_û j(h Ì«×þ„ñÏ (ʵs@i_¸ö›¡¡¾3¿²ök{åQ^¶ö¬f[xƒª£Æhïן¤"BGÀ/¯_ZѤQñü¯l<žyTGͧé…w{[fšÒå;?å=÷úG­ß;ˆôu|ÎoàŠv1~t3^…° «ß1¼Í€/žYƒH8ßTq[üu o‹i om´È_Ôø&‰¥ñ8^‡1¼¯ :ÿ5/¼9ô™âå–'Èù›aS¯ün½T·võ|Sxx¯<ñÂ’§Á6¾èØ b‰ÛKÿ~Óóu\8'p#Â[I¯ª+G•õ? ñ¸ðø[¨jqpìR5ÿ-ª;2Þð’p0î^âúç‘ÎÕ…_¿õ«T =Y‡€%nx1Ï>( ÇM¯TçÇ §þ´šžB„7Ûþ áþö•l_µÃ¼v•&TQæäG¥ÛûBõ¾º‘"q¬ÝxFÄSþÊOO?šÞ(’ùdš^ùÝÈÉ:¹Vn±œ¼§6—fä_}ãÅg=îÊõ]©S«Wû_Z½jådÈ~Ó«ÝE„­nD¹µŸÚàŸå;/þ¿à~o¾ö¿pþ-£®€V¯¦´zÕÊÉÛD¯öÞ°•ÓUº÷{͵þ5·õY´r{“V¯Z92—^íºX¦•VZi¥•VnOÒa+­´ÒJ+§µìqÒŠVZi¥•VZ¹}H¶ÒJ+­´rZK „­´ÒJ+­œÖÒa+­´ÒJ+§µ´@ØJ+­´ÒÊi--¶ÒJ+­´rZK „­´ÒJ+­œÖÒa+­´ÒJ+§µ´@ØJ+­´ÒÊi--¶ÒJ+­´rZK „­´ÒJ+­œÖÒa+­´ÒJ+§µ´@ØJ+­´ÒÊi--¶ÒJ+­´rZK „­´ÒJ+­œÖÒa+­´ÒJ+§µ´@ØJ+­´ÒÊi--¶ÒJ+­´rZK „­´ÒJ+­œÖÒa+­´ÒJ+§µ´@ØJ+­´ÒÊi-óë>ðÂÇÜãˆ!"³x‡ûüÈË?±áo…ÃúÍÏüÁÛ>¹vkª•ÓOò/½êžÝû¾á«ÅNµ:ÖÊtñ7¼ãÁÝ /ÿÌ jZÿà/ŸùÔ¿ÛºíNêö-ËëÞþSOx]ÿévÍÚÖ‰oüË¿ì)¸ G·ü¸þØß¼è9¿ùÉuwËÕJ+¥Õ±VZÙO²¿€°ÿÅ?xÆ÷œuÏýžŸã.9û¿óõÛ¿ìÂoúkŸ÷ÃßíÛïxæw~äs?ðÈoúµå]/ý‰Ÿ¿²°zÎw<è1ðYÉ´äßø‹\ò+‰Mïô°gÿñ5£ø§£ëþ÷ ~èn‡ˆˆzç_òk¯ÿùG>éý×ÿÓ/Ýëè‘ó¾ï ÿ‘oü²o¿× ÿêÝÏúÞ³ˆÎ}Æ?lcãÊÇ­žõôF笼öÍ÷ëÞë5ÿ‘cûã—]xç'¿ì—/¹ènw>÷Ðê·}ßÿóŽw¿øqßí.w:ºzÎ÷<ó½_Ëo›»ÚÊ-”]©eC&h]yÃ.«ëØmpM­œR¹%*Ô”iögš‰}õžõ° V»Y’.œ}ÑSÿà«­¾M¿dð™Þ-½ãOÿÑWú.?ö©7>úpÿß¾®ð[{æ9°ß}Å?o8ïG×þá¥Gþ;×ä~ëSÏ¿gväûž÷îO]?”ƒLÛxø…×Ü¿w‡'½ãKÛ.ÿÖ_^vaï¾W\=ôÞ?ÿŠûtÎý‰ßûÌÍÃÑÆuÿvõMù苯¼Gç~o¾¶žg–Îøóþìó×;¾‘{¿þÁY9úÓ¿~/®yÓE{¾úK£ð×É_óÙ-çݱýü9À™O|ïu#ïók~ÿû—Îþ™nžú›ÚÊ-•Ýªå苯¼Gç>¯ÿÏÜû©Z×бVnß²[r׿ýA žû/ýêkõØ¥3žò‘M?ÝþLQ¶ýø‘³žøþë ¯|òÓßÝ&÷`ŸË>Š‡_øÃw|ù»ž÷’Ç]Ø¥äðýžþ’§Ý1‘Óïù¥§Ýw‰€ôüÇ>çÉGþñ÷?r“[¸ßÿ¸ê¯ÀÕWüàÇ£žý¶Ï0Ó4aãÁ—ÞõÖÏÞíy/»ô.=JÎþþÿûç/øü;þòk†_|×ï]}ç_ñ”{ÉÒ¥óîq·3’ñ3+ýùÏ|ËK{÷³Zšð³–ô—=é^ :|ñ%wËÎ|Ìÿõ¨óR 9÷A<ýêk¶ÚœÐ“]«¥Úw4EëZ9­dO*4üêß}xAäìÿöþ͉ôiÊ–žó]ç­ýÍ[ÞòþÏó+^|ß³Ó“{µSöæǯ=‘Ýá‚C6|MÏüö3å‘™ÎêÎÿ%‡Ï?ì}c½Ìê}~ê×ß÷éëoþ§+îý±Ëü˜ßúÏ|Êƃ›¾|ÓèÓϹïÑ#GŽ9rö_þÖŸØ*QÜüŸÇÒ;Üù°ÝéÌÌâ…÷9wª2\‹ IDATúx…n¦{øŒø×dŒ]8c1Ø‚+} „Nö –Õ¾S´®•ÓJö¤BÙ/û‹«¿,ò™?ø…ÉÆšÊ4eëÜóò¿½ê•÷úôKvöY=ñÕ{CëˆMΩ”dõ¼•ü ×­—X±ÊÍ6Äd¸þõמˆ?Œ¾uõõ8rÞj…]võ?úÒÿùÿ¿ýáïýìÖSΙ¸qçÈGºzáç?úÔskê4ýagæ_ùÀ{?ôÙ¯”Åö7?õî7¾ÿæ»<â;¦lÜ»ëO=ã^Ÿ}ñåïø×àú×_ý©/œ(Î]âÉwùÜË_ðîß(Ýà¦/þË—ÖiùìÃþÚ~ŸÂuλ÷9'>þá/m{ ¼áoßô¶¯´>ÖíWv«–úêLÑ:ØY:ÖÊíHn‰ M)ögš²å_¿ê#ÿvÓÈ#=zÜëˆïËVãÆd!z÷{ñûßôЫžümÝîê·_úçwzü]{üSrè¿<¯{øY{èÁ¯3—½çíO9ߺãŸxó3váá^’.žÿ¨×®=å>ðœ{dS6Fv×gÿï?ý¹W?ühJdÝûIoüäšн÷ó>ð®Ÿøæ‹î¿’ØÞy|ÑßÞäÏzÌ+žs÷+{´sÆ÷^ñùáøyfwûÅß~ÑßþýwºÓwÜíÞþ­Õ§<ôÈŽÌj+Zv©–€sž9„iZgféX+·'Ùµ í(ÓìÏe+nøÐK/¹ k³ÞÒOü‡xÓo=þœýdõ÷‹ÜÖÕ:Seð¯/¾Kï¡ï¾Ñù­=óË?ô—ksí¶«[ie—2S-ókßöƒK+û‹·Ééµ²ÿe–­•“)ûÊ7èåÃþ×p›ÿþ‡/{Ë5ßùØ‹V[2{J~ÝŸ?û¢îêãÿzã¶>““-󪥻þí[4éžþ¥K^sÅ#VOý‰Þ.äv©W­e»Íe†^í£b øæ_úäÇ]õŸkÌÒ}Úÿzï/~g ´ý?÷›¸{åýøÛº“ÝÖ§r d^µ4gÿÔ‡¾uɆY=²¸¯^«ƒ#·[½j-Ûm*sèù6WßÊnÅoýÛ{Þ·ñˆ‡|úÑúëW|é}?°|[ŸP+· iõª•“!sèÕ¾¢F[9 B‹÷¼ôÉ7p¿g~î2ÿz‹2Ež °(_A/ü5ÿ¼°þ"A~½å·üÏ¤È Ÿ@y)½÷ý„¯oà Ü%tå•þûÄŽÐîûè#öÿE߃GÐß…PЫG҇þä`¯¦¿z¿4ãÖƒž@òÿþjÈÁ<•Þþ»þ§=à`a€½€y+@—;À"ð>®µì)ð÷†‘€ ¸ÆW:$\åQue8á¡“ jø W …|ŸóQ‹%þ ¯Ã"_³D„oõÈ”ƒ¼ð#å0@ XàR¿‰Aç)=[Ø3ÙpŠ“5Z¯þsÒ¯7õ*ñ#BA€‰çêÊ…#ÀÀ™–ùûû†C·°üˆÿcƒÂÀ%(-Ê”òù³ükä‚…C£K‘¿ÃÿD‚A@Ç€¬î¯ý÷ÄUÐ÷ý aÏÝèE/ʧü}=ªîõŸ>îïï0B é(,ññ–°9PÉ.gŠ<àeˆ=Ì{ü–( ol~×?Í!ÁŸÀÞký³J”OðÖÁÏã`-˶†€£ðP¸3f¯.ô?&À¤€‰‘R|ÕKPá0þÈGPì°Ñé_ó „IÁþý»ûûðWë@®l`ÿÂœ¯¦€!p"®G ÏíDíêü/zNßüs¹ÑT‹°H<¾¼p;úìx‡jW ÿgÀ(Ù|&ðúŒÁ¼'ð×±mw€¥ 9@çÈìM&˵{ÜoO@è•KY¶²Ú2<ª’?KÞÓ³1'hÀëÝúÀ°•¢X%†½%ÂeÅE¦FŒ¿f*4Ì8ägìÌ`Ôë²4ÉõìØKð'œ…ãO͈:åÚ­9ÐåŸF ¡1¯û—# ‰ÚÝ6Ã$âœr0"Â=éÁq%…¨±$€à(þä,J‚”²‘&-‰Ï ä ëà‘*fM%" @(¡¡ð¢üÆÃALŠ¡bÁ€y¬çö°B½@c†¯üZ”¡1 ‡IP„¸`5 ì>ç׫½G„·˜ÃQRÛɧÀaË0AŠ”4Pª¨§Ž » ‡`sf¶l3 j4Ð]#þ,jp-JÁ j—x<"Dݽ×™¨vY'§|åÛÛY™Ìù •  ÛSÄ—ÑïÚ¡>åõÂ{Bí¶ïü&4_) :4ôŠÌUìŸ3.ŽªÐC \è3¢K Wk°põ°Ç` ¤!9NÊÕ]+~|´6á¶`°HÀoÁ€¢’:Žv vŠ„Þ\æËËT@>ù´£î…è òâfKçdD„É·]öÉë/Ûë'ÿW8OW·;ãR¿œz,è….%À $xƒÒr¸#± dõ‰/,9áKüdih”%„‰r(MŠ èBÅ‚¡ã‡©Óê+9Ž9¼+B,è˜Þ @ 0,ÎqŒ/D‡áÓÁ8æHÃgÝ-OóP£'£åÖÖ+A¾Ù'KõuAÁ„öl–‘•TB¦¬Œàbæa‡œî ìÇJ ”•k`a1¶L7X˜d°âÙs:°ºí]'uÚwÄûn«+4œ«P”ÌFA!H &º¹hñ“„;êÕîðŸä;> £¨\n8ø¿bf ü$ŽO‡RPCè/2 ¨[a\žë+ÔpØA­‚¦çc9AüŸRÑ´Z ð_a¦¡;ró”GeÈRd†‰9ª˜~#૾òîJ &¼bë‹¿ðzþÙ|–èD„÷&ø7Iù͵ñKEêí2ðwô×ä&Æ‚^S\×pe¼K¨HUM@;|¿íŸžb¤¡Q'õÊøñ ‡3  øM° {Ad]@N¯{Nþ "ÊÿèXÐ@Š–†O…|’ô| KÑþûgÓëæ¹ÿû?"¼à.Õ¯%5¦Š[ ñ.Ô"&H…‚:.J¸ ¦§£C3ª!Ÿÿ§ª0¢ã Æq¨à°˜e°rðßϹ2S÷('¬ákê!oæ_ÈÔhÂÞxªx+½’“B®¾¨:kžÛ•¹¶ºe÷@øQwòó£`1UâÈhwfÄÔ¨W sFpÀ¤è(S(¸¬0æ-˼²¬*v4l° ª¨,‰ÔÆ™ÔÉ=!aƒZh”;R¥N&XBÇ¢4(8ƒž+ðÓü§äÚGê§DýdTªÀOzŒ€?ž‡{O™|ÚÇwv—$Š¢²¼…V¤i@ÄHŠ Ÿ™ú<¥<®+òS>3Æ?AÇ°"©QPš„‘Oµ‚m ’ê“@0Àž %gþˆ‹_"êAÿ4òÑæøÕ> $à £éoøg•°¿B¯Ýùæï ü.øĴʼ"—fU%F á˜Ê¨ÜYÂÙ——$¤ ‡á«É™í+8 -[U-}…ˆ¹ w0XuϽ:E½® –Q†¤n°ª KTð7dŽT¬Q#ì+ù×RýZòñU)½ÿ€Îqó5 ¾4[o‘`oêQuPìùŽ”~J¤TðãÏ>°(9°Ì[áõCüU³£²Ò)AyrÈYœò± u‚¯HâBM°7ÒÂœ0vQ‚$E’ ³0¢Zˆÿ«·Y=Š¼¨¸pŒ;)ÖÉõj*_ªÁS°°4\)ªsx`‚‚¡Q¢=Á¼Pša”…i=SŽiT>Ra8?ª’ËòAeu ¨QP‡ƒ D „'˜#ÕŸ)KX[Â9sp9’.„ƒü™”¶HæqI÷=¡±X0´x6Cs‰DP ZQ—ÉH z‡]×S£vĘ·Í(¸É@¸¥bÁF\(k¨"BljìÆ`5A1XÂ7鬋ŽmÍXPçm:\5N¯Ã©d3ÎGîµûÄže¯Å2¥ÚÕ±ZÈ[QL³YºAxÍ4Žê‘’€bEJ.‡€%Ž3þbì:Ð@õÅh `½+JÃuÔá`Rÿ$…‚ÓÙÑ"“Ý™EÁ¬é ž”è0Ü×8WJMõÓÙY5Š1t|‘ÒRNÖ+‚7Ü}BZx%öh, 4Þªr{: ¼h@¾ðÙÁ° r4YZ®—ÑA!+…Še½ÈVzVR-)¨cAM‡Jò€Æ<ºL„~ÿ ¤eUã8è …ˆ«xQ¯]‡ªÓdÿG„A4 ¿D:*Ÿ,Fy´ U´ ùô«Ûˆ»Œ…‰cÓ³ÅäV°Á°'}Ä) ]®%"ÌÇ –èO͵UÇ?m°l}E¼{ „šöµ\ «éP‰xD/*Xû€‚]u>sá FÇQÐp»ö {\;I¸#s<ßAÁ¿J!‚^i\fü[æˆp™¿†èpÕ†ÊÇ’ƒ íª,)kRÂEZå ‚U“”ʲÚõnÔ1K&ÈLÅ…öùÔ ±[iUب'Ø›ÕuÈ8 Nô¥‚¾ÍÐ+/½)tÄ„¥Uá ®Ž ŸÕ4†XP‰5Ò×ÞúÂ8åïéš°ººNå,§±Üáð;Žt=/^¤Ïƒ‚®ªîƒWÃÀa` èÈ(4›uOk XwÍŽ–*k©E§Çås¼³M¢¼+Q­TãÚÕáÏ” É°l10Q× 6Ô,¾¯wjz‰Çöp¸ |mþû)›=ý“¬Wn–^íÔ¹b*NR¬áuºdFú<„!ÖÆ‹E †@0 _h¦4|ÚÒ‘í#V'©¡óðcá É%ŒA`|ØPº1@â­-½-=ò€ˆãà'(xà0„}Ì‚ ,"Â#IP”1Aˆß÷O)þýîŽOb/@xõYp÷v½ãÞä"øB™¢‰é@ §¬g@[LY›ø‚g®Ž} 7ùsCaaŸ±i°ø¬NÁJŠOKƒ*eþÔ{ Ä(€QÏ[ Öx.°a­Ò¦ÁªBÃ.PÏqa©ò‚ÒSœ ¾¿ è‚.Þá‘{BÿG@?¶ëƒì1ÆŽŠÃ;þVL¢ƒ”4Ô²dØólQª”aÆ…Wî>ØV¹4FÂÁU`Å#Õ>Ö– ·¹»ê`,"ÌùZÀ<‰ÎÂQ]õlÝ»jøU¦î3Ž‘¢Ñ…*™µa¥¢z ²$Ï0P¾¦Q(høÖ¢¾²ƒ€ªQŒ±£ž5m"ß0]¯¬º%ªûD,]©ê9U8hQZÅ”j"4¡|v0Ôˆ˜¸2rïÂhlzKW`ÅaCb´Ÿ®7J» »a+ŒÖ‰9v2 c¬s†Jª:Î ®(´”° @ªÎ^êE e ÀÎQDr€r„¢/RÏ0áØÙ^i˜$õ\ ò BãD¦Ô«Á°†ŠÝTaÀ FÄM6XÛ@?A!©Æ´nK Ò5¥z'„÷lLż‰ÛïàJ¸¹«]É4Ìù™3ç+u1z:Pt½Ã>F¦Ns‘n”^ñ b›Ã»£mÙ /z¤r­#€,v¥°p)w„”•e……«é&£ ö±6Tº¯¸XÝ?u‡;¤9ÏFœ‡IIeíf¯tƒC·‰ŒUµ:°– LU¶½Í7U^`¯ôþv’Ë ¿¡Wù¹ôººÔ9Rã?ǃÎ@F{!@xQ&UE¤‡»t1,L|aG^Ɖô\Ð@#ŽwÖ+ ’$[$o+óJ +WÌÆÅ$Þض,‰™©Ë°‘Ÿ…+Tk$ðÄõ2rj4jL”ý?ÄZ¯ðH-à›Z«‡ ÕAêµâ¦ŽT :U¤.p¸­Pp 8Á(¸©°p=—1ÕÚ0<ã"%4RWêÕ%ò«°`|²DYD5d³ºÊgO›+þO·ž —j“Û íyˆµ½Êž"B(jtb.§TÕá¶PÊ53|é}^€QPÒÏ.ºÈ¥¡=d[ìuPžÖ¦BĪÃÒµ£âMA¹„}•’ètr¢‚?3I…ÆWBvY§ÓKåW‘¢évØx. Ñà'Ýõä`D„P(8ñ u€èOÆÃùY/¤ú0˜úh:Lï>€°‡~€Ã¸RU°!|$žGÊ̈hP&öI8˜TOš˜Kð¶ŠIá_µ=¯[ëmZr%Å °ùyŽóBÉhˆY¯‹b>›uP"BÉ&ˆyÖåf(t$#|&.ê¢9Ô)˾UEž$¹ÎŽ7Xƒ%3KwÇ—ajE¬’gjô±Ï•êbS)Ü«Cõ9FeÕe>QÁ_Êž{‡‘Õ V• ,ùŠ£.(8œ @D(D¨Ö¬q³5ÙT›zµÇ¸H8.t@.£cgÜA¾ËŠ²ÀárÈ "4(Uð´ÖYÁ¶ê…3£ºÍ[zçIÊx¿šiÉ,L9ÙœªÖR¥Nê=LºX²0ÔŒ½zóð¢:ûß`Í©W˜¨WäTÒm\ôx¤Ò±} KžV¢6ШæH{èwü0Ë )€÷Û >HÆÕS×¥ã¡Ì¶Icˆh ÏÈG–½óÆŽ9læmR”D†\ˆ þIw‘±¥q_#HltÿgȨFVUíEž‰Ÿ¨l;3@94àJšÁôjH\%ü¶UPØ4Xäzln=(Ö‰ê(èà#Ÿ®‹Ï'àßøײ@éâÅ 9"l,é5(ŽƒÆ?Ô5» >’à#¾ö†—|½š•Tb $ºÂ³BCéÁPh^TbÁŒ»Oˆß´ ,”¬WëÀ°œc6X¥d¦Ê&œÄG—ìˆv dÚÒÛ¾«"Â’×KN<£q&C/«½ž |ÒI«=Õ"C÷MD©ûê¥ó_›ÆsÂuJ“‚@¯yÑzÉL­³¼”É:´‡~š—‘`؆ïƒÆlj,Ø'wcfTâ?3 _úÊa¢ˆh@ÙØ^YÌ°ÚÔ›´0» Z”9R¾|0QìC¯Œ¤~ŸB8èA?J:ÏC3½y¶º-å Eɘ‹%T$ü¤g7E•bÅõÆ»‡pÔ£‚„ ]³ ¬'‚ÁZ†[V#„,«iæ@¨Eâ?¡Cw¹–œç¿Ðbµ9QŠÁrüÿP6©‘Àü tÇÏõØ@?ÂzX¦‹i ¢•Êc©\R–€>4$l]+ß$Å#JY²ÌAzÍS ªöÖXÁŽÀZ#u#@áá<\på¿(>´8P?`†êx61ø˘¶Ð`™óO ó¢2ðPÁ>VWyT%Ã!÷²„Å$°5Zïöè?= ç€çþf,Ø Ù¡wr 'ê+Kc`ŠÅi!Gu«&a¢ gXªC»¤yüx¿ l€újN”¾ý#g+ájÿ¤£½ÉÇ°¬ o²£ÁªrûPo2{ þ]@ôøíD„%ïçù hÈG=¬ªµ$‡fÆ´fÚ9T'‚Q“4¡ÌÝe Ìò:Ó ¸çõMø 9F…GîQz8ÀÕݽHE  ` Á8Ø æ6@8kÉxŠ’®Ú¦ÃC¡Æ*C+¯U§´hcnG÷Ò.¡»³€\ÎÄb-r ®BAëã²qfu<3Q± œñ¥¥jØ—G:>E(锹  I¹ß¦0k ºå4B ]#®’áiÀ³)ˆ˜4¡‘ò¸½çv’ʾ4Æ4Æù,- ãê\¨—»¤Wd€7^Ç<óžzƒµ[iËH®Uá`hwžÙQ¨ü®ë°>­úÉÖß}@U¥ç¬Tã‹ni k åaàpp¸¬†Šv´zšj¶¡úã±8¯ªri䈇 ¹ÎÇ0ôMæU,?{`u©Ô©ÁÉrbæ·¶ìÁÁTæ jEÂA_w©Œ  xg=èÀäp ãÏD*“Uiå` "ÂÀ1à8Šm †C‚ÃÁ`x á-ÁK° $&‡-`è°ñšÆšÊORoÕ©kœ°£Â‹ ôŠ+GL½$Þx¯ŠØÙQ5 …êZ¯Dœr­T>b‡z® ;˜H˜B¦­·jTn©šÉ0Êü(˜/¿Ú¬ õ PÜiáx ÇV¡ å„±eU±üµS/hGDi,™2ÍàCšTÈvv°’Žƒ-PÅ5ŠÈ…–¡{¾Eï6ðå\@¸ï©Ñ bt<`U7!KãKT°3aÇêeÆŸé€3 IDAT±0´LËÒ[a¶òú§ô¦Øf k³ƒ"ôþ:Ê=¡®p²P€0Q(.=Ÿ‹:z 1!^YW¡c>vN:Fê3´ Õ5†(Gè×yQm° JÝ ü>(&dbXÝ”õ™[ÜÚ²{ ,ø=Ô¹¨•ð)cÉÔƒiC2AÞºL}!(LKNÏH)Ö:… c8@ß¡ï"æ–1°ˆ@ã?Dä«Vø³( ¦K 6ˆÓ³ ¹Ò&Š/'N•ºªB•:%]Si¿® ›) X¦Ž EÓßÀBOä‰$¦ cÍ™“×3‡†ºE5úháÒ&Wù­«R¬M!k¨('!ŠH©¼­ë‰tÓʹŪõi”©­ˆ»P¤ð)à@ÆRd¤ãŒÍsò$t¨Žÿþ*p葘©6^ɾ§Fƒ ïÕÃA‰÷ˆÇÜ«XÐUÎDUú$²ó½‰fU‚GÍŽJùLÄBÂö ½ÎŽðrˆÇO–ÚQÉGéºP=^¿|†‰ðŠ±h¯ÃÅŒñ2åeüSyOø†®V3Å`U+ÄZ;ªß–©²1Ç“½ue÷@øغ‰ùˆþ• Õ6[Ep t€á-Bh·Íg2u<:âŸe±ì%‘¤¢e²¦ .Â:œÀp€M‡~‰mÆ‘G^çECj0%þL)ã_XŠ€ˆ@âaÂOv“«TÍ´2Ñ`ÝzÌ(ʯÒuö^åR ž¹±\"KQ”Àwáí!"¼ë© ¯Ÿb¨ši” IŽPl˜…£nÖÈ=WŸØv‡ñ£u©Ì¦›Ôúæ‰/‚jù>¨¯HÑuUâÂà—Š%öÝ$ìËÔ×LÕ¥Ë SyQY‘">Ëã9 „/$–>“ù$‰}"ôÝ›ˆÒ?íî©íé»Þå–ÈßÔ]¢‹à¥ã„À‘†1€$.Ôu¿^e {ü|óúhÒ5ñ¼…M©0KÊ«¶9ì;Ĥè™ÀQÆÂÃœ)ì"N!.G/)ržBÉ÷ÕÑ Y¹ÂIôùÊô,?:@Ì0à]úÊy³&@y9Á`i4Ñ}c-èE»zj{ÂÝ2Òk÷@ø>_½¤”F{áR&SòOá­6F¹Äa€#"T'»©¢q'>ÑŒÆÀ”ÃZDÁ-‡­› „ƒÀŽE=LCH”PåpËa=ÁE ce ØF¢C „b³ö»Ju\í@Ñw²ÇšdäÀu>†¾áŠ`–ì!"üêYpÁ© ã£dÝBjJ¯Hé•·äÕhÔŽËø((ƒíp2D"qe00Ôc„xà ÐàJ@ê2Lœo¤Vè•+V@ÚQ2 r¨·Cš0ÆDz’ƪQ*á³Xª= KI•· +ÂÊlóß# cÐäH/¡+g<µÝS£þg`ÖØm·šüWøùR‰*:ß¿² ›5)“)ëÎMÎQÊDŠ™qN©¶“q@ö€Ež-`8ƒð(pf0ÒÁ߀¨X”"é`)º(’ˆ«FW]Ÿs02äÎR3ÎÛÊÞäÄY>H¢ŒÓeýô#ü§Ô…äðÏãž )Ð=c盵 ¼ÒÀîw„:AhTiC©ŠHµç^ò‹Z"$\UÍèˆ0`aø*kÊUÝÍQûWz5d8äaŒüeDÁÍ›[CGáQxx©‹,!%$@‡ BJp„’Gk¶^kà= Áy”Ä™Eš ¦ìƒ¥\¤UªîóÂÀŒ_áxf¨@b#æ¬Í³SÏ‚Õ B­WA´^‘ ààq§eGœ«ÁØE ›"—éâE²ã#ˆÇöü‡ÕH¤”9üHÍd²Å•ÉǹkŇ‘C8"ØàTÈÉ$Ï,cª+<ú`ƒ3EXåd%ŠVa5ˆ+Ž×ÅéÌbDìc¡ ç,Y•o‹q y±ÔÔÈI²ï©Q('u1Ò+Ê©@¦”’M‡JÂU2óaë‚?%Y& |p¶&»¥6X \Wu;ÌìèQà\à(Jg°>÷¬6œpÉ"¸$KXî¡cѶêdy¤Æ\‘îÓr„…Â?Y þØPU9JH݇+4gÕtܬ…ZŸ]Þw¨QÇ»Ž…ÕNW©,Z\,L¦*R…a}Kegƒ…O ¦¥Á"òŠ×V¨—6-Œ<ú>f·<6¶¶<£ÐcÍÇ\`€ÀÔ#£x¼;õ¢Â!DõˆÃÀxx‚ñ°Æö'ÀÃ0!@´œªÅN8å”J«°åP½µ‰ d&¢jÆYÈ™²p €êpHÊ9ÐE˜†Í¤ ñ6˜ïÕt}¥ÆBC=«ß¸H™eìn¡9-!á¥Rf 8Ž­!6¶]•? (˜d„ŒÐõènÃæü.P½à Áp(A‰Æ¿‚mN‡ÁRgâÙ©"Äk¨ì±J¤¦A†' àg8:TKio/U£¹ªÙâT²0á' Y×*ÃZ(Ø’ªŒ—9?Ä¢®«DµŠ.çÿ–x €…!.LonnÖ€->rÂÅÒ¬†È–a³Š©4À€ÂB©³l“Æ/±_G0aë-›(M`õኸß@ÕF kÕÁ¬²€3äØ.žð­#»BÍSM{ÞÄ—,ì±ä äF¤²7c] íFýA¤ÂOäœl|JšþÈüC‡‘ÃÀaËa³Ä†Ã†Ã¦Ãv(–áÑÈŠ(¨kåsÜ2Ãg¢GN€õ(‘;5ÖÃl2A*CÔŽçäå?Ö_R¼†ÐüÃ$H¨Š§¦U•€ˆPªÌŽze•ïUVyç©$Œøø¤}%lÂZˆ½'ä׉ˆÈ¥4.¸,$Ní­­Hn p¼ÄZ‰M‡‘Gá#Óž:=ƒžAIp@o„„êê%Ö¥Ã.?êlŠU.½^JÅÃjTë•yxæ<`ùå!˜Ô%aR'cáÏb߀ÃÙOmßG„Fù¯¦‡PÞ{É›%@áà e·õR²t9Œ.GÈ)±1É£_,ÃA@‡ûÎ/rP˜¾ | ¸8ÆóÕÛH.F:uY¯»ˆÅN¥P^.«¬²ÐœJ`æ S2Ý8äI=”ð ŠÈØ{VJª8^îËìò¾6(áEE4É^*ûU6ôxÊԭΘtÕ«a".–0œmIé•ÐMgñùø"v“y <¶=¶ÖÖ¶=†>  G‡ÐSx$¦&ä µ%çjÀÂÃR(\Œ*"ž¦Cäé„/µ¢te•ãšº›:ª÷¾‚!YĹÉùÚè>¡õÊÔyQ¨ö`C¤Ú¯ŒÞXG^¬y˜{ÁÀ7¦ë“ÉÜeª[¡Fep I %PSÈép€u‡c%Ž•Ø(1pp@BÈ=ƒEyÈ„H l’ä€U~ȃ5 [W™TF;­!âÕËpµ„ ´xo@²ã6ñŽdFª0e£!x£F_›÷©íûîF½#ÇR8*&|g,¸>1g#&_E)6ò%x(¨JJA¼á-$>X¸Ç€¯_n6˜E_à9WEdçI‚ÌViMý Æ&Q×!áC¡¼î u'}Ýã*€<º‡‚¥²YºP¼þr€ð‰ï’jË1ÿ]î+” Q*J'I˜Õ“ábrõ0KHs sFÎà×VóT™h“FÄ’w–4é†ÃšÇ†GßÇ T ÐŨN°Ðy€â4a1aäJPLZŒVz%Š¡ö±Ç`Hyp:ð²û:ä[2T=zĵr@Ó„)ð]s"ÜÒ.Ÿò©—KþjL¯ÄžH& úæò§…'‚ÂÆìí–giWp8aV÷Ò(Y¤ OKrH90ÂÐaÓáD‰cŽØö  CX²ññ&„ÜG~#ñHÒ’+ í#ª´‚Сž/Ö)&T“&H“«¨Eœ&˜HØ ‡É\R P£Ì—‘>Œ>:×SÛ÷ែü0#BQ7y^¡ MZxøBÝm Ç™RI¬É"í™” @ï(’¥ˆO3⹯g,\ Ðc X« (`l)(õ»¬5¦N(ˆg®{u X¹$ѨAð^yÌü8³žYý4Þ–ô¼yžÚAèGø¿Ôļc„[U¨-·çl³ €,l¦ê®F\’,U=.‡ _³†ÒQ0ç´qΟCÅSfoGc„ó(= °íqÜa H%Äa,\ð1ɧwn¸Ç1Ú£ø“cD”ŽÝOãÒH\5ñÓ-Ðç¬tx;,ß®ÊǬò”Æûú-žÝ}'Ù÷¹¼_MÌÄÖÝGíoK"T„ x2Ι‡6t /aK”z–¾…ƒ-(áéú’P$©qQOrëAhe^ªU äC7–X/Ñ!¬Úv€Òs+zÕ¨ÓBª%™1t—:©È²WìÿH9ì½Ôaó”ðK8Mb«ßïZ¬”Ç̶€›€kàlvÞ—ƒõÅx@…œ7¨ò b”r6VI¬„ µüÿ¤Tޫͺ\HQÄ Õœ÷ÎØçRK4Þÿ zÎÎOí D„ò¾Yõ&'u«$"ùdÃ)È )G{=îëÒã|a«€Í0É[Ûp2«® ëÖW: OUÒå83%0eìhx˜˜ðDWqŠ g° LuŠ½¿!(´b,ªÑ«Èƒ%@–PràF{LG É7’ꪓs§CÑŸ\DyWBYˆ©‚¥ÙrÊç÷Úµˆ^—Óñ`ø“”j8cU³ñD &¾@’ ("ìå%¬ó¦ ¤€ a¥äÏÐ ü„t•*Q Çipô#ŒiIËVÉ–@¬„qR(7¡P¥j'……_µUp(›ÉîI< Êá­ªq@ 2žG˜ó27Ì=·^í¦AÑžÚ2‰¢i (ã±¥@éá¤;€$,FŠ¶ ¡Øè©óC 7È2†=¡¸ºªM6`ó§ç…ËŸ‚Žà”À6Ðc† eÎU:k)­ÑiwAÇ\ÝIÖ ¸$SXŒé©W°3›7Œ›y_óÜë«Í–ã»ÚúÖ½Ë$|{ôNLB…H"\ƒDºS-00-°+•*Â|,ý>¶dò=Nß'È4v#ÑNd£X³×#t]Â"a…à‹€º„¡‹¸Y‚؃ÐrzO†Co‡Wƒ*˜ âÚ1±”4Œ)“JÖ¡‘ª»ÍnÒ­¨ ¯KR=²Ôg&¾PÁ_ÎÅC^©“|*ušÛ\ lƒ;W‰:éÎ$¥ñÜ ÐÉDíºÒ¢´Hr¤‰/rJSä’ÒYŠ =´Í÷ °x åbÑ0顨„áx¾‡ÕfÆ)PlðÀÓL¿¤ ­ÒGÏth®®ÕòJ‡Àr3 ÖÜXx¨Ñ_ x‹{£ú[m9HÒÑÓyèªJar`X¶<–Ö±¼Ÿ`õa8,w‘„ºãu`ØŒëf ëÕ€j‚|Ë\5 SŠˆ€0| ˜2ŽçHèV/"ÚVr£Ôy$l⃒F½™6yÚ…›^iõsrX»BzÝ®w¹Eò€÷ò-›éci½2윀Pf QœlªÚHAÇ2G– È‘¦aÏ¢´p)ò²!:)ŠFCt:Ñé£×éŒÌ‚ǰŸʬV‰%‡d =Â!‹¾‹'8†Ì G14L3f@REÉ2‰r¿ƒØ1•h¬HÀ'}hŒ‚ÀRÕë‰Ô¾N½Å¡Øñî³ì¾j”°ë]n‰üÀÓùJËY.–Ü¡ör©K2u8”4­&Ì;ܽ!T8d„Õ%`›•&Œzµ lr§ÁõMlœ€S/n€.`pÆ@,gsÕ(˜Šèª1¹—Ê…j”I=3¦„"Š!qyuáyo‘Œ—ÑGS¥³ú ù<k¾±Öö„Ÿ›—ÍŸ,»Â×ùXiÄŒ•è–Š\@½ëŸN`„*ë1þ-ÖPÆ¥=Ä|Äh€íM”a Ñ®ÂcÀ¢ÁÙ‡€p&0âÖ†@Ž…~³ª™îz}û‚½½€v#_&½ìyÄí0û„¥êÜk *( ý"WG€€õ „ºÞ,œS1ÝF©÷8Ÿ¿Xf÷¹ÿ| —ïzÇ=Ê;}Íîë•6Q ‘˯;Q‘& ø©ô‹7(jà,2‹rˆŽñ.¡BÁÅyŠNŠ¼^˜‰iÛ,,­nÑ~$OJ:*$èùë8<Œ^W8)Ѩ$åÜd‹:ʯN•ÕYvÇƦâvΉ*'J‘4)&Ý?¦è•aÇÁÎY,ãwºs¯]ï¸7¹ >ç~¨n¤Í.vêõL!*†Šø×çÝ{AFÙdPì=ƒl‰ƒÇmî(€u¦Çèn^`uÀhGïŒäp\ ±fk»±ï¡ë``j¨ÃA 5$“òäDµµLŽT‰œ­pR_lý8“DßàääË\àà«{…ÃÝ¡Syg¨Ôs¨I^W4‰Š¿ÃdöÔû-åÉú%0eÇMÁztÙ°HÊf©‹Å# @…l¿ÚˆðÖuXäɘJD¦TFò2,–Ì8žkBJiöjwÅsÏ 64(yðð°ÿñÒ}ÀÊ;vÕÅG§î9»aù¬©&ûŸ öI4Ä(óS¼Žºvé{ýS&6§ÔªÃ\\¤NÒÀ%T }'DFµ-óקÈãèÛé¨s(§> o VãNdôi½môúìÎAYÉT… ™b”t,ˆI),aAŠzœGlç 3.±ŒH½äU:MBaÉÍ#´ï©QñÂÝ’ºn1Zš_5 ·¢ïQê‘ž,ï&¨¥?SU(žï‘%XšH@j[<þ>7`Kg‡§ OXœq+G‘`‚M#ÀÂ'ðj†C¡C‡Šm”È ÉU<—pcPII^y^ ¡ÍP]™>øøõpÜ`Ñ®°æ P£%;ª’\ö|¤\ýTröU£Z4óP‚dQÑòŽmž¤a¼!PzŒÖ°Þe—ºS¯Á:]í©”äÂèC‡°à0pØæ) ½¯Þ™>‘Yyy$nB¬;Eý ä¤Ã;¢»R„m¤"ø,Å)@'äSe µ}”Å>[ÉoL>m´†ìÿªQ±æáÀ뎭«cê™B‚'[$ª“x-ÊЂž}),2ÐhØ,AAð´°ž¹‚HuQO™ªZáiO‚­Ó«9ÏT9Ò©²žb+´!ôó g.-ºþª~MúØ4Ī#ëd,䉫1€³ŸÚ¾w°ä¤\¡QKiÙÐ¥•¾¾è;”ƒºS™éZÞL: ¼dÀJ`reÓ$ä·o|}©!òŒ&7«Àa —¡›ÅÃûz'ÆA½ã†.6@]#,Eç u)©RR°u©¸·!¹:r ÔíWÝ`Õ‚ÏÙ s@†X#å†_»c+Ö°ïAõ¤Ÿ¯WV¬Ú2E²¬Œœ”;Iš¶È!üØ0Üu0Q|’!œ$¯G-´œ•Y]ÁêÍXÜÄ ÄÐÅ^öÂ[1öP›­ˆ@¨Å+¨ ÚI*ð“Uø8¨)i#‚Iù3•3PÞ¥¼c¤TËÄh4P¸ï VS¯P׫q›LJÙÜ$Å’Üç õ°)„ªHļõ%E/Ç @ê~Á½ñD+Ëë$'Ÿ€d\¬ežùKfbjd|möt ¡ñOÄ«‚?_¥?«{®zħá|x3qø-xÃÖŽCmGFÏÎ!ãìèYg˾Y¦ÁXU¿æ&šSiª»  bºFkÕ9V£~J„ñ¶X^‰5óÊÆSØÄ ×a}ló8ÛÇÔ ½¡Æ&©_Q®(ð‚¿ u2îérËCe|½?ãzö‚|”×KBL¡ç•K&L½FÁDµ§˜O¯<çÙl’lím·=UêøYÀ¦;T!4ìÔ9RAÄ°}'Aºªâð:X?ÅI¦>ÜØÒ,‰a$Üñºò´;\¨µ¬GœÀÒ:–6QQx”n¼7mÇi¾nV}%–™úÒQæòßn¹\ð\~¬ž=.Ç·Y"ó\­ƒ”š0úü‡bÀG'e4ˆŸ©öÞRŠÅ3xt«0#eæjX¸ Ç×±:Q¬rIà?a™§^Ûn¯z´‹@ =Ÿq¤0äù³ !*Í™æaLúªcÀõE¬WH9>f°ª|€Y&ò2ßfãò­½í¶{ |±Ø?‹Sª¬¡Äˆ%UŽ¼.º+•OâSdሢ8>Ï„maXI6q}‰ ±%‡GÁ³€s»°Ü¡0Ö&¯1nr ×Í–S>•–†µ”S™”ðÒ<Žâf=Hx\·4\Ú1è˜.kw@kÂÆ`«âE¥@okã¬^å±5Ït”û7{€ù†A*ž–.Ë’Ð0QFÓN®Ò+çí(%O$?›9@ø9o–2]_@‹Ð¹>t1!Rg¡·½ÐíÛ¾ #;ø>° ²óœ×GØhèUÃ#Ô—à u?<ãl…JÑX±Dz©éÁ%ø ¤)‡%Å+ðÓÃËyЇü#晘w0}‚öYrŠ€ð¥ð¨wÈ™ 5Š ÍUˆn˜'v3X¢>»Ç}‡Q_Ñ‚P±{ЬRám©0²Ê +g‚Åvsb¿›G8v=N܈­øåØ?¢2©:±FØNjEâRÙR´ Q¥ï=̧’1*j¶±5ÉD†4‘ "ŽsYƒÀL­kûeá_tgNÌ{ê=÷=Q£²Ÿ«?‡’± :4ôu䃪zpJ“œA÷?5ñ),ï,Ï1’>®ÿ:N„Žö}†¶04Ã:°fpÎ!YŽ1ï¾ÁÓÈ…Ç>RŽgÓÕA Q†M€¢äUΚ $$yœõ"B`àN ऄŽ-°§']³¥‹­¶bvù»Ñý/’Š•úÚÙ²ÿ‹eôeŒë•ÔwˆË%¡!-!TBÆ+ÕbòN'P žÍ=óVÆ‘ñž™²t-‚Ò×~ˆn½l/Ðvo¡ß]dG Ú® ø|Œ@%'rÅbêê¯Zä³ÐF“¿æuBJ§†ÀoC‡ãÂþ äm$sƒ§@¹±aô“#u°%däU#ΦFû{â2' IDATOž¢ÁC9Bq?¤r²àNâz%QÝèsFDË Ð÷èx _1kb@ï£3x’¾%8|&)õ[¨zBàs 8á°~'°a1C¤œ) ˆ¤ã5øAÅ‚)›Q]Óš)8ÌØÒ$¼WÎ<O»Éõ;2üMÀÈ ”¯£N0U|— ç)ÂÂá[ðÌ÷"{B!¾…¿ãåX•ÄÏm‚ŽÂOg #•º‚$­caÃã |PZ`áFÜ0DÞWÏ,ä™onÎ68ë ¬†YSϳÏÏ0,#Ž Už §$_K¥è‚…#µ2† éiŸÃ»*¤ )sÊXó êQ&Ôøpñ*»¬ZÁ'¸õÃØä³eÿS£R©Ó` ½*S®s„–?Ã6)ÿ”ªmàg—Ä)|… ¡^ŽaÖƒ $ŽLá“‚’I©Á0ÖÌÝ>ú Ø¢³…ú] :vØYfKyâr“ƒ† ½J „ÚS95ÔÞ×MgQB‰sõNm‹Ð 3 ßSuÕ= ‹2!=’\ ›#)xümµ@òÚ{×X[¶¬<웪µÖÞçuo?À hŒ…Ø'–ŒF …·Á?°8‰CüJ‚ò°Cœ¨m¢B„òGØ‘CÚ1Q°A–eŒ! #dH ‰mh &˜î{ï9{Ÿ½Öªª9g~Ì9F}³j½ö>Þ§ï*Õž«VíµjUšßø¾1æ¬þ„ÎááK2þ Vb'ekš¼õnJ 5Ÿëd¥Æ¦Ã ×ë\Cy‘§¸{‰ÒQ(“ztçLäsþæM ­ð¦vXOŸâéSl€µEï‘xªå8RÍ™ËZ–ÚNùI¡4»›*¢Ôq>•îs h¨ÃZUÖ¸-9èÇíÆÒè íú@8é°"ÕÎ8Ùî<|Â;駂T,i Ô×n€Å ‹…@`N߶\¨˜p¬žà7žâq~Zø¢€~X– ¼Ëâ¯áµ×Ðn`ò¼~ä©ZƒÌ<¯¯ã8Å?îŒúZÛ¦na†üX9uF\oŽˆŠ‹¿Z -°±Pî«Âýfï¥"{å€P{)ö+mÄ™_9q¶† …ExYBÓ„Öe—åÁIž¬L=jü?$ß™¦C“gœÉp¸Á2/W8[b³ÂfÍ]‹mkºÖuë›eï1¸\Œ&Ì„äE‚½ˆD,Ðr3.“ç-¬áQGµÃY­L·ƒªÐÚ¾€Ü8¥ªÎ¶øpBç°=©SûhšŽ£×ð‚pAÒ8½@Å ë Q˜ŽŠ-µáuÀöJ®]Gë-]è =Œ.ùÖ}´ÀƒC«ºÐCYÞ¼¼CÐçR¤®5°‰Øtè»Òmå¢i"2þ±"ª@¨\P·³Ö¥K[KÀ­gVG/€GÖ²î¶x¤÷¢†Ã£vû¥Ñï¨óQÿn¤WR khd.jCá@©¿|‰£Åâ5Ø OOàw.¡o¦î|ø×ñÆ<ÍqÔ‡×ß~ ø8à5Y^_âÁ΂Pª ö{qÞàýµèf+u;œ"â’¬FŽV°p%p¸,\Éï˸¸V|Qs¯€Ï<±FFlsýš†Õ5¿âYíOÔß÷ ¨I¡º“ ¤¬”Æ y·A ½íÚEp^ódŠ<Ýv‡¶7ÍžwtƒåÛÖ lÏpµÀvíÛÛÝÛ}‹®Aï14¦w.z×»¶ L´)ZD—gê'!Ô(ÂE CÒí‘Â@ñ"×vqè¢(R)?’¥Ùaæ‚[,ô×)à)þúB±áï2?sÝyûuIÒû‘@EW@‘ÅR•LóIÍåJ:¯ ÷phÖ z¥råÉjäÓåŠ&Ø~ÍàÁ9žÁ>žÈ4Ûoªù”rsÂÄʺhC¨RÊè-’Bà’ºŸ5”&*4Bd4[Ë?%½4aAÖ=Ú„&/Ïуù÷¯yÝn0'äw_û_ø¿SÚYg´gocðoæ™&…_/kæ•ÜêM\Õ¦÷0Ç ã¬T ö ðx¸Ö—ç§}xSYýð›×jü{ x]dÒÚœ˜;KXD˜®®‚bž7P›+UxkGu­Yœ1I(¿±©çÅQ:¸$|×IÏ°õ£(¯YkÕèÿ˜ÁëhŒù§×¸È•ýs?ùy™1ïOUê˜W¯µ@½ë7ó·ÜNíô l l2˜é²Ä¦¬ÓveÖycÑBi7]Zô-¶yV6!¯uzša©â© 3mJm×Þ—gêóxy :h™G;­k¼»\ẆÖM•wu‡5éªz‹Ä½¬' Ô›”‹à>Oyìèa)T_‘ºuFbïäišGla¾ø°_!]8õŸÿó›ùÕM¥Ñ@£ œ¤…Un`F¨U/V’ÑzÊሽpD?ƒ–òˆAƒåC´ç0ù!…+rŸsß ¼sƒßø5¼ù\=’©¯¯÷€GÀkÒ(*ç÷V8_µÛÇ’êQž¤2¿ù.¢™D]&Ô[V3çY"­Ð¹*&¼’öV2GíåÏÔpmÓ³¤~ÅU}ˆ ÖöEÙ>ÁBõ«A¡FøƒÔ^6ùª™¾] ­—gP¸L˜¤"f‘çÝÞ`¹0Û –«´^`»1K%‚ á‚-º%6ÃB€P±°AoóÚcP,T8t&x7X]<—"sA3ႃ¤Ù¯ãÓÔ¨¿Àà-ÃÛDlÔÄa„ýØF52dK.ws„ˆ^ð¯!^˜j±´§wñ¬ž2m¹êrÝaÓ hä±xK`KÃL¯¤á¾¬KgôØâþ9îŸcñNÉiCp] YºV¤îwöSý›5 sˆN؇&œxÔX ^¨9ŸKøÇ=׊‚úéÓ¦dQð=j·_U‡Òs¤1P²0P;Ro¥—“P$ÈEÈžØIø’FŒ/òÚcñ‹<¨æ©<†ä!p¼ <e Þ¼Ùá͆·~o=@8:ø@dxzXS!ógZ¶iq¶Âb…3`‘Ðd¾Ø‘ƒmjÖ¨®ÂI­ › ¤\°µ”J+ò¨¸ÀÚ.¨õ= ‡Ú>j¿~íËüÒ-PcâW,êFõ+õ1E>u3'®è©'k  Gê]߸¡mãóìÛ-ºm^g,lÑo°Y›ÕÛEÚ.±]˜ÍGŸ)c–Có»™*5ÔµGpt^7EG‡àÍàý`}ô Yd¦aÔ¯Ti0u(ЃÍO.ض³ ¬;¨D<œÐ9\Ýúõù7$ªˆqtSFAÁ(… NåsÁ?…ÉAÔÑ^²§±kQ¯ÖÀf‹m'‰µ•À¡V´¯d†KyŒÎ[Ò•Áó V¯ãÞkh»Z]‹¨º®«qz*ùëêFG=ƒeÐttXI(哦a|„IÓø]1¯©ƒw†Ã–’…“Þí¨½ì2÷gÂ@,ZÐhüeŸbvÕÝ5)È*V#(ÈëÄ-e¼Ãâu´aI4õXŠ¬´\æ-à27ÞxŒ§ñæ¯ãâ 1ë¢øÏÔXœ9¬VX®°n¨mžØ” Ï¦²žFî BDõ«%°@ï*T+E×T²uù±Ç ¹“6 a¡Ž‘uMxa¨Á×XØHG£žÒÂví²oÛ­Y,°Í@˜3‚9í·Äb­Ç°4Yí<úeÚ,ÌV!0K¬ut„Üž¡cõÒ!X½¼Êü¨)š˜L¬•Œ¢q´Èu@4öÃïÄ9.“Ñ…÷CXYXÈÝ¿ u~LýèÖl6ˆù>“x]çÀEÎÊÈü|ª Þã¶ÁÙ÷X½Ž¶ƒÙnh½Œ^ ÈéÒÍÐQÛªn•ª÷ˆ!" ˆ@ØŽçÏÕÓ7p‡¥$OËa3þ§õq§,Ü~FÈ·ßdš ½qò§N²†öºÿtÝËxá^Û °,ìäº/€¥ÃÙ},îÃdUý-àyô ð¦dŸJñx+àâo]àx|†ôHÀO5RÈw V4ù{XXœ·hÛRÃj'ymL*e&ê¨j¤2L~uã¢-±c'9õ­ nå›àJö9j¯¢ðò«I¾£.MNò…Zè¤\9oÉaÖV¢+íÔØaÙm»±}Nøm°jÑ5è6Xf¨»ÂÙÝ›ý”¼ dG\ SlÐ; ¡AïÑ{iëF‹Ð`pšB {‡èÑû’Yì]Î&šè\€K HN‚¬ ˜©†Íë&Àhò”¶/#6òH ÝSöoN™bíö¡§†VÚj5•D„Dø½´y+R¶lR-× ì-¥ëÚRî0oÜl±Þ¢",ÇGåÌÚ}*¸O3ŠÍ—-î·X>À2Á^®…ç©XÚÑ!¬kít °ÔÁ=ýšÃA¬;¬q«òEVº& :·ÿ²€¯•Žj"*+/̱“‘°}={ 2Ü ½  ®=M«ÏöÓ¼e…Õ þ°OÇ¢>¼ \ÖˆÈíÇWxr…§OZtÙÓ^# äB¨s*T=#t,yáç-šs,Ü@–.‘Òl®¦/Š… DÞà)З‚‚Û:öÓº±Üø‹§Õv¾yíËüÒíÛ |ù×q3A äWš/hü×µÝ×n¶•ZÀV@±‘- BÛ¬ÍÆ/½-U Lû4Èë]›º}kFlk8ÔÚ™¦Àá9¢’Eå‚šSœ?CŸ°h(^Ð)³uâlæ…2vÞ*çã57rû›Ì÷žrÑnÿ8¯†ðב@Š{6k¸¤ÝSݱ&7 ¢¦E™¢ŽraÃ%ïÇš–ˆõcl#MЯö¸²fRksN]Ï™ÁêËsÜKð=Uêl©«Ð ž‹WÂÂ~&a…=jƒÛÑa•ƒ‚œþ7,A óÞÓ®ÛíGø•2–Zö&žKg(B=Êp ®J+K=1H戨dªENznU/]:,`ñMs%ñiM s Ö[ºN¸ÜâñoàòW±~€Èé=Åsá…ç2Ò‚fF;–mƒUƒåZÀE˜“$¯3©c"R˜Ü8wh/5Ê[™+Nryõú+஀ÿþ>oFßüÑ÷ý7|ûßú'Ûw~î7}÷¾ó«>ùÆsNŠé85õ}iêív×ZAÑwœÈ¤Ž‚yÁBWÏ •õÒÖöÍ¢o¶ Î ¹(&cØ›~èÙžeRÅ<‚"륾†C^FÄQ&Etˆv|8F4µc)&á…‘&ÔÎ@¨cE'¸˜·ÿWé hþó‡/Úóf„Ï߯þçÙì›ÙÅtë°k ©$û¸`$Q|›jÕ”‹R¹=™…©p¹Þb½Eg¨>|E㦖5A<«G/EP]+ƒ{-V-VÐFج*®…kŽ¨DP+ýßãñkìš}-gMehï̃—Hÿ°„ùÄc×íù2Âã~õlÒ(oÑ~˜}°ÖäšYØŽ]@¨…¦’ö/=—¯á°­Ouaä ±x€ö7WB /%¨|qÅÇxë1.«†sª¦ÑЖ„‘g“T"iá °²p дñA銞fÝÒÛ©£í)ÅlWµä²žÉ§L·þœ‹e.ôßûêÿÒÿ¹ŸºüúwýôŸß—}Íó¹÷ßzOsüÿÙQ¿š”:@üÇÊX u0Å?Ø3a‡–†F3.6µ§Ñp‹Ø¸Øº¾mŸ6É›! ¤D‡ U5ÿvÖ‘Öªi˜—˜râÇ]ðSå49aB y¢pD4c!ÄŒ<±¬?zÑžs±Ì ð«ùoÈÞ‘$€WšØÔ@IÍi‰+õÔà¡.«ºfœ•G¦`%¢MX¯±^£{³®¯¼OÉ¡÷ŠÞâFùG‹Õ«%VÑFBÞÉàe=a¡Ž¯ˆô3ÁgQE<¥/º¬j\ô4Pi>dñá¹N±v‚_=C±ÌÜ,5´cvh õË=A£¥îÉÓ4AJÇ•,6ÔU53D\,÷±¸&Âmù”,>‘¹dóÜk*Ÿ^nq¹Å[oàiƒîŒ&=§ ÷9å¹RjIòm#LCAŸ-R Ææ;‘ü×äª]×)n>9«Ÿý«?Ô~Ý_ÿšO?oðü?ú=ÿõŸýÁ_ù–o}Ïõ}‰m„jL Ù¯B=ЂÇó@ÜIcÙÉÐCKnÆd±©opž„£ZƒÆ m;´-|t6á1'%GØ w,Œp‘¶ÞìÀ†êKs²p^8“I¡@´ãã+K@‚M@„p±"ˆeÞT¥‰º%—#"ºðÒs„/¯À(k¤4TE=CQ’žOÓ}>¨¸”‡/èØ…IíJ!n ›5Ökl bS kÙ9gR¨@8RFƒ•ÃÙ=,ïaa65AÜì:®&…Å›ðBGˆÈC›ú¶aO×GíyJ£§øÕ€p>`q.͹ú-'m]ÐÕý”â"j,äÈ]/Á‚$ÓÉx|.kZ­Åê ‹3œ½&O°ö&MJ:¥†ôòI'ñô1.6g³É±ÏY¨§m„êb¤Lª©ÏS’Ì|'ëHtu´\ÉÆ5mT™ÿ¨=W LWúÙ·>þ›óÌù{ÞûÎ_ûÉ_Þà=Ïö„‹¹ƒ]~eë·xô½òÂ~AD „óˆ,™6„yº©GP´¡±¡m6Ë3kUíE>媙± ÔÙ!•©gædQª‹2)T ÌÔ€õYú¬ÝÜÖ+¥šDd^8T^´ç „/įtpüÖ$¼×{ŠgeC ‡Cýr¢-5¼èpwE.»Ì;l:¬‹pª¥ ÷k ¼_ä}ÙíŒêV™&žay†e‚ëjj8é?xžeý˜Ý“ZÒÈùkêa~ÏÝÂoùƒÁ‰Ús”FOò«ëáß2ðEÇFïO|&D–º3_ï0ሾÞM¹ÏÏ?³CMÓ6šÇK,–8{Í @8©¬ySø¨Žú$Oz{'¸tØÜ'dTvØPí”zVËN\ ÈyêS }]néݸ~âyËüßÇ?0n/6XÜ[(Z>h¶×óøñšö]þgð+®¯qucGtÒžÄ[–Ì“¿‘X:Ê<-bã·­ß.—ÆÇŒˆZM3e?꨹ &õ-:o†qV6ÁÅŒ|“da5Í~,Ô' +æöD)à¢nàÿ¬ùöS.ÚéÅ2Þü‡Çvy!~õûaüÈŽ «²|cêNž^ò> ­ûG¤­QÙá¶^w¢îlI¾\'\®±^ccšYÉÌ=BÇ{õFÆBí’Î – ,X=€UÔ =œž°•°ê©œ§¦î‘'Š ¿µ„9 qº“sË£ÖI~u} ü ˜éq“¡rs³{´mݘà¢RÆå¦ZïàkF¶$\ÌyÄ3ƒEƒÕ;°zÚA¤Ñ'"–>–<â“ZP-ˆ˜9¢Çv…ÄE4+>ªuĹ۴µ@:×H;9…a¨•ÒŽn§Žàð·%tÀ/>¿b™¯{ŒÿoÇ'ÛŃ•Ù^nËü×Û‹¾}°<ÎŽØ7'`Fo'ñèÜÂì].±±³Æ9o=¡‰,E4uÈËyÄ°4©qÝÂu‹¥iB†:¦‰ºŒ©D#e¥©Ï/™r »g4"Îy¡ä šy) W™êúÛÒ·¸÷›o;|ÑNg„*ý~ùæÏÌvy!~õcH˜ù߃;%ùfönÆÂükµ \wXïÜ!"âWÏ î‹Õ${Æc£6÷Ps‹]©D@NTnp‚Îë$mõ|K-böX¼çï€ïe¶Ò+zH@¨¸˜ P/<½Àåž6è5)œH£­H£*î´|/%A»$·J? Wv5kWiô…øKN;Ï):ÝüS)UÝ6Ô"ê{jLF"Îúiq¸Ž^[l¶¸|iA•¥“qJ Ïgõ¨+ Õ[`é±ôhÏÑ$˜f~\|ø‡O­ª\Ù!55É!Ú)áÕT“©½â…]…šRJŸ  \n±ÞâÊRŽã+YÔÇó<©s‡+òÒX´-Úh¬æ7'ƒëS`žî%f*My+îDÚÒ^,œ„Ï5r?ůnÄAeUjûÂùgù'Èá<74rW´ñ¢H. —éDjKr°²8¿óûp[à-BÄ ’L/iVø§úÄ戫56k¬m‹ØÖÔÐ (šýÁi6½‘ U& BÃHu„æa»q9ò ÄÙ¿ðŸ|àOÿ‘¯ù¬³?rõè3ÿð_üþoýôgFX ïb,ÜçWÏøìW÷òfšÊÁóB7ÓHu&Å ¹ÜôËE¿Z¬ÝКŽÆ VOnª‘I}*îLš2µd çE¤j¬”‚x!Ä—¤¾æ¥3ÂâW¹ÿ`i ´eŽ‚§åÜ÷Ú0{©þ›]X©—¬èøµL¯¨ÏN½ gÎ\D\=Áå„Ç2 Í=šæŒ¨!Vd^¨XØ*a0ðÞ£YJÅ~>êpè¼$9‹Á–ßÆ“Ô…Y¾ôD8]=ÅNð«ë?†éseÿ ó›wÅû:çëRÆÆÑý¤P]dt5#lÅxRѳ]/—Àr 4ó·Ä/eÆ¥Ì3Ÿ¾3ض$Š²FzàïêF^ëÄùe*”Ä Ìãc59qB‡ù?ÿƒ—ô¦¯ßãWaöíãfÏö["¿2°I*QMUnà é¦æ…šÖî†_ÊÌ‹fQ2ˆ{fëÞrá¨ÖËø4x ÖDf‡!JéN›`á ¿×|Óa¿ú×Ónv¢ÿGó•/ǯ>(‘ÁDxšëP “Š76®¿Ô!<€j j¸M­Ž>•"…Mýp&~bSß ;ä?QEßd¸EC2©÷B¸,5åÛi“‘‡Œö‘¨±òÌ÷Âc ~ð¦¾ñ¥×C4µë3Ÿ4ð9izmAá|¢·â,̟Ȫi¦†¥z·SLKçu «£¯<Î߉öìCÂÇ4ôâµ )¤i±ËhÖ„ÍÝv”3ƒCT]ôFâÞC9‹¶y8˜œv‚^ölî׶¿bàkbš9vùU¶}[öùÕ¡€ÔL_NØaq­gÐ&83—â!‘Ϋªr!-ÜvµêšEgÛÌ ·X(GÌíÉÔ3 zgh®™4XÄ ŠYåLá,L°¢yš(D¥ ÆF˜”L‚ùoí=pšÔnÿ\£¿ À?F²µ@jê—síÔͶìÓWí®‡ÓŠºÎJÏšÔщ(z!¤P“4 ;\tØæøülÖÉ|ß“ò®ŸhˆNFFè¤p¡j$I5Õ?2Ÿwå~¾Œð»>~¦L±Æêqª{Ÿ(í æEjOf: »°3~Â2wŽ<Ók¦4Š…\)3)µº’éáÏÈ–Ò>ó8{ ‹‡0Oh†¦†OiY^Õu-Ð  ë1q= ØgžRXù‡52Ãé!ÐÂüüÁÁsž©áEØWE ˆ3ä›øÏóâž6f¾”èÙ¯æaâZÕÀD8#¼0a´fd~+ñŸ•<`)£Æò[+`‹´°ÝjÙ5‹Ö–ò™-Y5=0 [©5Õ8 — $cv‘²ÅÂv‘`R2Pvh "ì×¥¿à¾ß|ÝÁ«„¢ ©y!C8g¨t{8"f55Ø5Mž­ÃjŒVsò#—.k.xO_qAÓ ?.".cs)>Æ-î“4ÊÚ‚¡NõŸ<ŒÍ#Ès-X9b†ƒ¿0ÿÊó«}Nv£b™9·fﲓÌßåºÁÉÙŒå+ÙÛc`½š}XKø.ƒõhL³³þ™—D ù­ìŒ%¤²X>Â*?Ðð-àV ^Îj¾xì+£Oaò˪«£ˆ˜oÉIRô¨}ü û|T-`ì…ö6vnŒ»|òÀncCÜ1i#Ô[f8Œ…qà(òÇü IDAT¼A#ØË„•Uîtª*vz`ÏXšn±ìmgÚ]†Ç²F:yZW*.B‹HåÍ@Ñð”1ÑØü³xz6Ùçe˼s5ÉÓd!çÍì]Ô“4˜Á`WÅè$ˆ]=c¨Å =É àŒÃrXF,:Ø5áŸbá"…¢P]H¿upñºÜ-Ý£5ÏYÊE}€Psá¨eRÔ„þÄ9±ÑjxhrÔ^úãr®„i?†Mö ~©ïÆ];§dR†·èx ²”0o1H®TÍ•p˜oxÉø!º~ë7Ûåæbѹ+3Nå~Néå{4¹õä^º,s‹Å¬ÎeLÅ9Aà%):×ßÓÙ`YM"+àM'á­g„0{¡k¾ v$Ì@nâW H©,Hä2æ¥$i‹L‘ÈeÓ„–ë6Â'ƒ@µ±–¶oâÉp8ÀOf%åda= w…ˆã{s¼|¤”æ‘Ú õÝ~Fh áɘóF]DÌÝ֤Êx¬úMP0Ph«YŽ(ÿ‚º'E=2¬–Ë%Ζ8¿³5Œ>1àbFW¨¢¯ p—ž>A¿&Yâ\5'…Zíµ¬éà„‚J÷÷:ú+ùTñ¯?l¯ # Ôžk¡¼ƒ¾œ8UÙ˜˜ 5ºöx)C Ct²Q¶ VxMëóÒa±År——÷®.—aáð@ª²Î4ñÏÉLj¸Î¥Ûê°Ì‘æL¶b¡êÊ»Z#íi25%'õ1skwµO/.¿õ9Â@Žg~5iz9½²Nù‘ðí’Üš)Ð>“‰)f›áТ_áiƒ…ǹÁ Ø$œ™âBçR¡m]:é¤z Eêmß.†Öw¦‘òÈúɤkŒ…1ãŸ& ÷)¥¹4TBÇXxŠÝþÇ01™±B‚¶cü˜¿°{ ´õË àqŠLeAmù4ÔÉÇ›‹’Ôî{¬îãþ9>…ÉÏô}“*`´ÎOAm)eÀEu!ñ¹CZÖŠE[WÍ4D yNCƒæùÄíÎ|)Sd5ñ°½@øÁ:Nü„Ôˆ8§ŒŒQú©T(]~¸LžV?ßÃÁ"Y_ž8h–ÅA//Á–px°€dLE ]„°è±Üàü!Î.qÿb{~ñáóx媹;;‚ÀŽ 1/Kê˺¼öX<Â⌞?}€ ¦Î˜Ý×@¨Cç!m>qùWpi¿„aæ¯yÙ®ÏÍ7\û_žÅþ§Ú¯¾Hü 3üCf©_Mi_?E;¶$ÿ™‚ìªwS@ÊÿK;ÿ{"8Q ´-Üa{†°B·ÄÖakÐ]Bo ž×£ÆtdèB^®ÊËÔº¾u¡uƒÏiB~Hád”=¨ˆt>ÐÞEù "5ü!ó¯^ë¢Ý€þ‚ùôëþ˳ػk^».ñÁH @]5wXCÍÿ& ´ùШGù„@‹šj¶Áê!piñô>­p®y=Ý4êà+ÙíXoq©)ê{Ô!e\óã dà™VÍháÌ„rB•©¨sq"ì¯9,å@ø}Ï4òåúÃ'>%URg o™È¡s-!W¤!zQ> r-x—yPT‰p=BÆ9W±À׃E°LÂh0#áG‚Oð Í€Õ€Õ÷®ðà ÷/pÿ1\5KÜ3¥Úø¡xÝy=(gç %¶š@µ3HUíËZëE­ÇDŒ":KìÙ8ÙÏ[ Ì÷>ñ7O¿Êõ?ñK>ñ%3¿BMò0S˜ÿÍñ¯ÀsA…CÙ¡àŸ€Üˆ‚³E1‰kŒ…ñpKØÜîþ ö þm‹33Ö$󈮳:*—1Õ`g)á3>èÓ*ó¼3s œ<¶×IêUCC ©Æž7 ÒˬŒðï˜/<ìWŸ”~ñfWüCæS^Ž_½%ÃÜ&’žT»LDKïv¶ó¢Ãth;¯ã®¹Õ&/u¥K:Z`ÿHÖ€G ÷Ÿ¢½1ÎoÊèæÇ”Dœ±È7[3ó½É˜B%…T!P+P×ÎÌkg㬡|éO>ñå7õxiÃ'"Eâ“(JÛó-1©pQz§/ à\idÙ'“˜Ÿ¢`Șç±5{S€°SÖ\Ø꫈ó[<]`‘Óö÷Þzó3ŽúdgÞÒ$.[!‚Q!í³pX>„W±ôRäЧBVu^ˆ!kg d–ç xØn½4ÊIRŽ®sµ‹æüæ ¿)ÿSn§Kª¡. v‚yƒl"Ðÿ’onã`ØìþÜq ß#Ä3 +„›%$3ö¨8ƒRÃ…¼\Ézz¤Öõ ¼ëѨ@jø {Šˆ „<Ê~®Ž$³GT§¼àI~uû¥QWψ€© ÊV¿§ÍôŽßbª7‡=F¸^ÆÊ$‹³‡?(0ëƒîÉ­×´÷0ØÞÃë ,'jé³QÆ'€ÀEf‡ ë5ú å­×1þ-gå£ “ªnìóškdÔžçk'ÙM§X› æ‘ÛIÁÏ# ‹ØT³&f©' ÕS"³þ©üÏ¡7B E'àWƤ&tCB—JY7h-Î îl-ÙÂ;ó7¦Ç÷CtåWp‡¥í³zû9YœIâ° Ú>‡ýY=8<›¥¨ÕÑI¦ò•û7k°»ö…~ÉvðæDP p"~Na†·ü„‚ù_nH±·ÇiÒ€ØÓz(àj¬‡[Á!õH}¥©"âò Ñ>vž ³#­fz›¢c¦‰0 ¶>z?xïÍУq|¦ƒùå¼j†g_›<¡Â"qî`b:¡Ì)Å2k¬®}¡_®Mr„$„†z­¹=¾™öM¸` Xf-zý!¢ÆËŠ‚ú؇ŽÒ0*šC@íðPò1a²4xýÎ'sâêrQÏ;¹–ÉE–y`~Âú CþòVÊ'%3›YɌ֑š 9Ä844Âþ}Ôžëk§ØM§XÛ‰yÚo—v2eÀCj ðä*˜Ô x 9 ^ªcœ ]&n‡š«cò>[ÂŒ‚Z"º„>a°Mè¶=‡e‹G]†U­¯0ˆÑ ½ñôa203—1 ‹ :Dž¦nψØz´áÏ%qø”àpR5ØÏ>rËa—R:·F8×ByÍ¢è’ÞêlŸøâXùR“¿CKæs¹1Ì °«^°-ü½Â‹< :V`}ãc`Æ_4QݸkU\TŽÑ"5®oÜà¼7Ãß Ï(¨¤“òQe‡©1UJçö±T,C#%Ò #µ' ¿T36nè˹æ9y©tPkx½®_X¯Ét܃öWt3˜æÎ’Âv(:¡‰ky¹Z`=`}¤@¨{—5òdÎ:c h$$¨xFÇzŠeP¿ìÔBS2 ƒ­äÐ„Ñ ÔåÒÒ<“#ä›@ EŸ!0 ¡¦´•ö Û„mÀ&¢Ølzlzl{lÎð@ ã`-œ‡\„ÏK‚‰0o^>„‘ÉD uÄ몙ꥱ–9¥ÏÂh2ö‚‚—»ÔQEÄH¯ŒPzŠA[pé,n<éöK´H~µs]r"„¢–CG]´.™VÁÌ–ÌðF>'(¨˜{¤±C¤Ñ!vH=Ü9€.Æ"X[Æa WçÈÃõ’I…±_M¡ÂaKqX8ô®o\ðCVGô*“2ò”Ü HN¾Õ–.ÒÎÆ]Ô©u]ºíÃ'tÊ©ƒZ¨¿¥QSƒ=Aæ@;ìƒÀž Pá°'ÌÓÇÇkµºA~-£]=Kçë,`Ì#¬¤z žœL%“.¯ à6¶*ÐnD,Í=Øf×P ™U»¨±ØUƒ‹Ëh¯€4šŸP÷ZÈs˜ŽDMA»<æ!ãb°¥4&ø¢yæûv°c:0 ¤Áb°èÂXô¦,ƒÁAˆàè"º€M^t=6ºˆÁÂ…k‹…ÁÂbápÙÂGyH÷àž\Þ«°Ð"FñÌ8 (U›€6÷\ š>He©}ŒˆšH`õCy¡fÏꊙo<éª=½öu~Ùö¿ø} ¨Åö‘NÒaWCño¢ˆÖº¨ ¡ÚŽmïÇíJCaÞ˜`‡²%nZ˜Áƒ+rRÅ8\­Ä¯ L},Õ~•…ƉÑ (¶@<0 zƒqZ/³O­[XtÑš¦ ôýœùŒ“®Úú¦—ûe™/£$u´.jª7¹×†:˜fù?¥íŒvú®¦ý´Í…âü8ÞMÍ3j:¦µÔŸëCƽ0²<²Áx˜X¢ŽÛmýx‚ɼñNªqÆnÑkXÞÊ{š/Ü—,tõ¬–[ù>m›YLõ½3S¬½3ó£Þ*&¦¬|ÒÈ÷äšR “2ÎÑ<ú ûµÐL3n  7£Ïu±¬»ˆm*êhˆB¡,¼®†„!¡7ØX,Ö Ú놦G’º^šѕ4¤TR¨Âiª•ÒXÇŽ­äx<°pp~ ³®±°«uÑ|»òzgƒ,}?˜¯>rÕn?þþ´ÿ$#XŠBçB¨ÁIþo¢‹î#‚Œ‹áb_r„¹]¢(±@™_&¯G@í`Ú‚‹±)IÄè6mÁ?KX¨ÝBšùUšZ;äùb‡©±ÁÙàgúé¤k¤‹ê8 #õ¢Š‚º¥ü&iüÖô þ‘ù´#WíÖaªÒ~Úai PIžÁDQ©a¨…Pm ‚*„ö„…“{#Û•¢¸>Èú\&âP&}oaï£ ä;êM“ü]FÁ–àÐ Òm6[ d ½Ä œ<‚õ˜ –I¹tAëküÕ#phnÚ_Ý´Øô‹eôÜFÌ7žÊ¡Mi@ .jŒ-Å¢é`F°7[ƒ`0 Ô…WKe—!bHIB]ÀÀ:x3 ‰ÁàÐ5Ø´=6ghø®÷ýU3êëõTDǤ ÓÄÇ-‘N¾àŒH ÃˆcÑMì`¥Ì‡JðZ"~›„n‹ÐËÖa#lH¯Õ1f†º¨§3¿Î0¿W4œø‚¹ÝHÊeAz«š –ÌŸ)êhNþÆèdh¼)u¤ñ öÑ¢zCZBL€˜Á[c`sÔíà, gÆßQ(fïÐ9t-6=+l¸Ç½ÇzF ùW–äµóŠt*tÑ{§‘uv£……ká[XeÖQî%NÔ'ê !Çq’äW ÃªÑ‘! N«ct$Õj² :•FwÒÁT0,œª²š?„ÂcÆp·H 2û(Pæ©QZi3Gl`:ÀbpØXÀÔ¤ýÊìñ«VüJ‡X.;˜‰ÎGcB0Žëev>¡‚ g䡾ù(8 }Ìn=#PwX {“¢EGÝSQJ[ `øÔ—ÓŠü!|ênxN—l>¿Mu!0-pµÂy€aòé–Ö®ÆEý&»œdÚn¤{&Œ R­ ¶!8ÍPoO¶û7½Ò/9£¬Ù²˜4åf(© yÊ4G³ÀØ’ÛìX“GÄç-!· dM1Z=*ßÏÖÀQ â ŒCkàmý{å» *7ضh<Ú6õ]ߢ“h¨ÖrEyšÞI¥³C=º¯§4¼ƒ[Á/)µ°’ÈñŒØ¡®õ¼,áNFøK5f‚eW!ˆàêÐ .Î軤¦êþˆ#”æÊ=¶ÆÀ4)Ì6~ˆ’ΩAÐ7R÷`à wú•yiÉÍZZ»Z/u.8\²&DX‹”ÇZH#¢ð?-ŸqL©|æ{€p¨×Êù€±ß˜  fêè$e8ìAÁ¾~W—X¿Ëù®&âOZé&&¿…`+O9Ù­E³À¢—ÎB#¨T;ñNv¨E8k*Ë6ROœqR5³•-Ûºpfçlךáíú@xa`%¤j˜DÎ šR/ )¢v”@µ@tDAªÍÈ—UЂU4@~ÔÓé €°шšqÑÀ[4¦ÂŠ¥k…ªÃÐ`Xa;À½[[ ¤Z®Z3k·•€†VÁCøQ§7p \ë’™Žp5ÔÁl^·`~×IWí@ø¾ëhÏnÏÀçW~ &Q¶* 3æ—jœ;¸¹5Ñ,3Ofhé‹îc,«C¥:f¢þL9hãÐ[8'ýIÅgÙ¯P³^ؼÈ^ÚÄ»àL´>:ÀFkb„Ëø„¤ Ï»²%‚ÌL1øˆy×IWí@ø/Õ¯ Î$<ðSÁiŸF–QÞêåL Dç(¨ÈÄ QõW³Výà€(¼ÉÓì,ªY:a[lœ†¨Ô/Ð °1V†ÀTë”Zü`Iãô@'®T ý¡› ¥PÊj¥¸G«fúš6X9jÈm~Ìn„ÿZÚëÌ®„÷S¹ôÔ`*2K#“|z)–qHVpQ†ÆGˆJÃÔPnNÐ:—·lËŒ°©¢G£x»c‹·hMAKo%#H¬ƒ=†Ãvh0˜õ¨  kåû¦îªâ¬Ã "dE‰ßÒÈYJ°,¬…o`8±“ê- ¤Ÿ€£ó7Þ À—¿¬në÷¦)Ð'&‚A'éJÅ …ØÉÎ5Ô¡Ï,壉2¼OÀNSý“í^^¨‹Ñ5ÇùR'ň8ñ«DGªÑQ Ò7Eªè+Õ6ZŒ Ñä¸0Ë¡°óª™üýÓ›cÉšáÿ‘à _’_%\Qè¬BVv§@^ÞRøˆ‡Ê'£ú0‹SX*¿ÚÓ_íꄽL²§ešôƒ*$îéet+,á3ÇÑêPêhv„ZAÓ+/Ì•¬ C0P¥{°.ê©=\˜/øç%ø‰#Wÿ@ø>$?|S8¼©4 U±€5í¶B}¯ RçÉËê¹r§†\Ráa’Èac¦ºqà)÷d¯Š4 J xÒPF¨»*;¥QF¾Xãb 0á¾ ã¿T((qs) Mõ]fÇህnÇçL1Xô®DݽO°õ ü-“‚ù¡cg®ùBå…Nø¢!ñ+"Á%—Çž%k²@j…æ6ßL ¹óÝo›“öú¨šÂ¦!wj¸è_4(S&Õã¢âÎÎ è{1cb¼O6OÓÖš|zZ•ZÒnIì5ÑÑóoІ*xŽ[æyÁXé¢;'ªÏÁòEƒ\oñCD8YÆôáäw˜P,ôįÀ$8S2+“Ze='êfhk¿$Ìr$–rÔ•=JýŠdØdmRïÊ3–F2§ôX¯@±L¶|5Ôb6=ÁBÔ’¦jм…ÓÊôWriK4 º¿’©IuÊd\*ä`ryz—Ia+G¶¨Å)þ%†œKýN»7/5©ƒÄ „…è#†ˆ4P‚q®Žjìü»ìU(–É&ÝQÎ+8R/ÝBÅ·$d»>J~$y'+»föÒ¡\Q#JH[ˆ›¬AkDs—g3•D_ª~K@©ôI6؇#‚R½PÃnÖgq¿‘êö5䘌‚J:ƒøS,'tì¹ò)t¶tµ`³WGII¥Ñ4}¯R/#1?9铼à)fær—ÑQÁÐÙÁ–'1é<2UÕŒŽ/ÔnW>Æ2Ì=/Ö O°¦ˆmsm„Ù¡†ôJ’3ùô~cÉŒ¸–“ý-ù•­]×™—ÊËÓNà+„¡n0Vé[,d±žCÚkÙîþ À¬ƒ Mùt*ÎÅ:š¡^'•j8­·É=Ö’ :QƆ0·|œÖ¸tâA¨*.äâÒ˜ò¨HSç§Zùèþ¤¾þUF×ÈL,ç4Á0¥«\(':™Ñ·2ÞhÒ£ìcè%™FR“䉓ý}*JNEït7ÀxSü©8V‚“ÅÈ®åx|)’¼)ÀÁÐ ×ÔSiÕ0ó+Ô¼vˬ´ùZ“D#D–ì¸\þºýêÖ¡Á ¿NÉBe‡©Þ‚:…•j7›öW´ÛÄøÊÑ”@8I¯§}UÙ‘ÏÓ0? môÒèñhy]))phØa|~IQ ”ÛNˆˆFVzÜÛº³H¥ê‰DNF Ù»µ¨PÕ~'öÆI”çU`„mªài>ðÈSÚÏUqV•xàggÓl,&dãþ±0!ä‘ò©þ.F¤QŒ(˜¹ 2ùñ ãx6ò+D„T ^¥ËŽJ‡id‚È3ì™ò¡ãÚ×·^"PôÒ‘©Fê UAÑ> ré.<°<æ^·s9÷<;ºò„Img……'B ïFSê˜ã`fß…}Òh=×ödgdrË'燪ƒ>ÁIZÀ "rJŸP‚YÆ~k,dj¨qzØ……ù`Ÿ&¸üêÖˤ2Æz¨¶M¯ï°ÿ­£ÙÁ£ýU#Ÿéw}(8QGwôW”YTÌŽ2µURQµ¥éŒ5ž_Ö WáTóBþÖâtV Ð×Ò°§ª¡¬ö"K¦Ú j €ó„xëˆ_½ @ˆrùŒ šj¡DòvÛ2¦]L*´%F]öM§Ô¨JÙd*.ŒC´,¡`Î?Û—àc!…>NOErˆq {U%tµ"š '”2³5(Z´p¥C ÏŠ5#ŒÔi/Æzéa»ýS¬Ë_&¡÷ždÞh!³2ck`³@‚‰ÒêÁ˜©_•ùe 3Bø=4‘4œUI¡µa—"jg~ÕÓº«Ia$Ge½é %Ì‹5´äWG»}¼*Å2Ê9|ŽõWÇ 3›^$7ƒÀD=X#_Ý£ŸùÕH¦ uÐ1+¥ÓþŠôÞôN/ûb–½LR¢ÐÊ*.¶ò«²Ç­DùêéଇRC+(hÅó\_Q9bOÚ1{ù»iŽÛ¼À¬E÷þôÇ”Q\éV•ò÷À›RT™&-H¤aõ‹êslfБ‰`A¾›ÊF³SþÏE=.ÅÝè)‘\.øíËr̾s‰3QK{(Ù¬M]ø€S“ϯ#¬LµÐYg<)–Ùk»„\ö2UACI.Ï!PöšŽ©È Ú )„Ž¦°Õ¤k;~\BŠ%MÈ=P2ˆ©dÛò+EGP‡®›ƒ~¥CN5ò)uQ¿Mµ_Íhín»õÒhmZMmØÓž˜ÛCãXSUPPB©è©k˜×™øÙâ÷] ¦m­¥æÆdž>öÔÒ€zÁ†âyN±Xª†§q$A„gæaÀ'øÕ+Â_ŒI*ftµTê\ &X3æq½üȹS-D0P¸\ £º¨,.9SxäÈ4¸æ%ÒàG)Cuœ}ŸÊikí¶4—£7Ž#¥ÄÒïÖâ>‡íÂ`Æž)& [TM0kdRªª@ÇJ3‚X•,Ž6öËãJ u‹“Ú3i’G7«>Šˆ ‚f2iÞ!¯ã‘c/öŠá‹0†F+Ý ÄNë¯ ÝLåºÌÃ÷|’L¡w‡š~i •k‡´¨tI£!¶‡^´Ó°«¡½£#€Âd ÷.{€°+·c* Ø]Ï:Í"œ-E>5¹æ%H0£¶s]h•L¹¬ÄʧŽw°âR†:+\°Hþ\IDATt.Â&RGg‹ö)ZÈ  B#¤ÔQf™C¦VD?J?P×Ó–Høšä×$’^r ÿ[OÊ9v ü±k~Å3Úd²‰ÏºÎLªS³@K`ôII€@ ¼‘ÿd:XûUÃHphJ"ÐÈÅÞ‘)t€1£:jöûÕ$ÌÊ>«a¶© b úÑÓG¡ö+ýp¶Xc­•Ø“ýê7_ó¢ß¿ï¥ú•Á;øeÂ/=Ç9¹Ù²Ú9”ï©J`4:Φ)yh7K‰—{^G*)´5ÎÏg¹öªXjj0ÈKméØÚÚw&–J]Z5ÚËöuí`¬Òìto$/Œv ü×üŠ‰Ý¨X&çc:šD¹éŠþa¬$DUXÍ°W€ÁŠ(Š„A)sÄ 2@bŸ”‘+hŠÔFQ´$õe„¤›ú–C ¹t&ÔÕ.ƒxD"tÈ™9©ÓQ:€ÅˆIð®,ÐËWøºŸRáäƒilxÏ1'¸~f€ø²º­Ï“YFcí X<•bŽ…£ë4ê2^ ‚ƒlŒ³© í˜ÕѧÉÉÉR8Ì.ÙÓ‰x(l{r ´n„BðI7…Ã%x·Ÿ2"&=½ÞŽ(è B‚‰å 1•aC*5¢ãoMeµcXQÂ&°çs à#œË@‹eÂ\ÐLòùKÔÉ• ‰|,mѸ^±°¥CŸç#¦ß¬‚Š!9”«fÂì_öÙÇŒ4:Á§ÙÛ@Ú‹‚Š”%ƒoj\Ì–äÏî{Š(™ðÁŒtpKÇOžuý)U=Œ^M悱ÆB °â,!®oˆ ÎýJ¿Eß u°e¯ãWë—+¼@óûãi#ÊÖP¯®©¢¨V„î<‰‘‚6ÒsÇ¥€×Ì°ÐË1è‘Ï¿bÂG˜a ;KP8¸†À!{Ð@_éGî“­'œ«£JT¸‡Òp´ó)±õ+Q5z-ÛMuP ‚Üœ¤¡wÊù˜65jØ¢”lÞADÀ* zê“&ÃÁ,Ħîf'gMÎá»:ÈïëW•ù:vq½ÝŸÙž œÅ`ݘö X¨t0QšP÷ц’BåÖæ//s_¢aN¶Hog×Ì¢Àsn”b™X2‚6FèC!ˆÈm죃j‰2ߨQ0RŽPƒwuyä¾Ï8lçŽz'ž¹›õõs9r3¶Ì|]¾_Ã,mH?Í‚§îSPp.Jc^:ÖˆÖE1Ó3e{Ù‡KP/1ÅBÊ)0u$f„«Oè £à üÊ_¹›û6§eso‹9¹Ek/ a^¿g¥}“†*Uz–±¯¿š˜¸Six6PF„^¾®¡ìã^¿²ô›!=ÈÿxêÌ"¡ ®Ù4*K³¯P'˜œ¬9šòÎíe?%à¦U£vÌoèOÍ}IׄóYóT8 #œbg(;§Ì3&D  ±”ÒxJ†ÚŸ´3pr0颱42T ´>C a¡ p &“°3„ן=é­¸ÛB퉗¦¤µ$J$ Ø ð{NŠ´ÜTÃzy’j®}ï.äÕΈT“¼½\vžó?å…cŠLýŠ…L mô‘ZRA«¬¡RF#tP÷9èWvæTs:hhã)~¥m[7ì̯>ó´>Üö©erÕh¯ïê–UWŽ5ôŒOÞŠ$:‚^ê„ÚzÞ‡Ãý•뢆tQ'Ðè }ý0@ ÅvúSµÈS“…Š´¡ æØ ¥7üL)Ö»ëŒÿÜ©Ìðö3BbÍi,Ul›X€óÂüˆ ˆsqŠÅ ÛÁBgˆdás 0CÚqÌiæOù8ÀD8À$i‹(Zr„.ÀÅ"™b€ËŒp8óðA©u^ªÊY»ÙÓ5eŸžwâ¡?ž€ãpxÿ¦ÚèËBb͘2LÑ<÷‘sš8AÁ]Dp|YÁéî„ <3#¢.ejXRæ£9`š ¬LÀ–ã¬ãaD<‘‚tQHcÎÿþaN€ÃpÛµQšb~J7v¢ (lšÔ „,ZVʺàÎþŠ7êIv5*jŽpB Ay@á)ä@ÏéÒ^Ê5L³ƒK{Þ@¡®;N‚ÃÛ„jÆ e!)){¹aó„¢CM Ln@ê-†ï2¼QÔ„#jeõæ ÉN$É'hóT29àsaj‚M°QJf2R ed¡Í#çLÎëpBRÍèHOè ¨âªÞ_7Ң୛üÛGÅ ÊM´›ʹS.8mÔŒp/Œ€©Ÿ¸[3Â]ÇGº¨Ð»ªdÆ”Œ`™†Mé )QòQ8̦¾„Ú¯XŸ;~ÞuàÅæí‰5 s ¯Pµ 3~# Œ ÕÓ^EQM\ ?È¿ ‚5fWièQQP™œ`³„‚ m´D ÍŒNÀÐô*êÇ%ú©æv —Õèå+ÔM ™ÇìSw|Nv} $õ7ãMæv–P-«£úî0f }΢PÀ‚…ùeÖ?ƒìcE¹I€Á`H‘€„!çç&,È@¦Éå0¹.Æj½¨0B+àåƒøI(8zð¹l ¶³:®¨‰Ÿ(n¢Îf~ªî£m+/O'”d«Û_Þ7É*d89œP½Ü›²8ÉšÒàÒP%‚æ<»Ö:HêhÆÈjRuÝàðÀwÆÚ¯,1Âü‘ ü–ö=qײµ_qqÛuN@e·žÒlgŠ‘êE&‚g~w’)Ìg| ,D-1NdOÈ¥Ù}À|Ýhäno#5eèéëµüùfv0ÕwLØ®ãÁòe¹'ìå]+§ÉÖ ¸Ó_ôö$®®„¯ #,Xƒ˜TÍqµ’Â,ŠftL’)ÌúgD1BÅÂ|¼E:è$·°ÞßÉHéN‹ øYÀæu4¡°ÃqÊÙ0l²X¾âjØ®@ÈB;N {Ú°DÕ<õtZ•Ã=—!æçZÞ~ Ì–Ãtk)¦ÞM YðŒ5vΰ°¬ónJůÒQþ?)þ¤)f8G¸»‚TH¡¡ìàa¿ÒLû•FZŠ”¦BÅ'$ÄÕ$3Þr²G{€0›ÐêGÏÙM 5"cœKõË9š³EOèØ_pxFTu5j¡Ê'E¤WàÄÐu¤7©R¬pȈÈÆQ“3ú«xÈd’cŠô2“ž&iÝ~ ÌChÛ¤·P„uˆ™jÉ]ß`È ˜…P!SCa{!TXè ¯Ï—w%ˆyxŸAˆÒs„}õ©dK'šH$¸ Œ09ÔZ†±‘!ÐÄœ)ÔëpïÀ¹VJç ·Óœ¤ªÕ˜K t¡œÜ•ù[¾ð¤Nkq} üÛø’ëþË3YžÑíóèTÏŒ(8VÇ8@_Ê€BVGYŽœñ¦ ¥{»-S”ò,kcšÐìBAž}M Æ˜“üJ9\ª3y‰ 퀹ٞ,jjPpÀï> o„ú¯ý/Ï`ò<ÂæsŽPfCÀfê²åàŒ…ž6Núv Q™ ‡üj¼½UçôuÃîBA}©U,Ç:,u…늈þܺ!?5¿Ô¤h”p]“™=ðã§Y×BƒûºÿÂv} \%@î–ÉS/ Ošñ/ca*e2 Jñ²ª£ºÎù“Â"© œVJV²Õ„”Ø%ŠÎΟn]tZ/S?˜ijé+)<ìWÊê8® ³™ø•’B5&‚ væºj?’à€/8ÖmÝ?á€_ý×þÇY*…ø½D”MM =eþ2Á{BΦ¢`C¾“ÝÂMºÓòáz9ùLEÄF܆DziY©b™ðîã᪞ ýìg¾r(=Žl©&ŽŠy½8¸þËHð÷Ãáµ0á?`ð\÷³]ÿÊqRYb¬< žY`ÖKÓ(zWÞÒ E¼A´´õ¼ þ•ñ7òn¶Ñî|®o*“Ó{UM°’t’ ´ v€Š:Z÷\,PŒu¸óŒ3,ÄŒzBGSç~í*½Ò€RµGdt.“ñµàÑax€DÞ?R»©8+:ÙyB½ ÿ«À¤kO€7a‡¦þƵrÜsSÌý"Öü_ا¸tAéóüǃ‚ ['ØíG˜M#Ù‘f8–É$)“ ,Ýh) [(6X[Ö!o·R\ctª[rÓb™ÜÉÅÑ 5 … F˜R©áPÚ~€ëáóŠÌ “:˜~Ó$ŠÆïf÷¥Ú¡B퉩†Ã@ÿr¥£²Å.s¯JÕ(÷ÈU¦P„vWÎOá®1òŸ¿Ù±¹Y{Â!\ÐÌPS8¢‹Ú=€41ö«¨9ñ+C·'j¿r5ÔƉ°7·áU™²H'×¼œP€ ™UÁL>d ‹”áSé $…F)U¯–žë‰M¥†¾f„ t®‘:ÂHÅÎrœ¨›˜â?Ö\MÐLSMc•se‘ÒÁ†xÁÉöæ5ö}v# œ‘Âd€dT •º˜’$šè0Àø²š t¥FfˆÔÙ›QmP‚ E¸}û4üÓ†2 ‡AFÖKjP§§1J Ç¢vì㹌 Q; Eî*¥ƒ”ê]ifDp’>Üoæö3Bì"…ùü'}9ÿQ2¤@&Ž ÂjÏ9$°,£÷åò-€ºRF{2… gæÿBÔ½ŽÝƒs .d_jÐÔN¥~¥'¤©Nœ/r³<÷a‹·Ÿ¢6‰«F®:#ÈX¨É ·î$M8P?JÀ}~:hŒýÉž**ª)ºz~еç@)÷`å˜öù4ÇEN¼Æ‘ñoH®kW¬:2êjZu7-Ø tBO‹¸n±L6¾Çƒ”jt¬Ž©%SïêwUUñ3¬`aò C·µ‘ Õyô‹"jõenG,XáHL‚é¥j¦‡ë3dW4$Å0<DAÚOq¤©œ+ÊkØK‚L°ð¸½*‘{M ‹4Jéε¦á`ˆùMkdæ½;ÃWåî:¦i¥Œ6v!f$, HtÐ^ǯæÓ¾}$?RIÈ–8k¨_©>ÁXxÔ^i4Û¤Ãr„sü›óÂÉ»Z#£¡k#ßÂü=ÛΈ8›¦:ô¥Ê›*!ìÌZÙ¨¤p `ã ×ÐʹP©kÒÐÓ§ñ’wõÇ[’@›šëÈÊIfõ˜Ý~iôÂÀý4â; ¤ó`aæÃï0|Ÿú[ðOòn?|ª»ß~FøZï%²œ”¯§2š~8[ó?À e}©‘ €4JvŽóPHœŠZvÞ)F˜(ó¨eE4ÀP*eÊñ$õCžÅ4.d¢Ñˆüº-Í ²*ÃIïOpÀW9¸áÅaÿ«ãÏ|ÉWü¥Où¿úðÏÔü¾Tún;[ó\3‡PPø_¾Ž™–MEQÖB¹L&à<Â>÷&,œRUGuÆ;ëlžÅæ~•jr;‡CU>ÓxóVL À%8à;Ê „ÏÁ¯:TKtóöN,Tþ§´oR/ÊäƒR5—O¯î¬²€v=Š…^¾W ¢ª£*œ:AMd]4ÖéãkÙ·ò ·¦vB ‡N<õûЗ"Eào÷þ „;üêFÒ¨ÞuÜ[9 ˜„d’™`¡“u/#("’œà­@ÆŒJM´t öè¢i„QŠer#–9ÕY`Êå0€”ŒšSaŽ« iêc7è¿8ÿ§ÆU ‰ EQP¦ë®& ¤ÑîÅËÄ·~üý_ñ•ß·üìoï|Ø&¢Ìè]rÒb¡­ d\kPÐ!i)Í]T¶@8*¡AeycU8CtpâW7ÃÅù8 2êÿ1#‚Fèö¬Úð¬çèWS—rqqŽ…®Æ¹¦ŽXµ:„ãµ}e2z` ®ÁÔئÁ¸¶™jáŒ#±TËGŠˆ®eš™¨£ä›J¾žz`_®õ4¢ú¦XÛãWףπü&Q†`€H=0&¦C  /ʤð^i<`„~eXr‚Fn€ÿ >U†7xÈÈ÷ŸÁï åñNÇÂÿ4>[‡æ©´!‚g9EüÏãÓõÃeì ûUü¦(\0ùÝ.?EÞ˜ùø ©ïýc3º¥ÚÌ:³| Þ¨±Ù¼¬æÏ™1¯êOšÒˆ´ýšâ¤A¶œ`[\Þl9þѦ¹ÿžoøÀßý®/z×nñçT›ûÕ‹_YŒ¢âO7F¤ð3 3ŽÄIs€Ì…ýsŸHZ¥üË‹ u'ó>­/h7Ž‹w0?ÿIãyÈ[ÿ×;ÇãÊÎ?Ý”ã߉|š úÁ¼C¾ÿ¥]~õþ=~¥ÿª>ó-äWHÀ×›ÒH´ý™âQ¼>ja}Ãå¨=/¿GæA<éQ­=zÀ|2BüNéç-A嚥bÓà iKî ¼ÁKó²ñ_Ó6Q:~ÙÁûèeyËàóˆ B¾ú“1v¾Í¤ÃŠÿ¼ê'ø¬Yðå€/+ÚGqgkvçWwö"ì$¿º~±ÌÝÙÝÙÝÙÇÝáÝÙÝÙ½­ÍÜÉèwvgwvgwöv¶;Fxgwvgwvgok»Â;»³;»³;{[ÛÞÙÝÙÝÙÛÚî€ðÎîìÎîìÎÞÖv„wvgwvgwö¶¶; ¼³;»³;»³·µÝáÝÙÝÙ½­íïìÎîìÎîìmmw@xgwvgwvgok»Â;»³;»³;{[Ûÿgðκ.ÞIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classQCPAxisRect__inherit__graph.png0000644000175000017500000000213514030601042027661 0ustar rusconirusconi‰PNG  IHDR‹³Kò gAMA† 1è–_-PLTEÿÿÿÿÿÿ222iiiPPQ™™™………èèé°°´ÓÓÕP+nnÞÎ"tRNSªvå’bKGDˆH pHYsHHFÉk>JIDAThÞíØÏNAp^a(C¨c$›Ô›m)!ñÔÒ%õæ,û+«ÄC#5xäÚŽrÀÄCÃMOñbâÁààÑÄ5á|Ó]*ØÝÎNw£hæפ™îŸ3¿Ù¤ô;G²¨¹9Ã$`VËÚU`@[©#W{)9Ã\/FMÂ,B“Zvä=³2ö¯.¸¯‹4ßNødѪ¼øtt49}WÙ!M à”¼‡³K–âýál–˜K^ä^Ùdrâœ)Yï³ÄLÐ'O(žXïx–(™_‹5Â=c´^”.#ôñiÀìj´8`¼¶¹Gç’9²‚E•?o8Žqòm‡‘m²\q‘YëªÅUCˆu|sóILi=ÅÐÊ„‰/Ãüô+ŠéÕcêb/îÌ ‚‰-ÿ³ò’Ì’ÿ% fÅÿžóÆÿ–óÃ÷3`.|ÿ2=“÷}õV©™»È|MϬ £Ü*5ó åV©Ü(ߦf.$s™ ÓJÍà²Ô—Æ0†1Œa cÃ&–Q~ÏÕñŸdô¿‰øO2ú?2oVÎ0QÁÛ$3-ð£D¦[ `¦~ô*êR3‘ß[x†ÀˆY®ìjP Uœáø=X•L¸(ÿ9}§XÔl¢¿á‡‘³‘ÖS|…6}Q7?dòcf(O±ñ`j‹ÉõÀåž0: â?6ÐÁ” '׿;ØbÛaó0êMÿ±ñ`>¢Å:ŸÖSøi1IË0Š™!ðû=þ“Llà§ÌýÆñŸÉýR1&÷‹-“û)˜Vjæý÷Ú0†1Œa cÃæö1çZ¹_)Ž±õ~ÔÅ2B§,ÃÌÌXPpÀþaSà£7h†÷óDÌasËí½MáÕ¼îöøóž¥Åð‚°„ƒ¯çÙíFI¬r9A.laÃ~<€DLop%Só,^°_º\4ër6¥šÇ×’ÎæŠÁÞ8¯ .*ëØxxVwQ¢àJ¦gál‰'f:²Å–l±ènˆ²}µ¶åaoe\Ûš”t6Ü|_´K¢¶¸ãmB[ÜMÔb!ºî-zŠ sû™l¾úujÄ1³×ÊdR÷~ N}ÍØ?%tEXtdate:create2021-03-30T12:49:03+02:00Á|%tEXtdate:modify2021-03-30T12:49:03+02:00°[¹ÀIEND®B`‚qcustomplot-2.1.0+dfsg1/documentation/html/classoverview.html0000644000175000017500000001350014030601042024416 0ustar rusconirusconi Class Overview
Class Overview

The following diagrams may help to gain a deeper understanding of the relationships between classes that make up the QCustomPlot library. The diagrams are not exhaustive, so only the classes deemed most relevant are shown.

Class Relationship Diagram

RelationOverview.png
Overview of most important classes and their relations

Class Inheritance Tree

InheritanceOverview.png
Inheritance tree of most important classes

qcustomplot-2.1.0+dfsg1/documentation/html/classQCPRange.html0000644000175000017500000013545314030601036024167 0ustar rusconirusconi QCPRange Class Reference
Public Functions | Public Members | Static Public Functions | Static Public Members | Friends | Related Non-Members
QCPRange Class Reference

Represents the range an axis is encompassing. More...

Public Functions

 QCPRange ()
 
 QCPRange (double lower, double upper)
 
bool operator== (const QCPRange &other) const
 
bool operator!= (const QCPRange &other) const
 
QCPRange & operator+= (const double &value)
 
QCPRange & operator-= (const double &value)
 
QCPRange & operator*= (const double &value)
 
QCPRange & operator/= (const double &value)
 
double size () const
 
double center () const
 
void normalize ()
 
void expand (const QCPRange &otherRange)
 
void expand (double includeCoord)
 
QCPRange expanded (const QCPRange &otherRange) const
 
QCPRange expanded (double includeCoord) const
 
QCPRange bounded (double lowerBound, double upperBound) const
 
QCPRange sanitizedForLogScale () const
 
QCPRange sanitizedForLinScale () const
 
bool contains (double value) const
 

Public Members

double lower
 
double upper
 

Static Public Functions

static bool validRange (double lower, double upper)
 
static bool validRange (const QCPRange &range)
 

Static Public Members

static const double minRange = 1e-280
 
static const double maxRange = 1e250
 

Friends

const QCPRange operator+ (const QCPRange &, double)
 
const QCPRange operator+ (double, const QCPRange &)
 
const QCPRange operator- (const QCPRange &range, double value)
 
const QCPRange operator* (const QCPRange &range, double value)
 
const QCPRange operator* (double value, const QCPRange &range)
 
const QCPRange operator/ (const QCPRange &range, double value)
 

Related Non-Members

(Note that these are not member functions.)

QDebug operator<< (QDebug d, const QCPRange &range)
 

Detailed Description

Represents the range an axis is encompassing.

contains a lower and upper double value and provides convenience input, output and modification functions.

See also
QCPAxis::setRange

Constructor & Destructor Documentation

§ QCPRange() [1/2]

QCPRange::QCPRange ( )

Constructs a range with lower and upper set to zero.

§ QCPRange() [2/2]

QCPRange::QCPRange ( double  lower,
double  upper 
)

This is an overloaded function.

Constructs a range with the specified lower and upper values.

The resulting range will be normalized (see normalize), so if lower is not numerically smaller than upper, they will be swapped.

Member Function Documentation

§ operator+=()

QCPRange & QCPRange::operator+= ( const double &  value)
inline

Adds value to both boundaries of the range.

§ operator-=()

QCPRange & QCPRange::operator-= ( const double &  value)
inline

Subtracts value from both boundaries of the range.

§ operator*=()

QCPRange & QCPRange::operator*= ( const double &  value)
inline

Multiplies both boundaries of the range by value.

§ operator/=()

QCPRange & QCPRange::operator/= ( const double &  value)
inline

Divides both boundaries of the range by value.

§ size()

double QCPRange::size ( ) const
inline

Returns the size of the range, i.e. upper-lower

§ center()

double QCPRange::center ( ) const
inline

Returns the center of the range, i.e. (upper+lower)*0.5

§ normalize()

void QCPRange::normalize ( )
inline

Makes sure lower is numerically smaller than upper. If this is not the case, the values are swapped.

§ expand() [1/2]

void QCPRange::expand ( const QCPRange &  otherRange)

This is an overloaded function.

Expands this range such that otherRange is contained in the new range. It is assumed that both this range and otherRange are normalized (see normalize).

If this range contains NaN as lower or upper bound, it will be replaced by the respective bound of otherRange.

If otherRange is already inside the current range, this function does nothing.

See also
expanded

§ expand() [2/2]

void QCPRange::expand ( double  includeCoord)

This is an overloaded function.

Expands this range such that includeCoord is contained in the new range. It is assumed that this range is normalized (see normalize).

If this range contains NaN as lower or upper bound, the respective bound will be set to includeCoord.

If includeCoord is already inside the current range, this function does nothing.

See also
expand

§ expanded() [1/2]

QCPRange QCPRange::expanded ( const QCPRange &  otherRange) const

This is an overloaded function.

Returns an expanded range that contains this and otherRange. It is assumed that both this range and otherRange are normalized (see normalize).

If this range contains NaN as lower or upper bound, the returned range's bound will be taken from otherRange.

See also
expand

§ expanded() [2/2]

QCPRange QCPRange::expanded ( double  includeCoord) const

This is an overloaded function.

Returns an expanded range that includes the specified includeCoord. It is assumed that this range is normalized (see normalize).

If this range contains NaN as lower or upper bound, the returned range's bound will be set to includeCoord.

See also
expand

§ bounded()

QCPRange QCPRange::bounded ( double  lowerBound,
double  upperBound 
) const

Returns this range, possibly modified to not exceed the bounds provided as lowerBound and upperBound. If possible, the size of the current range is preserved in the process.

If the range shall only be bounded at the lower side, you can set upperBound to QCPRange::maxRange. If it shall only be bounded at the upper side, set lowerBound to -QCPRange::maxRange.

§ sanitizedForLogScale()

QCPRange QCPRange::sanitizedForLogScale ( ) const

Returns a sanitized version of the range. Sanitized means for logarithmic scales, that the range won't span the positive and negative sign domain, i.e. contain zero. Further lower will always be numerically smaller (or equal) to upper.

If the original range does span positive and negative sign domains or contains zero, the returned range will try to approximate the original range as good as possible. If the positive interval of the original range is wider than the negative interval, the returned range will only contain the positive interval, with lower bound set to rangeFac or rangeFac *upper, whichever is closer to zero. Same procedure is used if the negative interval is wider than the positive interval, this time by changing the upper bound.

§ sanitizedForLinScale()

QCPRange QCPRange::sanitizedForLinScale ( ) const

Returns a sanitized version of the range. Sanitized means for linear scales, that lower will always be numerically smaller (or equal) to upper.

§ contains()

bool QCPRange::contains ( double  value) const
inline

Returns true when value lies within or exactly on the borders of the range.

§ validRange() [1/2]

bool QCPRange::validRange ( double  lower,
double  upper 
)
static

Checks, whether the specified range is within valid bounds, which are defined as QCPRange::maxRange and QCPRange::minRange. A valid range means:

  • range bounds within -maxRange and maxRange
  • range size above minRange
  • range size below maxRange

§ validRange() [2/2]

bool QCPRange::validRange ( const QCPRange &  range)
static

This is an overloaded function. Checks, whether the specified range is within valid bounds, which are defined as QCPRange::maxRange and QCPRange::minRange. A valid range means:

  • range bounds within -maxRange and maxRange
  • range size above minRange
  • range size below maxRange

Field Documentation

§ minRange

const double QCPRange::minRange = 1e-280
static

Minimum range size (upper - lower) the range changing functions will accept. Smaller intervals would cause errors due to the 11-bit exponent of double precision numbers, corresponding to a minimum magnitude of roughly 1e-308.

Warning
Do not use this constant to indicate "arbitrarily small" values in plotting logic (as values that will appear in the plot)! It is intended only as a bound to compare against, e.g. to prevent axis ranges from obtaining underflowing ranges.
See also
validRange, maxRange

§ maxRange

const double QCPRange::maxRange = 1e250
static

Maximum values (negative and positive) the range will accept in range-changing functions. Larger absolute values would cause errors due to the 11-bit exponent of double precision numbers, corresponding to a maximum magnitude of roughly 1e308.

Warning
Do not use this constant to indicate "arbitrarily large" values in plotting logic (as values that will appear in the plot)! It is intended only as a bound to compare against, e.g. to prevent axis ranges from obtaining overflowing ranges.
See also
validRange, minRange

Friends And Related Function Documentation

§ operator+ [1/2]

const QCPRange operator+ ( const QCPRange &  range,
double  value 
)
friend

Adds value to both boundaries of the range.

§ operator+ [2/2]

const QCPRange operator+ ( double  value,
const QCPRange &  range 
)
friend

Adds value to both boundaries of the range.

§ operator-

const QCPRange operator- ( const QCPRange &  range,
double  value 
)
friend

Subtracts value from both boundaries of the range.

§ operator* [1/2]

const QCPRange operator* ( const QCPRange &  range,
double  value 
)
friend

Multiplies both boundaries of the range by value.

§ operator* [2/2]

const QCPRange operator* ( double  value,
const QCPRange &  range 
)
friend

Multiplies both boundaries of the range by value.

§ operator/

const QCPRange operator/ ( const QCPRange &  range,
double  value 
)
friend

Divides both boundaries of the range by value.

§ operator<<()

QDebug operator<< ( QDebug  d,
const QCPRange &  range 
)
related

Prints range in a human readable format to the qDebug output.

The documentation for this class was generated from the following files:
  • src/axis/range.h
  • src/axis/range.cpp
qcustomplot-2.1.0+dfsg1/examples/0000755000175000017500000000000014030601042016636 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/examples/plots/0000755000175000017500000000000014030601042017777 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/examples/plots/sun.png0000640000175000017500000000477313532027716021341 0ustar rusconirusconi‰PNG  IHDR((Œþ¸msRGB®ÎébKGDÿÿÿ ½§“ pHYs  šœ ŽIDATXÃ͘{lVåÇ?¿ó^úÒJ//m)-N¦ã*ÈEï—x™ÑlÙL6³ìÆ€9£sf1oLe¶–Ä8¶™é¦s›¸Å1d^p*Dj±TåR(–·ôÞ¾—ó|÷Ç{Ú¾H,ñ$OÎsNÎyžO~÷ßÇñrµÌP-3çšÞñ\Ì<®Çµn•…¿p€îNÊT1å\ÆÕ\lIûÂÚXªlüÂ³ì„ ¦RêMu?ÿ?º‡sæŒPz+ñT\r å£LÕ%_ö5CHì­:ô~ìê‡ÁÝC‡B÷èA¢î©ÒF ,–ÜEr)ëÑÃŒúÔ=W›óü ¡KЖàTÇSªç›¤)´,è–ƒ¢œ„õO¥©©Sï¾Õi‘dÆ9‡Aå=t3J«¹ÐÕ±N!ŽèX‡½ô~<„þ8cŠž¡zò;5<¨;’¯Øm|è-ÕÞ²ÁÝûû.Ö}­"Ÿ8F÷!`¶4x¾**ìt*g-£w÷™t$®÷–*©Z°eŸ°í£Ä3¬Nž¹^ ®ÇÇ› u㛶󃿪W/xËÙ<´ù]œ 81Þ`¬ 3Ñ…±£Én¡1GúÓ‰q>«¯¤bî™T]›k¡ù™ÞR#’àÐÕDŸJ¶ýÊö¿þ¸¦…¡jô\:òçZwï`³îc&°\U•s¬zÁÆÖ”*o †Aª :wuhÏ[-º÷£­òxØ[Ákæ(£ ï~f›Æ… é ¬í½ØM‡«ÍÑȱ$8$;˜¤Ÿ´9Åóôö‡Ø¾ËôAòŸp£•—¯ÐÂïÛ¸j“ß™à·)°Q®†Èt¬½½þX7{[%ÅÍVž£qùÿfþĨmM6óúûWØ-l;jø:¦G¯áf.¸Û’™ËÕž|Ž°ý†) ¯añDúU¬ïUÃù 4( ®HfGÈGÑy¢ð2Ø°Îhܸç_bc"³È ¿¡tæ~¾•^ᎶÿQU¬ºÀ¨{x‘®ÞoÐÍ:+±5L=ç}µ¬ý׆;¡Ñ" ç÷çœÃú6Ýèôo‹<ï\Û²áyö¦/T,}©IM½ÇÀu9ó_r“þ±@ÎÄiÿl©õËRâL©ó"©ëb©}±ôñ,iïdiw\ÚU íK{v m‹Èõ]ëÜKs¤¨ÏuÈÿ9Õ™†2Åt‹Çoâ¬ïÉÔ™6ð 4 ¢ÅC¤BùàEÁ"`¡a .½ÿ¤1w¦T]þw~î\<“|–káµ%J>ÉÀ¢ÁÞ–G !/X—3,ûmHõAó‹Ø¢Eù„ø[µÞÑìoHw3ÑÆÇçRQaֳΰ(.. ~¤:ÁOG´wcÒ; zarù4ÝéÇRõaN¢•„ÈrõL7GZ]ŒWÍì øo‚RÙ]\: —鳬ä\ü,<ƒ G€¨õC¬ºrûOQíòˆ“f‹VâÛ üÃÝÊBH÷Ä)¦FE¥_µˆ]C¨’Zz/2Q©±å%øÛÁ\?”…KeÀÂ×&Á !ÇÏ~²¼¹Ì‰Ôœ“QeŽÑm’W°[iÓêÄZ%Øiž×f?s »Zfàõ|ò‰çÚ„3O§r T6Âö÷:mGï~ŒiäE=üØ`¼ l+#°xálrV*«zÒY`\ ¿8èë—¢³(Å´ÓÅüÑ fO­¶}So¥5}+û6mÐÞÆõ®–¿ª8fr…òBX$†BaLe—4³ ò]öÉË€,О €oUðl¤Òóƒ‘ Ø3 )PºsX8 Å(Ú¹T¥  °°·Œ­nUèf5ï¾ßþîDíˆ_Ež¾C8YÂ(ÆÑE‡R2W`¤¨ÀÒ1ùÙu©4x~ö› Ã#$™PÌ,•‚4]Œ¥P­É"žÝš¡oÛã6ø#‰Ì»DøØ»ŽTÀ»Î÷V·œV«nÛ@Œ›bFF„Ž}íÄã¥$Ž¨À2Y±('Þ¡¬Ý™ËJ/•MÍC€`ùXÔÑ2h!„c_ÏÕXÏ?è&I’ŒÝv/ö²Å¨¯:|o ëƒ03Åv7µhÆ¥¥¶˜ƒˆÀ"+EÓ°ãÂ¥ƒ{èÆøñØ{M-2½e4B¶$S-ØM#ˆƒƒ…%€w ÍÚÓ¾ÅcN}Á&9Òñ§a5J*•× tEe²ü|´¿ÎáºòÄ0ÒL2Ø‹˜G-¯½Ü¥øWÀ †%Ñ—#•AèÀd0ï:LÍ›6¾3@†G½»pú\¹8ˆ¶‚ÍÚßUoo¼cšr†HE²ø`.hŽÔ ç‰æ]ÆžOÛ žIÁgŸÒÙaK²eº9Êèá•ØZN9ñ¦M”m}Íðû!äY lÓjOÝ@: çKšmݾ…~w!¦ááÙr6©9¦mIpq¾ây/jbÞ<|]AÃŽuöv³iÆ9"‚H  =‰œÑ*(“Î;[jm3¶nß‚ï+­!ž÷’Æ„.;ší¨¢v·SÅüª'8µt1oíLr`àlÛ•übÜCeÑ÷mÁœB™ÃZ÷ÂÁöl†p‚HÌlL1Œ/G±lÞÚO˧-ÍU™d%±—8­¦Œ†mz½ù*ïVÞÿLµÖ€~VÁ*N[¬x›Ož^hÚ@>—z×qƒ[Ù¹V^¿Ì&–Πª¢JN,°XÔ°d u÷ض¦ÛÙÖ ŸG½<ëd.ž÷ŠæÖÄlÜ— ‘÷Æï;O7ôí`2Î~<Ò’¿ì|FQ1k©&œïo†Öþ–L­•eõ·‚——uOb&͉“*”¦  ZdlçUÞôþ¨+J¥ïb[òJÈ›mUÀ¸®WÍÆ?ÐGÇgs’ÕœOQé Œ=q—ÚVÙÞîçù –Bƒõâ`¼tuL2G!ít"`,… £ Öè»;™l•gQ>ã§êýh:í­ßó~¤G‡ú Oô^Õ±ÉçqöÐáÝ›-MŽÔà¸zN³ÒØ&&NàjM±¯çjo O±ôL5Z¾]Ž¯¥‹¼eƒåϱš¥zL«ˆŒ¤±qµàVu*ÝåR‹$w®ôLYZ«)øÔv¶Î­Üë‰ôdkx>Ò㳕„Ü¥wºß•Ü(=Qþ[wá‘üÈR=ÿ¿Ë­æ4m¼FîíHkÂëŽã³îq;K&ÁNíÛ´—ª$‘y7·dúBš¼6ím\”ác¾ˆ—«ejYx<×ü/ægÊÁé÷s*IEND®B`‚qcustomplot-2.1.0+dfsg1/examples/plots/balboa.jpg0000640000175000017500000011150313532027716021736 0ustar rusconirusconiÿØÿàJFIF``ÿÛC     ÿÛC   ÿÂeôÿÄÿÄÿÚ ýkÈy×Üõ:Q^æ"X†V=e{Õ¬b/äˈÄUé¶ý^¦efŸ„<Èò-PèÀŠDÔÊ;¤sÑ¥³3HFÍÛqZˆ<Ï%\êC:N·PÛŽât1 øÒîzX¹n&¤¼úÍL‚Ûb‚]£/ª¹Ìz‰ïz½’7[„ëPœV5t¤:µŸ˜wŸ.6:£œ5ííß­˜À\ÌãŸ<‘çe_¶ £¨çº;j\¬mÎö*ÎÝ•·J_“æjíÁ-»l'aØÛÜHmžjz1¡œ’¾oW<•BL`hݶzu©!ˆ v Ý£v݇:ã l,@ã ¡¹U²k*+!O»ëyü¾s ž÷£ÝµˆiÆ&vµcÚü'ÓòãˬÅç£u§Iª­P©™•º±ÆN¥n{N¥®Í:DZèÚ23g¤ü3Ì .Ý·bR@î<§¶ìs+̸ám·;î8@)SžäD¤/è:a— "žçwt¨Ô–-¥Q¯B{+oC'ž'çC¨\Z£Ó,Õ"Ì(ºØÜQš(ŒËeºXÙœÆt‡ Ær󉼴<>|œ¼Ü1ã£hÛ±+:­ÃnÙŽaŒ¢ê ¦¤… >°¨„ÙïCšõó>…áŸ#R~Çwz&Ôçì&Pt£šÓ“`Ÿ˜°Ž<ÇF±œÒÏœ¨qw ¯¬f’YK:-Vš`/vPÊD±ßKÊ„ô£äù¾n»$6íØ’’•¸mÇ°ÆÊtSQªu,Yµ€Ñtž(!1C#CöºáŸ+Âz½‹JP\@AÒæÌ­ªòÒ¤]BáI ˜ÀÙ…F“UCÏ9k¼ÎëP ´»0´ãp‘åyžtÓ–a»%·mÀĬ@è;¶lº(²’mÆԱÆQtÖ$AD™ÈÑ{K’…—_H 8· 0Ï¥q¨ 4GËŸ:’TÙ•”VUÅlê5Oxå.9®ú¥Ï^9›éGã0À«c²xù<î.E0Ì7bvÝ»m•ˆSĶ4lÊð:• Øȶ‘¶nxÍI¥¤ïSÑ‚|”"z=]#®âØ4 ÕZ}Áb^|¹…Qõ2òÏœ›0"“7¡k!JRdÌcQïIÕ7Ùç):^IùžOJ­×†ÜÛ¶ìwRjpám£5¶Â7–€§XF¦ÓK !ž¯¡ ù(’_×ÑÆíÌ&ÆŠT3v ÑJècä“-NUi­÷š1'nA¢¶Z…ªY[àÓ,ZÔ«h|®FIp ½¶ìCÙ·c¸è;ˆ°¢SÝ”¡ÑõÉe–êóÈÊ©h­§Ã'¶â~ÇtSä¦IoUµúZ®­‘4¨fäY÷4³‡ÖÓs£(⫸Ýn‰ÀCgT‘Õ±b¤›éJ #IvR©âãGŸ!TP#¶!‹m Óšíu®ÞŽ‡VÚϧ0fÀ ¹|Ì9ÅE9VñNÀ•˜¯£3ÞíŽ\”JuôÐéÖaÔ4ø×Z†)YΜʜ‰ËLö± ¥u©='œØ–c¸ÎdïM*”T¬ê­J0‡ËäÕÂrE·CÆÇÐè½]=l¯BËS—6 ý°…’P™'6‹f´yg‘‘•tˆ<óV4~Ùþÿt‘äte_[›veƒ0ÔÚëDyÖ&Œ£j *¸þž‰¦0%R›kQUí¨¥¸iÒLgyœžg&GvØÀX lš?«ÓÕEûõv]Â\s;¶Z$çÌ–ÖÑuñsŸ9Ó•ÔUTR=#j7O¿èÍJUu9·aVÓãMm4â„çâUÔ~ž U9SZÕ3›YÑ)›6’ Ž¥Lº'#f{™|Þ,‚p<6¶çZ—õõ•zTÔ¯.1q9dŒäŒ˜ãеé$ù$ó92  ”é¨àB©%VŒOU"12›(À U_Jˆˆnå”x8įOW¯µ÷ë™ø;iñµ.xM9ÕÑoV´Dêy¸|^¢+›hÃävN½²Þi´«Àq^¿sÑDxMgèõõ(SA›ÙI%$ÙfÄZ²ÑÉ@%w²Qwk2’fÎÆuNZÄØï/"‰>‡GM—ï1K2Á—)Gϳ¦þ…œÁAv¤¥â⃎"m˜;fâ)(s©)[ÍW‡,pF£ÛïD¹§OZsj´Š‹Èµž(:°¢±èÕÓ¨0 ”XFLË€L@URbQçÙ£é_O«¹Oiö{6ƒ4ÕQDF;CWMí£Ðlíʘòyü|5Âç¨ÝV©¯èÖÛ‚Õsšjäœ|Ê2îÂÍŸîw¢<Že¿£©Xðh§%‰æ;-ÎóÏ,¡Í“E¨"ËI“¶â †Ï‰ 矡Ó×gGl˜æ/<'43-=EÍšÀ 2†jGÎçàšQ^ ½5ÏÛi5Û­Bm»q:«œ¼2ðÃpá€F«Üôeæâa_C«©XˆÐÆÛaì¾£ÓΞ"Mò–dÆfî(£”Ý…G O‹›˜ï×u»U±ŒŽyI 1ÍÝwÚW6¨ãÚlZ³›Ž8s,£ñÜv“Í·j_ªëõݶìaX{›Ìó¸zgFÁ„úþ¤œ¼‡©ÑÕ;„©Ž<íµ4ã´í&’èBlí®’(¤í€ wlâŒE£Ð©…No½.éèmj€­ÆÌ©Ì.|þ_7"Ô`ÜO0Ö/¥…—0=KïÜe‹زŽ‡c/'‘/*hݶ_§êÉÉÁ¸z]á2d‰:¶TåÇvîÅ`´ËUÌÊŒøœ Û0ªî,Ì©ÌbÚ¯©éµÝ쀚ðÑ“±¤¼Î~X¤†aÇ’f²ë<£ƒz禮 À0ÝÊáñW£nÝ·¥èz±sqr¥½–•†Íz&qÖÙƒé\™"eËEí„cØ ‚,¾dÉ·>*oS·Ðkײ¡ìmÊŒøeÏäsó¯Û’fÒl¯I3AÏÇÄ=úm·a±<¡‡bì0äùpx~mÛn;·¯ßêÉËÆ 7ô´û:Ý2™3‘9â(5Zº†˜!0f½¶’*ºYqž.ÖÜuvêôº{Tj´3S„øµ%åÚG°Òu‰3vÛµímiçÀeŸÒèôì°¢5Q–rfÛyÜ~2!<Û†Ü{ok»Õ›Ÿ™R‹/±¨šT*ÂëfP±(”GÙ°`@¤]$Ut¶eá·N}lÇO«¿±ãªÅQN7?2‘4’c¬xî—½½ÆÇχ óçÒÖW­ô°SÃ¥Å*)-$<¨¹9s ¶ìwok³ÕžL`΃•ªË¦RAN;ŽudG!а8IVØTnÜp…2ê”ðmllÔÛ¡ô»™©b'Ÿ.20ìIŽ±Ì0+ =ŽæÖÀÏ“¶ ö[²†{‘Y‹È«Å¨ÆhùÞmØ`=†ã»zý^š¥4F »E§P™Èã`÷¢¹Ñ–l;ˆ0ᤈXf€«¬I‰3Y~ªž´ ¸ÈæåB&“¬sY©§EVëÒOlm8V³Å×»Ó­O(íÊ…ê /7 |\«d¸w ÛqÛ‡­Ñè* ¤‘ÔçMg 2&­ƒ3¢hurh6S.¶ã¸nS™1'n:»tú±.Ъœ¼n~lÇIÌ3%J­Öæ©œÇlU‚|³ÊÚ×èõ^àÍ6Ó…ÕÕ3±cŸÈtc¥°ÃX“5ìèëk1 ªk9“—[PÔôÛ£‹Nª°^­“X¸9srÙš+5âHI»z=”*Töüžƒvù¿V ‘‡®~¯™Õ7T©Ž‹¸"³ÐDæÁt&eÆzä˜ö/zút¶lA|¨Bt^ŽÖ$Ä‹YnÊ+m;b#@>js)PÃúµîclÇpݸnȸó£’NUÄs'¬ÖIM‰6 }?Q†òºgìy×–¹¨ÑÙ|¾Ø?žéè‹‘hWó{¦š®mÌ8b¸©1Ö:Å®öÒæJ%(9áƒfÄœî4Òþ…º©9ƒiÊ‹/2|iIž^t57 IJæÉ—Œüœù“0E‘E°Ù9&Ð7og»Õå2u'“ërD¹MŒæò^>¾Z ¯‡¯é|®”÷xäéL;˜k`šëf"MÚæ§3CÍ¢fÄq;QFµ­k×^«-ÛpÚK o2|ÑËŸŽ©º½ u%†ììŽY‹ õ+—=œÐùæŸç™UD^Ý6ä݇m}™`1ÍWO8ºT†ž‹}Ÿ×äusÙ:GTž¡ÓtÝ“\ëÇ_l˜\×°Ò_Wº—¦·&pĆìtaÅ[a;²V1GŽ"o§}M;—RØ‚è\Ùñ”œÜ^_<ÆmÊu€:,œC‰³fí-¼Î®rbË2š1¶â2Ë™¨”OJ÷<»Åtñ{åD‰Ï6,ÅM˜† Ök-jmsj%Žb¥Ã·ÒK1œ±'xAS¶s[×·kXöð£Â^Ÿ.sGÀdó\b¶)Ó…Ðq¸×PqõŒ`× fîˆN¬I„I¡&,çèÓ®óîŠÇÂôùõ‹•®æ¯Ý¢“šžÖÞù˜pÇ°mØö4¹&fb“#ËÇpÔ‹+Õ„·j×Ë+y#\S0Œ‰ã¸ا°Ç°.ÄÎ\æÃèÏŸW'–Ó× \‡RM:–MúãÑãèói!çme[s‡ £ó’×®½Tñ"ÚXvÌ8+1#‹lfTisà^Øݪo_NÒæ…Ó9nT–ÜDì<§O&Šæ86‘ƒ ì\ÀK=Uë9aJ¼ê%’o=ÓWs±¦Tóä–->ƒÉèù¯CžJ¡ÕèêRª9q¡fÆÜ33lÓ·Å{/aØpŽ\kY™ Š€S5è&ºz™C€ñ açÑ#a€ŽÝ·m˹(ìµþÄà›D噢Á<¬ÇÉ` ˆ’+dúE¡OSËêó{9 í›êÆÖu¬ÜôâúI“ ‰¶˜ž˜†hU*DœðCœ&¸»°í»;qÜt“fkSÒÖd£4[pÛŽmÛfÚ‡¦s.eã‡×S ce©™S&ÖÌF¥z&!R—¡;_ÅoÓ“*ô—†¥QÅö•ÂH±ìcfÀ¨“ÎQÍ‹Š¸vÛqÛŽ“Ûi,ÎÃF=èLÄ]ä¼Î8ðGÅÏÑm›pÆŒø¹&K¤ô—«~¯ÐäÒªSE“q+ %™ÕÌcí|÷ 9^ÅÜNDø>êoV]I0ÒuF` T©F ÒÌ¥Zô"ÛŒ‰Ê¥/Ò×håËKtúuêÌ $‰ÌŶ¼Æ6$''ò@T`ݳfõBŽFYX¯»Ô®®a4¶Qj \r¥)äé^¢?Ïé÷¼®£)âzóTG×.;6â7bÆ¥ôs33Ý‹2Ž0”óåÇH¯§N +åO™º¾…z·Çv,;mröÚr0‰gÈ;;ÒRqp. À5¹Q¨ËÂJÎŽ”d)ïøý~G³ÍâúÆ’›0y]?OávÇо­ÅDéç·+O^t8Öbrú=¥Lî¥XÍ¥¸žØ¶ÌsmÛ±@—™>^ëW¶‹ µ«œðÌ{À1@é›%R€î˜Ò;*s“Êó`¢4r2Hš²û Ðð½i?Jº¹<ßo•µ‹¼^´÷§$³‹µ}œ®(U'Ô’ðoGƒ§‹Íê1õ1»<‡æ0Ob$,4lÍÛ±ðÌ‹êîšÚ‚på§9ê\÷Â7l[QÉJógàxvÚ§8jþkR?ƒˆÑ‰eRéÿÄ)! 1"20A#3@BÿÚק㦳ÚOá‚,²WìËÖõê+ˆœ3OeÛÛ:˜Æ˜ˆIà@±ÌA–µ÷Ùâ|•ÊÄ¿39„F«1—oê¯ÿí!<48î¨ÒÝÔA™U\XØ„çKA¨âfc0 BÐ| â’Âsì¯Èé$¸¬[#.ée8òE,OG)‰ hº?º£ñ/ÓÕ±½¯¶úÕÄs™ºfgT]åÚecŸ@óa8„æV¹‡ˆç•Ÿb“ŸÞt*Ø•8pé ΫÜO½³úš± ƒëq†.˜á›Ä.âØ@L(À'1DÌcdˆwžà—¾ãû³ `‘+ê&_Ú'ÙŽD]'³ÄYœ ‚(åßÄsüÕ›: †™ê1´&(—6ÅýÄè?PvªûÄ÷ÿçú41c˜¾ÏÖÍrÇœÁáZÇ:Ü3h‹ „ÅŸAcooÚN˜ý!KE¢wgU÷‰¯èÐûHÑ#‹è’ÆçÁqc ÐLÅœh‚!h9ˆ N¡áý¹˜˜×*¥¢Ò6…Œå´ê¾ñ úÿD>´+–‰ò5FÅcà9™Ä&(ÌF:V#¶ÀaýyÐ,i·0 Ú.O‡Qö‹ë?“ú±àâZaÐO~¬c± ‚¢Fiì¨ÌÎÐ͸˜bÒíLÐtë;); ?%Š©37MП.£í.ŸÃ¢Æ™É³Sô’FÐL4cp ƒ˜Xڟе³Åè^ )I³k<b|D zŠ=›È„b;þÑbÏïñ ö#™˜ÇWúˆt©c& ˜9eÐfƒ˜¢Yf† è\Á]Nã´±U›ØÌ2©«‡{Œ@°C :oö ‹?°úzy‡A,ÐÅ'€`„ÁÉÐEâ3OqG.Û|q11*éÞØ ¤îª¾ÂµF*Üg&l=Á#u,Ñh{bÒ• ¹Æ¦|®ô4X!é`â9Ðè±þçJÆ:cƒ:(„Â`|A9ò«¥{bôõS©0xµbTc4Ù0«¨ Îñ:Vx+J€%¥¸gÊÏ®€p$)äžètA¡€d˜`Œ`ÔLâ3gEŽÙñª†¶-Õù´±â6ÎáhTÕBÏd¯¤Ì•ƒab´Ë: ß™òo¬ñ€=˜ðF:`ƒ…þXà?š6‚1ªVÖút®5ÐÑk™ –‚¼ÂV¸ýLÃY§ˆŠíÄZÚÂÖUÒ­·µÇ\j40øûX£,Óûf6¦,°ÿÏO@Á €j4':f =šúY¼ 6Us ™€f5Ê‘º†hœ×ÓĨ\$æɵj[:¢Þ*³l#A¡†åWþþÙ3¦$·D‡O@™ž¤ê4ª–¶-kX²ÝÓí!|Fxnà®-Qjœ$k E«1ú\g,fá7LéW¾à›ÒÉŠØYCWçëJ¿ôbþüztÜ]·< Á àj<«éá³ÚÌàG¼Ca0#4ìb(ÌUÚ °ñ(–ÜÖÂq7xˆ«6™´Í¦b+–ÍqÐèŸw‚ÞÄ:u|k€d¶™ãôc¾aÌ$,=D.Z-,ÑiD… ]Ñj„…›‹C„Ô–™…¼ëX!Ó,Är#o‹z‹ì§ÚD0C3|"ú30ù‰õé¼m3ÜZI•Ô«Ó¼À¡cÙ²ñú•ª=Œç>qªŒ00t÷¡lL“1:¬-™™ÔŽ¤Ç0huXþãq‡ÌFa9Ó0)1hÌT!lÀ¹‹OÛ2^|hõ&ßLJ«Ì±¦g¹Z`MÐNcŠl{}šgOZçâÐÅöa÷¢OqG.W`ùçv¢À´<šÓ1T,{b!hýJÔ‹qªW,³Þ•‰îmœ^ºÄ-3¸Ø{4x´aÌÏÆ ¯h„ê!ábú:*—>L|)L“Äfžâ&fBÂY¡ÛP»©6k‰@ݽ¤ðè£18…à¢Ö' ø€K_¸Þ?Ç÷©üêò}–h yñœxl\ä…ÌZ稨l–ޔǰØ|3¢PL ‰%1+|˜+c#<öUeöqä}¶‰ëúÜ ÙMWˆLIžxŽFï#áX™ÈE˜¾â> wWŸè¨Z%A&é˜çQxZâÖ! Fx[0©™uß ÆÒ¸cÀqáücÉÄwŒ|A¼ÏS—ŒË@¶æ´ë1¨0³“;püCj®™…ø{s=ÅX«ˆ÷fúN•ý˜ü­ Pn0rIçMßqâ‰am£¶ÌnêEp’ÇÃW1Spvp8…å1)¯q^5°œÀ¹=¸Ø¬=¦Í 0ùÁ¹Æâsà¹Xæ&„äE]ÆÚûgLãÆ´ÌÙµU ¬»©ÏŽ4TÌ ˆNä'1´ÄJËE­”myÚ³=§‹Y›vÆ»Žt|”g^›¥GªÞ†¶‹Ó½Ôt¦€ã]¡¾Šªîk¶‡X['BÅ´õ=øV›ÅÍ‘­J¥·5¾Ð Å«LÎL=†ŽX‰\wÌÝæ%…Gu¦æžny½¦wÒ´zJÂ50ùt#åoDÉ(tK?!J_ÕŸò=àÊÊ¥âÜË[#üæ+ÔõÝ'l„³áê{ðUÉá`\K:ˆN|–œÅ¤ÁLí ™­gäCsÌpä±Ä ™UJ£r‰Üº!²oxÁ™v#®ïä—”OÈÂõNº­€¿Å Á3‚ âX¹)ª6'P‰UšúžüŠ§au¨=†Íq¢PMI ¢wLËÛ&lX ¬î¨—_ºgJÓ3aœÎÐ@$æTªïj fWÓ«ÏÇ©%ä#ê|ˆ*gÚu º’HsvCÄO³^”Óh4?OÔ35Šl±†Òµf¶øyîðZY¢t EÛ\kgÈÁY›TNའ’pfÉf…m‰Ü›ÉŸ#6²}fø.eײøŸN­pLS‰e…ᨚÑ Í›Çl¨…²ÃcPTV:DAgùÃÔRÝ3øc0ñ3¢TϦv¬ß˜ ¬YDkfXͤÎÜÂç BødfÕ%(ã¶$lÙò0!‰Ó3Eé@–,êéQ æ–ãi‹k¿,qbî*=ÊëÜa…Ë?%ÃŽ©{_é0q¢&ùi¹:bW±HhHÏy~Tüƒ;³|îÏÈó;ó¹™îlÎ&4Ì­ñ;¦d˜µ3OÇ" x^ž%J°Be’øBh sÍ_*÷a”ä?ý"°ºÀØ‚Ì-yÜöì§1,jÈ38Ú7œ@“jvŒMƒ¢gã™Ø´³¶'jv )ŸˆgâøðÓˆßvæ-foÛ*ÜÑî›æù¾;KLo~k§od?&ÜQ;‘T™À²µí‘‰ˆ£sÚ6n™AsÐWb|©„æ˜Ä Ù2Ï6óÀ…æéŒÁ^bÕ6‰ÀÑ ³¹2ZcLOˆ…Ä™˜"uV¤Oô˜EëëiÝ ;“»;Ѭ–?êÌw…£k¡ž¢|â3ºw•ÄE³-±?ë/_Çzo6Nµ»½@œ²(Æ!À;²v“6@“Œo›æI²ghÎÔÚ‚wêIoUº3?¨fU¸ÆWØDîÍÞx˜Õrœ¿Pͽ˜S ÜÌ´µH#7öÛ¶~3Ùél²¸ô­]/Ä ñ‘Ä`Ó7 oÄÞLælœÎгò+XzåÖ±†çhI>X›f&Ø*&ŒìblMÑm…•å,*WÈ@³ddÓ­¬wŸ“È®”d+¦q=œN m­EU¸»üäEèmYgMS*§·cº`À«2‚w«Ïä¤ü©ùM?%áfi°˜´1Ÿ ;);h#íÒ´=j%@dV³²¦~8²³æ&é•3´ 4ÃYœˆÃ`‡–# ˜Œ!¡f•0 ÀˆÕÆ Š¶l½~ „Ë: k]»”ÞÙ麭Ӿ³ýÛÔ~Y4o3qœëˆ+&/LÆš/M?vŽv ¢~<¸bm̯§/¦2ΣVA®³`Îfã7MÓƒ6‰·BËî"ˆlfÞqªÅÑŒ'žšƒKUH·ªµn¸-1ÕEj³S|¬nˆ¨ê©V–öºÌw€0ZËZZ+–Ú×>˜‚–0tÐtõ€µÅÜ'zwŒî™Ý3¼ÓºgxË:“‚äÅ2»6ÈüËl”Ûˆ/\we ÂCZÎʙٌ˜ŒäOú°ñ¦¸Øø$ö$!eoÖ•¿è&'xc[c9%ÃÆŸCÙbB5ÎÆÉÊö%ˆ¬÷Š;Ê5%H|ÿFÅ#²†ŠËáïè{IÖ¾ŽX–ê4ãµ¼jÆÏ÷l‡…Ї„1 ˆòðŹå‰P…*ßÑm‘ÓlZic“¢ðÙ-OÁÛì­”(Öb¬J·PÑ?ýmcï ð!‹1ÃÞÕ†$2ŠÇ/¢:_¢ŠŽ/Y”¨somF?dž$!_ŸŠ±»wµ’ï/{†1 [›¢ËÂ"³ÙÖÙ)Þøiý³RUÆtãðÿÑ?þw2}á1 džåð¡»Ù¥YÙu—*%6ó[r!§D"NñdWŠÛÎdüU“—“½óÂ^c†Î„=ÈobDU"ñe–9øŽMî솓}Š*#tjNñFœKÇ_¶§—Á I6%˜òÏÈÁ !/‚Ë,²Ë$$EQe–L‚¢öQCe‹$ãD:{,¼ÿÄ+ 1!0AQ"2@BRabqÿÚ?—ÆŸ\W=_1!…Ùø7–Äb_«·ò=;Z™áâ¸ëGìB#×Åá‘G\$ðرy±rÔ{b?‚øÕ’Ó<¬'DfžÑ*™Ä> /.±Á±¾aeyåѯ+ññ_)FÉB‹ûÅ-¨Õ^lÓÿXybËÄ„K¢(ë xC*†È¬3²¹IÒ$íßÇ|¨–˜­a>ðDiÿ¬> /.ˆ.,XCxKâÖŸ×Ë|Ú±Ç1“E£W¡ôiÿ¥Éc¼± X¼_vEc²«’$ö¡»wó®n#´wCè‡ûä°¸DxlCÂËņÅÇZwãþŠËã(ØâѸÔìBÿ|–$ð²°Þ{Ëb5%µ|é|lÚ‰ö#©rXXxCcð°ð—ð±b,Ôžçó%Íp±³É>ñ.ÅÍaábà°Ä¹,X±­©^ËBE—ð]eYX–$.¹1aæ]‹(C|Å‹‚ðN{Q'¹‹åoᲘ’á,H\‡—Ñö!áe X|R¤jênx_ ~ÔßBôíö/L¾Ïb'³ÃÚ‡á?O¡Á®Î‹ ,–$C¬<,1ÿ+Áv³.…†,1o aç[SþܯAË¢:?¢ÑHQqÓr#¢£X¾.IRú[ìPHlž·Ò¾Ç•—™’Äx,HC–?Šá؆ð°ÄŽIî|£§»²:i‹ádµ7Ê] Oÿ!E}bsŒ’zÎyyYy˜ð¸,1 Ygކŕ‡iø¥Âˆi9ÓŒJäÚû%«ø\æGI}‹Dõ©ø%'.ø<¡aåô1wÅ á Cë0\žÞ7CòQDt܈訉rrH–·à£)‘ÒK³ÿÌY=]¤õ\¹<¡q} |Pð†D—!‹(y蜭â›#§úW¢Z‰RRèZr—dt’àÝÖúC·Í¡á “!ß a‹ ‰,%Á‰W’òó)_ŒF Š4uÁÉ.Ç­ø\¤-/Ò0KŒµ(“r(Ø{dt‘² èQáµ~WàôâûD½4?L×EWbçøK¼¡ã¤w„²Þh›*Èiþ掉j¤=I1BR#¢¾Ä’ë‹šDµ/£²Šâ‘LòV(ÔÓLªâúø>Ä1èEe YEÒ?Ó"’Ã7(’Öü”ˆé¶GM"ø·Dµ ¿‚1æÕ“…ò6{©U±[#¤Ø´Ôs\%4‡+ãB‰X¡/ƒ[Œ°»)v7…Åï=à±Í!ÌòÈÁ²:_¢ŠY® Ñ)ð¢Š#$Ë,Œ~ÍWo‹ÏÖPù"åö!¾mÐÙBˆ‘›¾.t7|+ uÖ(_ Ÿ&K øÄÞ¥ÿ+Áåñ…Ñx“ç7fÒ±x³³¬ßé)æ¥c²0ÃÊŽ/ž¤¯Ç9 BXEåvÎÝeò~8$ERX²Ç-£•æ±e‘ƒ}Š)bR(¢+áÔ|ÆžRûà¼C÷t„Ûï‡C|#Å«þ³\²0¢ñ"²—ʼnêm.ù²XÒÃÅá ’ó"%;Hë-Ñ)^+ŠKt7˜®wMeÝeócÆ—|“DˆùdŽ±Tï 2u„³ðohÛebñE 5ÆO%›¬V®ÍMvüDl±<Ùe–XñÅc,²Ïd?G™Ëj³K[~[¬%˜Ä±âSüãXJÄ«…âŠá|'¨¢JnCÊË/šÚóRþM?]©öKÔF*Ù¥êV«¡µf¦¯¸üuäõ:³ù4[pWÁ«#¤£çbÍ ]’›|+ŠbËË‘¸»(®Q-$Éh´<¬1ðõ’]2©Kù‘©rUÛwD47¯Ó‘&¼’Ý(PàiF™ê•Àô¾£wòÇ?ê—àìYBñ‡©ø^h¬(Ø©y(¬¿%%_¶šepcá8[ò{g¦‹Ýäž–Ñ$os%£öy³m’¨º5¿··èkÎèš2”£mpèï… ùHrÝšÂFÓiY¼y¼9„¯” Î%*7Ìœ¼y ‡éD £ä—”RexÄ—’èö竨RgüdÑ‚¢.Ç©NˆÍ4wÉË4(› «•—™˜òï2ÔŠ·àÛcÂ磭-OÇ~ 8¨’,cXpòU—V˜ýD¤GÖW†)ÇUZ†ènð¢Ù°QXy¾5†Æò¸Vg­“õ]. œ¯6{lBŒ_’‡ óx¡Ž.míÚ»5=<#=/;OJ¶ÚúÌ¥HÑ”÷yèro "Iu‹Fãy¼Ün7æóqÙC(ðXžlÞ‡­KÕ~Ö”‹¾ò¾8’tl›•ˆq®˜•4#e»#ÿ±èÖ¦â~IEHQ¯¬!¼(YG‘D£i°ö͆Ói±› †Ói´~ Ø¢¦ä‰k¤K]±ÎOšæøDìWB—“UMÕ1:^O.Vΰ„è“;'/n6‘ÿ?Swô_¹åKôñôybXK_ÆÑGò‡¨‡ª{Œ¼mLöǦƊ๾ãÁÄÿ‘éÙ É> jÍG·ú£ÜZñðM4¼3Am€„‹HVuß +–9$=Uô{››øªÏa2^ŸðzmÍñÒ™$· 4ˆÓG•à_ƒ[XňɲÝô9}KAOÌÒz•ôFì—ÿ"¹vPâ¦uç›â=Hžèõ$Ël¢Š(¢Š(£k61i›E–Rd´S%¤ãÉŒ±Öƒ¥g©ÕÙ‹¶«6zMyëGc#ÒWôBŸd©ªÜ|JKɧî%q4­¯èÛdô©ÙíïìPPT²¢Å¦-1D¬QEb³á‹(¢‡àìÚV<–Ë/7›7bq²qÚðƱEaiîÒ¶J #Ñx"ükz—¥:HÒÕ÷"MXàŸƒKMB> •£V;zØõ4´ÕJ(®VYe‹ÈÊÅæDQ|ì±¯ÂŠÇÿÄ0! 01AQ"@a2q‘PR¡Á#B±‚ÿÚ?ÀAâÊwF#Þ“¿cF&†Óô;¼v3‘x£Üy̼S÷cß4äÞ9¢‘ùîšÊ}û_¯Þ|ÑŽ ÖØw,pÓÎožî-›ç?s ©7èw{ž¥‘ì¼÷£¸~óÒT‘Jõÿ ý–‡ån?**íãÛ0Ëéû.£MåoY] VªláNŠ$ðœRÝãã‹ÎKå=fàZ_>T@S‡UÒœÀî†Ìmò:iŽSýJŸÀME,<)¶Û S•ã0v/Ù¸ O%uu”ÔÛɲpJò¡Oéñ§*zêò˜a›"ɳ¤+Õ@W~˜ÿ×|ý‡Htõõµ]6MŒ¦õ×ûWQüg›dùo_Âjt²l‹9Q"Ç©5=#±6 °;+ûÁ J‹'å5å9œzé i]5±ò¶#ÆHË'=ëøÃÉÁ W'…:qûjÿ¹*³ã²•ÓgrTazÓSÒ3õÑyÈ öÞù-šçño%qdÆ9Ñ5yNKö@ ©ïF²\§¯^í§ð>MUrpœàßÏjçDÔIå9Æå0Ìwëªm—]òAÛ#‹N°k²ü&NG•9¾6Ë'X{îÆ£Täãœÿ¶?'0èš1=š®’[l·Âäevˆ§"uÏ»OÎY´â€Ã±…ÉSŽTg°Ó8݇Œ7Xjï—6 ý&¦JsŠ,ÑýÓØråxÍ{h0½‡iîµq’?â…:ršˆ„^•é*BôÛ rÛ›ÉN»º`X´#M4éÊïå=D9Ùe]î¦ÙUv)Û äC©Ð.˜^1Í° ѽÔÔµ|© #2iö©¾_„õK!Wà ò ¨S4yOƉ·AY_¥îïá93°Ë`ž¥ÓóŽT%r´‰l¡ @ÞL[Yò‚¬3’ÓÂÕG¼£ËYNö½_ ØŠ‘¦š¯Œ¨ÑÙrTáô®ª¾Ž `“˜È­QeêQ”E p½Ó÷AÐé¼jÁÕ;^;]§•]@o²e{3EÔWH¶lŒ÷R¡Jab±é«Í¯T•|ÕR‚‹•O¼'<2ûf›×ʪK¯Sõ]ÌÞWÈÉ€ºá@PÙ¢ŽÒsY2mì4»$6¨ŽŠ)vNªt[Ãê¼ (]&U÷z‡ú—Ò:W¸ÁNŸpA¯Èu²š–Ž ƒL:æOdiª£¡LŽP¯í‡h¯i:S°°ðÌÖ6Ö„¹±é¨Óìœõ{Ù? ¶²lÑIeª…ª’µÇªÕkŽiG‡ ¡ü£t8åÓÔnÒìú«Æ‡xü£çUzž¡½Òåy°•E4‰(ŽTTüªé«Ø¾ LêKœ‡Q›•ÕH>Ê^•ûÿŠNˆø™ÚÊÔ¨þ†ЦmšATÕy ØŸUHÑ¿…xàzP$€>T&-,˦–e0Ì“d Ù«ås{mÕÄ'¤ƒ@ÈôÃÒÕIpSÓÕGî–úÀxB½ª@?Qø¦ÖÂÚëØꫬǕS‚*äê´7ŸøRí»*®½<{.¬*¦Zbš¬€ 2×/E¢œ2Ò§,Ü”ˆx²Ÿ¦â™õ t< ¿œ·LiuUt’Ü+¬÷w¤Bþ€j€šŽîµSP^«4Z(Z­m×dÁ²iÇ*2® uÕK¯ßEZ'–D;£ÒÞÛ*©®€j:*Š‡Óû{kªmÊvÛdM²!M Ê,N‹í·±Z­pén‹Dݦ¶Â›²MuRI ì¯šZ”Sê­s:ª™¬«c» áøL®T‹§dëíÔâ–ø4SP W³E¢Ó·Œ22œ*ˆwºUˆʪ¯3"÷@ªJ•ÝVëšx*žÈC^«m‘ê,Î0ˆîµÄÄeÿÄ(!1AQaq ‘¡±Áð0ÑáñÿÚ?!ãò›g´ 6,¾††‡”KYƲp&¿S…ÀœÍšÒ@°Ä¤W,•’ˆ½DB8²,î7PZ.ÙS^¸ÂB „&s†£-b^”Ç44<¥àb?@iai*/‹¤‡ÐX±¨w#Plœ>E…¤5„£ƒŒØƒt%,mð@„ðDè«Ñ¸pA"½ ç¢÷”,¡4@„'ÂÑÜŽ[ HjPëÙ!fK2BctŠÐŠ$J…“ „°ËzŠÙ3B¡F„Èç'$:D8²öð˜\qðÂn¥ÐvÃ]u¿±eeâ2@ðCÞ‹ J*™ÀËä`³,Å©QGÀš†³u†lUG“Œ’1l«’132Fî‹ÎĶJˆ2ÑìLÉ‚Ñ %/Ácd©‰2ÅçúÆÄ6s9nز¾ äÖ&îP®‡xÌZËÝøYõ¿‘7Ò:Áìcbª‰HЕ¡ÅžG2€igkäz#ü –rý x7KÒ&]¡AÁÇ£Š’”¯Û + äÆ͈Á¢7b±-óØÙ1áô?“vs…ÞÈ‘¬{F¡T½Ð±ºðä:cF÷]‘(ã¤4ŠD[ý=‘({ˆÑ8·±/éû7ð¾X_&‚dA444ÀýŒ „/áŠÑ3Ûx¶Ñ.²¨XÍ°jaä ê±á!ÑäBbg‚˜\5KÎ|Ä’lWe+ÿA±|WÉáÀÞ,1¢2©ˆc¾™§ÐßD4š‚¢>s4'…%P7"Ðð¡[$L7èfÅ.4™eðMDÎ.‰Bø/‹Á±#+àÆ°¢ÀÒÂó ¨z8Ó7&Ù*.*ñ"Äì$ESú'’L[x!.—y<†Ø¡%šÛÎ(YBø6HD‹%†É'ˆVßF‹ôYñf5I/CÐáNBÙ³bgŠ†Ä:9"®1±²\:+#xY+&bÈÜì–šç•ñY˜…,%†3@‹†›AydÒ¤ pPoô8Š$ƒ›Ý‡PsÉyȨp•9ö,‚ ‚`‘¸'6r‹î ùÇœ/’Ãs!¢„±jÂÉÄ°£[byüg8°äT‡°ÃY-ÉFʪ„0ðmÇÛKò#ý¿"Š~Ò™Š[¡%Y¨$¾‚FX›ebŽ¥Ú^McÚ €…ò àXQšA%ïnȺtQ^9ÑÐD±@4±`lT@‰1Xm fÞÙ8D%ý-[Û¡Õ--ý›²µ’…ØÈj¶P©, æÆ‘Dˆw=ð„Æ<"Äš}‹Hì ¨Ls™# e%K|1ì«+ *Zœ; ÀØ‚‡É6^Ĺ<‰°´¾¿XïжaøÁrO¼e®‹vÅ„7^ÅégÈÖ.ÇÅ›RKû ©l~µËÿCnÍËÄ’&!àþB’,Æ‘ð;y7ÿcx#fÁ·ƒrÅCˆEö46lØkp°k&BA×ÇþˆJ]p5É­Ð÷ã¨CÍâ!¼ •Ë!¹1qµGòN”8Sd’…¥¤‰$Þx<‰I–$D ìNÄÚB xY`D¹c"ÊBZ6†ÇAº‘FãûÙ¥ô…S>»4¢àˆÂcæ¬#‘àÛ7 ÉLœŠJ_òk‰’'ÆØõAª[µS¼\âÌÓì˜B-Ý¶Ë )Z¾Ä¢v_F†,¤HãáwCš~ËiG0=“¯CŽŸô1…øj>_Ðùú"Mˆ!ŒjFúÄ&bFI Z'gK¢MXÃÀ†È &IYmŠW¥Ë/V´ž>OË[%ËMÐìŽhïÀ°’Ê(lð—¢gjßNG¯fž¶3rˆªùQfÝal˜UÙRn6:Nâ”ÌÆéB¯ä–öq9lCƒ YàâEW‘§E“ÛzeþÍ.IWD ÉHžè嬈ÊÆÈlk‡ÔPã±k„a =‹¤º]ŽW_nð´:'ã3üF5P…iŽ¦ÆÒ9i7,nÎpØú‹zN/°'¶kÐм!±)f¦Ï39ì"¿Á&Uá¥Hj´(ÐôÉlŒI±¼$±;ìxDè(”EŠ\ŒcbÑ¥èêÁy%Ðß®uÐHO„³t[rZ*Q˜•þ’'œÈèhâh—ñДÆÙÃÄ5äÐClZd›Ä°†¼Å.%Èsm[¾vM¨‘,Ë~áÄᆈ”„Å’—83BŠÆ¥ˆ:·è)¤ò>óØÝe!öÑÊM ô-bï±-/'ð×ÁŽ‘KÒÈÜ,-C6Ihú/E?njr‡¤{! ›…¡Ë.ƒTýŠ•bˆ„œÒ_CÒô”í¯²®J2 Ýø8„’Ò\ áu¦1HL„²ØÎí÷ùãö7B„-™}ìin:bM‹°«JÒ)²ÛžŽ†òµ¯KnÂ\‡C^ú¡µm“­²[˜ìC¨¶¼â>GÑ™5ð’ÂÆå‰]QèVÕµ|›ªY%Ùt©KD@ëXSý¿ÞEP•½Ù_ySè5J­ØºˆÔù¨©z&ÝÁˆÚ¹ÜÏZøh6Ä ˆ”h:‚è…Ń^[–N"›“DuÕä›B)Ë~q š¯Híð39~ਸ਼‚hÔ³¤ˆúDRˆ-¶@äÛPÚ6Òдj4¥ˆCa+T•–¡òβqä)Åi·dŽÛ'¸ R ‘ªçÉbr0äõ¾ÇÕÍ¥¤¤‹dÍ'’i­ýsïO¯&͵uˆ$iš;tOiK¡­f\²,#ènÒ‘#§äO6Ü{bìÕ±õ?K l}Äå±r2²X„m+:I±,Ò~„ÕX¦ YlýŽ(½áŠ5™ÃYè{vE0dÏ¢&\$”Ϧ“’ï=I-¢‚iÑ.}’o >Å¢ ¬øp. 8¥Çý‹„殢(o¹JD”L³ -ø'&©ã¶B?­©žÐש’e‡(³$…°Ç®&ÜjpÉ}{dXNÆ…"§¯±R¦íì_@kZ„iŠ£ˆS:÷ "®’/Œ¤áÚ½þ{rŠÊ;X™=õþØòÔÞÖ†æíZyžÚüˆp¾‚/K\’£ ªW"†Ýœû:#{]¢gcs«MkkRÿPç-5Vì…éœg(cË(”éî‰åà™2'•Éø’¢}ò4£aÃÜ’®Þa¤{C¥4„•ÑÛ“&EJújE¼E¼uh™èQÙ“ØXÀÙóÿ‰‹9B­ÊʧƒwCfI“ó<“Düš$®êqÅ ×7*óöJTà#þhd“æaµQµàŸÑ¥F¤áåtÉçèdSþM® šò† pâIÁßã¬M¶5¶ –b•iæKV„Ù‰CuM]ßGkÁþ±5ì¹>“^Ù:X+WУ$'û;äª:CìLÅÈi6= ‡¹ÚÉÀnÚ2 ‚0—G¨™š&Áè¸(IB8P†åú4Á|S‘Ó’ŠR.Eú°5 ò³Ê¸ã¢NÆšÍ)qb¸É: âŠS}x'ÄÑò7“t‹KU±Ï궟àg_¼ð@¿RhR«ûüÝØbÕÚ‘ÌOn«ènᥴ¨Oþ~„ƦÉþà™N îÇ!¶ÛcJ¢Ó‚ø ½=f ’µÊm·ƒœ*: –HHý†Vøé‰âLn88LjЗCj hÐÝÔ|ËÜÊÑvjUMr¼žw%f¼›özÑOlèÃfÛpÕà‡MÁ4>¸4U ö’ÛŽ”SRBƒKnQàœ3gv„JÔš£iùÌánI”‚‹WÅþÇ¡¤Ïð9Ê4½‹ýc{™IåÜ–@†¨xË"¦‚¬D;ž²³Lu¡b¨ð'¡£Šdy—4@¤/N‹É 3vîùèO©8ÇLI˜ºðOàH*¶Æ64Ž+ŽŒY ' è|ºd em™ ºFáIáôuÆ¡hd’ÃF 1Z)dè— "ÌÚ] Æö$vÛOlY“ò"‚£d¡ÍJ$äƒh?¸$;‘ØÛ¢Ž’ ЦUšŠažGMÝ&6'2žS؉ƒè†ÒSÐàµ(\%±új}‰¤éÁ)Pßq²>ÖKtxß“Cƒ‚àˆ…ä(F("‘ rAÈ»Žq6Š ù6Сð@º‡¼2P.EðÔ ÿÚ ÊòŽ¸ô­!ßæŠÔ*›+D[+‹àÍã+EB»3AûxÊlëBßÚý¤‘ÕËZë4Ö=G6_«¶½ÌÛC0l$GË‹“H‹²ÔÛfÛM$ÑB&Ö•ƒÇ>@¤3ºFÒ\¨TTTÚ]º…o@ìÕBþŸ¾®ÒÕÉ” uh¹‚£{.-").ì sñèï8ÙdkîßšOy Á¢ÇàòŠog.·ã‹…Ó•‡Hy4òçèA&þ×}Œ…DV´®£h7(î}Ո̷ ‰$nYAú0aš¥këÎãY%À‚ˆ§öÞ ©)YpÉð)‰z$¡ú/øøŽËó¾±Bðá\»ç»0á$7ñÆ×ДUÌš~–2>´MÉïßR 拓RV†X¾YSmŸ±:I$ا ¾X/óÓºƒ Ìê¬ü´-i2Æö¾ÜìyÏ;ù¸zö°þ#B͇+É5ÓöËW žûöÚÈ·'®´S#-WàîaOk@±Q®; X:ŽMÒî?]x,KƒÈžtÈRsC/¯–,‹ñZ&m±ÀUû‹U;ÔªoÔ«—üòõ¿>¼dü…S.I3aÙkÖë™…Çó+ì#"¾Ý|M ûì^ÆH |@]F‚Y˜üj,ô7&ÉD\Hn6 ¤zhñú@¤,BÍ'âU9aKRÑu´gý>g§zÑ«Sðl½ÿŠ˜q†„jIš´05Ѓñ .œýjBàÄbROÿÉkPZ8ö™0ŸPÎëÍJ×IÎÿb/}8Çâwœ¤u NMÝ®£D •~ökBþßhþ™Âêa'Àu a(2$¹à–}I\Ü»9ó?ø3ýÐ2÷¬ñ9LbÅÇ­L/¡nš9·¬–L‰“ýsð§*úZËæôÍ:ó¶9N¦Àu¬P”Q>šeÄÚiúuéó^wRîݨ ›k‰§i¼´?ÑJTùÃï>µSK•Ýݹœ®×¨÷í†ïŠßh6ד»ª¾oÖ ¢Ù°ºúáu&°Ã@‚$)¬/-Ÿ½ÿÜßÙÅüSYÇv;ѵìéC|`ì43Á É{/í¤m»£Ý®\)’vÚwi&+ Ô[ŠX¢‡6SéZm^³L;;,ÙE‚í–c£æsg‘À2¿=˜Æÿ¼œ¥â=Á pÕ‰ïs^ D.Ù±œŸ6&­µ­|ú™úýæô;¡×Nö¨9iÚ]ðè=óVø; Ž¨U—þÞBÜ[ŸžSþb{(Å/Z‘[–t“ïx[k%­ÈÕŒhÌ’ß©gÿÿÄ!1AQ aq0ÿÚ?õ'Îû~CnÍî=‡/…Å-où²ë~pÓd\"ò{Ûüy,r̓„o¬^m‘ô·f~IJË"/;) &ι~äŒ{óÏñã3Âè¸>gãÔôåý ÉäÞÃ^Ë"Ø'.Ý•'³9*°d¥ìÞ®Ë.Ý2þ@÷¨¼#GXá 5—QV±áëk{n$ËýŸ¯Í¶ØÖ]#ñfÀ‹Ï²Ì˜S½»r.˜9ð}Yåù²Ö Þ\#ˆÓ·‰³%W)jË·©U…€ä¬•Ž;íùB í?èˆû¿»ðY$òÇÛ'K6|Â|›ÂýûêñxŒ²vÞ.›ƒ±œ-‹-’ÎYšÏm˜Û‘ #/íøx¿©ysëö#ý$ÏÁÏ»3#ˆöïÆânÆý¿>>ÂñVfO±ä6.±,[üºëeÂö—Mƒguì?„2ÛíK½ÿd|ß«/Çü-²òd‡–üùYÛóáíâ!Ÿe¥»<-ÝŽÛ’Û –'¿…Óo> L~Ïæó¬`³¹ÿdGÕÉl’Kðm·¶›úÜÞùôáïÓÛcÈò÷/ä{>\2bXn È"Ýä0ÉrêöÀøäÂáeÂÙðû²Ùe’Aõâ^ƱTŒùuÿ›~D{[ËÉ|ä¾<&>8rõŽ[ËôŸ€Þ¶ë[±ÂÅlÙøÿ“àÛñ…–|>&ßÛ0™×ø>Þ¥þ¢|¿%’½Klr[Ûkp–°~Ê_„Á–‘uaÛ|Ïÿ\¸øJ¸^WƢǢ·êIuƒ–JÏ'ç¶Yð>Æü÷ä¸}…æ|bÈ6\2:Žœ^¶PáÛvéÛ‚Ý“&ÒGn|R¿‹"ëÈD¾žÕzÀ½„?À³äB]Œü÷ÂØŸÀ|ŸØ~ÞK¬0—ä2âÒ?Ø/á @!·]¶gü‚ùzÑz‚á -_!¾Ø%aMëòNû)ð|Ï„|?E­Äß’ìÙgÉlºÅèŽJØN6L0k' P§l˜I]‡>3gǸ_²¿&ÃÄÿ0–¶Oc «¾³®^¾Aî[9?’?ïÁÏÂ>oÈVêcÆé†é.Ïövà—·é-šÁ’×,;)u¹K…§È!×æ}ïçγÁ- ‡/R)ÿ–ßû·Gc¹‚pß‚Õíäü#çWܸÃ;/ÙvÞ|¸-_Œ{ ,ìᬆ0–ÂY eÂ]†Ã…´±Ãm\·~÷ÂZ.˜' p’ ýcâ<åŸ\†uø½züØeðÆõðûßÄóäfO“³—X˜ë,ä¸^¯Ò\½o k %ŽK/oú„MËl‡ Â~8ycNض<ž˜]vg.½„Ìç‰LüÙ‚a{øD/-ÝÀ½Y¿ –‘øZÌõ²'ÞË’Ö2á’߃3=~au’ ®?ØÖòG¯˜Þ!Wa·9ãíø¥[mÙsçÐÇÑ„^Þ§Lp^£åĶ=ú2ëɇv\ƒ[#ÖGXÃà 8l¯üFg¶òÿ¬˜/ä¤êHñt€;vÂovÁ:ö÷àŸf”“òêMž$7¸l‚õÇŸO¶ìdz>ËÓá†KX3¿ –]„²ìy~q×-Ýž þO±ž¯3ä-Â=×ÂÂ_Âñ¶ò2Èr=0þÀZ|qmJ𿥉t;Ä‘Ò]ù°Ûp^¢ŠöчÀL5 ŸryË„õƒ%ÞJ`ÈJ@Y“¯,}ù=YîywC“?Yþ.¾ÜÏjÛ2ªíú· m[#M‡rNE›dÞ’#G!ð¶ót±ì7â¥Ö<½ü(v"Ç#¬àÉ|-ìr[ØIÃáN탿 ‡­Âöá$^Yú”Ág#õX³<·à›³rßeÏ™ñ³mmÆÞòùz_¶ÑöpÖ /Q/ËÖ\¸6õ<-íä°ø¾™ ìÛB,ºÌ?Ûr?íº¼·¿¯óçè¹ì{,'Ûòa†üz™œ‚vÀ—#­‚SìM»a—„§ìê«¿´g }[–íYòÒâUìÎʾJ6åºÉ?Ë!ìþ-æ[ ¶ÝÏËà’9ðäu¿2Ü%¦Æ¬ð•[ÉbÙ…³> íÓ[g7gáë(¾âüö ^[9ÂØ+VËoÈayoò;í¹åÓf@¬,­µóa¶Ûyßžá±ÂýÙDýläàˉGeøK ²á×[Üpƒ=ŸÁ8qöxŒg¬Î¿›Á)¾"8@$Ygö ÌöâP^ÚY{eX2gÓèóèöé8KrNZe¬?Û¿/ by{K_™°CmÛËvyäàê¶á*Á¹3VB­üZ³åí¹nyp¿œ À•|ƒûÖFûþº]Íê=¼±É‹ÖßËð¸|(ŸžK¿óá]?M=nµÖOüÙäü“¨C"¬Û/Ì_ä ÈN·ð²Ì{$òHÄgeæ1‰e–Ywâ¾Ï²çݽN#¬ÿ. ë ’Ä¿ÖË„ö 2÷…­¹ÉƒÈF¾£ä·¶Mâ#­‹ÈYÄï ¬L» ub¨Y0Iþ…Kàãfwü|ï~˜Ë{.-Ö‡mÝaî]2Áí¿.[–üÈ&ZÄ9a.H•xKÏX.úÌI–À¾ÆçlyµˆŸ‡ŒE–Y,ž–vìNø´°—H—º`à…ö.H› NöfÂWåµý¬~À$E|¿î–>X¥ÛöéöAb™82É0íÌÏÀOÐ&Ž65=µÕ‡–Í´ØiÈ£¶úÒ-¶{h°3æZ@ð¿èÍîܽˆ?—ãIû‡íŸ›vSì€nß‘ðk/¬a)ÄîEZ…‡¬gÁw±æLÏùv)'vA—Æ-d9h,­¶áÛfŒd™b߬sáËä¯Ë[lÛÌ&ý¼ÂÂßá{rÂÙ¯äkòAÛ–ÇÃÓሠoä]v„Š9Æb>äF“dù=m»„ìåÇKôv]²ÀÑí¢×Èqº÷ïm=”<»ûçÄýØýŒ8]m6 ’¯å«?°˜#<»–­‹nØÎ Oäm¸°ƒÔ— wõ¸ø|d³üùyómvÔ¥wËA Ï·Qñ”ËþËSÈÔ=­<°rÁïÈ[úA~I~@À€}n/!'íȇŸ²}L¤á#Ãê?D|o߬yó'þÙ oI‡Smž>ÆìqÒd:î@qhp»’Ô.ÎùÄ #ìО&¬ ´7­Ø ð'øùÛgû~ý‚=“ûjÀÃÛ†ÉïVÇÌ™˜ù¿å‹gúØã¥.øvõ`Ÿt…ã ÂÓâuí¿XÎn°ñ,!Ûú³.þüaûñ§òëh «?·ý¤¼µù+ûm·…~ZžÂ[3/ùcãód îoý9 ²Æ ù¹;oS?éÿa;  ®±–/’‚B°o· BÇì‡çWæÜH"=·á,•nÙeÂ6 ·ãFͼ¸z]Ûä²gâïlÆËmG’v%ˆëcÒyäjÕ¿=¾ÙØY¯ ÎÆöý’?"Gé{`’‡û?œ%?e,vvÆÆÈL gä&òG°žÇ€ø·˜örz0ÿ‘°rKc0úCòöOy6É>ö°Õ×–M†™žO–ÙL¿ñ ³ú°þÎ]bßÊ‚)¶þ–Ðß’>À{“b< .ãò ™í‡2WòþdbíÛ[–)?ŒÉLâ!ÛFÐäÿ˜Yðz”» âN@ùû+ÆYÉc²¾'²(öòwÅ òS’Ó wÛþÖ¯Ûß?’!=ƒ÷àù¹€äÀþƘJWô˃våû¢µ\l,³lË·ý—¹õxKd{;Ù>†ÙŸgËìÁ¼‰@›Ë;8±êñ±dí‘=¤¼™Ö' &Fþ`"³æX°,?~j¶”±f?^YÀdbºö ñœAžX=…æÇè‡YãŸècÔÉçs.^;&<†/ò“ñ+—éy=ìº7»$ûjò„v !¶YV­J‡n{ À9ð|°›ß˜X‘d<ºˆÏ†1cÔ FßêLÉêú/§·ÿÄ !1AQ aq0ÿÚ?*×Áä9–fa“Ò'„{1t¼OW±Éþ¶ÑØ3¶–žÁ4á+ìo×çäÅÆ×mì°Ã »Ôؾ7ðaΓn1øAr]’ËN>N¹3õ> ¼#ÛÌ{y´mA‘ÛåÂ;íÏ`̆¶çÀk±8ºÿ;°¦û-Wê^D6üýI>¯Ð‘{hÊùreÉoܹEØ0༒³/Ùn ’ñåëàu¹lšüXZ1ì¹.¼ŽmÖ„ðØk~y&ýÉ ó$øM¹lA†öσÌcŒ?K†Oü›òØ'5ƒü?~ ]߃çÕÌÙ¿‰áØ~ËiÂë¶ÖÈØàm¿wDSñ³?Ãm±¹!ö¤¶ØÊOÇvcà¿gàö~ võðé=oÙy.Ý1ìðÈg[h5°%ËÖÌ-ý—c„~Z™úÏÍ—~d1øÂü^K²˜ùkÙB®4y?[ÄÔï‘äõç!„¹z·“Äa¤쀞¾ —¨ý•ØáÛ6xd#Ñ”ÌýgãgïÞÃr[m½“û~Ä—°‘Â}Èê!†oÙøûGŸ/³Â}øåáoävãŸ?ïâ+µÄµŽMø_Û=¼-Ùå£_ðÌü؈ƒo%ú ?ÛºF}>Jóøû?o ö\û}°ŽÜýùÛk5ŽK {™¬"G—oýÙu×ëõ’f~fAðò]™{nCXl·ËÔñmýŸgãÖú~a…‡e¬vRÝÄìÛ¥Â5ƒ‘aH¿êAÖÛ¹ó>$ÍÙ>gÁr]øÏ·¿m²-|³ä8Þ,´'Ùø{g/φqxºd68K± äµøy.°a’á{qoÀÖË%þ Ì›?dÖÌûð‰¤ü‡ÓÂ÷~ÎìO³ðö>8'à%ª2áŸÃ-,Öòݶe‘ë2äöáÿ²£ðOܳæl„Á°g`—bË>7`É…³Ø^ÿ¹ó3~B/ÓávË!ÙÄ£±ý—%ì?eò[È>.^ü¤ØžGÁ?6^GÆ͉¯‹ð/[Óá±úG͹7‰˜G_M¿èµ‰øüúMÒkIäK)³%Ç r:öY:°°—l–[ÙËž=ˆø&ퟞ2GÕÚ€ó–~­?-e’/Rà@ÙvT‰žJÛ{Éá=”~/Q.“Y Œ|8·[ô”ò]r ž¹œOc®Ëù(j ·3Ù6}ˆÏ‘ìü7 o}±íÈ=CäÏ^ì=øcàÿ#9žÇû3ä»H~aåۑ˨ì8]°í‘o%ìy1v ;3hÉÄ}[ùzƒ€°'ñ’ËvõdX/_yAß,Ég¿%á—Ãx#ÙŸ#¯Åu ö÷òþVÙ,šÆºoÊÈa)’ùèUf"7ò^¡±ø°>:ÀZ·öxã½P ¸ þÏÑð|Yt|žÇ‹¬¿+’Ö7w¨á~ìõƒxƒ _ÓmeIvÏy áìÛ8d‘ý]? Ìùf^ü-þBõ É£]÷ápìþLlz”ß‚aðøñ$;eŸiØù’|roÖâ/'Û²åëxOX2ZÙÛ‚M‚9/[úøñ.ÃÖæÿ/o'#úÚr¡­ÔžLÒãò(—#~‡øàÍö~-ø ùÏ%ò{xú,äÿ/܌˨NéÉR]c²É{ ¸×á8C9cØå¿Ë×ê:†åÌž‚é·/a:YÙô06'¶måÛÏô²ÛÏ_«2ßÛÉ|>ÌÏgËÖòÒÁÂ`,8J̓>F.«Ãã6À—=½Ÿ ¾w¿ òuø¹䦯ȘþïÒýŒÄà¶ü_®^ ÷»O'ŸŒÏ²O×òeâ%~m鵟åf°g~Ge–Â[ØâÄ€wÝ™,&SÝÆ.iw!u\9/²*¨¤#-Žüÿ„PrˆÎÝ’Ë,“¶H»<¥–„ö¢ä{Û¦—’Âé³y0ËwK³oòJHµmx%=½û×°pƒûn^ûr–üâ»`ƒûô ²ÑØÿ `FJO‡áâYe:3ü”½˜Ï¿V—ó‡Ã8vg¬pŸŽ¹u† ,l<íçòõ½O•¸H±eùçXNMîÃàF°›·Lá`óŸ<½÷%É{Ÿ#òvl…˶ðŸc—±–âÿÙá’}ŽK ßcâóà‡>/4Ÿ%ØÅ¿Ëÿm½2<'¿ME3z!9ó¦ýŸ›m¯Æ,.iþê}aÆ%íܽÏ!Ûþ|#®Ãu„ØìÞÄ·¯ÅÏ€6E|áy(¿ ö[„õ‹Ì¯[>Ä›“½ly:ºÀˆ¼ùfÙ––üKl5|%Þ¿3ü-¹h-äÓõ.›=cØkp‡ ZþK†Ëä…‰E«·åÁv/eÁÙ¯ ¿¿ DæÐ…à°ë&í»¸D þ.¶dG-[ÎÚñ=øüìÇ¿âÊ<[³ðY¸œ—-ØEëË>ét%®mËü@;Ökí›â[ÂêÀp” ~˜ƒ(^·2c¶„êÛ–/ýûŸVMÿ²Ò p³õðùÂq¬;}nÁì.ûŽ]0OÌȱ-Û '‹¥²1*ûO-·e…Ó`…eùÔ¹· °%ƒc—ð†{, Ó[mÿ/³Ù¿DxÁÍøãÈoQf]pŠ'©~Ë[¿²ýØ-¹Y øáôÊùd@ þ.±6ë ×ȼkg_,zËcyì“ÈßVd»`–õ[óm¶ÙOóâ¯èJæ6ɯÀ{.é ZööÏUºçÃlX^ü2 ôeÎÃÌ#ëöGXúuˆ'ȽH¦lü—>9±öØ‹¿œ„j˜ð“ßØ!å³þãçdœ@½—65߇ñb;~Ém»m­¢e¿][ù£¬u…îö—í屬w’­„ArSexHçn£>ÂBZ¶MŽ^ÜSÛ´·ŽÉŸ ÖØtºœbŸ—óom –ñs?²ºm“çmk¬°ÛÆgJÚP'"5håäƒx'Ÿ;ÂÅý G$N¼ùç`òÁoƒà,]vìG#àøsõÓœ`?ýÔÓ W”–›tïnŠS©2¿zX?Œ°SóáÙX2È!°šùÈ¥í·Xøc~¨-~Z­>Ù°>5así‹ÔXØÙe’m‰mƒu Âü=n.Ÿñ¯.œ´o䉎6NXòÆF]_–!ü1œM°Ä¾ÙW¬F¯FοçÏb­µ€E·ãl]6¬g kjÏê8gøòC³NË’· í~ß™›>ÀtŸÅ‡o,+¼Æ‰ô…uÃØ*C]ÃöxÏÆ|Ö º¶ †4ë.ò]f5+áö´%×–¿0Xü>f»`'õJ|e–C-ÿWþH~·`Î/u‡Ñ>M—–È%ßü³°Äf'Ÿ- •#ð€^I£‘V ä+äÿÉ’¾ïû~cØFÇ<úÿÛ’¶,Añ¡í„«kbʽ¸¶6ÏïÆ„f\(§«öý ³ñ{ðtÛ9 ha1ìK$È.Ü'¯É]¢,Ôög#öT®D[[ÿêâ"ßôP©Û.OÙ”±ûd𻸊n bf@ÞØd]aù’GÛ߀ä{Œ¯HË">2ß±`°òå\ hÜð¿K!ãä‚ÇFYDêN¾~CÜd²aLý“ÏË?’t¼°p²~‹î_ä&bÁÉþm/ûlA>?âI”Ú¶›pŽì‡­Â¼Òõ$_d“àG¶l¼¶RÛlû’3²pC&kt>ɉ`öm1²þ¤ë˜âYÃÁ c= —?0#Ù ù³}žOÍl.\ùÙ›˜}Iù+ì·¶“$¾0|%=&d øÿ†_á ën<ëéÆ l&Ã¥¡ìºd?àç±%E®ßØ&X¹cÖZ7ìP’^Ë÷ý„9åý+øÛ/¿ä´]^ÄöýŸÑ¼›#?’_á/á?ªýÐ’>Á=ø£Ë‘z“<øÇò…ü Ï™¶Yb›!†uã{ÿSz‡àeûY­äþÛåäð‚ :¶02jZ¶ružWYÃ~ùÄ €8ÛþÂþÝZýÂ%ý‚@À ò´©¤ÃÈšTÞY½Œ¹·,>1±º[ÿ>göÛ…ß[˜dû0’9i™ß%öV€å€t?gâ¬ÿâË2ryÜdB¤GÕý ñ’—óò@À0ÊòOØ "gÆ,XX°,%…ÃcGlÜùp´ñjY? ¯û‡g>Áûsö2s%ì7äŒCˆéØA,'A#3›òé6Lƒ†USÂ=fOXpl® žÙ€{»äoý_û³cK'K¥«V­ÔvÄn» ö?=‹6@ü·åÿV6zB<´E‡wæl„ˆ_ÿÄ'!1AQaq‘¡±ÁÑðáñ ÿÚ?(Å€›–&³q[¶¿D¡Ä!FED3Ĭ¨ón5^Þ±rüX÷5ÍÔ­v-³ Ûj$U•ÜvÕÃY¦®}¶vË‚9Û?hb:ÌÙT\³]²ú§Ç,Ÿó&¢#¦`4œFµ'F;„%æ>BµÝsqÞifzb1zŽ« ~òz2ôå2Á5 ©JºaQ)–l2•ú–ié‰T=ðÇQ`+é† 6;#ÌÂ¥‹RªQíÌÈ›·sá PS-cµ‡‚k8÷#l—„åÉ,Êî¥Î r3™ëÀ)MU‘¬rrG™nK1OvúLß2ˆh ‰)vÇlv5fæ@ÈÜ*Ê1ê A¿2æ˜Î¦Y1ÎtJfA‘à/0U/î‡ËÙ_Ö¾ý#@çÔèchg©d¤˜CʦVžájŽÃ˜¥…<2ö b*O™Â\ÌÃÕb[ÕF¤’y!lºÎõ1W}ÊKn PÆUÇVqù”)¡n®‹…ÐkiQÐS,IŸ²|2œÃX•e4 "ZÓ9i)V1®[ µÊ3àÜ[ø‰n÷ oPNEj¢å—. =JbÖß0V7ÔUiK¶;äŸekÁa0¹Ä¬­·‚_ɨò»ôzv‡pÔ}HjT%À•˜ÂÇr¹ìYX_p²ÁÁN¦”çÌ¿xz5A‡â+ZÊÙÈþº‚¢*êj[¯-Íeæ: +˜Ã¤ßQžðŠhà%¶‡ÌŸ¸À9”3”ψoÕÄÑNâõflêP¡²Oxwæ:x#wAPõÌ\ 8-, ]ÁA³ËÔ/1ÂÊ.׸Úv)CAVLy]¹ù˜¬ÍÕT(âáhø?~!ÄÚ 3jiQ—„¦*üzXñ-xˆV‡æ%ÍDŽº·ó>Hålê;X(]YßÂ1KÖaÉŒCeuAÔZŽ P[R±,.e¤%Ž®!9¡¯’奰LP…7H–À¥ó9ɲ~ Q@`M-°²R‚Y²ƒþöŽË·øˆÅª|-nQnæƵ¯èšõÜØâ)C ÛˆÍKM¯s’eCsx5z4zŽ`ø•¼ÆÉ”X(Žå=â $CØèA<ŸiÀ—˜¿2̸Ùó0T¶ÛO4–™ƒóɽK ¸¢HjË¢ZŒvúŽ˜øŽ`¡Ž2CZ´LÙ¨çÚÊtVÕpb õ[sæ2Ë8Èw¢^EÅÿªmðŒµ x—-ŽýsÌ6U¬.éÁ¸Ýžeì.W;x©•­8ç ô6„3 "ƒ7Ϧ ^e-Ë\ &ÐN&ÓKÂK œ+‹á•0‹”*ÿ39Š²W÷@ÊR]A¢Ë¸æÍ^ðŽ_Ì°J¤‚Û7ÁÄ4 cļÅmÁu:›ÿÈÅ/6Ôµ*[70eaSA9e|õ••i—R7ú&ôƒuþı€MÂßlzw,%ægtÛÔçØ󔶭üERïÿÄ7 ÏÂóPª©Y©SŸC>…pº‹qƒ>‚K(}¥Ñ6%–`ùˆzá5ÝPðëQ°c1´ j*Þ¢÷(y¶®ã-\˶¡XÔÁ1ƒçýlDX.QŽ£v;™ÅUþ1Vðb"­E§PRÍÇ‹„-)%Hų˜¢B©/ÆõÆHø2¬jRŒÅ8:'(f£ ÔÂ)Ä»„ ó,A)Fgæy‹ÔB9nPc«Ä`5é4t‰±¿ACÌUWfk˜ðJVj.M z¸Ž9Ñ/ÅÃBWtK4_Œ~“Á™^#´Áè¨'Ü^ T`¨%ˆ µ·¶ fÁ ÔRÄÆž/üŸ‰Hx¹cM·¨‹«j\ Y¸,]øb¦H¶f¼Fe¬Ev©ÏR™õz ¨NHq9QðŒ³@ñ„²D韕?»¨o‡¢eàߢa59+ü¬þ‡èžôùâe)ä³P¦jîdùæY~`È¡Â6Û3 J˜µc¿i*àQ¨V­âß‚eeârµ¡ÐoÝÄ µ‹ß ˆ„JÒʆ¡ÄogPóóÂXÌíˆK+SÃy÷ˆŽîU\@¥cpI®`—ÌF|Ëض‡2Ñe¯Ä¿K*‹P|°eˆAB&{—~–[ŽfÕôqè•«°=Þ>cfŸ¥Wæ|þ¯îT ‰b¼¢qt%É׉C¹Àö/°@3§G¶_ÜZœÕˆ¼¨A®î æK­æP@ÆîtÁ5ôÇ>H ¨ö¢þ¥hÑ9?bK3qq9Õ‰RŽm]-®˜‰Vo ˜‚§(¾½q8ƒÁ®íîbI²Ö¹EÛ&8fcÉB¯95ŽeZêê  <=B5AâúaLcx(!SH¿0[®‡ ’6œý ·¿ÑÛ)k³@úcìeD™€P{úÅä¹hF;Ü5µ¢¥¿‡š³RÕøâe¹ŠX1bª»“ï©JFÆiî;ù™2*%¼© Uq±å€FÀ¨IL½À¤ÍÅ/2¨™ßF)á¢g䎢´î U®ø;‹o¡eŒ¶^åë‚Ÿ–>³/Ê¿÷–_ŠŽyë óÜL¼AnÈqm,¤!~%ÊCºÌ,¤PãÛ`¦ª³õ½Ö.rŒý’®{ø‰F¶®ƒ/1Ç-PCˆÂ¦1s0ÚòY qÒ‘º¾¸îÆz‡a¯Q߯3ÜB_‡»_A”„ñQ ¿iJ9ŽSiQ{[j>Ä™„Có0æ åÌC˳ƒS;MÊÚ”XÊ´¶a8‹ÐÁ@6¯‡/Á+Yƾ¼üÜG)FŽ£5NÐPœw+XœpCRÖë©fA‹Æê7&ùý¸›[83¨ÞQ㈑P÷1±V¸þåµ50Õè’ë¶+`€ãÓiA›ÄÆáù›_¡â_3Î;Àò¾æ$¸™Œ¼ ç¨À€±Mûw( î56*³ÇEËXm™<ÐÀ!æó3pX¦3,¤PbÀ=å÷»—$ÐxˆÞw¸WH‡Þ:Ë›«•ˆíRÓk3Eô©KÿN]àñq}“8G·•CHÃØÿØ8”­…È,¼–ÕU1­F•— )„ŠÀýÁ-ü×q’Nu”(Ûv”ò´¢%fÜÖ¥ñC«Á5ͯ5y`ü(Ÿ…cÝŠ(M«lZ˜ÁÜV+7Ệ¡ˆjçå"[c}E¾ @wż÷ŒÄÓ3qŒÔ©tŠÉ¼TQá0¸.A5ýÔœÅ*‘œùˆ+©^x€W9âbáÆå¬6ûwÐnªõ ³/Eüžkˆ×ˆá¡·^ã¢6‹Xx/³û}K‚;-^ˆ‚²Üj¼Ë°ÐmŒŽV5QÇ,ÚAÁ¹z³vó 7'pAiz¬OÚ†cˆŽ€?òl.sUâ"0±¿ø…­j¿ ÿ>ŸtA–H¬ÌØÊH•0U¢æp”jÜ0€ÈÏAV±=æY‰º ÔµV¡¸èôâÛç÷ßñ8Ö‰tÙxÔhîW'02ðÊ6PxYE7.LÄœxŠ‹ÐQí@eåD/3•˜%‘ -f¥Y•{×^?ˆ’;B€îc+‚æøÝÅ(ÛDZuÿ²ÄÂœˆ¼ŽÖ¡jyùÌ9u8Y™õÛÜE7{–Q0T:ƒg1è2u×û0i®EÐm¯¬So¹àñ¾wµ©k‚]½ÌII "fMÞ–iAEH9V32‡À¯á—ªš–Ž.?C¸«Ù¹ :ŠáÊh–2À%Æì_þzXÄ8i³÷²"PS<ùöˆ¬‰4õDà]ËYšàÌ¡Áñ,X‹lºÜ –WãÒ)=º>;—re¡—Öø‡ˆi‡’¿õàMÁ»h3óæxyœ®æÃÆKÔ¯[Z­&\¤>—b+Ææö ˆÿ{G-çˆep•ç’‘Õíßê YæóaôÌïfi› k?pv-¢ºD«WÈ¿|Ç*6F¯æz‡æePꉘú$z}dRă™¹í3ìÌA®£ÊÌ‘C   xÔ\Å3LGdÚ%Õ`¿¥"M!ìË ‘þ ˜7ľR«U›ù×æ ŒTEmB›ˆ¶ÌPÚhÄ ¥ 6Â’ûðÃa‰@Á×î+Yr Ô^Ëàˆ”)o~aÉì n · ÐJ†Îàeå"¥Qu™`büÂhTÖæ\.7- , _ž¾zšFdl=û›Ç1ZW–+5_ygRž‹U)•gdÁnû‚ÑQÒ³橸º¸VI:2¨Ù ´ÇÄJ_GÊ%w,A ãpÊƪ¾„U±c¸1åÊVŸ¢s·,˜ÍÈñD¥ªQÁÙG¢À=ßhè/dò*tZ¨ù®‰Xì¹sè¹—Ë@5\÷8µ¥æ¿‰;Òÿ‡<‡ðêY[óE_D5Jż¾ÿÁ?S!czýD4¼PÇÄ n|ÎyÆ>`hÈi×âR–V)ƒ8®h>cƒt ¿¨j¼±U1ó+6·,%®˜Iw0¨ŒB¸@ØÚP v˜aq`=ü¨ØåbÀoP¯3,Þ"8r)Þü@ hW%¦½Æ=F #±Š @û7îVLH‹ÙvD¯'(q0ƒÛ©›é1[ô)aF¸Lé½>MÿP*¦AG+–#IH5q9W8Üú¢ÚTL6ÌÓŸ¹^ßh¬¶õÄÊ X¿¨9þeÅÄÌyÕfXˆ‘ÀœÈõ»,¿÷q6^ ÏÜQ(Ù®¥Þ½jÿ©sx9LŸÔ¥€Ûq÷¦0…‡÷¹ò®½§ž½¢–[—-bp”Ï%@à‚%‡´¤j—, W,@H†-ÅKCÕ •;Ú2ŠÐ Æj*°ÿq kµýüÊNq¨ ßPYÄ#ù‡š€/â{aºÛAºùô“ìÇÊÝL#-«¯0XˆR²§Þ%Ž XÖ€Ç\Ký_€ugçÇy45&!‚,ÃR±Ö9y+5_&S‹^!`dw¨¥.‡ƒÔO+[kg]]‚cå•A¨¥21ßÎa1[â46µYoä¹p øÌ®8KwœgÛóÞ³úOŠ!òöÆ"Ûú>¥4:q5(1ˆí.± 0-jnâ؉do)Q4Nx™³k^ð¹TeR Äk(Ö8@­%^Ýò\nÞü…!èÛ ÑÈßìíîZ€O1a1Ž¡²œQ.…aÉ„.„üCéÑmaV¹+DG1(-Ä-¤V…S5[/7 Eƒ‚–Ý|WçáV–ª}E™VÁˆÐ”c5-,,ª/¼<ÃIW ‹`cÞJ§z„«%éÌ|Ç%ª{®.Yi“‰B*[<9ÖõÛ 4{vŦûTYw3ô‚lf8 6-²á¨ñ*î0ŒB€¯€q~c§Jî]¢ž â.± Z(3ÊUŠ–u¹!>–±«>)ãJ8%Ì æ ™^œ½KPä‰[‚OPÝ•w!S·ÞºÓI|M~½´ËîÄx•ÆÏÌíï$©46d/œx”¥V´¿Ùˆ"– ¨Ïk¨'‹j„‡n0D¥c\1gбm©TJÜ@¨3+pá´kþ%– ¼ ›6Ën¥BBV›pù„óÙ¦xì(þDò¿ò*/wîÆÎY´³Ð)(J¢35@Æ2CpÛ`¼lD0"âË=Ê"€ã2÷&—¿ˆá¤¶q‚!…š¹bÜoDïpÊKÆ¢ÜR YÔv$F¡müEéƨnÛk¢ýåxÁyÌd*(Ñ‚ ºâ+$ËViÛž¡¼p_‰–ýæea©‚ fæ ,Dw RŠ]?R©ìà™&T;ÃR᪶>/ÿb€7YƒVã“žc]Qt~·,ÈñZ._l_Eg[©¸_Ѫ%Úâp°XÖ®©“½ÑXj[i’5m’ãKê Úõpø.QTöq3šÑ-)¾¡Ç¯ñ ·…‹úh=®pñœû•éYèªOä7 KD¢Ž^G ²0QÝ`˧ŒñØ)/¬µn¹ï̹El®†YEûËæX·"‰jtB- °v÷%`5îk˜`ÄPEDÚæ%Þ…¥R¶ÁCX¿’"åÇKãëÇ|‘Ÿ0ñrä&ð o´aMR  Zñ¯Ž°ÅUçE*ÛVùºøÚ œ]ßÇ´Rµ¶ ”ÍL8–P˜n >j$ ½K(ÉÔ\„Ûl¡t@€5ÜÎ=Á7‰XoªµÙaÈåÀêU–ãÝ©ÔRѯ2ÀgC èþåQàŒ§Ôa¨Ö¡NõËQ‹ëјdŠ¤a·mÑÎ*b=èÇ 4ãÆ,æ#P¶®¡‚d"(•\hUÑÜA£%l ϼ4\ÅÕÆTÙ±¾70UtQíÐÐÕñ6ÃW,jKpÑ K7 @€f.¸é0ÇIE3q¤(§BþÒÿÝLœ°°9+ºÖÝýK³2•±Îëó£,AoGô™Xª5,ö³)¡;ˆΣl²YVÙv­Áâ ¨bX{æ ²³(GB¿#Qh8åCÔ´Y‰SäÕFæ×'³¢P`ôòT`oÓRà‘ohš(q§Þ(É1bošÇûÌx…‘‡5~"<§>h¿¢X£y EŽÂé`ÛíþâZ[HQØkî o%æË€ä³7÷‰UµÉ~ùf·ÄnšRªù1¨·¨•Å7Ë·([‚c z•š×[¶øÆü\QnèÞŠßòkz{}µ®ªb ‹íøÍ–«w ÍFsèG¡8 Õý".&Ÿª•Šª²^~ ªÓ† ÙW"aŽ÷û”…­ËÞá‚0g1Þ½¥ƒt ®à;\]—Úá€Å÷ Ó0RÍ ¿îæBÓ¢þá0j ›ËŠøƒ*ÍB(¿_ÌRæ`‹ #c”<匇+E¹Ã;Æq ; ‹ÝEÌp"‚[F®53v:cÿe÷Ám^Mw³Ô»¡€) ãM¯ëÆc:Ȩ¹}¢”ƒ&qþÔ@@€óºŠ®Ùß )y&ÜLÆ,Èþñ¼{@è‚ä ,ª.ºó08ëš« â­%ä¨à|hUJV[{˜Áo¨0)GR–ëî [ÓÚT舲·¼‘jɉNQ'FçÒºr‘Yä{”.¼×1Ù{P²Ü{*qÛ„¢`à®nåº'+pÂÅ©‘ NsŸE\ zV‰Q]Œ‘+q)JÊcΣŠräKFXóï6Ï€nð³|l~øŒËD¡G h|_ÜT‚üì¯7»5jÑÌS•ï‹$…ráj[ufpߑĶ›¥9¬Ùä•ÖÒqKñú‰±®‡7õÿF=°Óµµr»Ycqm¸h¥€@¶-‡1V9þ!^bÀ¸ s\«]Ø#W¶8‡C1§.wºûË Yl¿t÷Z™‰ƒÑŸ@(Ap˜… AA Oe4Ãñæ*ú&  "Z‰` ·Ädžh<‚¤Ã¬RäX&8„÷…ÐÜWWOˆuë“š7e[ÓOF¨YÃmð¶Ý‰ï,wÀ••¥²xë¸WÒ¼ø]gÇ!Á`6Ù kíW®Iñ àaã $…5ÊÚ«{Ï®µ¨V‚)À‹ï(Hi4SÙj/\E¯rÙøø™Â"ù å…ŠmL™Å|Äi*•wP3vŠÀž @ì6];Œc;Ãdzq %ܲÇqÓ‰Q/¨[0Á3ú”åcgme_~%]^ÃO䃻Ž}¢W&Õôe°áEÃÛŠXc%øç^`î¾3ˆÛ;WJJvG´¿ÌSÆÕä¨Ì[>ò#»KlÂvÛƒ±ˆqì@n>±JÁÎ Kwi¹– T. ‡ö ® Æm2<Ê÷)Êå1"Ĥ!‚Y r¹ý· sä[áe=ÂUi9WWŒº¢Ûß ÐÙ2®—„Càê" ²’è5_pÕR«cJsÒÞ"Å%˜,¡Çê6]2»v42®ö»üÊj\ ßNt98ˆM¡,Yµ™üÆtÎYp9ÆåØ2Þ½ãh;&V]…žâ¬e̪¶ŽX'¬,—’×ÅWÛ\…Ý=ÿ¾¢Õ bØ—S+ж€Ì¤Kí_l4t‘– Ke½àö̸-ÃóMjZÓ ÕWA+aá–çSqIõ)¤Í—:7(ƒìE¬±Ê«0!s¹µ„âc¿’B®rf 9ƒ!M¤ênÂêõPèÂD6.©¿ˆ¤f’ÆdQâa‰kæ\ZöÄV¯že’m MÈ6ŽÆÃðßÍ<eþ®;u“Dñ€Rªñ2©ñY餼—ï3×Q]Tl°&ÀIš7’‚JJSÄ39šä3.Ó"é¯1I©Äœ^ýÃ8‹˜û{Û-5KwÜ´ žé³â,¸((]fÔ»ö­æT{®=å®×0*{f)‚&æÖ';b–Ý˸J•'° £ÓËQ˜ÀYû† VM­T¿‡;Ô§FhÊ-xäø– Q°jâ˜~ ~ Uê¥rÕÒîÍ‹ˆ*è&ÀA-¬£qŠ%XãÌ`…¦Xßp?›¶THD?‚s,*Œã¸·Ì!¨Ö¤µLÖª2E6¼ÌƒAñ*i¨ôK`<´õ6LED&<~¿(©t¬ µ·Gù”›ve6Êë Ð]Àà¬((ß+=ØDP%"1Vÿuoâ*K.ÎoÌaÇ àØú^æ6 ´÷+3'Ÿ2ŠðÉ+™vKÏ(ivD✔íà’æåK{:Æ-¶56 üîZ­Í«Ì-€nüE•z\B„SbàâgˆP!jØ>ã(#ÉWšÛþÃWÊÇÙEš«ê#/5ú¢–a(7‚?L¹I×3„3T‚•Ý’‘àØʃKnjôqQ¿1rË>€ ¨{1u¢æMM0Ç N¬—s^%Í·ÜmžPY \D*¥vÖgˆ,a2ô)¿>™¥î³ž/¢R`fí ǘG›u&Jç‹Îû>r¨ê3™²Ã-®Õ³-™+êQQÈëÙžé„Èi¾ ­³U¶¯¶¿l9ÄØ°ÌVà (ÏCú–ÈË|²ªEyñÜ]ŒxÚ‰£„i|ƒ%ÂËXdÚ•Ñ}ptKU°æpð âòCkdÛq`:Ì Úñ-¬†\¥ \ßÄÌ#P·q•B‘±ÅßÄ•!Ç™¸ÁÜdì?AÖ°S¶)3ÄR>×mRÂœ¡@÷¯¿¸èóܵá|c\Ïfø'}½àz½N4_ÜØ öFy™ˆ]¼FUÞã,KÜEÛ1`£<aáa k.lÚ"Q³™où˜„¢}8|ñ‚à£Ä4†©D‚™.ɧÑni²È L-I… G´’³Þ<æ ŒÞ#BØñf«‘×M¡¡PAµ‹)7[ª½RŠÍ ]ÔÞÊ=ü^‚4‰` ¹C#-T»°¦Ÿ~33‘j€¡N"7æ:Ai:àf9 UUµ‰}éÓ&nÈ»cÛPrû;bPÉãè‘ J,y¨µÑj(õñï.àÎ¥  +gñ—?ß÷óUYŽ,Ûõµ|ªX/L¨ù—x†èØõORˆÇuR˜Ì"œÕÑâåV+à.!YÙ¥‡´tJAn̵\ÏgÁõöÄ57bLÇ7rÌš" p\ ±*„^ÿ¨ƒ?gˆx=s ó7à ÉTgÌ_D¹^ƒ´øÍúÔÅ#•çIæäµ°+µÀyxœD*@ÑnžJ­Sþ’UËÉ»7Ì®¼Ðû–íºà׳´DAbGä‚T`0*€há–¶4C¨ÖmUøó*x@uˆ™6I¦ QHª 4cW4q6áNn©~&ç“Ä0‘ˆÑ4 Pù2ûÀ¢ÎB4ÖVµÖàØÉV?Lé%§€‹È:Š¿ñ¾%²éy”U‹«_ŽOñs µÃš¬®6¨¨Yª×î [U[/•û” [[Mß&€ˆf†#ÅŒZ¬]ˆPðÊt´ õ•´Ë]Ä»Uæ(ð9yp÷‹âÙ{–‡2û\Æ~ ,­z&•qð&ÑýË-ªËÒîU-‡-?2ˆ ±Éø•^ª}ŸÔ8-ã7ÖåªYAÜ;#‡0n ¹4ŽýYDHªc¤f…²·±0lrVl꜂ڲyï3;(áÅóP¹½w() ³³OÿQ"¨Æ–«ž®'*y€‹Û(ßj34>¤¿ò(·Ql©–S*S„,‚#ù•dÐÓF_¼ÊÁä…(+É99ÉaQ7så ú-q0öu¨/[¯5^abR‡,:Æêû” B- ¶%ånpÑ‹T1CHºÇR« fjÎV¼{\Q¾¤ «@Þ‡àø!Ñ¡0•Áâ– 34ȳWâWƒW€Á£Dàw§˜»MêbÑ3§–Õ‹^T§)[˜Anƒ¿˜È*µr¬ æV`1šËñÝ¥°Á¦Ë¼Ã t]%]ë#Þ u(¼ÕµtÒûŽø$ UGº‘\rÜTµÎÏ.8’ e–*ø»ˆ+‰ÛÅxuvë ·?Ì@ô¶Òü2ãlûÌ]æm¯˜bœþ&PÓ Cé̱óˆ8+sÌ[Iâ%•÷Šbº–Ÿ?@ 6ú—¦¸¨öŽì{Í‹ˆ2öƒPƒ±ˆ¨+RÎKÍD”Ê»f*ÚW1çÒ£‰S4¸Ô¥¯FESw¨JêÜ­Û^Y`0ûýÌ<Õ¥Rý)]±„­{²ûÛ]÷ pg+Ô]7GD®KÄ[UÊvÿÝÍàHAb5gÊD´UuˆÔˆR«"´¥üDN¨rWá©@æäS³©Æ-å Ý;kÜF@T©Û¸|å–Šµ$±•œ%|ã˜A/¤¤ËíÅÝÀavÛåLÞ1â2ž À}±EÍSQÂÑ´s¦9„ ‰{|j9j*¹WæfR¦T™ÿ¾V`hSáU|Î@ö&„›T²\|AžkÞVP¤SˆóUl˜ƒ5p¤°[0wàøƒºIF¾ŒX¹¢ygI6‚jælRƘí«Г¶ž"ÔËÛs‰UËÙˆ Ûp,«Û”=øó´ð¦—<‰¨êÛ”·¼g¼C¬´BäøÌ¡j›6¨áÈcóKrX´ÏÜQ0$o(뇹j‹Ej¹c*ÒÎõ¸àöÞ£½”Sì13³ˆKH•MçƒÌwhJØÜ8ÇÚœgÿ%£(V¥² ¼[æû‡~ ¨Ÿ°Ñy‚Î9)[>c¨±2ÍÜYÏÙ*e}Ê\³8©›Qøˆåqi^Âæ±Z…í j—ax*!Á¾ánUÆ"í}ü;˜ð†E)Ô|*¢%/©’"yØ”­€µR‹³0lÄJì}D¸mâé'Lã^e•…:k®‡­~"¼iÌ‚s{D•éšA0-˜$}cCH‰ºR-Úp}ÛïPÂñž/%ÊguÇC-fd5ö0ÍÖ)ß•ˆB´(éÙÚ¬¬Û{ÜP°rPCWÀ/Ä %wƒýS†4Š«8Îè® !àËjwï3.ÅcNLjeÖDÃ*ÇüÊaÞ>…û@…Í(#¡9ÖÛöƒòЊܻ…q{”͵,…<±(k/mEª¨ö‰o2«´,néTV Îõ ¬ÜP¢¾`}Ô3EÔNF¦/,²÷†@TA–ÿ™ì\¢Wæf^ñ Â=ÂTPÅâôM”¼Í G¸F–øƒÚØÃXŒD;•øžq9–%a˜žRý5€ >ñq^ -ÇtØäŽͲ½¾à»Uù¸k.jÜÑTù„GÖO9€…‰X-¿x¶-¿Ê ¡ÁÆæR<&UeŒ¹‰uGýœBÎ*éWgÜa‹ÓSUu“øû—Ž¢º§çÄ|,€¥Ñ-çÑ°´h+î[ÄÝóÀtx†X ] M/V29c¶ÊQƒÄ»QT¤X]¡Rí.áÃ(´ª˜#K…o´á?•ÄV˜‚…Æ…XÕÌ2Ä5[‡\d¦w̯¡m_f¥jU´f 8–¹"Mj ÿÈ+ˆxŠ‹â,¬ æ%f&§~‘VÿÙqcustomplot-2.1.0+dfsg1/examples/plots/solarpanels.jpg0000640000175000017500000005131413532027716023044 0ustar rusconirusconiÿØÿàJFIFHHÿá€ExifII*>F(i‡NHH0210 0100 ÿÿÿÛC     #!)!$%'('+.+&.#&'&ÿÛC   &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&ÿÀMôÿÄÿÄA !1Q2Aa"Bq¡±#R‘ÁÑá3brðS‚’¢ñCc$Ts“²ÒÿÄÿÄ1!QaqÿÚ ?ýS€H‘J@HQBƒ@ )A …( ¼¡@ ,åI€¿Pµ• &ý>Ü ?=àeïÛ8Ž¶$¡w¿Æ“±€ oüÂ76P #PL &úÒ§{3)Ðuh£Jµ0d/ÛEÊÌÌOÄ™B ú^I°7ï€-¯ó(’Eì3= ÖöêA‘ ˜ü6•HeØ„›!íßÞPìFD“ XK-Æ">ñ½¿ó€„¾€²Õ¨.ž„±’+Öðî/zÌ:h¢36d\’u;Êa—æv€Ý†D(P4¬‚A¿™¿÷ °Ì‡#g=¹D" c½¾pªU$s`+·¥‚Ž‚ð¦˜Q( €¤Q F@ ”J… PL¡@ €Œ`#i¤+\å²QyYfÌN@e´* ÿ8B$è?õg¿Æ“}  È `A7€eiP¯hS¸ã›ßÚô©‘fqŸEýLµ\$…7n­·´bKjr÷”j=¶÷$ÜÚþæ0Û¯¶ð$›› àÃ¥ÇÎP³Èv !qïÔÛHc`-—AoŒ{Nƒx\ ÷7ø@z€®‚áªrzS«4m^·‡ÍR2Ó8³9–'S(C,­ŸS´̶@A¼ ÌÝ›MàX,¤0ÉŽƒhÌN@“¹ÞTbl9º“ÐH¤moíõ3rD#ê§5(Q $H¢ (TÅXP2…2©@ ¡ &P|úod…Êß„¨Í‰'YDœ¶>°€Ø Þ›oœ¢uöÚ¸IPµ¶Yt Dioʆ&6öŽŠTð[œt:/¼­WUVÈêÛÀç×®]¥ Ø Ž~Ú@‚Aì!LXj=‡êaMò÷€ ºeó.Æú ö×üÎÒ€³vè?X&ç2tÀl$;~su\5ejeL—«4o^°¥› Õ"Ê£Óˆóݳ7$±Ôʤ2Ðy¾PeÃ’€£ÿ( csk{H-I[7_Jþ°%Ù³¹$L(Uk‹ ±Ó´ "×[ä5;§6=?h \d€¹¨œÔ@$ E &… R…8ˆ%à“"Œ )TBªDÂ)(P„n`0¶×ò• ›cøÊ39ë1¬¨“ßò,@„/ÊP‰Ó8Nyˆl´×´!Ç;JÄu9üaIU€äè tÓAO;ŒCWè¾Ò#ÕC *lŸ9F9IìJ‘>ÿ´¢.K;–ÇÂ$ß 2ëxA},? kYØž—ì-…{†­m K1p:,¢B’ns'A}`6\Ø€Äu„¾†¾#ßÂ@3i7Fõ« Vgs’ ô‰3ç»Ý‰9¹ÔÍ*F]<Ý Q# ¬-Ôõi\±èøJ-M†#ôÌ;¹$³c¯hRUl¼¤“ ¶²¡° •'?Q‘PnM† Uˈêh b<ŒôÎô÷œš(@@FòFŠ{B ` ’‰†0… ¡ YB€³02„c çñ•ÍӦР÷€‰ å ¾²¢Xçü OÎ,Ý€³”"[H bON°?ú€S¦ÎÖsé¥BSBqXzŸ«{B9ëUÅ•ì£E”e`MÎ{ C%ÊþûÀ›ß;e¬Vè.:í ‚ovÃxÎIË2zÀ`=‰ÎÃV”Km º  IÏ2tÖE‰óä|„æ=Žž‚²µJ2hèn!èÒûC„œ–šåa&`óݼĒKŸ„ÒÊÇ ÉÐB™a„‹îmàN"ÇAo”Š¥µ®yÿ¸À£“‰› û¢ç3r6Þàª#c=´¹Z/mðë×…¯nKÔ-%U}V¥ðÝ0îÅÀXç‰Ga}ä¢ @ 4P‚/36¨ü (R”å¤ ”([æL¨d…·á*u›5Ïë Ymñ$íù¢I¾…(–$œ¡ ÇcÇ+™B aq×­àI;kÚD¸,X*¯3¦4iRqaö掣’­BívüÒˆ°¾y˜ Š[+þ'X‘7#ØJ+ä=öö¯°Åb,3èÌÀ–vcarO]à0¯clVêHPV©ÔÛ°¶hW9šL}Ä\xj÷±P78„—<5r} ?̸-x`¤®1¨¹Š±Ö ± P¨^Eè$F-ÂrïT–=†_h€§|ËÑE}R‚ƒ{ç©//„È^Ÿk¿ó¨Uà“Š•†¹¥ W„A`@ÐÓáBúÇ .lí2€¡'¦Ÿ¬A›ñôÁ°F#ü¢ n4ej ±ÐüDñÙÙ) ·11gé äùBí XdÇë`2„} àД)(w…(B‰bd¡H¢…e¡@Yo`<&ÝöšJú\Xl"‘‘7…€é*#ŽÙåùJ‰ÄO´ç 9J‰>#z[¾P 4ÀÃð„#N¡6ÂGs(<*–ÉGýÂ( ¿ÛïˆE£‡À^¶ÔÅ… `i«¢ÛâdD?îÅ™˜ŸÃ/Œ´%àÀÌ“ï3ÂÓ¹6îßÄ] êÔo›\Ú=SÁÃ-É4óêOóƒÿŶf‡ö“¡âáE¬Ê:äƒöDž#‡¹±v'e¾³@“Øu¿ó ¸Ú@M¯þQýum3 ¾²Á'JK–¦ùDõú„ùi ÷¼°oÃW­U‹)IyšÚÉ¢ëÕT_¨·ÜI3ŸS‰­rK°'ÒBhf¡Í™ŽÂúÀd¾#rqu;J!‰9ˤ Tb]ó6Ð$ô9Xr‹ëX’[.¦AVq—Ú™ÀL@¸&ìu0©1Ïa¼ ,1x‡˜í2VÖ°øÀ`aµ…ØéÚAB¥$|{jI9ʧžfÄ€^HƒIxŠ?ôÇ ±ˆ)@V&X¥„ï,)`=ÿ(…¼°¤¹°üL`gKã*$¢õ"!:á”")î¿” &˜ê?8Ð[3ù @j ¿çhDøÉ÷Xû´ 5Óª_ÜËøã_ m*Ä‘{"Ò)ÉÈ-»ÄÑz­gkéåÍ ê„ ¡ÑF‚"9½Rl‰;BÄö½ØîeY€ÐöH†'v= ”‘|ÿä›fM„¡@­öÛÞ|ƒkñ€Ô/W°êÀ| I k¨Ð[H©¹¾ƒxpÛ+âõ5ôì%Ÿ1 „ øj"¡$åEy˜õ“Gi¯àð÷*)®Š£[LÁçV¬îØÞ×ô‹i43ómó…V'SpH~Q†kä4ù©ÎJ n§hB:hB‰6flÿõ  ¾\FØ|É„"H76Ä~D…“” ,Œ<ª¨b a¹¿S *„ 8@Ãf5¦ú@œarUR7k~²#ê²í<ñ±øËàYGå'Ñó‹„÷‹„+ö‹€¸ÚKŸJWì%¤£äBÄw‹«±‘ Þ.“»neºLoï›0Í”~“H͘“"§ñ$í(]ï’9T½Ì"XÔŸyQ>ùÀLVݬ¨uü Ä- ÷ý¥{öéH‰–äò§ê`]jì«áâí´ˆãgf'2IÔï(/a©¶ûÊfHÓ´*1Ì)'å ™éñ2¢m|ØØ@¦O¦ãÿs8Wÿpcæu;ö$›mq Ú(AF­rNƒx¢›½˜–õiØ@Ϙ€·HðÔ+ 9žÒhíf§N$a¤¼«÷»˜GÄW5_Äuÿ&Qˆ7»0ê`‹VÂA(¤žU#ã­p,IÔÈ \[+±ÐZQAØPÚó4,Ìl/n€B'5 þFqð ð‘9»w=aU†ë{LuÜÀ3ÉÈ7ô‹i €¬Nw“@„§ˆÀ c .3&ãÌHÄtÏH«}H¬ 7¨.—Â2ü„¨úYãë¡Ún ¼› ‘JéDx yB‘H›J Ì¢€¶góšÌe ýBMÕˆ×XR9u”IϯáºÀ’oí*µ¥MòîeBþð‰-†fÈ~ò¡9An×€•K0q1Ð@ì¥LSËÕú/´¨Æ­|ŠÓ6N¤õ„rÜžÀBÎVü¿xîXÚä“Ö2ëîe±ÙÛ¢þò¡,nAbtLn ¾£S´* ÚÊ„„ཎþô!Fغ ¤RU7±'A}`S $Œ`ŸSp%œü ‹m߆ k1U`fÍ"»‰¥Jˆ'ËEtxïóøšÞ3ãkáô©€³ÌMº™UjPÌ„JßXD3Xž¬u0°* è Xk¸T±æcÒ›7E{k‹ƒ„[×´"±œ8Z˜ÔÛS" ³3e×@ <ùAËÔÒ€±*.N¢ÞA»nL ².lm&þb<£%XDY™·&µ^ ¥L7Í­Õ©p P¦ …žò#ÐÈNceyÕ(¼ •Eä P@/ PÎ’€ys £e¦ó\g¬Ù‰™Ö¢(L¡[r%Næœõ0°ëÂiH=l  ºßm¥D{~æ #¡·Î³rĨtлYEÏÀ@ëUJjJ›/©Î§ÚV\Õ«ã@ÃLh7…`Mó † ä[Œ„,XØuí¬öåÔïí*;'-A"¤_V¹'A¼ ¾dâ÷oÐ@’K›  µ—Bÿå5ÇO7ÊT$)bt óz›hnrQ…mÃðïYŠ­‚Žw=!€©Ñ’‚ïë;Àó¸šÆ³ãv*ç(Â؉%½ò…XðbbBŽU·4"Y¬I&î{i" Ómàiq±5O|–lÀ \o¼¡®V²ÝŽƒhtÃT_Ö÷“5ò4C/(×´‚±Ýp¡VÙ™rÇ ; UÛ‘O˜êvF£ð÷„º÷‘bÇnÐ,¸¦ —l¿ˆ­*U¢(ÓóW©©ÚA ©G‡t¾¤¶¦X˺yŠðà€^P¯Š¥xàI$À »þSy‰º­×å-LÆd“2ÙD“´ªVÊ÷ˆ‰'¤¢zæEûÀDŽ¦TO[“¬¡5†a¿ÚÇ­‡´¡ùm©ö·ÎÜØfw•F–6Ë%Í´£«ìéSû©·V†\•ë °°è°¬¯|Ø_õ€bµòû{@‹âÈ  †_ÿi@õ ïe 6@‘q™“ ´€6bȑ״"13€ï¤)ß-N›´!;·RKüdT¨µ‰'A(«Úö9ú›hFd–8TeÐB¶áè½gÀšzŸ •’­4¥…r¢¹“÷̃Îâk5wÄÙ å]àafv¾_´¢Â ‰˜Ð_60%‰#A÷dT*XåÈ,¥*Ž%¬À“©€€U˜û0UÆ«syy`fÅm„aÛX²ØæXè6Gö©‹e— °€Ç–Ö[¹ÐmÉP¾ªâ<Í„ Ù‡*(€ÁÂ11QúÀôø*c†¡ãÕQâ7 ¶r *T=&­W:­Óô•[=z¤»>»µ¡_Gyät ÅàŠ¥&Z ö€…ÉÞQ`'ñšÌe ää2nµ˜‹ûH¤en{deDNŸàÊàüeM´µà 3ÌÆTULr:üdÅÖ'<Éšd͆Œ?iQß r­8×8PjzŸiQÐî”b”£ŠµBÎYÏA´ À¹“Òð)n½Úúö#›¥€ï‚¢×Kƒ¢ïY¬oa~Ý= !—A‹cÒÆ0›n­Õ¥D\±èø@wÛ.ƒïB•J†÷6ÅØiW+.N‚Ð-]–ø[Íêm f\’oØJ5¡N¥gðé›ýæè$G¤0S£„1WRNndw\×kœ©.‹¼ªçÍÛýÊ0ÜÜS~ñ€yˆÏÒ»@€¥‰$›u0,«€©°‘hÁ–ùÇS´«–&m¼ ,Ío¹@#(Fg!„o©¼(PÄÖ; àS!R<Áª?Â5€Âw;À@˜ßa¼ ¡±Þ«ô¶ŸÌ Í”>¦¡yšåGMàwýÃ#ƒÅW¾922°Ø‰âj䣜¸/‰®8š¸Ê‹¹…s³b7 ÂAõ3ÊêP ö”€‰”€±^Ÿmæ³ ¢B‹|&¸ÏY3’uü¦7w[̉€‰…NgQøK‰ëñý¥™ì ã+[ÞTI'¥ýà+/·”Ktü6„ Î×”Iîʉ7;è¥C Õ”è£V•+ZµVŸP_Ò£Aâv%‰-v=aP™Ïå*aI_‰Í™6´0Û;ߢÛâ`C0ÌI:˜O÷|  iÚà0^ç691¹È„ bBW¢ßY¤K5‰êß)[ ·'A ¼@0©oSÜåȵ쪢Ý+ZÞ­O˜ú› =5Ztéá[-%æm1˜Gĵb@8hŒ¬:Àå,ÎÖ€$U ÁˆQÌÛÀmQˆ“„r¥àf 1$±Ü˜ ›‹›à å@XŒØÝÏÂ*Ìä ½¼ìö¬Ä­î|çS´ P ØòŒ 7vžQ¨#2ÇS´«|È!F°4ÂÀ ®†Ç”[#ü@“qæ7.ß ªsÈu;@êáxWâj ©J+©è›V`ˆ0Ч·^ÐŽ¤kšµn¸¶2Ž&Ã’« #ãÞE M˜]s¯é®'™Ô^@^\Jà$ÀÑW©„Þc;¤ïl—3¾Ñºf2,OYž´/ ’ÇAœ¡_­à"Ö„E÷ü¡_­åD’O`!Gk~¢IÎÃ3¼!XŒí§]¥tÐçÓyB˜æáê£C š »zSoxfª½R™/™Î§iQÂÄ“`nN§xP«­ˆjIÒTIÈg§A}`M®q1Ëç ¦[[5'`y}áHÐ5ï©ÞU¶5«åHQ×ËÓ¼°I®KXÑVB·'üRÚ÷ @¾wc©…@µîIÐZ—%3¤ ÉÊ/m kB‘©PRK’yŽÂ¥M)Ò¦R™µ1ÎýZF\RÄ æ`5€1NlðŽU";u&¯†r8…5ÔLÅ Ç„…ô©7Í¡$õ&)BlAð×6#¬̤ãÁe*Þ\»ird,|Š†l`7ts•<Ó¥õþ`fÍs˜ŠÌY|í‘ý zôPp|:€ ñ´ˆUª/@ÞÍU¾'ö”yMUØšµ Ý´Ëã Ì3“`I&AwbE5bw7Y¬€%*®rûÀ÷‡Yæv…[YP^ER-óÐo5˜Îê‰T·á5Ä•“½Îs;­f"㬊 he{æFRqÀý¥D¾‚¯°ýå@Ì6ä¢}ÅÎÐÙtϯí*"äì€_ †ð‰gÎâ×í(tÑ‚ªÝÂÙMš›0¿ª§í4ι«qùiœ5#¬͉˜Ød ;›jmñ0¨Â×bHÐ_!ò&äð DCgÕ¶ö•“ˆáQ”)è2Ó«B6e”M‹Ìrê`Vy\ŠÊ%š×ÝŽ¦¢Ö6»î¹õ4‚ ¿•FP.•7wéŒNu;@õhQZHiS?þåA×°„×ħ§夺å1È×9(6è$U¥7$ª!fê@½¥ "Àƒ\³0$‡cÊ{ @Ñi;¨§ûšÙkúHA ÞÌÚg´ “5Ñ ØfÌM M×$ ë ’›¥ûE¥2ßfŒ£«1`$Q{b¨:À†»Üv)RÄ #d{@n  ]HÕ˜@‡±È„i(j€Ä‹ž_ÞAép<:ðôþ·X†b.‚êB+qU͉Ú%G•ÄTë5F,Qt¶[B°b®Iü W•S‰†Ú8¦ˆ)¦3U¹²Ó´‚1"yp¶¦ð>€ õŒóÇp`-dƒUK7å7˜Æé=@2Sžñºf1&÷Îe°-¼¢I×=e­Í·´"I¿[SòÛ­öýæ‘ô¼€Bb£{lzÂ##™½¥âÝÇä!{ä.oñtišeÐs6Ò¦ºÀ§N™·–ŸRuiYrWâE:ïÞ]•AÂ4‘MVà æt+©¹å¸øÀ@\V»6†ð3±ÚÑ_içw5RO魯†ìl ½îz™©»¬ž¡a`,»o&ëYŒó=¦TFV”#s¤küeˆ“—í $ç™=â!Ž£Þ “s°ð-î-Mº‹ü¥.yÚç¥à ‘æ¿íƒžBÀ F´(x™— OS ºê¨Ôi(²ÿY¦\5ªv9tYVÌÍ”*ˆ[ þí²òŒÉ€MΦÚ¨ kç½´” €+6¤ŒÚAÌu° C_Ù– ØfÒÀ‰ nuè6„Já͘›|áVpdsñ:/E„fÅEÀ$“©Þ$]Ž‹Ž YI,yØþ3$¸*’p”Á.~=jhP¤Êv#7{Lô×Å+ÃÒfÀþsHã%m…AÃ﬊ E–ît@»¦ ¢þ§¹›06@Q €Ç”Ø(Æ~*ëƒÃTQ÷ß<àfÌA@Q €Ç–À(Æ~‹ÄšJ‰Ÿ3À͘h¢Ê7€„@Ätýàh®PUCQµ%FP3fa[ÔÛY§,L‡Kk–£S>! Xò‚£ó€™ˆ¹6ÆÚä2 v6ȦÚ@èái?XSO* M´=ŽïÄ­ÊSAçaæúG‰(|*nqMó¥ààbPa½ØóÒE%¹<ÖL6¹$"ˆ ¹r^¡8F‚ÿ³I&äÀ¥E°/S : _(AM ÌÜ/ÄÎ9Ž»ªvEr4Q.™X»–79™šÖb~&Z¹:äý>„[l̦ߴN_îp…rs9 AÚ߆Ð$±ÐfOXA§¾ûJ ß›âÌä tQ£p !=+Õ¥‰ºÚ©F\L2D!+.:¾+6'R[ ¶B*³êÊ1ím`2•q[í¤d©k-7·øæeCZUFˆ×êm¤éoé¾°æ`G…]Û:l?é9@£F¶ø/ƒl9™@iWøO‹üNR¢GXæÔª{a9À£B¸ š,\è- F¸-*‡s„ç¯ \Xø.IÐa‡® _ îy› jAÈP¨l ^ˆÈ -‰º‘¤ú4E4ij°óÔû£´ âiÖ–‡ NËlÚñÄq·Ä…iåÔÜg kÁq_' ¸€ ˆÀ)-«cp\G*¨Â?¸gN º‹á\]<Ã( ð5ÔYpÚœcòŠp\E°¨\#ûÆpàk1 ~ƒ‹ýFº®MM™µ8ÆQp#ÁWÃ…J[¯œg^°7cLÛ¦1Xàj€\Ô¤_ Å§x¡}F°\šž#©Æ"‰GÕ¸½J`” ³]êR J \EËÒ' Å”\ÿ¬u«Kþèõ ˜BŠ´€'ÌqEÁÒM>‡(NÜÌ kLS§D¢=˜æ[ ÌÅHä^b,x‹±ëᘪŸørÿúƒÿñ™*«þ˜pøç¹ðÎqC~™UU¬ê¿fMÌT&ú=V`AHÅ}Lë9íᘠo£‘˜±¬äŸþ£zàK©'·ó0ÙYI7Áß/æ!O¹ùD)Z­Š¶°ˆz0Ó'Zdû…¦,qÓü„—Ùgæ§ù‡§jbÞjyéˆjZcK–žálIa*C1Qà ,TsûD?€€ñQþ"ø@F¥‘ª¾ÙAèÇG/´\ý¿hE8Ã>c Ê ĵ5qâUûNÆX­S^J ÿ•àA«MÙCV*FI”õ^5 úÃ:â0€q °®Äû˜ q'Ç6n`#ÄÐ}³gÜÂúC‰ A>3Xw0žŸÖ8{ã6z â n/‡ o¿3ŠáÀÕlÿÊ gˆá±[ÆbêÊ Ÿ­ð¿ó›ÿ(ýg†¸#\ÿ—ï,=‰ánmT:ç$=O×8_ù‡ò1TœGõ0ä±éciYnM:gÍÕ¯’Ä+«ÂP ©wÓ!s,D7Áƒ`‡/í"¯p¸qmŸöˆ‚Âä6,zDxþ l}”I03Çð¸qxMžžQ,xîaû6,}8E⥾áA#Âcì¢ ?â6^þ+œ@ÏÒ(@M&¹Ñpˆ‚_éH _¨°Ê éÜø-aÖÂ_¤xr¥š“(éÎ Ò<8š./ °ˆúJ6^ÿ„ _¤xrø|6jÖüJÄE'Â:åâ”å?Â?IÑP ¤ùçl uµe^j”*Ì2FÖ>^›×¬N6×·a‰ºçJ›1ðl£w‚3?J¹?Ñ·ýf£ô£¨Ò9رÒ§úTªàŒ}|ÆЩ¥*)Ãá-úæa"Wé:¬l)'æaM~“v{ K‡®gH ¾•|G ·v7½ï™ÓiÅÙX»[ô€±ÜØuëß¼ZÚþR…ˆœÎþ6%É6“·s¾Ðk ô?™%‹fM€”º[ØoKÛ­ÎûB°ÄÇE”wСáMf«ðYXÝGÄá&#wõ1é)+Ÿ[ßS¼ŠÁ¶­ò€_"I8zž­*&ìæà > Œ6/SÔÀE¬#Ùv –»1Ëx “•Çø¬¡3‘{±ÔÂËÌÙì7€îØ¿¿¯öÀ†k +§S¼.¶Êìt@3ÌŸ©Œ f¾Ké‘[Dª6VÚ­ÃPú²à[ì<ÏÑD#>3‰Á£C©ÿzÀòÙ°Üv<Æ*2ÄÚm¼ %‹¹å@Lp‚ Ý1ÖP-‰¹{u€É#ÎÃÌyDŽ ‹ùΧh¢ù“e˜Müì<£%X å|ç7:v* |L æÈ\S]Nð …dé 7:À»ò.nu·ÊÿÖ¤[ÔÞ%ÚöU倅ÀÐneÿFp¦³ž"ª’ŠrxÈ;Õ]«Õ—E=;Ê+Œ®ÜMl*~Ít¿ÎUr¹½€Q¤€EË ‡MÌ €ñ\s•Æ¦Qââ<¿¼ ìdT`ìÜÖùJ>ÊÇ«ßhqOËIΩŽË Ï­³œSˆž€(…P6éøoMRçA~Ã!{Ø 0ö埨”¢1È´€¾[me êhQm@‹“›uí¬!‡!´RGB2YD3’rÎú›k©£»„E þÚJ•ßÃJáT3jš~ιøŽ-Ùˆ¦ÖZÙ~‘È\Ÿ*ÿîEˆÐ‹[h Ô8&˵³2£0YÍÉ°WÑvêÐJŒMØŒ], Á6,Ç/œ ÁõzVÚJÔ7>lLuh,[2t]áµÊF;f~ì Ùò§.¦Ú˜%z]ŽƒhCWu ªÃ>f´ Ùú.CÚ¨`B¨ÅQ²Ú0=> VQR³æÇLÞ@¸þ1©Ù:‡A·y®#ÌzrYËT:›é •&ؘ£ã  ì¤T&ÇÒ '¨×%˜µC©'H—9’B`Pr¨r•`QÉ/Q‹T;"ˆ\Lm{§h|YÜŠkñOUÞÏQ‰•o+»I&\ßÃV¿Þo÷¤ ñ—ÃE%Ì÷›;­‡Aƒ\DùŽƒnð)jT¤V"£kÚ3AÏÔ`$»ÚÀj`tðT_Š®òÓ\ÉØB½J|CU¬ÈŠž /Q^²OQÃôøÍ*lqzˆùM#…تàçÔI)‰¯îvWÆÚŠ>Tz¦îÍ—Ðm6vf¾„¡*1“þ ï©»S(bÓŸÆPb` FbY´$ü`gs¹êŒÈ¹½úNnªkpà‘Û!›ß%:š…ûöþë| & uËmýàN¹–ËÚYpŒó蟼±XUÎö@6$¶Þò¬ ÃP6ío”'•H´ xz&«FÜÎzJ›®äZt©§ z˜êßÄ2ãâxPaF+HvÖ]1Ì|Ù 6‘T¢žw|+Õ­¯a[µô迼"mŠì[ñ´¢ì…nXé@5á$â»ü M…±1ËçÊŒŽ;Ôû¡rYQ›¯}Nð ,Ndè$Ê ùj‡sÌsòÊŒ˜­°«>r T @¸.t9J*­Õ*«›y›< fÄ[ ° R) Ô'-r”z¼7 8\…Ÿˆn½H^Ÿ M•Zõ›;Ú÷•S$’רu;H©U“eÀÐ*ñÀ·"Xçü@ƒå7&î~%P6x² jªŒ =@ˆº ÌÈyØ‹žQÄÖÄ >ð4DW8UD³`"çˆxk×8Ç\²ürapù m—\ 7@§Â§Q^üÄ^=­…Xa(@Ðn`^ 'ŒÕ±å[çïlP\‘Œ÷Ò,l,IïjTZ»­ Ew¹:ÀõJ 4ׂáóvçhDñU)ð¼?‡Mµ¼·ëÞ^$YF2ÃÓ÷‘YÛû…ÿá•…Éóð*ª*‘JU}Ⱦ²ŒÜ‹V H€œØXjv­:b³›ÔDEN‚Q6Æä±m Cݘ’Gµà‹i¦H®™˜tMËvQWékÓ©Ik{ü u9“Óxó½ÅÇ^‚“*õøÀc-5êÛJ"Ûù˜rÇ á~ª/|†¬zÊÍw1§F–c1¢õ>ò²óøŠíXÝò^‹¼ŠÃ7:Ø„)åm—âÒ„NEÛ ÚD /æbmó”3™>•,Ö½Øêа¾Ãxž/ïø,¢€WN§y£ ‰c¢ÊŠÎävõ6Ð3fË òüäU(ÂFWs ÚPn çêhD3 a^_œ PT€êÐ=N†ú°Œ|KŒ‡Ý„>*ºð¨@8ê¾wßøå»ŜޡԞ¬Ô_2l£S²# å]à2lq¶lt@…ÌŸœ 6"Ú"êw€®…”r¬ $³nL ·ÿ“ÌÞ •M‘s'xíˆä,‚ACÈcÊ6ï(3\†n~  9žb>RÌÙF¦QCÍæad\€( ÷½GüûÒI$æOX|ƒç:öíÖáhŽ‡ÆÂõêdÐ4%xJ R©½Fæý¥GŽîÕª5j¦ãýÊEdÌX’u2 EÇê<½»Êû5¿©†]„€þšÿsÈ@M†dÀ·È k™¾vêe ²µ$Ìß;u0Ì NæA*¥šÂšŒ§ 6!F–6¿yGp&à±9è:™‡CÀÜqùBjŒÇ"I=z˜P A?Š„)³§©„F&c–@|%ZÙzž¦j­`À Ú{À€Ió1Ë{@ëᨵZ£ ?JõiSuÓ^²QPÏkŽT!—ŸZ³¹½Cž¡v‘XÝÙšÃxUb7ŠJ‚¥V&åƒ6öÈ{@€l16ð«Wuk€ íae„CÔ767'V¶°$X‘rt[@´¨êÇ ú±Ã(ÉŸ¢é½µ€ó]EÜè-¤ˆ¥¨Ã\$žg e(ͪzTY~p(\Xa΂Ú@ äEÂIçr dÏÑ@Ãí¬ []As ¶=N‡ÕÔ3¢·ü¢Ü°‡Ä×^ ¸z¯ñþ%]Z¬ÎjT±¨{i"³[±èSh¬9ˆ7€=BÞwUYT Z`³µ¬ 0*÷ò­°Žf´ z‚ EJi X3–7 @¼×ÊÚ½ QqƒÁDKúŸýé'qÊ£Ê>2l(·A¼ ¢¥êT¤®Ç”åÞQ%°g„co| JùšÁGçÁV`€}šæMþ0F§Q¼´Í:j4Åsÿ¸3:´K…9ç”_ãÒú7‡¤´¾·YHÂ|·:ÇGU;³*®_pƒyQåñœHâªU²­ìIøÉUÌî¦À-”i )»òs×´¢éµ2ÍRµ2Ê:¶{@E‘™ª” _!„ Ù”’HbO÷)J¢ã±ÄtøÀÑ t‹¹lÚw˜².,Ã0Ë°^ð46E¶a˜gØ@Òšp¡‹R°b/eCa®HûÄff[NM6´‚%³|#{f}¥)#Sì¶ùȱy™¬=¥dÂ.òXçï‚lIÄ |  £"ÄèXW})W­goM1úÊÍi_ˆJW»ªF@G¯9ÞìYŸž»H¨ 9™²?Ue@·KôK," u9ÀA@±$tçÝp¶Uß©²À͈¶an§x RÄ ‚ç@zD — TV>§ID-…HÃï¬"‘ ¢Æ¡Ð2€™b¡ÔýçÅ0­‚ÿÎIM±‡Aq”ÈÈJ zš÷´#6½°¨òŒ §MBÎyVÐ=.†ú½ªÕ\\Cr¦Ð5¯Ppô™ÉUµ¹×ø•C—,j9ÅPé~’+0ŒÇ?Ę­u,­%ÔïH'ÌËeª AÍr '´ƒD¤î|:JXúšQ8qyEÂ.¤õKe² D+b—<¢Úw€Ù™ÀU…C®Z@–òŒ /÷Žð%›–(ÖAeXý£¡2Kö”,ÇÚ>dòƒ Ï2w&–#ìÓ6<ÖùJ©!u;ÿ%ØX*òyŠ Ù¹GÇ´¾†n.¹gÊšóÒQé›q,¸z]^ÐŽ¥8¬Lh&ƒ&·Ê yï侯ÚEJ©f°ëÏ…4ÉGSó”ÎÁ$^§§xísa’¢ƒrÜ£X yØ»rmò”ÎÅß”kl¿ÌY‰=`U03vÑzn`4óQó3~¦3bÇ2`vfÞf6-žÂÙt_ÔÂÖ;¶û{@@ulï ÞÎý mÑ`K5®½õ;š!Ä':,#Òá¸aDâ{=c­ôIQO€št|Õ3GžÏ­ØêÛµÅÉÑaUõ»õ= ÂÅWN§xS µ®ç¦Ðƒ©±ÏÔÐ%šþU8 $›ü ¨üž³\aQe 00› ßå(C¨/SH‰v¸°ÉD*”a z‡A´ Òê¦çÔÛJ!˜[ òŒ„ :/ëÔà¸o õ†*ÍÈŸ¬£^"²ðÈj9ÅU¿Û{BuäÔvf5jœNÚ ¡Y]·'©`òƒd³o$0¹Êšè7›ÆçðA¥°ù7:öí(_؇/S@—`|«’ˆ F¿éÀa™<øˆsŽðb€­Î3Ìví6½‡S´ ¾#Ô"ÿ¿œ 5À.Íá®Aoð›Tbo{{@¬L‹|GÐ_A µ«Vˆ*ŽC¶½»@†b£>oQý%˜˜Úÿ‰é Ú‚?YiRÞÚw0=šÆØxJÖ@µ¥ÄaÆñ ÂQZt¹½?¹—ƒÊ.ùÕv&£iûȬ±ŒÅ¨óeð”Y¬ô©š*íÌp‹û@ÍØ Áa‹Õü H$žÐ)šäS@ê`]J¡Õh¥$°êl`fì‘@*:îd |Ì(¹LC2¢( d;÷”iYé¹ZtiØf|Ð$Õ4ü”ŽCR:˜(äÙX÷ 2ÒMLÈQ®¦ÚÀc#l ·Ê –R\ùœ” ‹\áUË ¥gp””3ïÐJ=:4’ŠÙ-ŠÖzŸ´3ºæ¯ÅëN€F¬b‘ÂÎ4P-ó†Cl ¾ÛB,8Â@U¿ª¡ý%¿•W- Pòœ€/¾Ò‰0TgÏ8–½”-‡A‡”Ù@-Ôí(e©”©„g¾²#6plåÐ^d¦À]ýô•TM"¸QY@æruí&u ¤(éxE€š‡A´ >)—,yÜÚÐ1fKaR@öÖ@ÀUÍôJ=>…JAxŠØž£f¨GXÖ¬œ:šµšîÙeÓ°•—“YÅG5ªoʤtý¤i;jI= ZcƒUõ= 7ðÎHÌ).ã2`fìë`4ÒA@È9Ó-?™E:"Y)Õǘ€r›ÃX[©Þª¶ÄÌ0üà^PÖz‰Joü@œ×ÎOœæÝàB©b±&‰LÔ>6]Ë1´Ví€0Àº›ü`KÝŽV 44K mc°¾²•Zj+T\Û–ÿ8…e°’çNÝä…¾ë~P4ÜÚ•4fcÍaסHp6˜¸Š’àЫPw »Úïo”¿¨ñ\½jV¨6ëûH¬›5È?”‚‘pŒdgéV¦¾+©òÜkÞQ)ä_þcËûÈ3§"_ÖÃòE¿©‡ä%ò%ýM§a9œ‰oS|ý4¿©Çä?™BJx½M§a ÎiÞP¤ ¤iiJ¥‰E6½´ö–"lml$/¶fA;a°ù@߇áêU8PY}U’J•4§O 0B[«ÿõÖBÔÅîq–Z@¶ZtéŒ5 ªÚŒ<¢( óoÚA*˜ƒŒ£T¦*¶ªˆŠ/vËñ.¡› °ðÓ¨ùÀ‡»€ €Ä24KyÚÖ ê`výÁ=zž5aöZ’O4@‘ÄÕ¹P§Ós´£“éjíaEHÏšÇá<ÖR‹€X±æÏNÒÄØ)¯‡Q˜Q¤…·°ÔÊTt>‘Ï-L q`EÀÔîdªÌÀ®ð,†vZtÔ4Ë^ðyˆ¦™î`ÉÝW®çx ³“ß2´Ó02ê` ­MsR:™ASÊ0olÛÞr ±%/#SÝntí(Ô ñÛí"QÌÌ-ø翇àÁ V¹%5ÔÀê«V V nU%G—Z¡¨Øê°?us…eld’ã-MŽR ©>*¢ ïv”I¶X­oJÞ Œ,äœC¹¾4ZxÙ•iIav‚¤Œk[Ò·‘…ݳµýô•V”™•°Ø æru€­q˜!ƒy0w:{*4JU+IK}ç‘`A©¶f¾#–h$¨à€ªZ¡èŸÌª-„”^oSˆf¼¿9PÆÙì7•]ü -õ®$eé_½í¨þšõ͈Ð}ßæTxõë7þ%L©ŽU¼+bÆÿ$bžU¨rö€Zßf™“ÌßïHìÀ¼£®òT[rð*ÿü™<«þô”+”ó±½C˜íÞA ÉG?³C—Vßø€ 6C$\É.ØŽBÊ4£ ýÐzÀ pý£±åç(CÈ1ç:vï Ì\›r`hrû$ÌHêv€ÿÆ™îwþ K‘l Ê:î`$\G[™;@߇¢ü]u¦‚Ê?ñ=š–8. 9ŽÒŒxÞ!xZ.kyÿR£ÈRTx§˜òßç2¨0ªä[ú˜~BÁ4–àÙØeØ@@”[úÛNÂ\ïÉ(–¿™µì RU©EegØè ,L‰rÇwÐJ3ÆßxÈ4ÄQ/–&í ”iF³ÐBà&6Én£.ò ÕŠ©¨@¹åÊÙï<_Ú h–Pjܾð#û£óŠ:ÚØ…Øè°¯G…á0R¸ÇTòÓÛާĊ=qÕ#ò•:ó*;.çCù f/3º“‰^‹¼ c„ݳnƒ¢Â%AbXœº“ «‚ºaA ê`"mbÃ?Jí Ø›û“² å¦5;Ê ä /¥wgmÌ ÝPÿ“B7[E1¯y³bì‚@8FuM¿˜E+º])9¹fÒˆz†ØU·ÞÔ°ÙšÝõ„zGÑaÿåqÊ9Wxu(5ë¶ÍWîÿ2£Ê­ÅT®I,Rˆ:¿Ì‹íQ‰Øt+KÌ:e§óÒ«Ó0¥ÛS„eÚLà +c¹¶²3ó0D VøŽŠPdªzʾ&5]Ê e2Ø-ÉhH_"€XêGÊPÙ©•©ÒúŸ¿Äƒ7e¶øÀJªAbQßXSðXš•Ãà(S¯iDø{t›Ä’ÍsÚvZcšÎFÚEÔD¥LZ¨j¨±òˆÃ+ˆb<Ý»H!P±IÐ^©Iª2ѤA'sk™G±J˜à8`‹æ®úÚ¨^‹Œ¡›7$ü%Äx•«ÖjµH·[„ŠÉñ3_/ÎATÓVkXt¾¦‰B««q„ ÌÌ ìÆ¥E$ ím{@ÍÃ’Y”Üö€Ðwm€õ0©7ªà•SÔí_;5GÌ Ï~Ð!˜³=`:j Ù¹W_Ú[ÔrÌrµ Õ©÷GÈ@U\d° ³`Sœl d£xxÍCìé°æ6½Ì£×¡ÃSáÍÔø•º»h°3â8´¦Zšõ¤o/WšÌrÎukÌ´@-±5ÀùÊ4®ø‹zP A*¤œD¶öÒ ¤b,l;k°)”Äï„zP.°©6Sv#Am FD’ùu&Aª¢2’j¦?6•–LÄZÞUgn`I¥:xÁTtQo31´ +|®1ÜfdÁ˜å`€0téTĵS·§ù…›£J<Ú3mÚTK «aêm¬©a‰Á·A¼î „,~±Å (4R-â I?mPX(º­´Â<~*»q5 $­%ÓýÞ*¹±h,ƒi€"ìtw€ìÈmbjŸÌ2„HEÀ¹ŸQý$‹‹2l£S…›3妿ïç(9¾ÑÅ”d«¿ilÅÏXý1ýçáüÀV#È¢îr?´ˆQMþñÞ¢â:Ø NÐ,çîÓ_÷ó”æçËMÛ{À‡lFú[@:H)Q…þè=`!â6dò߯xùˆscËûÀοÓ[zØgØB½_£xu᨞.°³åB7£v'‰«Ìyè7šG•Æñ ÄÖ—( —¿y5\ÎÂÁ”uÜï J¥šÃ.û@£öŽ2Q¥öÞPØ—aM9—ùÈ&£e^UÓ¿x 3XweÙÜ*1d3ùÀ§¯V Z+Q™@_YDT©¢)º‰ÞÄ€$ö]F±ÖÄÚ˜U­† ž\Ì2`Cœ ÃÍ¿hÜ}ÑK„M,Î7éj B•Qé±sp¶oŒ£˜ è­ õ8®.äÑáòV¾å%€W®§xPP ßEÞ@óŘÄç§A*6…7c«o J  O’ôÀ£‘…Ï¥ "p›“z›í •[Ü“`52ŠÈ­Ï•€u„ÚÌã?JÀÛs¼ È‚ªl£™·€dGݦ?2`C1c¥‡A…ÐØgPÿãüÈ—’™óf”K0¶Ó©ÞÑ@ÛNƒxGõCõšìVšè4¼öl_mVʃ5Só0+ŠâŸ‰rŠR÷÷…ŽW¨M‚’iœ©*117<¢úÀ¤©R‘Æø‡NÒ„îÂø˜š‡˜ž’LLl¹è ]ñ›…RD zÍVØ‚­$ÐíåµBÇE°Ð[H¨ÄyGë ´¨´”–¤­Q´$œ¥H¦-„#>ÒP€ n{ÀÐab) %o™¾°*©¢äS TfKuï(ÉÙ ”\(ø÷€ÑÜ–8F¹@ÒšR¨ÅêÕðÑzaø`Íâ3 #+~!üÌIay"áÉR}"úÀïú;jŽ8ŠöðÇ›[Þk­V¹Ê…?Œ¿ˆåúV³a•”bæ³ †Ò4©D¶EÛ\ô*Œ-÷L 2 T–nk„¡ÕG¢¾)Wavì6A©µì6œ o"`ÍÍû@ Ñ-£0Ï°€"_Ôúv"‹öiÔܽ†ð ~Eñº/¾ð1`j6ƒKõ0 ’I$ܘMA%›•s=û@h j¹›_2vÀ*1«Pª» E¯Là¥RÊ:Ž§y³­°…²û뀪G–î}7ÒQ`ÓÂ@Rjzœ¶Be«{»À` ˜²ïþÎ×lMXè¶3%T ,uiTR1!}¥H¦:ŽTT ¬ÖZÙ4K±8Åõ$ޔ髂¢ª"fkçHj1¥Ž°!ƒ1ôÛ  2iMñ@©Øéü›Sd&šØµ¼Ì áÙ  ºà$OSm·ÝÁðmU¼n$`¤½4¿hˆûB­r'ëWÄ?P¢ÜS“×¼.9’0¨!GÆ@*Øcq—A¼Øã¨<Ç0駙7¨~Ì PXØ Ì µþÍ—RÛ÷ö€dþUÊšæOë¯`”h 5 n.: à;Ÿê>dè y<훜Åþp3Ôî`Yºý˜æ:þÐò EØŸ1)Brxjo÷Žò E,l2ï´ >rrQ¿ÎP¹Ø*ùQwùÈ%Úö%šâ$¶J507áh?ÄËÖÞ‘×­èàøq`giF|etáh§®‹Üï/ã.Wªù›å~¦eY’I$Ü“Dò/ˆuôþð"iý·P|½ÎðfΫ±;\êe—bos Ò™* F:d õ2‡AÙÆ&øt^æ@Z£UªA_(Ï´£6¨Y±0û@tìÆì£ÌÈ)©X@Tkck EVt­UE:X@ Σ!ò¨8WLõ>S 0.¦:û˜ÕZ¨`J¤Ô{tJ1@ baeý`g„}á ÜyM—7ßiTÀÔ)°õ1„C5ÆQñ…P\¸»ß8C†ËÍPõÚaS{êÒT[d¿9TÉÑœŠ‰1ÂnÙÔÛîʨ±9û“"/",<´Æ¤õ”s’ ð¨f,~@t‘…s¨ñþeËÉO6#ÌÐ%˜têw ¢Ø›%ùÀíàxSÄ7[ËE~=„£Ò'Äó°µ%å]ÿ‰Qæq¼SqiÒk'S¥ÿ‰4Ž7al |?"„Øœ>úÀ±QI ú@”6«Wú•™Î€;ÀÈ3³rIY'úifc©´ ñXÓð)„Ãêl#?âQ“¸åP0ò¿x|Ì£׿i+¡lu)‚ƒ ·´ b¬MV@£Ò£ýÒA™`ÌI“Þ 4ÀkDd/§xý…:W»øÌ;yeùi‹\‡a¶‚Ø6½¤RG\LlÆPêÓE*u¡:•ßhÙ.#ûõ0!Q˜Ø|ä-•XR¢¥€ø÷•^¢ð0¦™Ö}HÞtéø4˜œÜ‹¹)QâU58šåÜ=´+*—cÊ@°×8²P.Lªäò¨ÔýÑΫØyTûD¢j6#²`$ ZöNÐ(ý£…Q`2´Î&TLÀÈw€T Y0½w03å¬ jy†:fǼ¡7‘z›6ý¤ôéÿsÈ0304§ä_®‹ï¼EE˸º§MÏA(J Z„±×60FÄ×µ†€l$±&_%6JcRNm(Ⱥµ€Sa ø…P¬¿¾‹"ˆi—.yœè7‘(-n¦ÚȨf&ÇAk^…iàÆõ.äyS’ˆ>F$¸57ÛùB¦+ù…†¦ÉLTí5ÔL¢b `Kr4Ø ÀÒ'Ę TìF_Ì@š›£J.Ú1À–W«[©¶°%S«‚éÔ»8>¸†ñk Wð¿aô…ªeÃErU¨GÇñ-YÍ y(ÉŽ—þ#Lq30!Ë©ÞE$PF&ÉFÚžÐ(ççqe(ý ýŽ/~Ußø™%ÎdÀ² y½C‘íÚµ¾Íݲ$| K£›ýâ:ÀH¸ŽÀfNÐ(ù͇–šÿ¿œ gÊšÿ¶ÅôØm¨ 1°¾Ãs†Wªþbt;™Bóc¥ó¿yI¹7=à_ôÖþ¶vé­ýl?!þšÿ{È@Ž²‹o³\˜óví õþáÇ DñU……”l mDo¬ÔÌžAúÍ#Ëãø–â*ŠtÉ(_Üw“uqÍP…æ§s -îvhîÂÈŒMºƒ©”hüET¥õu{W[ fìQpXbõeðgˆì?(9À¸0ŒG›ö~%:t0x*j8Í®rˆSLV³0Ë°×cùÈ4L(¾%È:/ï(Ó†N U«Q€S`0ê`dª‹³]Flw'8رas(KL³X0iáµz¡)FŠ @®*“Ò"†\ͳ¹”C+S§†ÇfÙtè e Ö• µ²!a{^%€µÎ€ E„áLß«mþï …PØzš3 a\—ç"@fÙeSÌ·™Îƒh@N çw:¤T¢–¹ÑF¦QY0û´×ãüȃP…r®òª—kþ@H‹¹Ô;t”[Ȇìuh ˜4êw€‘A›%œ S‹©ˆÝh®ß!R gl. Ó]«B<î7Œg‡6èJü„Âï„`V'v¾°¤˜Ébjd ¹cˆä‹ ”hõªTµJ¤*oÂ&£1¹±ü Uü1r3˜Ë–A¢ÔP¯„Uº‘ËüÊ3fî¡F",Ùœ»@…šÁs=ä„Š`¹7×¼¢ŸÁv H:¢êXü`dì¤ i”€TR 8F²i%:¥ž­QM+[à Eƒ¶7a€eaò, n¾ÀÚDÂ1µÝ˜}^¨O¬TBAÓ¿ñ0¬/QÁ' #S Í®I&÷0-ñ1å¬?§T}šgŸS½Ö«åFž½åG'Ò¼Và¦LÃ?íKÁç³L^¶v+)ŸÓKÛÎÃ.¿f¸ýG—·xyÅ:úxÀºvA✣¼˜ÕÛ07ê` 1¹w&Ã60%س=`×Zö“°FõjQa F„LÕrûÀ*y¤:sw02©òS·©ó=„ ¥zhkhÚ'¿S(š@]…Õs=ûH ±,XœÌ LlÁCûÀª•[‘Žï-VȨNøG©íÒØR±Ý…1«ÖlT‹²Ž–€Â*fÌ1t= „}²Tªz ›@ÌŒ …e,ukÈ%i“™ /Sq_Úž;¤º Bçù”Fl̶QÊ¢ È?”ˆµ¦àáD-Pì4”"¬§ÃQç919@–`Ó©ÞŠÄÆÊ:Àéá8fâŸy(¦§nÐ=^ˆW§j|>t͗ͬ™èó¸þ-Í*fìrb>BiDàR€‹žb>R*Uql¦AFÍý´×ýüàÍæo*.@~%ر¾›Ò(°óP~rƒú~vÍÎbý;À?¦.¨~̃0 6 Yò 3'˜Ž½ ÏÃLÉÔï¹p)Ë©ÜÊ!¶ƒ©ÚAÔ`«åEߧs(Ú0UòÓ_‡s±X(²€Eä›(ÔÀ¯ê1cåUø  5 Û$_€Ú»–kè4t*Íىºçð¿J¯Ä€ †¤Ž‚±ÅT.ËÂÑÔêeÁ—Y8N*gl—ûŽò£ÉñjTcZ³~§hVLìM͉=„ §kp ŽÚ™Ñdj†¥jjê3lȾкWª_ÃðÔ ð ÝÕìFVÈUv¶` ÉØ@±‚­URÅA•ì%¸¤]iÑrê2]L p  jëa¯sg€î¿œ YS,y¬~4©B¯Jî–j™oa*`¢š–óh£¾ò Œ ¤ ’Íʹžý  µ\Îm™'¤Uƒ¸åQ«åÑy»˜@Øy)bõ>C°• tü1’ŒýåÍŠÝÐU/•qêoaÚ…êÍ×hy« Ì ¤¸ÝVö¼‚—í `%œx™†H.¤*–k“œ‚ù0æn»J7¢ƒ]nH=/§Âª1@˜›ëxQO8\d_¼ x`xŽ*2p©6Òö•½aâW^y)õ·Y‘ËÇñ/Ai¥àØì×ç3@Ù{’H+"Çeÿ´H4bÑ~&p5¬0¹¤9S/s¼+èx C„L<ÕbÞð„ÔÖƒáK“SV'9qU«W%² 6UM|œÓ!°ýäVp‹¯“xc%L‡ïÖòÚÐ}ÉþZjƒB1ð1«yh ¼Ïç(ËJãV6¿l¡UOËMê E”v¼#(Á¥<îEð øÀT€z€6wÌ÷€jµAc›{@+´*2 Ð#ÜÈ5ªJª >Äž·•Z§ôxl*¨q’ *4•¶:F%߉‘†SéøÀªj®álEÎð4EEe­È°—G¤x/*Ó¬Ê-s–¦ÿÙqcustomplot-2.1.0+dfsg1/examples/plots/mainwindow.ui0000640000175000017500000000166713532027716022540 0ustar rusconirusconi MainWindow 0 0 548 420 QCustomPlot plot examples QCustomPlot QWidget
../../qcustomplot.h
1 qcustomplot-2.1.0+dfsg1/examples/plots/mainwindow.cpp0000644000175000017500000021012014030217664022670 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ /************************************************************************************************************ ** ** ** This is the example code for QCustomPlot. ** ** ** ** It demonstrates basic and some advanced capabilities of the widget. The interesting code is inside ** ** the "setup(...)Demo" functions of MainWindow. ** ** ** ** In order to see a demo in action, call the respective "setup(...)Demo" function inside the ** ** MainWindow constructor. Alternatively you may call setupDemo(i) where i is the index of the demo ** ** you want (for those, see MainWindow constructor comments). All other functions here are merely a ** ** way to easily create screenshots of all demos for the website. I.e. a timer is set to successively ** ** setup all the demos and make a screenshot of the window area and save it in the ./screenshots ** ** directory. ** ** ** *************************************************************************************************************/ #include "mainwindow.h" #include "ui_mainwindow.h" #include #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) # include #endif #include #include #include MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow) { ui->setupUi(this); setGeometry(400, 250, 542, 390); setupDemo(0); //setupPlayground(ui->customPlot); // 0: setupQuadraticDemo(ui->customPlot); // 1: setupSimpleDemo(ui->customPlot); // 2: setupSincScatterDemo(ui->customPlot); // 3: setupScatterStyleDemo(ui->customPlot); // 4: setupScatterPixmapDemo(ui->customPlot); // 5: setupLineStyleDemo(ui->customPlot); // 6: setupDateDemo(ui->customPlot); // 7: setupTextureBrushDemo(ui->customPlot); // 8: setupMultiAxisDemo(ui->customPlot); // 9: setupLogarithmicDemo(ui->customPlot); // 10: setupRealtimeDataDemo(ui->customPlot); // 11: setupParametricCurveDemo(ui->customPlot); // 12: setupBarChartDemo(ui->customPlot); // 13: setupStatisticalDemo(ui->customPlot); // 14: setupSimpleItemDemo(ui->customPlot); // 15: setupItemDemo(ui->customPlot); // 16: setupStyledDemo(ui->customPlot); // 17: setupAdvancedAxesDemo(ui->customPlot); // 18: setupColorMapDemo(ui->customPlot); // 19: setupFinancialDemo(ui->customPlot); // 20: setupPolarPlotDemo(ui->customPlot); // for making screenshots of the current demo or all demos (for website screenshots): //QTimer::singleShot(1500, this, SLOT(allScreenShots())); //QTimer::singleShot(4000, this, SLOT(screenShot())); } void MainWindow::setupDemo(int demoIndex) { switch (demoIndex) { case 0: setupQuadraticDemo(ui->customPlot); break; case 1: setupSimpleDemo(ui->customPlot); break; case 2: setupSincScatterDemo(ui->customPlot); break; case 3: setupScatterStyleDemo(ui->customPlot); break; case 4: setupScatterPixmapDemo(ui->customPlot); break; case 5: setupLineStyleDemo(ui->customPlot); break; case 6: setupDateDemo(ui->customPlot); break; case 7: setupTextureBrushDemo(ui->customPlot); break; case 8: setupMultiAxisDemo(ui->customPlot); break; case 9: setupLogarithmicDemo(ui->customPlot); break; case 10: setupRealtimeDataDemo(ui->customPlot); break; case 11: setupParametricCurveDemo(ui->customPlot); break; case 12: setupBarChartDemo(ui->customPlot); break; case 13: setupStatisticalDemo(ui->customPlot); break; case 14: setupSimpleItemDemo(ui->customPlot); break; case 15: setupItemDemo(ui->customPlot); break; case 16: setupStyledDemo(ui->customPlot); break; case 17: setupAdvancedAxesDemo(ui->customPlot); break; case 18: setupColorMapDemo(ui->customPlot); break; case 19: setupFinancialDemo(ui->customPlot); break; case 20: setupPolarPlotDemo(ui->customPlot); break; } setWindowTitle("QCustomPlot: "+demoName); statusBar()->clearMessage(); currentDemoIndex = demoIndex; ui->customPlot->replot(); } void MainWindow::setupQuadraticDemo(QCustomPlot *customPlot) { demoName = "Quadratic Demo"; // generate some data: QVector x(101), y(101); // initialize with entries 0..100 for (int i=0; i<101; ++i) { x[i] = i/50.0 - 1; // x goes from -1 to 1 y[i] = x[i]*x[i]; // let's plot a quadratic function } // create graph and assign data to it: customPlot->addGraph(); customPlot->graph(0)->setData(x, y); // give the axes some labels: customPlot->xAxis->setLabel("x"); customPlot->yAxis->setLabel("y"); // set axes ranges, so we see all data: customPlot->xAxis->setRange(-1, 1); customPlot->yAxis->setRange(0, 1); } void MainWindow::setupSimpleDemo(QCustomPlot *customPlot) { demoName = "Simple Demo"; // add two new graphs and set their look: customPlot->addGraph(); customPlot->graph(0)->setPen(QPen(Qt::blue)); // line color blue for first graph customPlot->graph(0)->setBrush(QBrush(QColor(0, 0, 255, 20))); // first graph will be filled with translucent blue customPlot->addGraph(); customPlot->graph(1)->setPen(QPen(Qt::red)); // line color red for second graph // generate some points of data (y0 for first, y1 for second graph): QVector x(251), y0(251), y1(251); for (int i=0; i<251; ++i) { x[i] = i; y0[i] = qExp(-i/150.0)*qCos(i/10.0); // exponentially decaying cosine y1[i] = qExp(-i/150.0); // exponential envelope } // configure right and top axis to show ticks but no labels: // (see QCPAxisRect::setupFullAxesBox for a quicker method to do this) customPlot->xAxis2->setVisible(true); customPlot->xAxis2->setTickLabels(false); customPlot->yAxis2->setVisible(true); customPlot->yAxis2->setTickLabels(false); // make left and bottom axes always transfer their ranges to right and top axes: connect(customPlot->xAxis, SIGNAL(rangeChanged(QCPRange)), customPlot->xAxis2, SLOT(setRange(QCPRange))); connect(customPlot->yAxis, SIGNAL(rangeChanged(QCPRange)), customPlot->yAxis2, SLOT(setRange(QCPRange))); // pass data points to graphs: customPlot->graph(0)->setData(x, y0); customPlot->graph(1)->setData(x, y1); // let the ranges scale themselves so graph 0 fits perfectly in the visible area: customPlot->graph(0)->rescaleAxes(); // same thing for graph 1, but only enlarge ranges (in case graph 1 is smaller than graph 0): customPlot->graph(1)->rescaleAxes(true); // Note: we could have also just called customPlot->rescaleAxes(); instead // Allow user to drag axis ranges with mouse, zoom with mouse wheel and select graphs by clicking: customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom | QCP::iSelectPlottables); } void MainWindow::setupSincScatterDemo(QCustomPlot *customPlot) { demoName = "Sinc Scatter Demo"; customPlot->legend->setVisible(true); customPlot->legend->setFont(QFont("Helvetica",9)); // set locale to english, so we get english decimal separator: customPlot->setLocale(QLocale(QLocale::English, QLocale::UnitedKingdom)); // add confidence band graphs: customPlot->addGraph(); QPen pen; pen.setStyle(Qt::DotLine); pen.setWidth(1); pen.setColor(QColor(180,180,180)); customPlot->graph(0)->setName("Confidence Band 68%"); customPlot->graph(0)->setPen(pen); customPlot->graph(0)->setBrush(QBrush(QColor(255,50,30,20))); customPlot->addGraph(); customPlot->legend->removeItem(customPlot->legend->itemCount()-1); // don't show two confidence band graphs in legend customPlot->graph(1)->setPen(pen); customPlot->graph(0)->setChannelFillGraph(customPlot->graph(1)); // add theory curve graph: customPlot->addGraph(); pen.setStyle(Qt::DashLine); pen.setWidth(2); pen.setColor(Qt::red); customPlot->graph(2)->setPen(pen); customPlot->graph(2)->setName("Theory Curve"); // add data point graph: customPlot->addGraph(); customPlot->graph(3)->setPen(QPen(Qt::blue)); customPlot->graph(3)->setName("Measurement"); customPlot->graph(3)->setLineStyle(QCPGraph::lsNone); customPlot->graph(3)->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCross, 4)); // add error bars: QCPErrorBars *errorBars = new QCPErrorBars(customPlot->xAxis, customPlot->yAxis); errorBars->removeFromLegend(); errorBars->setAntialiased(false); errorBars->setDataPlottable(customPlot->graph(3)); errorBars->setPen(QPen(QColor(180,180,180))); // generate ideal sinc curve data and some randomly perturbed data for scatter plot: QVector x0(250), y0(250); QVector yConfUpper(250), yConfLower(250); for (int i=0; i<250; ++i) { x0[i] = (i/249.0-0.5)*30+0.01; // by adding a small offset we make sure not do divide by zero in next code line y0[i] = qSin(x0[i])/x0[i]; // sinc function yConfUpper[i] = y0[i]+0.15; yConfLower[i] = y0[i]-0.15; x0[i] *= 1000; } QVector x1(50), y1(50), y1err(50); for (int i=0; i<50; ++i) { // generate a gaussian distributed random number: double tmp1 = rand()/(double)RAND_MAX; double tmp2 = rand()/(double)RAND_MAX; double r = qSqrt(-2*qLn(tmp1))*qCos(2*M_PI*tmp2); // box-muller transform for gaussian distribution // set y1 to value of y0 plus a random gaussian pertubation: x1[i] = (i/50.0-0.5)*30+0.25; y1[i] = qSin(x1[i])/x1[i]+r*0.15; x1[i] *= 1000; y1err[i] = 0.15; } // pass data to graphs and let QCustomPlot determine the axes ranges so the whole thing is visible: customPlot->graph(0)->setData(x0, yConfUpper); customPlot->graph(1)->setData(x0, yConfLower); customPlot->graph(2)->setData(x0, y0); customPlot->graph(3)->setData(x1, y1); errorBars->setData(y1err); customPlot->graph(2)->rescaleAxes(); customPlot->graph(3)->rescaleAxes(true); // setup look of bottom tick labels: customPlot->xAxis->setTickLabelRotation(30); customPlot->xAxis->ticker()->setTickCount(9); customPlot->xAxis->setNumberFormat("ebc"); customPlot->xAxis->setNumberPrecision(1); customPlot->xAxis->moveRange(-10); // make top right axes clones of bottom left axes. Looks prettier: customPlot->axisRect()->setupFullAxesBox(); } void MainWindow::setupScatterStyleDemo(QCustomPlot *customPlot) { demoName = "Scatter Style Demo"; customPlot->legend->setVisible(true); customPlot->legend->setFont(QFont("Helvetica", 9)); customPlot->legend->setRowSpacing(-3); QVector shapes; shapes << QCPScatterStyle::ssCross; shapes << QCPScatterStyle::ssPlus; shapes << QCPScatterStyle::ssCircle; shapes << QCPScatterStyle::ssDisc; shapes << QCPScatterStyle::ssSquare; shapes << QCPScatterStyle::ssDiamond; shapes << QCPScatterStyle::ssStar; shapes << QCPScatterStyle::ssTriangle; shapes << QCPScatterStyle::ssTriangleInverted; shapes << QCPScatterStyle::ssCrossSquare; shapes << QCPScatterStyle::ssPlusSquare; shapes << QCPScatterStyle::ssCrossCircle; shapes << QCPScatterStyle::ssPlusCircle; shapes << QCPScatterStyle::ssPeace; shapes << QCPScatterStyle::ssCustom; QPen pen; // add graphs with different scatter styles: for (int i=0; iaddGraph(); pen.setColor(QColor(qSin(i*0.3)*100+100, qSin(i*0.6+0.7)*100+100, qSin(i*0.4+0.6)*100+100)); // generate data: QVector x(10), y(10); for (int k=0; k<10; ++k) { x[k] = k/10.0 * 4*3.14 + 0.01; y[k] = 7*qSin(x[k])/x[k] + (shapes.size()-i)*5; } customPlot->graph()->setData(x, y); customPlot->graph()->rescaleAxes(true); customPlot->graph()->setPen(pen); customPlot->graph()->setName(QCPScatterStyle::staticMetaObject.enumerator(QCPScatterStyle::staticMetaObject.indexOfEnumerator("ScatterShape")).valueToKey(shapes.at(i))); customPlot->graph()->setLineStyle(QCPGraph::lsLine); // set scatter style: if (shapes.at(i) != QCPScatterStyle::ssCustom) { customPlot->graph()->setScatterStyle(QCPScatterStyle(shapes.at(i), 10)); } else { QPainterPath customScatterPath; for (int i=0; i<3; ++i) customScatterPath.cubicTo(qCos(2*M_PI*i/3.0)*9, qSin(2*M_PI*i/3.0)*9, qCos(2*M_PI*(i+0.9)/3.0)*9, qSin(2*M_PI*(i+0.9)/3.0)*9, 0, 0); customPlot->graph()->setScatterStyle(QCPScatterStyle(customScatterPath, QPen(Qt::black, 0), QColor(40, 70, 255, 50), 10)); } } // set blank axis lines: customPlot->rescaleAxes(); customPlot->xAxis->setTicks(false); customPlot->yAxis->setTicks(false); customPlot->xAxis->setTickLabels(false); customPlot->yAxis->setTickLabels(false); // make top right axes clones of bottom left axes: customPlot->axisRect()->setupFullAxesBox(); } void MainWindow::setupLineStyleDemo(QCustomPlot *customPlot) { demoName = "Line Style Demo"; customPlot->legend->setVisible(true); customPlot->legend->setFont(QFont("Helvetica", 9)); QPen pen; QStringList lineNames; lineNames << "lsNone" << "lsLine" << "lsStepLeft" << "lsStepRight" << "lsStepCenter" << "lsImpulse"; // add graphs with different line styles: for (int i=QCPGraph::lsNone; i<=QCPGraph::lsImpulse; ++i) { customPlot->addGraph(); pen.setColor(QColor(qSin(i*1+1.2)*80+80, qSin(i*0.3+0)*80+80, qSin(i*0.3+1.5)*80+80)); customPlot->graph()->setPen(pen); customPlot->graph()->setName(lineNames.at(i-QCPGraph::lsNone)); customPlot->graph()->setLineStyle((QCPGraph::LineStyle)i); customPlot->graph()->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, 5)); // generate data: QVector x(15), y(15); for (int j=0; j<15; ++j) { x[j] = j/15.0 * 5*3.14 + 0.01; y[j] = 7*qSin(x[j])/x[j] - (i-QCPGraph::lsNone)*5 + (QCPGraph::lsImpulse)*5 + 2; } customPlot->graph()->setData(x, y); customPlot->graph()->rescaleAxes(true); } // zoom out a bit: customPlot->yAxis->scaleRange(1.1, customPlot->yAxis->range().center()); customPlot->xAxis->scaleRange(1.1, customPlot->xAxis->range().center()); // set blank axis lines: customPlot->xAxis->setTicks(false); customPlot->yAxis->setTicks(true); customPlot->xAxis->setTickLabels(false); customPlot->yAxis->setTickLabels(true); // make top right axes clones of bottom left axes: customPlot->axisRect()->setupFullAxesBox(); } void MainWindow::setupScatterPixmapDemo(QCustomPlot *customPlot) { demoName = "Scatter Pixmap Demo"; customPlot->axisRect()->setBackground(QPixmap("./solarpanels.jpg")); customPlot->addGraph(); customPlot->graph()->setLineStyle(QCPGraph::lsLine); QPen pen; pen.setColor(QColor(255, 200, 20, 200)); pen.setStyle(Qt::DashLine); pen.setWidthF(2.5); customPlot->graph()->setPen(pen); customPlot->graph()->setBrush(QBrush(QColor(255,200,20,70))); customPlot->graph()->setScatterStyle(QCPScatterStyle(QPixmap("./sun.png"))); // set graph name, will show up in legend next to icon: customPlot->graph()->setName("Data from Photovoltaic\nenergy barometer 2011"); // set data: QVector year, value; year << 2005 << 2006 << 2007 << 2008 << 2009 << 2010 << 2011; value << 2.17 << 3.42 << 4.94 << 10.38 << 15.86 << 29.33 << 52.1; customPlot->graph()->setData(year, value); // set title of plot: customPlot->plotLayout()->insertRow(0); customPlot->plotLayout()->addElement(0, 0, new QCPTextElement(customPlot, "Regenerative Energies", QFont("sans", 12, QFont::Bold))); // axis configurations: customPlot->xAxis->setLabel("Year"); customPlot->yAxis->setLabel("Installed Gigawatts of\nphotovoltaic in the European Union"); customPlot->xAxis2->setVisible(true); customPlot->yAxis2->setVisible(true); customPlot->xAxis2->setTickLabels(false); customPlot->yAxis2->setTickLabels(false); customPlot->xAxis2->setTicks(false); customPlot->yAxis2->setTicks(false); customPlot->xAxis2->setSubTicks(false); customPlot->yAxis2->setSubTicks(false); customPlot->xAxis->setRange(2004.5, 2011.5); customPlot->yAxis->setRange(0, 52); // setup legend: customPlot->legend->setFont(QFont(font().family(), 7)); customPlot->legend->setIconSize(50, 20); customPlot->legend->setVisible(true); customPlot->axisRect()->insetLayout()->setInsetAlignment(0, Qt::AlignLeft | Qt::AlignTop); } void MainWindow::setupDateDemo(QCustomPlot *customPlot) { demoName = "Date Demo"; // set locale to english, so we get english month names: customPlot->setLocale(QLocale(QLocale::English, QLocale::UnitedKingdom)); // seconds of current time, we'll use it as starting point in time for data: double now = QDateTime::currentDateTime().toMSecsSinceEpoch()/1000.0; srand(8); // set the random seed, so we always get the same random data // create multiple graphs: for (int gi=0; gi<5; ++gi) { customPlot->addGraph(); QColor color(20+200/4.0*gi,70*(1.6-gi/4.0), 150, 150); customPlot->graph()->setLineStyle(QCPGraph::lsLine); customPlot->graph()->setPen(QPen(color.lighter(200))); customPlot->graph()->setBrush(QBrush(color)); // generate random walk data: QVector timeData(250); for (int i=0; i<250; ++i) { timeData[i].key = now + 24*3600*i; if (i == 0) timeData[i].value = (i/50.0+1)*(rand()/(double)RAND_MAX-0.5); else timeData[i].value = qFabs(timeData[i-1].value)*(1+0.02/4.0*(4-gi)) + (i/50.0+1)*(rand()/(double)RAND_MAX-0.5); } customPlot->graph()->data()->set(timeData); } // configure bottom axis to show date instead of number: QSharedPointer dateTicker(new QCPAxisTickerDateTime); dateTicker->setDateTimeFormat("d. MMMM\nyyyy"); customPlot->xAxis->setTicker(dateTicker); // configure left axis text labels: QSharedPointer textTicker(new QCPAxisTickerText); textTicker->addTick(10, "a bit\nlow"); textTicker->addTick(50, "quite\nhigh"); customPlot->yAxis->setTicker(textTicker); // set a more compact font size for bottom and left axis tick labels: customPlot->xAxis->setTickLabelFont(QFont(QFont().family(), 8)); customPlot->yAxis->setTickLabelFont(QFont(QFont().family(), 8)); // set axis labels: customPlot->xAxis->setLabel("Date"); customPlot->yAxis->setLabel("Random wobbly lines value"); // make top and right axes visible but without ticks and labels: customPlot->xAxis2->setVisible(true); customPlot->yAxis2->setVisible(true); customPlot->xAxis2->setTicks(false); customPlot->yAxis2->setTicks(false); customPlot->xAxis2->setTickLabels(false); customPlot->yAxis2->setTickLabels(false); // set axis ranges to show all data: customPlot->xAxis->setRange(now, now+24*3600*249); customPlot->yAxis->setRange(0, 60); // show legend with slightly transparent background brush: customPlot->legend->setVisible(true); customPlot->legend->setBrush(QColor(255, 255, 255, 150)); } void MainWindow::setupTextureBrushDemo(QCustomPlot *customPlot) { demoName = "Texture Brush Demo"; // add two graphs with a textured fill: customPlot->addGraph(); QPen redDotPen; redDotPen.setStyle(Qt::DotLine); redDotPen.setColor(QColor(170, 100, 100, 180)); redDotPen.setWidthF(2); customPlot->graph(0)->setPen(redDotPen); customPlot->graph(0)->setBrush(QBrush(QPixmap("./balboa.jpg"))); // fill with texture of specified image customPlot->addGraph(); customPlot->graph(1)->setPen(QPen(Qt::red)); // activate channel fill for graph 0 towards graph 1: customPlot->graph(0)->setChannelFillGraph(customPlot->graph(1)); // generate data: QVector x(250); QVector y0(250), y1(250); for (int i=0; i<250; ++i) { // just playing with numbers, not much to learn here x[i] = 3*i/250.0; y0[i] = 1+qExp(-x[i]*x[i]*0.8)*(x[i]*x[i]+x[i]); y1[i] = 1-qExp(-x[i]*x[i]*0.4)*(x[i]*x[i])*0.1; } // pass data points to graphs: customPlot->graph(0)->setData(x, y0); customPlot->graph(1)->setData(x, y1); // activate top and right axes, which are invisible by default: customPlot->xAxis2->setVisible(true); customPlot->yAxis2->setVisible(true); // make tick labels invisible on top and right axis: customPlot->xAxis2->setTickLabels(false); customPlot->yAxis2->setTickLabels(false); // set ranges: customPlot->xAxis->setRange(0, 2.5); customPlot->yAxis->setRange(0.9, 1.6); // assign top/right axes same properties as bottom/left: customPlot->axisRect()->setupFullAxesBox(); } void MainWindow::setupMultiAxisDemo(QCustomPlot *customPlot) { customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); demoName = "Multi Axis Demo"; customPlot->setLocale(QLocale(QLocale::English, QLocale::UnitedKingdom)); // period as decimal separator and comma as thousand separator customPlot->legend->setVisible(true); QFont legendFont = font(); // start out with MainWindow's font.. legendFont.setPointSize(9); // and make a bit smaller for legend customPlot->legend->setFont(legendFont); customPlot->legend->setBrush(QBrush(QColor(255,255,255,230))); // by default, the legend is in the inset layout of the main axis rect. So this is how we access it to change legend placement: customPlot->axisRect()->insetLayout()->setInsetAlignment(0, Qt::AlignBottom|Qt::AlignRight); // setup for graph 0: key axis left, value axis bottom // will contain left maxwell-like function customPlot->addGraph(customPlot->yAxis, customPlot->xAxis); customPlot->graph(0)->setPen(QPen(QColor(255, 100, 0))); customPlot->graph(0)->setBrush(QBrush(QPixmap("./balboa.jpg"))); // fill with texture of specified image customPlot->graph(0)->setLineStyle(QCPGraph::lsLine); customPlot->graph(0)->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssDisc, 5)); customPlot->graph(0)->setName("Left maxwell function"); // setup for graph 1: key axis bottom, value axis left (those are the default axes) // will contain bottom maxwell-like function with error bars customPlot->addGraph(); customPlot->graph(1)->setPen(QPen(Qt::red)); customPlot->graph(1)->setBrush(QBrush(QPixmap("./balboa.jpg"))); // same fill as we used for graph 0 customPlot->graph(1)->setLineStyle(QCPGraph::lsStepCenter); customPlot->graph(1)->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, Qt::red, Qt::white, 7)); customPlot->graph(1)->setName("Bottom maxwell function"); QCPErrorBars *errorBars = new QCPErrorBars(customPlot->xAxis, customPlot->yAxis); errorBars->removeFromLegend(); errorBars->setDataPlottable(customPlot->graph(1)); // setup for graph 2: key axis top, value axis right // will contain high frequency sine with low frequency beating: customPlot->addGraph(customPlot->xAxis2, customPlot->yAxis2); customPlot->graph(2)->setPen(QPen(Qt::blue)); customPlot->graph(2)->setName("High frequency sine"); // setup for graph 3: same axes as graph 2 // will contain low frequency beating envelope of graph 2 customPlot->addGraph(customPlot->xAxis2, customPlot->yAxis2); QPen blueDotPen; blueDotPen.setColor(QColor(30, 40, 255, 150)); blueDotPen.setStyle(Qt::DotLine); blueDotPen.setWidthF(4); customPlot->graph(3)->setPen(blueDotPen); customPlot->graph(3)->setName("Sine envelope"); // setup for graph 4: key axis right, value axis top // will contain parabolically distributed data points with some random perturbance customPlot->addGraph(customPlot->yAxis2, customPlot->xAxis2); customPlot->graph(4)->setPen(QColor(50, 50, 50, 255)); customPlot->graph(4)->setLineStyle(QCPGraph::lsNone); customPlot->graph(4)->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, 4)); customPlot->graph(4)->setName("Some random data around\na quadratic function"); // generate data, just playing with numbers, not much to learn here: QVector x0(25), y0(25); QVector x1(15), y1(15), y1err(15); QVector x2(250), y2(250); QVector x3(250), y3(250); QVector x4(250), y4(250); for (int i=0; i<25; ++i) // data for graph 0 { x0[i] = 3*i/25.0; y0[i] = qExp(-x0[i]*x0[i]*0.8)*(x0[i]*x0[i]+x0[i]); } for (int i=0; i<15; ++i) // data for graph 1 { x1[i] = 3*i/15.0;; y1[i] = qExp(-x1[i]*x1[i])*(x1[i]*x1[i])*2.6; y1err[i] = y1[i]*0.25; } for (int i=0; i<250; ++i) // data for graphs 2, 3 and 4 { x2[i] = i/250.0*3*M_PI; x3[i] = x2[i]; x4[i] = i/250.0*100-50; y2[i] = qSin(x2[i]*12)*qCos(x2[i])*10; y3[i] = qCos(x3[i])*10; y4[i] = 0.01*x4[i]*x4[i] + 1.5*(rand()/(double)RAND_MAX-0.5) + 1.5*M_PI; } // pass data points to graphs: customPlot->graph(0)->setData(x0, y0); customPlot->graph(1)->setData(x1, y1); errorBars->setData(y1err); customPlot->graph(2)->setData(x2, y2); customPlot->graph(3)->setData(x3, y3); customPlot->graph(4)->setData(x4, y4); // activate top and right axes, which are invisible by default: customPlot->xAxis2->setVisible(true); customPlot->yAxis2->setVisible(true); // set ranges appropriate to show data: customPlot->xAxis->setRange(0, 2.7); customPlot->yAxis->setRange(0, 2.6); customPlot->xAxis2->setRange(0, 3.0*M_PI); customPlot->yAxis2->setRange(-70, 35); // set pi ticks on top axis: customPlot->xAxis2->setTicker(QSharedPointer(new QCPAxisTickerPi)); // add title layout element: customPlot->plotLayout()->insertRow(0); customPlot->plotLayout()->addElement(0, 0, new QCPTextElement(customPlot, "Way too many graphs in one plot", QFont("sans", 12, QFont::Bold))); // set labels: customPlot->xAxis->setLabel("Bottom axis with outward ticks"); customPlot->yAxis->setLabel("Left axis label"); customPlot->xAxis2->setLabel("Top axis label"); customPlot->yAxis2->setLabel("Right axis label"); // make ticks on bottom axis go outward: customPlot->xAxis->setTickLength(0, 5); customPlot->xAxis->setSubTickLength(0, 3); // make ticks on right axis go inward and outward: customPlot->yAxis2->setTickLength(3, 3); customPlot->yAxis2->setSubTickLength(1, 1); } void MainWindow::setupLogarithmicDemo(QCustomPlot *customPlot) { demoName = "Logarithmic Demo"; customPlot->setNoAntialiasingOnDrag(true); // more performance/responsiveness during dragging customPlot->addGraph(); QPen pen; pen.setColor(QColor(255,170,100)); pen.setWidth(2); pen.setStyle(Qt::DotLine); customPlot->graph(0)->setPen(pen); customPlot->graph(0)->setName("x"); customPlot->addGraph(); customPlot->graph(1)->setPen(QPen(Qt::red)); customPlot->graph(1)->setBrush(QBrush(QColor(255, 0, 0, 20))); customPlot->graph(1)->setName("-sin(x)exp(x)"); customPlot->addGraph(); customPlot->graph(2)->setPen(QPen(Qt::blue)); customPlot->graph(2)->setBrush(QBrush(QColor(0, 0, 255, 20))); customPlot->graph(2)->setName(" sin(x)exp(x)"); customPlot->addGraph(); pen.setColor(QColor(0,0,0)); pen.setWidth(1); pen.setStyle(Qt::DashLine); customPlot->graph(3)->setPen(pen); customPlot->graph(3)->setBrush(QBrush(QColor(0,0,0,15))); customPlot->graph(3)->setLineStyle(QCPGraph::lsStepCenter); customPlot->graph(3)->setName("x!"); const int dataCount = 200; const int dataFactorialCount = 21; QVector dataLinear(dataCount), dataMinusSinExp(dataCount), dataPlusSinExp(dataCount), dataFactorial(dataFactorialCount); for (int i=0; igraph(0)->data()->set(dataLinear); customPlot->graph(1)->data()->set(dataMinusSinExp); customPlot->graph(2)->data()->set(dataPlusSinExp); customPlot->graph(3)->data()->set(dataFactorial); customPlot->yAxis->grid()->setSubGridVisible(true); customPlot->xAxis->grid()->setSubGridVisible(true); customPlot->yAxis->setScaleType(QCPAxis::stLogarithmic); customPlot->yAxis2->setScaleType(QCPAxis::stLogarithmic); QSharedPointer logTicker(new QCPAxisTickerLog); customPlot->yAxis->setTicker(logTicker); customPlot->yAxis2->setTicker(logTicker); customPlot->yAxis->setNumberFormat("eb"); // e = exponential, b = beautiful decimal powers customPlot->yAxis->setNumberPrecision(0); // makes sure "1*10^4" is displayed only as "10^4" customPlot->xAxis->setRange(0, 19.9); customPlot->yAxis->setRange(1e-2, 1e10); // make range draggable and zoomable: customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); // make top right axes clones of bottom left axes: customPlot->axisRect()->setupFullAxesBox(); // connect signals so top and right axes move in sync with bottom and left axes: connect(customPlot->xAxis, SIGNAL(rangeChanged(QCPRange)), customPlot->xAxis2, SLOT(setRange(QCPRange))); connect(customPlot->yAxis, SIGNAL(rangeChanged(QCPRange)), customPlot->yAxis2, SLOT(setRange(QCPRange))); customPlot->legend->setVisible(true); customPlot->legend->setBrush(QBrush(QColor(255,255,255,150))); customPlot->axisRect()->insetLayout()->setInsetAlignment(0, Qt::AlignLeft|Qt::AlignTop); // make legend align in top left corner or axis rect } void MainWindow::setupRealtimeDataDemo(QCustomPlot *customPlot) { demoName = "Real Time Data Demo"; // include this section to fully disable antialiasing for higher performance: /* customPlot->setNotAntialiasedElements(QCP::aeAll); QFont font; font.setStyleStrategy(QFont::NoAntialias); customPlot->xAxis->setTickLabelFont(font); customPlot->yAxis->setTickLabelFont(font); customPlot->legend->setFont(font); */ customPlot->addGraph(); // blue line customPlot->graph(0)->setPen(QPen(QColor(40, 110, 255))); customPlot->addGraph(); // red line customPlot->graph(1)->setPen(QPen(QColor(255, 110, 40))); QSharedPointer timeTicker(new QCPAxisTickerTime); timeTicker->setTimeFormat("%h:%m:%s"); customPlot->xAxis->setTicker(timeTicker); customPlot->axisRect()->setupFullAxesBox(); customPlot->yAxis->setRange(-1.2, 1.2); // make left and bottom axes transfer their ranges to right and top axes: connect(customPlot->xAxis, SIGNAL(rangeChanged(QCPRange)), customPlot->xAxis2, SLOT(setRange(QCPRange))); connect(customPlot->yAxis, SIGNAL(rangeChanged(QCPRange)), customPlot->yAxis2, SLOT(setRange(QCPRange))); // setup a timer that repeatedly calls MainWindow::realtimeDataSlot: connect(&dataTimer, SIGNAL(timeout()), this, SLOT(realtimeDataSlot())); dataTimer.start(0); // Interval 0 means to refresh as fast as possible } void MainWindow::setupParametricCurveDemo(QCustomPlot *customPlot) { demoName = "Parametric Curves Demo"; // create empty curve objects: QCPCurve *fermatSpiral1 = new QCPCurve(customPlot->xAxis, customPlot->yAxis); QCPCurve *fermatSpiral2 = new QCPCurve(customPlot->xAxis, customPlot->yAxis); QCPCurve *deltoidRadial = new QCPCurve(customPlot->xAxis, customPlot->yAxis); // generate the curve data points: const int pointCount = 500; QVector dataSpiral1(pointCount), dataSpiral2(pointCount), dataDeltoid(pointCount); for (int i=0; idata()->set(dataSpiral1, true); fermatSpiral2->data()->set(dataSpiral2, true); deltoidRadial->data()->set(dataDeltoid, true); // color the curves: fermatSpiral1->setPen(QPen(Qt::blue)); fermatSpiral1->setBrush(QBrush(QColor(0, 0, 255, 20))); fermatSpiral2->setPen(QPen(QColor(255, 120, 0))); fermatSpiral2->setBrush(QBrush(QColor(255, 120, 0, 30))); QRadialGradient radialGrad(QPointF(310, 180), 200); radialGrad.setColorAt(0, QColor(170, 20, 240, 100)); radialGrad.setColorAt(0.5, QColor(20, 10, 255, 40)); radialGrad.setColorAt(1,QColor(120, 20, 240, 10)); deltoidRadial->setPen(QPen(QColor(170, 20, 240))); deltoidRadial->setBrush(QBrush(radialGrad)); // set some basic customPlot config: customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom | QCP::iSelectPlottables); customPlot->axisRect()->setupFullAxesBox(); customPlot->rescaleAxes(); } void MainWindow::setupBarChartDemo(QCustomPlot *customPlot) { demoName = "Bar Chart Demo"; // set dark background gradient: QLinearGradient gradient(0, 0, 0, 400); gradient.setColorAt(0, QColor(90, 90, 90)); gradient.setColorAt(0.38, QColor(105, 105, 105)); gradient.setColorAt(1, QColor(70, 70, 70)); customPlot->setBackground(QBrush(gradient)); // create empty bar chart objects: QCPBars *regen = new QCPBars(customPlot->xAxis, customPlot->yAxis); QCPBars *nuclear = new QCPBars(customPlot->xAxis, customPlot->yAxis); QCPBars *fossil = new QCPBars(customPlot->xAxis, customPlot->yAxis); regen->setAntialiased(false); // gives more crisp, pixel aligned bar borders nuclear->setAntialiased(false); fossil->setAntialiased(false); regen->setStackingGap(1); nuclear->setStackingGap(1); fossil->setStackingGap(1); // set names and colors: fossil->setName("Fossil fuels"); fossil->setPen(QPen(QColor(111, 9, 176).lighter(170))); fossil->setBrush(QColor(111, 9, 176)); nuclear->setName("Nuclear"); nuclear->setPen(QPen(QColor(250, 170, 20).lighter(150))); nuclear->setBrush(QColor(250, 170, 20)); regen->setName("Regenerative"); regen->setPen(QPen(QColor(0, 168, 140).lighter(130))); regen->setBrush(QColor(0, 168, 140)); // stack bars on top of each other: nuclear->moveAbove(fossil); regen->moveAbove(nuclear); // prepare x axis with country labels: QVector ticks; QVector labels; ticks << 1 << 2 << 3 << 4 << 5 << 6 << 7; labels << "USA" << "Japan" << "Germany" << "France" << "UK" << "Italy" << "Canada"; QSharedPointer textTicker(new QCPAxisTickerText); textTicker->addTicks(ticks, labels); customPlot->xAxis->setTicker(textTicker); customPlot->xAxis->setTickLabelRotation(60); customPlot->xAxis->setSubTicks(false); customPlot->xAxis->setTickLength(0, 4); customPlot->xAxis->setRange(0, 8); customPlot->xAxis->setBasePen(QPen(Qt::white)); customPlot->xAxis->setTickPen(QPen(Qt::white)); customPlot->xAxis->grid()->setVisible(true); customPlot->xAxis->grid()->setPen(QPen(QColor(130, 130, 130), 0, Qt::DotLine)); customPlot->xAxis->setTickLabelColor(Qt::white); customPlot->xAxis->setLabelColor(Qt::white); // prepare y axis: customPlot->yAxis->setRange(0, 12.1); customPlot->yAxis->setPadding(5); // a bit more space to the left border customPlot->yAxis->setLabel("Power Consumption in\nKilowatts per Capita (2007)"); customPlot->yAxis->setBasePen(QPen(Qt::white)); customPlot->yAxis->setTickPen(QPen(Qt::white)); customPlot->yAxis->setSubTickPen(QPen(Qt::white)); customPlot->yAxis->grid()->setSubGridVisible(true); customPlot->yAxis->setTickLabelColor(Qt::white); customPlot->yAxis->setLabelColor(Qt::white); customPlot->yAxis->grid()->setPen(QPen(QColor(130, 130, 130), 0, Qt::SolidLine)); customPlot->yAxis->grid()->setSubGridPen(QPen(QColor(130, 130, 130), 0, Qt::DotLine)); // Add data: QVector fossilData, nuclearData, regenData; fossilData << 0.86*10.5 << 0.83*5.5 << 0.84*5.5 << 0.52*5.8 << 0.89*5.2 << 0.90*4.2 << 0.67*11.2; nuclearData << 0.08*10.5 << 0.12*5.5 << 0.12*5.5 << 0.40*5.8 << 0.09*5.2 << 0.00*4.2 << 0.07*11.2; regenData << 0.06*10.5 << 0.05*5.5 << 0.04*5.5 << 0.06*5.8 << 0.02*5.2 << 0.07*4.2 << 0.25*11.2; fossil->setData(ticks, fossilData); nuclear->setData(ticks, nuclearData); regen->setData(ticks, regenData); // setup legend: customPlot->legend->setVisible(true); customPlot->axisRect()->insetLayout()->setInsetAlignment(0, Qt::AlignTop|Qt::AlignHCenter); customPlot->legend->setBrush(QColor(255, 255, 255, 100)); customPlot->legend->setBorderPen(Qt::NoPen); QFont legendFont = font(); legendFont.setPointSize(10); customPlot->legend->setFont(legendFont); customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); } void MainWindow::setupStatisticalDemo(QCustomPlot *customPlot) { demoName = "Statistical Demo"; QCPStatisticalBox *statistical = new QCPStatisticalBox(customPlot->xAxis, customPlot->yAxis); QBrush boxBrush(QColor(60, 60, 255, 100)); boxBrush.setStyle(Qt::Dense6Pattern); // make it look oldschool statistical->setBrush(boxBrush); // specify data: statistical->addData(1, 1.1, 1.9, 2.25, 2.7, 4.2); statistical->addData(2, 0.8, 1.6, 2.2, 3.2, 4.9, QVector() << 0.7 << 0.34 << 0.45 << 6.2 << 5.84); // provide some outliers as QVector statistical->addData(3, 0.2, 0.7, 1.1, 1.6, 2.9); // prepare manual x axis labels: customPlot->xAxis->setSubTicks(false); customPlot->xAxis->setTickLength(0, 4); customPlot->xAxis->setTickLabelRotation(20); QSharedPointer textTicker(new QCPAxisTickerText); textTicker->addTick(1, "Sample 1"); textTicker->addTick(2, "Sample 2"); textTicker->addTick(3, "Control Group"); customPlot->xAxis->setTicker(textTicker); // prepare axes: customPlot->yAxis->setLabel(QString::fromUtf8("Oâ‚‚ Absorption [mg]")); customPlot->rescaleAxes(); customPlot->xAxis->scaleRange(1.7, customPlot->xAxis->range().center()); customPlot->yAxis->setRange(0, 7); customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); } void MainWindow::setupSimpleItemDemo(QCustomPlot *customPlot) { demoName = "Simple Item Demo"; customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); // add the text label at the top: QCPItemText *textLabel = new QCPItemText(customPlot); textLabel->setPositionAlignment(Qt::AlignTop|Qt::AlignHCenter); textLabel->position->setType(QCPItemPosition::ptAxisRectRatio); textLabel->position->setCoords(0.5, 0); // place position at center/top of axis rect textLabel->setText("Text Item Demo"); textLabel->setFont(QFont(font().family(), 16)); // make font a bit larger textLabel->setPen(QPen(Qt::black)); // show black border around text // add the arrow: QCPItemLine *arrow = new QCPItemLine(customPlot); arrow->start->setParentAnchor(textLabel->bottom); arrow->end->setCoords(4, 1.6); // point to (4, 1.6) in x-y-plot coordinates arrow->setHead(QCPLineEnding::esSpikeArrow); } void MainWindow::setupItemDemo(QCustomPlot *customPlot) { demoName = "Item Demo"; customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); QCPGraph *graph = customPlot->addGraph(); int n = 500; double phase = 0; double k = 3; QVector x(n), y(n); for (int i=0; isetData(x, y); graph->setPen(QPen(Qt::blue)); graph->rescaleKeyAxis(); customPlot->yAxis->setRange(-1.45, 1.65); customPlot->xAxis->grid()->setZeroLinePen(Qt::NoPen); // add the bracket at the top: QCPItemBracket *bracket = new QCPItemBracket(customPlot); bracket->left->setCoords(-8, 1.1); bracket->right->setCoords(8, 1.1); bracket->setLength(13); // add the text label at the top: QCPItemText *wavePacketText = new QCPItemText(customPlot); wavePacketText->position->setParentAnchor(bracket->center); wavePacketText->position->setCoords(0, -10); // move 10 pixels to the top from bracket center anchor wavePacketText->setPositionAlignment(Qt::AlignBottom|Qt::AlignHCenter); wavePacketText->setText("Wavepacket"); wavePacketText->setFont(QFont(font().family(), 10)); // add the phase tracer (red circle) which sticks to the graph data (and gets updated in bracketDataSlot by timer event): QCPItemTracer *phaseTracer = new QCPItemTracer(customPlot); itemDemoPhaseTracer = phaseTracer; // so we can access it later in the bracketDataSlot for animation phaseTracer->setGraph(graph); phaseTracer->setGraphKey((M_PI*1.5-phase)/k); phaseTracer->setInterpolating(true); phaseTracer->setStyle(QCPItemTracer::tsCircle); phaseTracer->setPen(QPen(Qt::red)); phaseTracer->setBrush(Qt::red); phaseTracer->setSize(7); // add label for phase tracer: QCPItemText *phaseTracerText = new QCPItemText(customPlot); phaseTracerText->position->setType(QCPItemPosition::ptAxisRectRatio); phaseTracerText->setPositionAlignment(Qt::AlignRight|Qt::AlignBottom); phaseTracerText->position->setCoords(1.0, 0.95); // lower right corner of axis rect phaseTracerText->setText("Points of fixed\nphase define\nphase velocity vp"); phaseTracerText->setTextAlignment(Qt::AlignLeft); phaseTracerText->setFont(QFont(font().family(), 9)); phaseTracerText->setPadding(QMargins(8, 0, 0, 0)); // add arrow pointing at phase tracer, coming from label: QCPItemCurve *phaseTracerArrow = new QCPItemCurve(customPlot); phaseTracerArrow->start->setParentAnchor(phaseTracerText->left); phaseTracerArrow->startDir->setParentAnchor(phaseTracerArrow->start); phaseTracerArrow->startDir->setCoords(-40, 0); // direction 30 pixels to the left of parent anchor (tracerArrow->start) phaseTracerArrow->end->setParentAnchor(phaseTracer->position); phaseTracerArrow->end->setCoords(10, 10); phaseTracerArrow->endDir->setParentAnchor(phaseTracerArrow->end); phaseTracerArrow->endDir->setCoords(30, 30); phaseTracerArrow->setHead(QCPLineEnding::esSpikeArrow); phaseTracerArrow->setTail(QCPLineEnding(QCPLineEnding::esBar, (phaseTracerText->bottom->pixelPosition().y()-phaseTracerText->top->pixelPosition().y())*0.85)); // add the group velocity tracer (green circle): QCPItemTracer *groupTracer = new QCPItemTracer(customPlot); groupTracer->setGraph(graph); groupTracer->setGraphKey(5.5); groupTracer->setInterpolating(true); groupTracer->setStyle(QCPItemTracer::tsCircle); groupTracer->setPen(QPen(Qt::green)); groupTracer->setBrush(Qt::green); groupTracer->setSize(7); // add label for group tracer: QCPItemText *groupTracerText = new QCPItemText(customPlot); groupTracerText->position->setType(QCPItemPosition::ptAxisRectRatio); groupTracerText->setPositionAlignment(Qt::AlignRight|Qt::AlignTop); groupTracerText->position->setCoords(1.0, 0.20); // lower right corner of axis rect groupTracerText->setText("Fixed positions in\nwave packet define\ngroup velocity vg"); groupTracerText->setTextAlignment(Qt::AlignLeft); groupTracerText->setFont(QFont(font().family(), 9)); groupTracerText->setPadding(QMargins(8, 0, 0, 0)); // add arrow pointing at group tracer, coming from label: QCPItemCurve *groupTracerArrow = new QCPItemCurve(customPlot); groupTracerArrow->start->setParentAnchor(groupTracerText->left); groupTracerArrow->startDir->setParentAnchor(groupTracerArrow->start); groupTracerArrow->startDir->setCoords(-40, 0); // direction 30 pixels to the left of parent anchor (tracerArrow->start) groupTracerArrow->end->setCoords(5.5, 0.4); groupTracerArrow->endDir->setParentAnchor(groupTracerArrow->end); groupTracerArrow->endDir->setCoords(0, -40); groupTracerArrow->setHead(QCPLineEnding::esSpikeArrow); groupTracerArrow->setTail(QCPLineEnding(QCPLineEnding::esBar, (groupTracerText->bottom->pixelPosition().y()-groupTracerText->top->pixelPosition().y())*0.85)); // add dispersion arrow: QCPItemCurve *arrow = new QCPItemCurve(customPlot); arrow->start->setCoords(1, -1.1); arrow->startDir->setCoords(-1, -1.3); arrow->endDir->setCoords(-5, -0.3); arrow->end->setCoords(-10, -0.2); arrow->setHead(QCPLineEnding::esSpikeArrow); // add the dispersion arrow label: QCPItemText *dispersionText = new QCPItemText(customPlot); dispersionText->position->setCoords(-6, -0.9); dispersionText->setRotation(40); dispersionText->setText("Dispersion with\nvp < vg"); dispersionText->setFont(QFont(font().family(), 10)); // setup a timer that repeatedly calls MainWindow::bracketDataSlot: connect(&dataTimer, SIGNAL(timeout()), this, SLOT(bracketDataSlot())); dataTimer.start(0); // Interval 0 means to refresh as fast as possible } void MainWindow::setupStyledDemo(QCustomPlot *customPlot) { demoName = "Styled Demo"; // prepare data: QVector x1(20), y1(20); QVector x2(100), y2(100); QVector x3(20), y3(20); QVector x4(20), y4(20); for (int i=0; iaddGraph(); graph1->setData(x1, y1); graph1->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, QPen(Qt::black, 1.5), QBrush(Qt::white), 9)); graph1->setPen(QPen(QColor(120, 120, 120), 2)); QCPGraph *graph2 = customPlot->addGraph(); graph2->setData(x2, y2); graph2->setPen(Qt::NoPen); graph2->setBrush(QColor(200, 200, 200, 20)); graph2->setChannelFillGraph(graph1); QCPBars *bars1 = new QCPBars(customPlot->xAxis, customPlot->yAxis); bars1->setWidth(9/(double)x3.size()); bars1->setData(x3, y3); bars1->setPen(Qt::NoPen); bars1->setBrush(QColor(10, 140, 70, 160)); QCPBars *bars2 = new QCPBars(customPlot->xAxis, customPlot->yAxis); bars2->setWidth(9/(double)x4.size()); bars2->setData(x4, y4); bars2->setPen(Qt::NoPen); bars2->setBrush(QColor(10, 100, 50, 70)); bars2->moveAbove(bars1); // move bars above graphs and grid below bars: customPlot->addLayer("abovemain", customPlot->layer("main"), QCustomPlot::limAbove); customPlot->addLayer("belowmain", customPlot->layer("main"), QCustomPlot::limBelow); graph1->setLayer("abovemain"); customPlot->xAxis->grid()->setLayer("belowmain"); customPlot->yAxis->grid()->setLayer("belowmain"); // set some pens, brushes and backgrounds: customPlot->xAxis->setBasePen(QPen(Qt::white, 1)); customPlot->yAxis->setBasePen(QPen(Qt::white, 1)); customPlot->xAxis->setTickPen(QPen(Qt::white, 1)); customPlot->yAxis->setTickPen(QPen(Qt::white, 1)); customPlot->xAxis->setSubTickPen(QPen(Qt::white, 1)); customPlot->yAxis->setSubTickPen(QPen(Qt::white, 1)); customPlot->xAxis->setTickLabelColor(Qt::white); customPlot->yAxis->setTickLabelColor(Qt::white); customPlot->xAxis->grid()->setPen(QPen(QColor(140, 140, 140), 1, Qt::DotLine)); customPlot->yAxis->grid()->setPen(QPen(QColor(140, 140, 140), 1, Qt::DotLine)); customPlot->xAxis->grid()->setSubGridPen(QPen(QColor(80, 80, 80), 1, Qt::DotLine)); customPlot->yAxis->grid()->setSubGridPen(QPen(QColor(80, 80, 80), 1, Qt::DotLine)); customPlot->xAxis->grid()->setSubGridVisible(true); customPlot->yAxis->grid()->setSubGridVisible(true); customPlot->xAxis->grid()->setZeroLinePen(Qt::NoPen); customPlot->yAxis->grid()->setZeroLinePen(Qt::NoPen); customPlot->xAxis->setUpperEnding(QCPLineEnding::esSpikeArrow); customPlot->yAxis->setUpperEnding(QCPLineEnding::esSpikeArrow); QLinearGradient plotGradient; plotGradient.setStart(0, 0); plotGradient.setFinalStop(0, 350); plotGradient.setColorAt(0, QColor(80, 80, 80)); plotGradient.setColorAt(1, QColor(50, 50, 50)); customPlot->setBackground(plotGradient); QLinearGradient axisRectGradient; axisRectGradient.setStart(0, 0); axisRectGradient.setFinalStop(0, 350); axisRectGradient.setColorAt(0, QColor(80, 80, 80)); axisRectGradient.setColorAt(1, QColor(30, 30, 30)); customPlot->axisRect()->setBackground(axisRectGradient); customPlot->rescaleAxes(); customPlot->yAxis->setRange(0, 2); } void MainWindow::setupAdvancedAxesDemo(QCustomPlot *customPlot) { demoName = "Advanced Axes Demo"; // configure axis rect: customPlot->plotLayout()->clear(); // clear default axis rect so we can start from scratch QCPAxisRect *wideAxisRect = new QCPAxisRect(customPlot); wideAxisRect->setupFullAxesBox(true); wideAxisRect->axis(QCPAxis::atRight, 0)->setTickLabels(true); wideAxisRect->addAxis(QCPAxis::atLeft)->setTickLabelColor(QColor("#6050F8")); // add an extra axis on the left and color its numbers QCPLayoutGrid *subLayout = new QCPLayoutGrid; customPlot->plotLayout()->addElement(0, 0, wideAxisRect); // insert axis rect in first row customPlot->plotLayout()->addElement(1, 0, subLayout); // sub layout in second row (grid layout will grow accordingly) //customPlot->plotLayout()->setRowStretchFactor(1, 2); // prepare axis rects that will be placed in the sublayout: QCPAxisRect *subRectLeft = new QCPAxisRect(customPlot, false); // false means to not setup default axes QCPAxisRect *subRectRight = new QCPAxisRect(customPlot, false); subLayout->addElement(0, 0, subRectLeft); subLayout->addElement(0, 1, subRectRight); subRectRight->setMaximumSize(100, 100); // make bottom right axis rect size fixed 100x100 subRectRight->setMinimumSize(100, 100); // make bottom right axis rect size fixed 100x100 // setup axes in sub layout axis rects: subRectLeft->addAxes(QCPAxis::atBottom | QCPAxis::atLeft); subRectRight->addAxes(QCPAxis::atBottom | QCPAxis::atRight); subRectLeft->axis(QCPAxis::atLeft)->ticker()->setTickCount(2); subRectRight->axis(QCPAxis::atRight)->ticker()->setTickCount(2); subRectRight->axis(QCPAxis::atBottom)->ticker()->setTickCount(2); subRectLeft->axis(QCPAxis::atBottom)->grid()->setVisible(true); // synchronize the left and right margins of the top and bottom axis rects: QCPMarginGroup *marginGroup = new QCPMarginGroup(customPlot); subRectLeft->setMarginGroup(QCP::msLeft, marginGroup); subRectRight->setMarginGroup(QCP::msRight, marginGroup); wideAxisRect->setMarginGroup(QCP::msLeft | QCP::msRight, marginGroup); // move newly created axes on "axes" layer and grids on "grid" layer: foreach (QCPAxisRect *rect, customPlot->axisRects()) { foreach (QCPAxis *axis, rect->axes()) { axis->setLayer("axes"); axis->grid()->setLayer("grid"); } } // prepare data: QVector dataCos(21), dataGauss(50), dataRandom(100); QVector x3, y3; std::srand(3); for (int i=0; iaddGraph(wideAxisRect->axis(QCPAxis::atBottom), wideAxisRect->axis(QCPAxis::atLeft)); mainGraphCos->data()->set(dataCos); mainGraphCos->valueAxis()->setRange(-1, 1); mainGraphCos->rescaleKeyAxis(); mainGraphCos->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, QPen(Qt::black), QBrush(Qt::white), 6)); mainGraphCos->setPen(QPen(QColor(120, 120, 120), 2)); QCPGraph *mainGraphGauss = customPlot->addGraph(wideAxisRect->axis(QCPAxis::atBottom), wideAxisRect->axis(QCPAxis::atLeft, 1)); mainGraphGauss->data()->set(dataGauss); mainGraphGauss->setPen(QPen(QColor("#8070B8"), 2)); mainGraphGauss->setBrush(QColor(110, 170, 110, 30)); mainGraphCos->setChannelFillGraph(mainGraphGauss); mainGraphCos->setBrush(QColor(255, 161, 0, 50)); mainGraphGauss->valueAxis()->setRange(0, 1000); mainGraphGauss->rescaleKeyAxis(); QCPGraph *subGraphRandom = customPlot->addGraph(subRectLeft->axis(QCPAxis::atBottom), subRectLeft->axis(QCPAxis::atLeft)); subGraphRandom->data()->set(dataRandom); subGraphRandom->setLineStyle(QCPGraph::lsImpulse); subGraphRandom->setPen(QPen(QColor("#FFA100"), 1.5)); subGraphRandom->rescaleAxes(); QCPBars *subBars = new QCPBars(subRectRight->axis(QCPAxis::atBottom), subRectRight->axis(QCPAxis::atRight)); subBars->setWidth(3/(double)x3.size()); subBars->setData(x3, y3); subBars->setPen(QPen(Qt::black)); subBars->setAntialiased(false); subBars->setAntialiasedFill(false); subBars->setBrush(QColor("#705BE8")); subBars->keyAxis()->setSubTicks(false); subBars->rescaleAxes(); // setup a ticker for subBars key axis that only gives integer ticks: QSharedPointer intTicker(new QCPAxisTickerFixed); intTicker->setTickStep(1.0); intTicker->setScaleStrategy(QCPAxisTickerFixed::ssMultiples); subBars->keyAxis()->setTicker(intTicker); } void MainWindow::setupColorMapDemo(QCustomPlot *customPlot) { demoName = "Color Map Demo"; // configure axis rect: customPlot->setInteractions(QCP::iRangeDrag|QCP::iRangeZoom); // this will also allow rescaling the color scale by dragging/zooming customPlot->axisRect()->setupFullAxesBox(true); customPlot->xAxis->setLabel("x"); customPlot->yAxis->setLabel("y"); // set up the QCPColorMap: QCPColorMap *colorMap = new QCPColorMap(customPlot->xAxis, customPlot->yAxis); int nx = 200; int ny = 200; colorMap->data()->setSize(nx, ny); // we want the color map to have nx * ny data points colorMap->data()->setRange(QCPRange(-4, 4), QCPRange(-4, 4)); // and span the coordinate range -4..4 in both key (x) and value (y) dimensions // now we assign some data, by accessing the QCPColorMapData instance of the color map: double x, y, z; for (int xIndex=0; xIndexdata()->cellToCoord(xIndex, yIndex, &x, &y); double r = 3*qSqrt(x*x+y*y)+1e-2; z = 2*x*(qCos(r+2)/r-qSin(r+2)/r); // the B field strength of dipole radiation (modulo physical constants) colorMap->data()->setCell(xIndex, yIndex, z); } } // add a color scale: QCPColorScale *colorScale = new QCPColorScale(customPlot); customPlot->plotLayout()->addElement(0, 1, colorScale); // add it to the right of the main axis rect colorScale->setType(QCPAxis::atRight); // scale shall be vertical bar with tick/axis labels right (actually atRight is already the default) colorMap->setColorScale(colorScale); // associate the color map with the color scale colorScale->axis()->setLabel("Magnetic Field Strength"); // set the color gradient of the color map to one of the presets: colorMap->setGradient(QCPColorGradient::gpPolar); // we could have also created a QCPColorGradient instance and added own colors to // the gradient, see the documentation of QCPColorGradient for what's possible. // rescale the data dimension (color) such that all data points lie in the span visualized by the color gradient: colorMap->rescaleDataRange(); // make sure the axis rect and color scale synchronize their bottom and top margins (so they line up): QCPMarginGroup *marginGroup = new QCPMarginGroup(customPlot); customPlot->axisRect()->setMarginGroup(QCP::msBottom|QCP::msTop, marginGroup); colorScale->setMarginGroup(QCP::msBottom|QCP::msTop, marginGroup); // rescale the key (x) and value (y) axes so the whole color map is visible: customPlot->rescaleAxes(); } void MainWindow::setupFinancialDemo(QCustomPlot *customPlot) { demoName = "Financial Charts Demo"; customPlot->legend->setVisible(true); // generate two sets of random walk data (one for candlestick and one for ohlc chart): int n = 500; QVector time(n), value1(n), value2(n); QDateTime start(QDate(2014, 6, 11), QTime(0, 0)); start.setTimeSpec(Qt::UTC); double startTime = start.toMSecsSinceEpoch()/1000.0; double binSize = 3600*24; // bin data in 1 day intervals time[0] = startTime; value1[0] = 60; value2[0] = 20; std::srand(9); for (int i=1; ixAxis, customPlot->yAxis); candlesticks->setName("Candlestick"); candlesticks->setChartStyle(QCPFinancial::csCandlestick); candlesticks->data()->set(QCPFinancial::timeSeriesToOhlc(time, value1, binSize, startTime)); candlesticks->setWidth(binSize*0.9); candlesticks->setTwoColored(true); candlesticks->setBrushPositive(QColor(245, 245, 245)); candlesticks->setBrushNegative(QColor(40, 40, 40)); candlesticks->setPenPositive(QPen(QColor(0, 0, 0))); candlesticks->setPenNegative(QPen(QColor(0, 0, 0))); // create ohlc chart: QCPFinancial *ohlc = new QCPFinancial(customPlot->xAxis, customPlot->yAxis); ohlc->setName("OHLC"); ohlc->setChartStyle(QCPFinancial::csOhlc); ohlc->data()->set(QCPFinancial::timeSeriesToOhlc(time, value2, binSize/3.0, startTime)); // divide binSize by 3 just to make the ohlc bars a bit denser ohlc->setWidth(binSize*0.2); ohlc->setTwoColored(true); // create bottom axis rect for volume bar chart: QCPAxisRect *volumeAxisRect = new QCPAxisRect(customPlot); customPlot->plotLayout()->addElement(1, 0, volumeAxisRect); volumeAxisRect->setMaximumSize(QSize(QWIDGETSIZE_MAX, 100)); volumeAxisRect->axis(QCPAxis::atBottom)->setLayer("axes"); volumeAxisRect->axis(QCPAxis::atBottom)->grid()->setLayer("grid"); // bring bottom and main axis rect closer together: customPlot->plotLayout()->setRowSpacing(0); volumeAxisRect->setAutoMargins(QCP::msLeft|QCP::msRight|QCP::msBottom); volumeAxisRect->setMargins(QMargins(0, 0, 0, 0)); // create two bar plottables, for positive (green) and negative (red) volume bars: customPlot->setAutoAddPlottableToLegend(false); QCPBars *volumePos = new QCPBars(volumeAxisRect->axis(QCPAxis::atBottom), volumeAxisRect->axis(QCPAxis::atLeft)); QCPBars *volumeNeg = new QCPBars(volumeAxisRect->axis(QCPAxis::atBottom), volumeAxisRect->axis(QCPAxis::atLeft)); for (int i=0; iaddData(startTime+3600*5.0*i, qAbs(v)); // add data to either volumeNeg or volumePos, depending on sign of v } volumePos->setWidth(3600*4); volumePos->setPen(Qt::NoPen); volumePos->setBrush(QColor(100, 180, 110)); volumeNeg->setWidth(3600*4); volumeNeg->setPen(Qt::NoPen); volumeNeg->setBrush(QColor(180, 90, 90)); // interconnect x axis ranges of main and bottom axis rects: connect(customPlot->xAxis, SIGNAL(rangeChanged(QCPRange)), volumeAxisRect->axis(QCPAxis::atBottom), SLOT(setRange(QCPRange))); connect(volumeAxisRect->axis(QCPAxis::atBottom), SIGNAL(rangeChanged(QCPRange)), customPlot->xAxis, SLOT(setRange(QCPRange))); // configure axes of both main and bottom axis rect: QSharedPointer dateTimeTicker(new QCPAxisTickerDateTime); dateTimeTicker->setDateTimeSpec(Qt::UTC); dateTimeTicker->setDateTimeFormat("dd. MMMM"); volumeAxisRect->axis(QCPAxis::atBottom)->setTicker(dateTimeTicker); volumeAxisRect->axis(QCPAxis::atBottom)->setTickLabelRotation(15); customPlot->xAxis->setBasePen(Qt::NoPen); customPlot->xAxis->setTickLabels(false); customPlot->xAxis->setTicks(false); // only want vertical grid in main axis rect, so hide xAxis backbone, ticks, and labels customPlot->xAxis->setTicker(dateTimeTicker); customPlot->rescaleAxes(); customPlot->xAxis->scaleRange(1.025, customPlot->xAxis->range().center()); customPlot->yAxis->scaleRange(1.1, customPlot->yAxis->range().center()); // make axis rects' left side line up: QCPMarginGroup *group = new QCPMarginGroup(customPlot); customPlot->axisRect()->setMarginGroup(QCP::msLeft|QCP::msRight, group); volumeAxisRect->setMarginGroup(QCP::msLeft|QCP::msRight, group); } void MainWindow::setupPolarPlotDemo(QCustomPlot *customPlot) { // Warning: Polar plots are a still a tech preview customPlot->plotLayout()->clear(); QCPPolarAxisAngular *angularAxis = new QCPPolarAxisAngular(customPlot); customPlot->plotLayout()->addElement(0, 0, angularAxis); /* This is how we could set the angular axis to show pi symbols instead of degree numbers: QSharedPointer ticker(new QCPAxisTickerPi); ticker->setPiValue(180); ticker->setTickCount(8); polarAxis->setTicker(ticker); */ customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); angularAxis->setRangeDrag(false); angularAxis->setTickLabelMode(QCPPolarAxisAngular::lmUpright); angularAxis->radialAxis()->setTickLabelMode(QCPPolarAxisRadial::lmUpright); angularAxis->radialAxis()->setTickLabelRotation(0); angularAxis->radialAxis()->setAngle(45); angularAxis->grid()->setAngularPen(QPen(QColor(200, 200, 200), 0, Qt::SolidLine)); angularAxis->grid()->setSubGridType(QCPPolarGrid::gtAll); QCPPolarGraph *g1 = new QCPPolarGraph(angularAxis, angularAxis->radialAxis()); QCPPolarGraph *g2 = new QCPPolarGraph(angularAxis, angularAxis->radialAxis()); g2->setPen(QPen(QColor(255, 150, 20))); g2->setBrush(QColor(255, 150, 20, 50)); g1->setScatterStyle(QCPScatterStyle::ssDisc); for (int i=0; i<100; ++i) { g1->addData(i/100.0*360.0, qSin(i/100.0*M_PI*8)*8+1); g2->addData(i/100.0*360.0, qSin(i/100.0*M_PI*6)*2); } angularAxis->setRange(0, 360); angularAxis->radialAxis()->setRange(-10, 10); } void MainWindow::realtimeDataSlot() { static QTime timeStart = QTime::currentTime(); // calculate two new data points: double key = timeStart.msecsTo(QTime::currentTime())/1000.0; // time elapsed since start of demo, in seconds static double lastPointKey = 0; if (key-lastPointKey > 0.002) // at most add point every 2 ms { // add data to lines: ui->customPlot->graph(0)->addData(key, qSin(key)+std::rand()/(double)RAND_MAX*1*qSin(key/0.3843)); ui->customPlot->graph(1)->addData(key, qCos(key)+std::rand()/(double)RAND_MAX*0.5*qSin(key/0.4364)); // rescale value (vertical) axis to fit the current data: //ui->customPlot->graph(0)->rescaleValueAxis(); //ui->customPlot->graph(1)->rescaleValueAxis(true); lastPointKey = key; } // make key axis range scroll with the data (at a constant range size of 8): ui->customPlot->xAxis->setRange(key, 8, Qt::AlignRight); ui->customPlot->replot(); // calculate frames per second: static double lastFpsKey; static int frameCount; ++frameCount; if (key-lastFpsKey > 2) // average fps over 2 seconds { ui->statusBar->showMessage( QString("%1 FPS, Total Data points: %2") .arg(frameCount/(key-lastFpsKey), 0, 'f', 0) .arg(ui->customPlot->graph(0)->data()->size()+ui->customPlot->graph(1)->data()->size()) , 0); lastFpsKey = key; frameCount = 0; } } void MainWindow::bracketDataSlot() { double secs = QCPAxisTickerDateTime::dateTimeToKey(QDateTime::currentDateTime()); // update data to make phase move: int n = 500; double phase = secs*5; double k = 3; QVector x(n), y(n); for (int i=0; icustomPlot->graph()->setData(x, y); itemDemoPhaseTracer->setGraphKey((8*M_PI+fmod(M_PI*1.5-phase, 6*M_PI))/k); ui->customPlot->replot(); // calculate frames per second: double key = secs; static double lastFpsKey; static int frameCount; ++frameCount; if (key-lastFpsKey > 2) // average fps over 2 seconds { ui->statusBar->showMessage( QString("%1 FPS, Total Data points: %2") .arg(frameCount/(key-lastFpsKey), 0, 'f', 0) .arg(ui->customPlot->graph(0)->data()->size()) , 0); lastFpsKey = key; frameCount = 0; } } void MainWindow::setupPlayground(QCustomPlot *customPlot) { Q_UNUSED(customPlot) } MainWindow::~MainWindow() { delete ui; } void MainWindow::screenShot() { #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) QPixmap pm = QPixmap::grabWindow(qApp->desktop()->winId(), this->x()+2, this->y()+2, this->frameGeometry().width()-4, this->frameGeometry().height()-4); #elif QT_VERSION < QT_VERSION_CHECK(5, 5, 0) QPixmap pm = qApp->primaryScreen()->grabWindow(qApp->desktop()->winId(), this->x()+2, this->y()+2, this->frameGeometry().width()-4, this->frameGeometry().height()-4); #elif QT_VERSION < QT_VERSION_CHECK(6, 0, 0) QPixmap pm = qApp->primaryScreen()->grabWindow(qApp->desktop()->winId(), this->x()-7, this->y()-7, this->frameGeometry().width()+14, this->frameGeometry().height()+14); #else QPixmap pm = qApp->primaryScreen()->grabWindow(0, this->x()-7, this->y()-7, this->frameGeometry().width()+14, this->frameGeometry().height()+14); #endif QString fileName = demoName.toLower()+".png"; fileName.replace(" ", ""); pm.save("./screenshots/"+fileName); qApp->quit(); } void MainWindow::allScreenShots() { #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) QPixmap pm = QPixmap::grabWindow(qApp->desktop()->winId(), this->x()+2, this->y()+2, this->frameGeometry().width()-4, this->frameGeometry().height()-4); #elif QT_VERSION < QT_VERSION_CHECK(5, 5, 0) QPixmap pm = qApp->primaryScreen()->grabWindow(qApp->desktop()->winId(), this->x()+2, this->y()+2, this->frameGeometry().width()-4, this->frameGeometry().height()-4); #elif QT_VERSION < QT_VERSION_CHECK(6, 0, 0) QPixmap pm = qApp->primaryScreen()->grabWindow(qApp->desktop()->winId(), this->x()-7, this->y()-7, this->frameGeometry().width()+14, this->frameGeometry().height()+14); #else QPixmap pm = qApp->primaryScreen()->grabWindow(0, this->x()-7, this->y()-7, this->frameGeometry().width()+14, this->frameGeometry().height()+14); #endif QString fileName = demoName.toLower()+".png"; fileName.replace(" ", ""); pm.save("./screenshots/"+fileName); if (currentDemoIndex < 19) { if (dataTimer.isActive()) dataTimer.stop(); dataTimer.disconnect(); delete ui->customPlot; ui->customPlot = new QCustomPlot(ui->centralWidget); ui->verticalLayout->addWidget(ui->customPlot); setupDemo(currentDemoIndex+1); // setup delay for demos that need time to develop proper look: int delay = 250; if (currentDemoIndex == 10) // Next is Realtime data demo delay = 12000; else if (currentDemoIndex == 15) // Next is Item demo delay = 5000; QTimer::singleShot(delay, this, SLOT(allScreenShots())); } else { qApp->quit(); } } qcustomplot-2.1.0+dfsg1/examples/plots/main.cpp0000644000175000017500000000407714030217664021454 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include #include "mainwindow.h" int main(int argc, char *argv[]) { #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) QApplication::setGraphicsSystem("raster"); #endif QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); } qcustomplot-2.1.0+dfsg1/examples/plots/plot-examples.pro0000644000175000017500000000066014030217664023332 0ustar rusconirusconi# # QCustomPlot Plot Examples # QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 TARGET = plot-examples TEMPLATE = app SOURCES += main.cpp\ mainwindow.cpp \ ../../qcustomplot.cpp HEADERS += mainwindow.h \ ../../qcustomplot.h FORMS += mainwindow.ui qcustomplot-2.1.0+dfsg1/examples/plots/mainwindow.h0000644000175000017500000001236314030217664022346 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ /************************************************************************************************************ ** ** ** This is the example code for QCustomPlot. ** ** ** ** It demonstrates basic and some advanced capabilities of the widget. The interesting code is inside ** ** the "setup(...)Demo" functions of MainWindow. ** ** ** ** In order to see a demo in action, call the respective "setup(...)Demo" function inside the ** ** MainWindow constructor. Alternatively you may call setupDemo(i) where i is the index of the demo ** ** you want (for those, see MainWindow constructor comments). All other functions here are merely a ** ** way to easily create screenshots of all demos for the website. I.e. a timer is set to successively ** ** setup all the demos and make a screenshot of the window area and save it in the ./screenshots ** ** directory. ** ** ** *************************************************************************************************************/ #ifndef MAINWINDOW_H #define MAINWINDOW_H #include #include #include "../../qcustomplot.h" // the header file of QCustomPlot. Don't forget to add it to your project, if you use an IDE, so it gets compiled. namespace Ui { class MainWindow; } class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow(); void setupDemo(int demoIndex); void setupQuadraticDemo(QCustomPlot *customPlot); void setupSimpleDemo(QCustomPlot *customPlot); void setupSincScatterDemo(QCustomPlot *customPlot); void setupScatterStyleDemo(QCustomPlot *customPlot); void setupLineStyleDemo(QCustomPlot *customPlot); void setupScatterPixmapDemo(QCustomPlot *customPlot); void setupDateDemo(QCustomPlot *customPlot); void setupTextureBrushDemo(QCustomPlot *customPlot); void setupMultiAxisDemo(QCustomPlot *customPlot); void setupLogarithmicDemo(QCustomPlot *customPlot); void setupRealtimeDataDemo(QCustomPlot *customPlot); void setupParametricCurveDemo(QCustomPlot *customPlot); void setupBarChartDemo(QCustomPlot *customPlot); void setupStatisticalDemo(QCustomPlot *customPlot); void setupSimpleItemDemo(QCustomPlot *customPlot); void setupItemDemo(QCustomPlot *customPlot); void setupStyledDemo(QCustomPlot *customPlot); void setupAdvancedAxesDemo(QCustomPlot *customPlot); void setupColorMapDemo(QCustomPlot *customPlot); void setupFinancialDemo(QCustomPlot *customPlot); void setupPolarPlotDemo(QCustomPlot *customPlot); void setupPlayground(QCustomPlot *customPlot); private slots: void realtimeDataSlot(); void bracketDataSlot(); void screenShot(); void allScreenShots(); private: Ui::MainWindow *ui; QString demoName; QTimer dataTimer; QCPItemTracer *itemDemoPhaseTracer; int currentDemoIndex; }; #endif // MAINWINDOW_H qcustomplot-2.1.0+dfsg1/examples/interactions/0000755000175000017500000000000014030601042021340 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/examples/interactions/mainwindow.ui0000640000175000017500000001006513532027716024071 0ustar rusconirusconi MainWindow 0 0 621 515 QCustomPlot Interaction Example QFrame::StyledPanel QFrame::Sunken 1 0 0 0 0 0 QFrame::StyledPanel QFrame::Raised <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> <html><head><meta name="qrichtext" content="1" /><style type="text/css"> p, li { white-space: pre-wrap; } </style></head><body style=" font-family:'Ubuntu'; font-size:11pt; font-weight:400; font-style:normal;"> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Select the axes</span> to drag and zoom them individually.</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Double click labels</span> or legend items to set user specified strings.</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Left click</span> on graphs or legend to select graphs.</p> <p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-weight:600;">Right click</span> for a popup menu to add/remove graphs and move the legend</p></body></html> 0 0 621 25 QCustomPlot QWidget
../../qcustomplot.h
1 qcustomplot-2.1.0+dfsg1/examples/interactions/mainwindow.cpp0000644000175000017500000002743414030217664024247 0ustar rusconirusconi#include "mainwindow.h" #include "ui_mainwindow.h" MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow) { std::srand(QDateTime::currentDateTime().toMSecsSinceEpoch()/1000.0); ui->setupUi(this); ui->customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom | QCP::iSelectAxes | QCP::iSelectLegend | QCP::iSelectPlottables); ui->customPlot->xAxis->setRange(-8, 8); ui->customPlot->yAxis->setRange(-5, 5); ui->customPlot->axisRect()->setupFullAxesBox(); ui->customPlot->plotLayout()->insertRow(0); QCPTextElement *title = new QCPTextElement(ui->customPlot, "Interaction Example", QFont("sans", 17, QFont::Bold)); ui->customPlot->plotLayout()->addElement(0, 0, title); ui->customPlot->xAxis->setLabel("x Axis"); ui->customPlot->yAxis->setLabel("y Axis"); ui->customPlot->legend->setVisible(true); QFont legendFont = font(); legendFont.setPointSize(10); ui->customPlot->legend->setFont(legendFont); ui->customPlot->legend->setSelectedFont(legendFont); ui->customPlot->legend->setSelectableParts(QCPLegend::spItems); // legend box shall not be selectable, only legend items addRandomGraph(); addRandomGraph(); addRandomGraph(); addRandomGraph(); ui->customPlot->rescaleAxes(); // connect slot that ties some axis selections together (especially opposite axes): connect(ui->customPlot, SIGNAL(selectionChangedByUser()), this, SLOT(selectionChanged())); // connect slots that takes care that when an axis is selected, only that direction can be dragged and zoomed: connect(ui->customPlot, SIGNAL(mousePress(QMouseEvent*)), this, SLOT(mousePress())); connect(ui->customPlot, SIGNAL(mouseWheel(QWheelEvent*)), this, SLOT(mouseWheel())); // make bottom and left axes transfer their ranges to top and right axes: connect(ui->customPlot->xAxis, SIGNAL(rangeChanged(QCPRange)), ui->customPlot->xAxis2, SLOT(setRange(QCPRange))); connect(ui->customPlot->yAxis, SIGNAL(rangeChanged(QCPRange)), ui->customPlot->yAxis2, SLOT(setRange(QCPRange))); // connect some interaction slots: connect(ui->customPlot, SIGNAL(axisDoubleClick(QCPAxis*,QCPAxis::SelectablePart,QMouseEvent*)), this, SLOT(axisLabelDoubleClick(QCPAxis*,QCPAxis::SelectablePart))); connect(ui->customPlot, SIGNAL(legendDoubleClick(QCPLegend*,QCPAbstractLegendItem*,QMouseEvent*)), this, SLOT(legendDoubleClick(QCPLegend*,QCPAbstractLegendItem*))); connect(title, SIGNAL(doubleClicked(QMouseEvent*)), this, SLOT(titleDoubleClick(QMouseEvent*))); // connect slot that shows a message in the status bar when a graph is clicked: connect(ui->customPlot, SIGNAL(plottableClick(QCPAbstractPlottable*,int,QMouseEvent*)), this, SLOT(graphClicked(QCPAbstractPlottable*,int))); // setup policy and connect slot for context menu popup: ui->customPlot->setContextMenuPolicy(Qt::CustomContextMenu); connect(ui->customPlot, SIGNAL(customContextMenuRequested(QPoint)), this, SLOT(contextMenuRequest(QPoint))); } MainWindow::~MainWindow() { delete ui; } void MainWindow::titleDoubleClick(QMouseEvent* event) { Q_UNUSED(event) if (QCPTextElement *title = qobject_cast(sender())) { // Set the plot title by double clicking on it bool ok; QString newTitle = QInputDialog::getText(this, "QCustomPlot example", "New plot title:", QLineEdit::Normal, title->text(), &ok); if (ok) { title->setText(newTitle); ui->customPlot->replot(); } } } void MainWindow::axisLabelDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part) { // Set an axis label by double clicking on it if (part == QCPAxis::spAxisLabel) // only react when the actual axis label is clicked, not tick label or axis backbone { bool ok; QString newLabel = QInputDialog::getText(this, "QCustomPlot example", "New axis label:", QLineEdit::Normal, axis->label(), &ok); if (ok) { axis->setLabel(newLabel); ui->customPlot->replot(); } } } void MainWindow::legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item) { // Rename a graph by double clicking on its legend item Q_UNUSED(legend) if (item) // only react if item was clicked (user could have clicked on border padding of legend where there is no item, then item is 0) { QCPPlottableLegendItem *plItem = qobject_cast(item); bool ok; QString newName = QInputDialog::getText(this, "QCustomPlot example", "New graph name:", QLineEdit::Normal, plItem->plottable()->name(), &ok); if (ok) { plItem->plottable()->setName(newName); ui->customPlot->replot(); } } } void MainWindow::selectionChanged() { /* normally, axis base line, axis tick labels and axis labels are selectable separately, but we want the user only to be able to select the axis as a whole, so we tie the selected states of the tick labels and the axis base line together. However, the axis label shall be selectable individually. The selection state of the left and right axes shall be synchronized as well as the state of the bottom and top axes. Further, we want to synchronize the selection of the graphs with the selection state of the respective legend item belonging to that graph. So the user can select a graph by either clicking on the graph itself or on its legend item. */ // make top and bottom axes be selected synchronously, and handle axis and tick labels as one selectable object: if (ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spTickLabels) || ui->customPlot->xAxis2->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->xAxis2->selectedParts().testFlag(QCPAxis::spTickLabels)) { ui->customPlot->xAxis2->setSelectedParts(QCPAxis::spAxis|QCPAxis::spTickLabels); ui->customPlot->xAxis->setSelectedParts(QCPAxis::spAxis|QCPAxis::spTickLabels); } // make left and right axes be selected synchronously, and handle axis and tick labels as one selectable object: if (ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spTickLabels) || ui->customPlot->yAxis2->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->yAxis2->selectedParts().testFlag(QCPAxis::spTickLabels)) { ui->customPlot->yAxis2->setSelectedParts(QCPAxis::spAxis|QCPAxis::spTickLabels); ui->customPlot->yAxis->setSelectedParts(QCPAxis::spAxis|QCPAxis::spTickLabels); } // synchronize selection of graphs with selection of corresponding legend items: for (int i=0; icustomPlot->graphCount(); ++i) { QCPGraph *graph = ui->customPlot->graph(i); QCPPlottableLegendItem *item = ui->customPlot->legend->itemWithPlottable(graph); if (item->selected() || graph->selected()) { item->setSelected(true); graph->setSelection(QCPDataSelection(graph->data()->dataRange())); } } } void MainWindow::mousePress() { // if an axis is selected, only allow the direction of that axis to be dragged // if no axis is selected, both directions may be dragged if (ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spAxis)) ui->customPlot->axisRect()->setRangeDrag(ui->customPlot->xAxis->orientation()); else if (ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spAxis)) ui->customPlot->axisRect()->setRangeDrag(ui->customPlot->yAxis->orientation()); else ui->customPlot->axisRect()->setRangeDrag(Qt::Horizontal|Qt::Vertical); } void MainWindow::mouseWheel() { // if an axis is selected, only allow the direction of that axis to be zoomed // if no axis is selected, both directions may be zoomed if (ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spAxis)) ui->customPlot->axisRect()->setRangeZoom(ui->customPlot->xAxis->orientation()); else if (ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spAxis)) ui->customPlot->axisRect()->setRangeZoom(ui->customPlot->yAxis->orientation()); else ui->customPlot->axisRect()->setRangeZoom(Qt::Horizontal|Qt::Vertical); } void MainWindow::addRandomGraph() { int n = 50; // number of points in graph double xScale = (std::rand()/(double)RAND_MAX + 0.5)*2; double yScale = (std::rand()/(double)RAND_MAX + 0.5)*2; double xOffset = (std::rand()/(double)RAND_MAX - 0.5)*4; double yOffset = (std::rand()/(double)RAND_MAX - 0.5)*10; double r1 = (std::rand()/(double)RAND_MAX - 0.5)*2; double r2 = (std::rand()/(double)RAND_MAX - 0.5)*2; double r3 = (std::rand()/(double)RAND_MAX - 0.5)*2; double r4 = (std::rand()/(double)RAND_MAX - 0.5)*2; QVector x(n), y(n); for (int i=0; icustomPlot->addGraph(); ui->customPlot->graph()->setName(QString("New graph %1").arg(ui->customPlot->graphCount()-1)); ui->customPlot->graph()->setData(x, y); ui->customPlot->graph()->setLineStyle((QCPGraph::LineStyle)(std::rand()%5+1)); if (std::rand()%100 > 50) ui->customPlot->graph()->setScatterStyle(QCPScatterStyle((QCPScatterStyle::ScatterShape)(std::rand()%14+1))); QPen graphPen; graphPen.setColor(QColor(std::rand()%245+10, std::rand()%245+10, std::rand()%245+10)); graphPen.setWidthF(std::rand()/(double)RAND_MAX*2+1); ui->customPlot->graph()->setPen(graphPen); ui->customPlot->replot(); } void MainWindow::removeSelectedGraph() { if (ui->customPlot->selectedGraphs().size() > 0) { ui->customPlot->removeGraph(ui->customPlot->selectedGraphs().first()); ui->customPlot->replot(); } } void MainWindow::removeAllGraphs() { ui->customPlot->clearGraphs(); ui->customPlot->replot(); } void MainWindow::contextMenuRequest(QPoint pos) { QMenu *menu = new QMenu(this); menu->setAttribute(Qt::WA_DeleteOnClose); if (ui->customPlot->legend->selectTest(pos, false) >= 0) // context menu on legend requested { menu->addAction("Move to top left", this, SLOT(moveLegend()))->setData((int)(Qt::AlignTop|Qt::AlignLeft)); menu->addAction("Move to top center", this, SLOT(moveLegend()))->setData((int)(Qt::AlignTop|Qt::AlignHCenter)); menu->addAction("Move to top right", this, SLOT(moveLegend()))->setData((int)(Qt::AlignTop|Qt::AlignRight)); menu->addAction("Move to bottom right", this, SLOT(moveLegend()))->setData((int)(Qt::AlignBottom|Qt::AlignRight)); menu->addAction("Move to bottom left", this, SLOT(moveLegend()))->setData((int)(Qt::AlignBottom|Qt::AlignLeft)); } else // general context menu on graphs requested { menu->addAction("Add random graph", this, SLOT(addRandomGraph())); if (ui->customPlot->selectedGraphs().size() > 0) menu->addAction("Remove selected graph", this, SLOT(removeSelectedGraph())); if (ui->customPlot->graphCount() > 0) menu->addAction("Remove all graphs", this, SLOT(removeAllGraphs())); } menu->popup(ui->customPlot->mapToGlobal(pos)); } void MainWindow::moveLegend() { if (QAction* contextAction = qobject_cast(sender())) // make sure this slot is really called by a context menu action, so it carries the data we need { bool ok; int dataInt = contextAction->data().toInt(&ok); if (ok) { ui->customPlot->axisRect()->insetLayout()->setInsetAlignment(0, (Qt::Alignment)dataInt); ui->customPlot->replot(); } } } void MainWindow::graphClicked(QCPAbstractPlottable *plottable, int dataIndex) { // since we know we only have QCPGraphs in the plot, we can immediately access interface1D() // usually it's better to first check whether interface1D() returns non-zero, and only then use it. double dataValue = plottable->interface1D()->dataMainValue(dataIndex); QString message = QString("Clicked on graph '%1' at data point #%2 with value %3.").arg(plottable->name()).arg(dataIndex).arg(dataValue); ui->statusBar->showMessage(message, 2500); } qcustomplot-2.1.0+dfsg1/examples/interactions/interaction-example.pro0000644000175000017500000000105714030217664026052 0ustar rusconirusconi#------------------------------------------------- # # Project created by QtCreator 2012-03-04T23:24:55 # #------------------------------------------------- QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 TARGET = interaction-example TEMPLATE = app SOURCES += main.cpp\ mainwindow.cpp \ ../../qcustomplot.cpp HEADERS += mainwindow.h \ ../../qcustomplot.h FORMS += mainwindow.ui qcustomplot-2.1.0+dfsg1/examples/interactions/main.cpp0000640000175000017500000000026113532027716023003 0ustar rusconirusconi#include #include "mainwindow.h" int main(int argc, char *argv[]) { QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); } qcustomplot-2.1.0+dfsg1/examples/interactions/mainwindow.h0000640000175000017500000000154613532027716023707 0ustar rusconirusconi#ifndef MAINWINDOW_H #define MAINWINDOW_H #include #include #include "../../qcustomplot.h" namespace Ui { class MainWindow; } class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow(); private slots: void titleDoubleClick(QMouseEvent *event); void axisLabelDoubleClick(QCPAxis* axis, QCPAxis::SelectablePart part); void legendDoubleClick(QCPLegend* legend, QCPAbstractLegendItem* item); void selectionChanged(); void mousePress(); void mouseWheel(); void addRandomGraph(); void removeSelectedGraph(); void removeAllGraphs(); void contextMenuRequest(QPoint pos); void moveLegend(); void graphClicked(QCPAbstractPlottable *plottable, int dataIndex); private: Ui::MainWindow *ui; }; #endif // MAINWINDOW_H qcustomplot-2.1.0+dfsg1/examples/text-document-integration/0000755000175000017500000000000014030601042023757 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/examples/text-document-integration/qcpdocumentobject.cpp0000644000175000017500000000656314030217664030223 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include "qcpdocumentobject.h" QCPDocumentObject::QCPDocumentObject(QObject *parent) : QObject(parent) { } QSizeF QCPDocumentObject::intrinsicSize(QTextDocument *doc, int posInDocument, const QTextFormat &format) { Q_UNUSED(doc) Q_UNUSED(posInDocument) QPicture pic = qvariant_cast(format.property(PicturePropertyId)); if (pic.isNull()) { qDebug() << Q_FUNC_INFO << "Plot object is empty"; return QSizeF(10, 10); } else return QSizeF(pic.boundingRect().size()); } void QCPDocumentObject::drawObject(QPainter *painter, const QRectF &rect, QTextDocument *doc, int posInDocument, const QTextFormat &format) { Q_UNUSED(doc) Q_UNUSED(posInDocument) QPicture pic = qvariant_cast(format.property(PicturePropertyId)); if (pic.isNull()) return; QSize finalSize = pic.boundingRect().size(); finalSize.scale(rect.size().toSize(), Qt::KeepAspectRatio); double scaleFactor = finalSize.width()/(double)pic.boundingRect().size().width(); painter->save(); painter->scale(scaleFactor, scaleFactor); painter->setClipRect(rect); painter->drawPicture(rect.topLeft(), pic); painter->restore(); } QTextCharFormat QCPDocumentObject::generatePlotFormat(QCustomPlot *plot, int width, int height) { QPicture picture; QCPPainter qcpPainter; qcpPainter.begin(&picture); plot->toPainter(&qcpPainter, width, height); qcpPainter.end(); QTextCharFormat result; result.setObjectType(QCPDocumentObject::PlotTextFormat); result.setProperty(QCPDocumentObject::PicturePropertyId, QVariant::fromValue(picture)); return result; } qcustomplot-2.1.0+dfsg1/examples/text-document-integration/mainwindow.ui0000640000175000017500000001011513532027716026504 0ustar rusconirusconi MainWindow 0 0 786 440 QCustomPlot Document Insertion Demo 400 0 0 0 <html><head/><body><p>Size of plot<br/>in document:</p></body></html> 0 0 1 9999 480 x 0 0 1 9999 340 Use current TopToolBarArea false Insert Plot Save Document... QCustomPlot QWidget
../../qcustomplot.h
1 qcustomplot-2.1.0+dfsg1/examples/text-document-integration/mainwindow.cpp0000644000175000017500000001463114030217664026661 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include "mainwindow.h" #include "ui_mainwindow.h" MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow) { ui->setupUi(this); connect(ui->cbUseCurrentSize, SIGNAL(toggled(bool)), ui->sbWidth, SLOT(setDisabled(bool))); connect(ui->cbUseCurrentSize, SIGNAL(toggled(bool)), ui->sbHeight, SLOT(setDisabled(bool))); ui->plot->axisRect()->setMinimumSize(300, 180); setupPlot(); // register the plot document object (only needed once, no matter how many plots will be in the QTextDocument): QCPDocumentObject *plotObjectHandler = new QCPDocumentObject(this); ui->textEdit->document()->documentLayout()->registerHandler(QCPDocumentObject::PlotTextFormat, plotObjectHandler); } MainWindow::~MainWindow() { delete ui; } void MainWindow::setupPlot() { // The following plot setup is taken from the sine demo: // add two new graphs and set their look: ui->plot->addGraph(); ui->plot->graph(0)->setPen(QPen(Qt::blue)); // line color blue for first graph ui->plot->graph(0)->setBrush(QBrush(QColor(0, 0, 255, 20))); // first graph will be filled with translucent blue ui->plot->addGraph(); ui->plot->graph(1)->setPen(QPen(Qt::red)); // line color red for second graph // generate some points of data (y0 for first, y1 for second graph): QVector x(250), y0(250), y1(250); for (int i=0; i<250; ++i) { x[i] = i; y0[i] = qExp(-i/150.0)*qCos(i/10.0); // exponentially decaying cosine y1[i] = qExp(-i/150.0); // exponential envelope } // configure right and top axis to show ticks but no labels: // (see QCPAxisRect::setupFullAxesBox for a quicker method to do this) ui->plot->xAxis2->setVisible(true); ui->plot->xAxis2->setTickLabels(false); ui->plot->yAxis2->setVisible(true); ui->plot->yAxis2->setTickLabels(false); // make left and bottom axes always transfer their ranges to right and top axes: connect(ui->plot->xAxis, SIGNAL(rangeChanged(QCPRange)), ui->plot->xAxis2, SLOT(setRange(QCPRange))); connect(ui->plot->yAxis, SIGNAL(rangeChanged(QCPRange)), ui->plot->yAxis2, SLOT(setRange(QCPRange))); // pass data points to graphs: ui->plot->graph(0)->setData(x, y0); ui->plot->graph(1)->setData(x, y1); // let the ranges scale themselves so graph 0 fits perfectly in the visible area: ui->plot->graph(0)->rescaleAxes(); // same thing for graph 1, but only enlarge ranges (in case graph 1 is smaller than graph 0): ui->plot->graph(1)->rescaleAxes(true); // Note: we could have also just called customPlot->rescaleAxes(); instead // Allow user to drag axis ranges with mouse, zoom with mouse wheel and select graphs by clicking: ui->plot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom | QCP::iSelectPlottables); } void MainWindow::on_actionInsert_Plot_triggered() { QTextCursor cursor = ui->textEdit->textCursor(); // insert the current plot at the cursor position. QCPDocumentObject::generatePlotFormat creates a // vectorized snapshot of the passed plot (with the specified width and height) which gets inserted // into the text document. double width = ui->cbUseCurrentSize->isChecked() ? 0 : ui->sbWidth->value(); double height = ui->cbUseCurrentSize->isChecked() ? 0 : ui->sbHeight->value(); cursor.insertText(QString(QChar::ObjectReplacementCharacter), QCPDocumentObject::generatePlotFormat(ui->plot, width, height)); ui->textEdit->setTextCursor(cursor); } void MainWindow::on_actionSave_Document_triggered() { QString fileName = QFileDialog::getSaveFileName(this, "Save document...", qApp->applicationDirPath(), "*.pdf"); if (!fileName.isEmpty()) { QPrinter printer; printer.setOutputFormat(QPrinter::PdfFormat); printer.setOutputFileName(fileName); QMargins pageMargins(20, 20, 20, 20); #if QT_VERSION < QT_VERSION_CHECK(5, 3, 0) printer.setFullPage(false); printer.setPaperSize(QPrinter::A4); printer.setOrientation(QPrinter::Portrait); printer.setPageMargins(pageMargins.left(), pageMargins.top(), pageMargins.right(), pageMargins.bottom(), QPrinter::Millimeter); #else QPageLayout pageLayout; pageLayout.setMode(QPageLayout::StandardMode); pageLayout.setOrientation(QPageLayout::Portrait); pageLayout.setPageSize(QPageSize(QPageSize::A4)); pageLayout.setUnits(QPageLayout::Millimeter); pageLayout.setMargins(QMarginsF(pageMargins)); printer.setPageLayout(pageLayout); #endif #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) ui->textEdit->document()->setPageSize(printer.pageRect().size()); #else ui->textEdit->document()->setPageSize(printer.pageLayout().paintRectPixels(printer.resolution()).size()); #endif ui->textEdit->document()->print(&printer); } } qcustomplot-2.1.0+dfsg1/examples/text-document-integration/text-document-integration.pro0000644000175000017500000000114214030217664031635 0ustar rusconirusconi#------------------------------------------------- # # Project created by QtCreator 2013-07-06T18:51:44 # #------------------------------------------------- QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 TARGET = text-document-integration TEMPLATE = app SOURCES += main.cpp\ mainwindow.cpp \ qcpdocumentobject.cpp \ ../../qcustomplot.cpp HEADERS += mainwindow.h \ qcpdocumentobject.h \ ../../qcustomplot.h FORMS += mainwindow.ui qcustomplot-2.1.0+dfsg1/examples/text-document-integration/main.cpp0000640000175000017500000000026113532027716025422 0ustar rusconirusconi#include "mainwindow.h" #include int main(int argc, char *argv[]) { QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); } qcustomplot-2.1.0+dfsg1/examples/text-document-integration/qcpdocumentobject.h0000644000175000017500000000536014030217664027662 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #ifndef QCPDOCUMENTOBJECT_H #define QCPDOCUMENTOBJECT_H #include #include #include #include #include #include "../../qcustomplot.h" class QCPDocumentObject : public QObject, public QTextObjectInterface { Q_OBJECT Q_INTERFACES(QTextObjectInterface) public: enum { PlotTextFormat = QTextFormat::UserObject + 3902 }; // if your application already uses the id (QTextFormat::UserObject + 3902), just change the id here enum { PicturePropertyId = 1 }; explicit QCPDocumentObject(QObject *parent = 0); QSizeF intrinsicSize(QTextDocument *doc, int posInDocument, const QTextFormat &format); void drawObject(QPainter *painter, const QRectF &rect, QTextDocument *doc, int posInDocument, const QTextFormat &format); static QTextCharFormat generatePlotFormat(QCustomPlot *plot, int width=0, int height=0); }; Q_DECLARE_METATYPE(QPicture) #endif // QCPDOCUMENTOBJECT_H qcustomplot-2.1.0+dfsg1/examples/text-document-integration/mainwindow.h0000644000175000017500000000444514030217664026330 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #ifndef MAINWINDOW_H #define MAINWINDOW_H #include #include #include #include "qcpdocumentobject.h" namespace Ui { class MainWindow; } class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow(); void setupPlot(); private slots: void on_actionInsert_Plot_triggered(); void on_actionSave_Document_triggered(); private: Ui::MainWindow *ui; }; #endif // MAINWINDOW_H qcustomplot-2.1.0+dfsg1/examples/scrollbar-axis-range-control/0000755000175000017500000000000014030601042024333 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/examples/scrollbar-axis-range-control/mainwindow.ui0000640000175000017500000000355313532027716027070 0ustar rusconirusconi MainWindow 0 0 469 357 QCustomPlot Scrollbar Axis Range Control Demo 0 0 Qt::Vertical Qt::Horizontal Insert Plot Save Document... QCustomPlot QWidget
../../qcustomplot.h
1 qcustomplot-2.1.0+dfsg1/examples/scrollbar-axis-range-control/mainwindow.cpp0000644000175000017500000001165314030217664027236 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include "mainwindow.h" #include "ui_mainwindow.h" MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow) { ui->setupUi(this); setupPlot(); // configure scroll bars: // Since scroll bars only support integer values, we'll set a high default range of -500..500 and // divide scroll bar position values by 100 to provide a scroll range -5..5 in floating point // axis coordinates. if you want to dynamically grow the range accessible with the scroll bar, // just increase the minimum/maximum values of the scroll bars as needed. ui->horizontalScrollBar->setRange(-500, 500); ui->verticalScrollBar->setRange(-500, 500); // create connection between axes and scroll bars: connect(ui->horizontalScrollBar, SIGNAL(valueChanged(int)), this, SLOT(horzScrollBarChanged(int))); connect(ui->verticalScrollBar, SIGNAL(valueChanged(int)), this, SLOT(vertScrollBarChanged(int))); connect(ui->plot->xAxis, SIGNAL(rangeChanged(QCPRange)), this, SLOT(xAxisChanged(QCPRange))); connect(ui->plot->yAxis, SIGNAL(rangeChanged(QCPRange)), this, SLOT(yAxisChanged(QCPRange))); // initialize axis range (and scroll bar positions via signals we just connected): ui->plot->xAxis->setRange(0, 6, Qt::AlignCenter); ui->plot->yAxis->setRange(0, 10, Qt::AlignCenter); } MainWindow::~MainWindow() { delete ui; } void MainWindow::setupPlot() { // The following plot setup is mostly taken from the plot demos: ui->plot->addGraph(); ui->plot->graph()->setPen(QPen(Qt::blue)); ui->plot->graph()->setBrush(QBrush(QColor(0, 0, 255, 20))); ui->plot->addGraph(); ui->plot->graph()->setPen(QPen(Qt::red)); QVector x(500), y0(500), y1(500); for (int i=0; i<500; ++i) { x[i] = (i/499.0-0.5)*10; y0[i] = qExp(-x[i]*x[i]*0.25)*qSin(x[i]*5)*5; y1[i] = qExp(-x[i]*x[i]*0.25)*5; } ui->plot->graph(0)->setData(x, y0); ui->plot->graph(1)->setData(x, y1); ui->plot->axisRect()->setupFullAxesBox(true); ui->plot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); } void MainWindow::horzScrollBarChanged(int value) { if (qAbs(ui->plot->xAxis->range().center()-value/100.0) > 0.01) // if user is dragging plot, we don't want to replot twice { ui->plot->xAxis->setRange(value/100.0, ui->plot->xAxis->range().size(), Qt::AlignCenter); ui->plot->replot(); } } void MainWindow::vertScrollBarChanged(int value) { if (qAbs(ui->plot->yAxis->range().center()+value/100.0) > 0.01) // if user is dragging plot, we don't want to replot twice { ui->plot->yAxis->setRange(-value/100.0, ui->plot->yAxis->range().size(), Qt::AlignCenter); ui->plot->replot(); } } void MainWindow::xAxisChanged(QCPRange range) { ui->horizontalScrollBar->setValue(qRound(range.center()*100.0)); // adjust position of scroll bar slider ui->horizontalScrollBar->setPageStep(qRound(range.size()*100.0)); // adjust size of scroll bar slider } void MainWindow::yAxisChanged(QCPRange range) { ui->verticalScrollBar->setValue(qRound(-range.center()*100.0)); // adjust position of scroll bar slider ui->verticalScrollBar->setPageStep(qRound(range.size()*100.0)); // adjust size of scroll bar slider } qcustomplot-2.1.0+dfsg1/examples/scrollbar-axis-range-control/main.cpp0000640000175000017500000000026113532027716025776 0ustar rusconirusconi#include "mainwindow.h" #include int main(int argc, char *argv[]) { QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); } qcustomplot-2.1.0+dfsg1/examples/scrollbar-axis-range-control/scrollbar-axis-range-control.pro0000644000175000017500000000105714030217664032572 0ustar rusconirusconi#------------------------------------------------- # # Project created by QtCreator 2013-07-25T20:43:22 # #------------------------------------------------- QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 TARGET = scrollbar-axis-range-control TEMPLATE = app SOURCES += main.cpp\ mainwindow.cpp \ ../../qcustomplot.cpp HEADERS += mainwindow.h \ ../../qcustomplot.h FORMS += mainwindow.ui qcustomplot-2.1.0+dfsg1/examples/scrollbar-axis-range-control/mainwindow.h0000644000175000017500000000447314030217664026705 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #ifndef MAINWINDOW_H #define MAINWINDOW_H #include #include "../../qcustomplot.h" namespace Ui { class MainWindow; } class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow(); void setupPlot(); private slots: void horzScrollBarChanged(int value); void vertScrollBarChanged(int value); void xAxisChanged(QCPRange range); void yAxisChanged(QCPRange range); private: Ui::MainWindow *ui; }; #endif // MAINWINDOW_H qcustomplot-2.1.0+dfsg1/examples/axis-tags/0000755000175000017500000000000014030601042020536 5ustar rusconirusconiqcustomplot-2.1.0+dfsg1/examples/axis-tags/mainwindow.ui0000640000175000017500000000174413532027716023273 0ustar rusconirusconi MainWindow 0 0 400 300 Axis Tags Example 0 0 400 22 TopToolBarArea false qcustomplot-2.1.0+dfsg1/examples/axis-tags/mainwindow.cpp0000644000175000017500000001034414030217664023435 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include "mainwindow.h" #include "ui_mainwindow.h" MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow), mPlot(0), mTag1(0), mTag2(0) { ui->setupUi(this); mPlot = new QCustomPlot(this); setCentralWidget(mPlot); // configure plot to have two right axes: mPlot->yAxis->setTickLabels(false); connect(mPlot->yAxis2, SIGNAL(rangeChanged(QCPRange)), mPlot->yAxis, SLOT(setRange(QCPRange))); // left axis only mirrors inner right axis mPlot->yAxis2->setVisible(true); mPlot->axisRect()->addAxis(QCPAxis::atRight); mPlot->axisRect()->axis(QCPAxis::atRight, 0)->setPadding(30); // add some padding to have space for tags mPlot->axisRect()->axis(QCPAxis::atRight, 1)->setPadding(30); // add some padding to have space for tags // create graphs: mGraph1 = mPlot->addGraph(mPlot->xAxis, mPlot->axisRect()->axis(QCPAxis::atRight, 0)); mGraph2 = mPlot->addGraph(mPlot->xAxis, mPlot->axisRect()->axis(QCPAxis::atRight, 1)); mGraph1->setPen(QPen(QColor(250, 120, 0))); mGraph2->setPen(QPen(QColor(0, 180, 60))); // create tags with newly introduced AxisTag class (see axistag.h/.cpp): mTag1 = new AxisTag(mGraph1->valueAxis()); mTag1->setPen(mGraph1->pen()); mTag2 = new AxisTag(mGraph2->valueAxis()); mTag2->setPen(mGraph2->pen()); connect(&mDataTimer, SIGNAL(timeout()), this, SLOT(timerSlot())); mDataTimer.start(40); } MainWindow::~MainWindow() { delete ui; } void MainWindow::timerSlot() { // calculate and add a new data point to each graph: mGraph1->addData(mGraph1->dataCount(), qSin(mGraph1->dataCount()/50.0)+qSin(mGraph1->dataCount()/50.0/0.3843)*0.25); mGraph2->addData(mGraph2->dataCount(), qCos(mGraph2->dataCount()/50.0)+qSin(mGraph2->dataCount()/50.0/0.4364)*0.15); // make key axis range scroll with the data: mPlot->xAxis->rescale(); mGraph1->rescaleValueAxis(false, true); mGraph2->rescaleValueAxis(false, true); mPlot->xAxis->setRange(mPlot->xAxis->range().upper, 100, Qt::AlignRight); // update the vertical axis tag positions and texts to match the rightmost data point of the graphs: double graph1Value = mGraph1->dataMainValue(mGraph1->dataCount()-1); double graph2Value = mGraph2->dataMainValue(mGraph2->dataCount()-1); mTag1->updatePosition(graph1Value); mTag2->updatePosition(graph2Value); mTag1->setText(QString::number(graph1Value, 'f', 2)); mTag2->setText(QString::number(graph2Value, 'f', 2)); mPlot->replot(); } qcustomplot-2.1.0+dfsg1/examples/axis-tags/main.cpp0000640000175000017500000000026113532027716022201 0ustar rusconirusconi#include "mainwindow.h" #include int main(int argc, char *argv[]) { QApplication a(argc, argv); MainWindow w; w.show(); return a.exec(); } qcustomplot-2.1.0+dfsg1/examples/axis-tags/axis-tags-example.pro0000644000175000017500000000073014030217664024626 0ustar rusconirusconiQT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets printsupport greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 TARGET = axis-tags-example TEMPLATE = app INCLUDEPATH += ../../ SOURCES += \ main.cpp \ mainwindow.cpp \ ../../qcustomplot.cpp \ axistag.cpp HEADERS += \ mainwindow.h \ ../../qcustomplot.h \ axistag.h FORMS += \ mainwindow.ui qcustomplot-2.1.0+dfsg1/examples/axis-tags/axistag.h0000644000175000017500000000477314030217664022377 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #ifndef AXISTAG_H #define AXISTAG_H #include #include "qcustomplot.h" class AxisTag : public QObject { Q_OBJECT public: explicit AxisTag(QCPAxis *parentAxis); virtual ~AxisTag(); // setters: void setPen(const QPen &pen); void setBrush(const QBrush &brush); void setText(const QString &text); // getters: QPen pen() const { return mLabel->pen(); } QBrush brush() const { return mLabel->brush(); } QString text() const { return mLabel->text(); } // other methods: void updatePosition(double value); protected: QCPAxis *mAxis; QPointer mDummyTracer; QPointer mArrow; QPointer mLabel; }; #endif // AXISTAG_H qcustomplot-2.1.0+dfsg1/examples/axis-tags/mainwindow.h0000644000175000017500000000447114030217664023106 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #ifndef MAINWINDOW_H #define MAINWINDOW_H #include #include "qcustomplot.h" #include "axistag.h" namespace Ui { class MainWindow; } class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow(); private slots: void timerSlot(); private: Ui::MainWindow *ui; QCustomPlot *mPlot; QPointer mGraph1; QPointer mGraph2; AxisTag *mTag1; AxisTag *mTag2; QTimer mDataTimer; }; #endif // MAINWINDOW_H qcustomplot-2.1.0+dfsg1/examples/axis-tags/axistag.cpp0000644000175000017500000001230514030217664022720 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #include "axistag.h" AxisTag::AxisTag(QCPAxis *parentAxis) : QObject(parentAxis), mAxis(parentAxis) { // The dummy tracer serves here as an invisible anchor which always sticks to the right side of // the axis rect mDummyTracer = new QCPItemTracer(mAxis->parentPlot()); mDummyTracer->setVisible(false); mDummyTracer->position->setTypeX(QCPItemPosition::ptAxisRectRatio); mDummyTracer->position->setTypeY(QCPItemPosition::ptPlotCoords); mDummyTracer->position->setAxisRect(mAxis->axisRect()); mDummyTracer->position->setAxes(0, mAxis); mDummyTracer->position->setCoords(1, 0); // the arrow end (head) is set to move along with the dummy tracer by setting it as its parent // anchor. Its coordinate system (setCoords) is thus pixels, and this is how the needed horizontal // offset for the tag of the second y axis is achieved. This horizontal offset gets dynamically // updated in AxisTag::updatePosition. the arrow "start" is simply set to have the "end" as parent // anchor. It is given a horizontal offset to the right, which results in a 15 pixel long arrow. mArrow = new QCPItemLine(mAxis->parentPlot()); mArrow->setLayer("overlay"); mArrow->setClipToAxisRect(false); mArrow->setHead(QCPLineEnding::esSpikeArrow); mArrow->end->setParentAnchor(mDummyTracer->position); mArrow->start->setParentAnchor(mArrow->end); mArrow->start->setCoords(15, 0); // The text label is anchored at the arrow start (tail) and has its "position" aligned at the // left, and vertically centered to the text label box. mLabel = new QCPItemText(mAxis->parentPlot()); mLabel->setLayer("overlay"); mLabel->setClipToAxisRect(false); mLabel->setPadding(QMargins(3, 0, 3, 0)); mLabel->setBrush(QBrush(Qt::white)); mLabel->setPen(QPen(Qt::blue)); mLabel->setPositionAlignment(Qt::AlignLeft|Qt::AlignVCenter); mLabel->position->setParentAnchor(mArrow->start); } AxisTag::~AxisTag() { if (mDummyTracer) mDummyTracer->parentPlot()->removeItem(mDummyTracer); if (mArrow) mArrow->parentPlot()->removeItem(mArrow); if (mLabel) mLabel->parentPlot()->removeItem(mLabel); } void AxisTag::setPen(const QPen &pen) { mArrow->setPen(pen); mLabel->setPen(pen); } void AxisTag::setBrush(const QBrush &brush) { mLabel->setBrush(brush); } void AxisTag::setText(const QString &text) { mLabel->setText(text); } void AxisTag::updatePosition(double value) { // since both the arrow and the text label are chained to the dummy tracer (via anchor // parent-child relationships) it is sufficient to update the dummy tracer coordinates. The // Horizontal coordinate type was set to ptAxisRectRatio so to keep it aligned at the right side // of the axis rect, it is always kept at 1. The vertical coordinate type was set to // ptPlotCoordinates of the passed parent axis, so the vertical coordinate is set to the new // value. mDummyTracer->position->setCoords(1, value); // We want the arrow head to be at the same horizontal position as the axis backbone, even if // the axis has a certain offset from the axis rect border (like the added second y axis). Thus we // set the horizontal pixel position of the arrow end (head) to the axis offset (the pixel // distance to the axis rect border). This works because the parent anchor of the arrow end is // the dummy tracer, which, as described earlier, is tied to the right axis rect border. mArrow->end->setCoords(mAxis->offset(), 0); } qcustomplot-2.1.0+dfsg1/changelog.txt0000644000175000017500000015102014030217664017524 0ustar rusconirusconi#### Version 2.1.0 released on 29.03.21 #### Added features: - Compatibility up to Qt 6.0 - Tech Preview: Radial Plots (see setupPolarPlotDemo in examples project) - QCPAxisTickerDateTime can now be configured with a QTimeZone for adjusting the label display to arbitrary time zones - QCPColorGradient (and thus also QCPColorMap) now has explicit configurable NaN handling (see QCPColorGradient::setNanHandling) - added timing/benchmarking method QCustomPlot::replotTime(bool average) which returns the milliseconds per replot - QCustomPlot::plottableAt has an optional output parameter dataIndex, providing the index of the data point at the probed position - QCustomPlot::plottableAt template method allows limiting the search to the specified QCPAbstractPlottable subclass T - QCustomPlot::itemAt template method allows limiting the search to the specified QCPAbstractItem subclass T - Added Interaction flag QCP::iSelectPlottablesBeyondAxisRect, allows selection of data points very close to (and beyond of) the axes - QCPAxisTickerDateTime::dateTimeToKey(QDate &) now also takes a TimeSpec to specify the interpretation of the start-of-day - QCPAxisTickerLog now switches to linear ticks if zoomed in beyond where logarithmic ticks are reasonable - Added QCustomPlot::afterLayout signal, for user code that crucially depends on layout sizes/positions, right before the draw step during a replot Bugfixes: - Fixed bug where QCPLayer::replot wouldn't issue full replot even though invalidated buffers existed - Fixed QCPCurve bug causing rendering artifacts when using keys/values smaller than about 1e-12 in some constellations - Fixed getValueRange when used with explicit keyRange, now doesn't use key range expanded by one point to each side anymore - Fixed bug of QCPAxis tick label font size change only propagating to the layout after second call to replot - Fixed bug of QCPTextElement not respecting the configured text alignment flag (setTextFlags) - Various documentation typos and improvements Other: - QCP Now requires C++11. However, Qt4.6 compatibility is maintained in the QCP 2.x release series - QCPColorScale is now initialized with gpCold gradient preset, which prevents color maps turning black when linking them to a default-created color scale without explicitly setting a gradient - QCPLegend::clearItems is now faster in case of many legend items (>1000) - Modernized expressions and thereby avoided some warnings (e.g. nullptr and casts) - Switched to foreach (Qt macro) where possible (in preparation for switch to range-based for (C++11), soonest at next major release) - Work around Qt bug, drawing lines with pen width 1 as slow as with pen widths > 1 (polyfill instead of line algorithm, also on Normal-DPI), by using pen width 0 in such cases. - Added QCP::Interaction flag iNone=0x000 to allow explicitly specifying no interaction (Avoids QFlags::zero, which was deprecated in Qt5.14) - QCP is now compatible with defines QT_USE_QSTRINGBUILDER, QT_USE_FAST_CONCATENATION (Qt<4.8), QT_USE_FAST_OPERATOR_PLUS (Qt<4.8) #### Version 2.0.1 released on 25.06.18 #### Bugfixes: - Default filling order of QCPLayoutGrid is now foColumnsFirst instead of foRowsFirst, as intended and consistent with QCP1. Note that this also changes the indexing order of e.g. QCustomPlot::axisRect(int index), compared with 2.0.0. You can change the filling and thus indexing order yourself by calling QCPLayoutGrid::setFillOrder. - fixed bug in QCPColorMap, when using alpha in the gradient color stops. Used to draw falsely black data points when the associated data value is exactly on the first or last color stop. - QCPDataSelection::enforceType(stDataRange) would erroneously add an empty data range to the selection, if the selection was already empty. This in turn would cause isEmpty() to erroneously return false. - fixed hypothetical crash when selectTest is called on a QCPItemCurve which has all of its points at the same position Other: - Various documentation improvements and clarifications - Prevent conflict with windows.h min/max macros if user forgets to define NOMINMAX - compiling QCP shared libraries with static Qt is now easier - added defines QCUSTOMPLOT_VERSION and QCUSTOMPLOT_VERSION_STR (the same way Qt does) to provide the used QCP version number - added missing Q_DECL_OVERRIDE declarations, thus preventing warnings some compiler settings - QCPAxisTicker and subclasses are no longer copyable by value, as intended - QCPBarsGroup constructor is now explicit, as intended - Qt 5.11 compatibility #### Version 2.0.0 released on 04.09.17 #### Added major features: - Axis tick and tick label generation was completely refactored and is now handled in the QCPAxisTicker class (also see QCPAxis::setTicker). Available ticker subclasses for special uses cases: QCPAxisTicker, QCPAxisTickerFixed, QCPAxisTickerLog, QCPAxisTickerPi, QCPAxisTickerTime, QCPAxisTickerDateTime, QCPAxisTickerText - Data container is now based on QCPDataContainer template for unified data interface and significantly improved memory footprint and better performance for common use-cases, especially data adding/removing. - New data selection mechanism allows selection of single data points and data ranges for plottables. See special documentation page "data selection mechanism". - Rubber band/selection rect for data point selection and axis zooming is now available, see documentation of QCustomPlot::setSelectionRectMode and QCPSelectionRect. For this purpose, the new default layer "overlay" was introduced, which is now the top layer, and holds the QCustomPlot's QCPSelectionRect instance. - Data sharing between plottables of the same type (see setData methods taking a QSharedPointer) - OpenGL hardware acceleration is now available across all Qt versions (including Qt4) in a unified, simple interface, with QCustomPlot::setOpenGl (experimental) - QCPStatisticalBox can now display a series of statistical boxes instead of only a single one - New QCPErrorBars plottable allows attaching error bars to any one-dimensional plottable (QCPGraph has thus lost its own error-bar capability) - QCPColorMap now supports transparency via alpha in its color gradient stops, and via a dedicated cell-wise alpha map (see QCPColorMapData::setAlpha) - Layers may now be individually replotted (QCPLayer::replot), if the mode (QCPLayer::setMode) is set to lmBuffered. Mutually adjacent lmLogical layers share a single paint buffer to save resources. By default, the new topmost "overlay" layer which contains the selection rect is an lmBuffered layer. Updating the selection rect is thus very fast, independent of the plot contents. - QCPLayerable (and thus practically all objects in QCP) now have virtual methods to receive mouse press/move/release/doubleclick/wheel events. Before, only QCPLayoutElement provided them. this makes it much easier to subclass e.g. items and plottables to provide custom mouse interactions that were cumbersome and awkward with the simpler signal-based interface Added minor features: - High-DPI support for Qt versions 5.0 and up, using device pixel ratio detected by Qt (can be changed manually via QCustomPlot::setBufferDevicePixelRatio). - QCPGraph and QCPCurve can now be configured to only display every n'th scatter symbol, see ::setScatterSkip() method - QCPFinancial allows to define bar width in absolute pixels and axis rect ratio, instead of only in plot key coordinates (see QCPFinancial::setWidthType) - Range dragging/zooming can now be configured to affect more than one axis per orientation (see new overloads of QCPAxisRect::setRangeDragAxes/setRangeZoomAxes) - Added QCPTextElement (replaces QCPPlotTitle) for general texts in layouts. Provides clicked and doubleClicked signals, as replacement for the removed QCustomPlot::titleClicked/titleDoubleClicked - Export functions (QCustomPlot::savePng etc.) now support specifying the resolution that will be written to the image file header. This improves operability with other tools which respect metadata. - Replots can now be queued to the next event loop iteration with replot(QCP::rpQueuedReplot). This way you can successively ask for a replot at multiple code locations without causing redundant replots - QCPAxisRect::zoom(...) allows to zoom to a specific rectangular region given in pixel coordinates, either affecting all axes or a specified subset of axes. - QCPRange::bounded returns a bounded range, trying to preserve its size. Works with rangeChanged signal to limit the allowed range (see rangeChanged doc) - Plottable rescaleValueAxis method (and getValueRange) now take parameter inKeyRange, which allows rescaling of the value axis only with respect to data in the currently visible key range - plottableClick and plottableDoubleClick signals now carry the clicked data point index as second parameter - Added QCPAxis::scaleRange overload without "center" argument, which scales around the current axis range center - Added QCPRange::expand/expanded overloads which take only one double parameter - Plottables addToLegend/removeFromLegend methods now have overloads that take any QCPLegend, to make working with non-default legends easier (legends that are not QCustomPlot::legend) - Added QCPStatisticalBox::setWhiskerAntialiased to allow controlling antialiasing state of whiskers independently of quartile box/median line - The virtual method QCPLayoutElement::layoutChanged() now allows subclasses to react on a move of the layout element between logical positions in the parent layout, or between layouts - QCPMarginGroup::commonMargin is now virtual, to facilitate subclassing of QCPMarginGroup - QCPGraph::getPreparedData is now virtual, and thus allows subclasses to easily generate own plotted data, e.g. on-the-fly. - Added QCPRange qDebug stream operator - QCPLayoutGrid (and thus QCPLegend) can now wrap rows or columns at specified row/column counts, see setFillOrder, setWrap and the new addElement overload which doesn't have row/column index Added minor features after beta: - QCPGraph fill now renders separate fill segments when there are gaps in the graph data (created by inserting NaN values) - fractional device pixel ratios are now used, if Qt version >= 5.6 - Axes may now be dragged/zoomed individually by starting the drag/zoom on top of the axis (previously, this required additional code) - Manual minimum and maximum layout element sizes (setMinimumSize/setMaximumSize) can now affect the inner or the outer rect, see QCPLayoutElement::setSizeConstraintRect Bugfixes [Also backported to 1.3.2]: - Fixed possible crash when having a QCPGraph with scatters only and a non-transparent main/fill brush of the graph - Fixed QCPItemPixmap not updating internally cached scaled pixmap if new pixmap set with same scaled dimensions - When using log axis scale and zooming out as far as possible (~1e-280..1e280), axis doesn't end up in (via mouse) unrecoverable range with strange axis ticks anymore - Axis tick label algorithm for beautifully typeset powers now checks whether "e" in tick label is actually part of a number before converting the exponent to superscript - Fixed QCustomPlot::moveLayer performing incorrect move and possible crash in certain situations - Fixed possible crash on QCustomPlot destruction due to wrong QObject-hierarchy. Only occurs if a QCPAxisRect is removed from the normal QCustomPlot destruction hierarchy by taking it out of its layout - Fixed possible freeze when data values become infinity after coord-to-pixel transformation (e.g. maximally zoomed out log axis), and line style is not solid (e.g. dashed) or phFastPolylines is disabled - Fixed a few missing enums in meta type system, by unifying usage of Q_ENUMS, Q_FLAGS and Q_DECLARE_METATYPE Bugfixes [Not in 1.3.2]: - Fixed QCPItemLine/QCPItemStraightLine not being selectable when defining coords are many orders of magnitude (>1e8) larger than currently viewed range - Fixed/worked around crash due to bug in QPainter::drawPixmap with very large negative x/y pixel coordinates, when drawing sparse pixmap scatters - Fixed possible (but unlikely) int overflow in adaptive sampling algorithm, that could cause plot artifacts when using extremely sparse data (with respect to current key axis range). - Fixed QCPBarsGroup bug which caused stPlotCoords spacing to be wrong with vertical key axes - A QCPBars axis rescale in the main window constructor (i.e. without well-defined plot size) now falls back to a datapoint-tight rescaling instead of doing nothing (because bar width can't be determined) - Improved QCPBars stacking when using bars with very large keys and key separation at limit of double precision Bugfixes after beta: - fixed QCPCurve vertex optimization algorithm not handling log axes correctly - upon removing the inner most axis, the offset of the new inner most axis (previously second axis) is now set to the value of the removed axis, instead of leaving a gap - QCPColorMap now has a default gradient (gpCold) again, instead of an empty and thus black gradient - doc: black QCPColorMap/QCPColorGradient documentation images fixed - scatter styles ssDiamond, ssTriangle and ssTriangleInverted now get proper filling with the specified brush - fixed click signals of plottable/axes/etc. not being emitted properly - fixed uninitialized scatterSkip on QCPCurve, leading to irregular default appearance of scatter skips - fixed device pixel ratio not being implemented correctly in cached tick labels - QCPLayoutElement::setMaximum/setMinimum now is with respect to the inner rect as intended (and documented), instead of the outer rect (and this can now be changed via setSizeConstraintRect) - fixed dllimport issue on template classes when compiling as shared library with MSVC Summary of backward incompatible changes: Plottable related: - Removed QCustomPlot::addPlottable, not needed anymore as plottables now automatically register in their constructor - Removed QCustomPlot::addItem, not needed anymore as items now automatically register in their constructor - QCPAbstractPlottable::addToLegend/removeFromLegend are not virtual anymore. If your plottable requires a custom legend item, add it to the legend manually. - setData/addData method overloads of plottables have changed to facilitate data sharing and new data container (see documentation) - plottableClick and plottableDoubleClick signals now carry the clicked data point index as second parameter, and the QMouseEvent parameter has moved to third. Check all your usages of those signals, because Qt's connect method only reports problems during runtime! - setSelectable now not only limits what can be selected by the user, but limits also any programmatic selection changes via setSelected. - enum QCPAbstractPlottable::SignDomain has changed namespace to QCP::SignDomain Axis related: - Removed QCPAxis::setAutoTicks, setAutoTickCount, setAutoTickLabels, setAutoTickStep, setAutoSubTicks, setTickLabelType, setDateTimeFormat, setDateTimeSpec, setTickStep, setTickVector, setTickVectorLabels, setSubTickCount in favor of new QCPAxisTicker-based interface - Added QCPAxis::setSubTicks to enable/disable subticks (manually controlling the subtick count needs subclassing of QCPAxisTicker, e.g. QCPAxisTickerText and QCPAxisTickerLog provide setSubTickCount) Item related: - Renamed QCPAbstractItem::rectSelectTest to rectDistance, to prevent confusion with new QCPAbstractPlottable1D::selectTestRect - Renamed QCPItemAnchor::pixelPoint to QCPItemAnchor::pixelPosition (also affects subclass QCPItemPosition) General: - Renamed QCustomPlot::RefreshPriority enums (parameter of the replot() method): rpImmediate to rpImmediateRefresh, rpQueued to rpQueuedRefresh, rpHint to rpRefreshHint - Renamed QCustomPlot::PlottingHint enum phForceRepaint to phImmediateRefresh - Removed QCPPlotTitle layout element (See new QCPTextElement for almost drop-in replacement) - Removed signals QCustomPlot::titleClicked/titleDoubleClicked, replaced by QCPTextElement signals clicked/doubleClicked. - QCustomPlot::savePdf has changed parameters from (fileName, bool noCosmeticPen, width, height,...) to (fileName, width, height, QCP::ExportPen exportPen,...) - Virtual methods QCPLayoutElement::mouseMoveEvent/mouseReleaseEvent (which are now introduced already in the superclass QCPLayerable) have gained an additional parameter const QPointF &startPos. If you have reimplemented these methods, make sure to update your function signatures, otherwise your reimplementations will likely be ignored by the compiler without warning - Creating a new QCPColorGradient without supplying a preset parameter in the constructor now creates an empty gradient, instead of loading the gpCold preset Other: - Replaced usage of Qt's QVector2D with own QCPVector2D which uses double precision and offers some convenience functions - Extended relative range to which QCPItemLine/QCPItemStraightLine can be zoomed before vanishing from ~1e9 to ~1e16 - Removed QCPItemStraightLine::distToStraightLine (replaced by QCPVector2D::distanceToStraightLine) - Removed QCPAbstractPlottable::distSqrToLine and QCPAbstractItem::distSqrToLine (replaced by QCPVector2D::distanceSquaredToLine) - Qt5.5 compatibility (If you use PDF export, test your outputs, as output dimensions might change when switching Qt versions -- QCP does not try to emulate previous Qt version behaviour here) - QCP now includes instead of just because some users had problems with the latter. Please report if you now experience issues due to the new include. - QCPGraph can now use a brush (filled polygon under the graph data) without having a graph line (line style lsNone) - QCPFinancial is now two-colored (setTwoColored(true)) by default, and has green/red as default two-colored brushes and pens - Plottable pixelsToCoords/coordsToPixels methods are now public, and offer transformations from pixel to plot coordinates and vice versa, using the plottable's axes - Plottable getKeyRange/getValueRange methods are now public - QCPBarsGroup now always places the QCPBars that was added to the group first towards lower keys, independent of axis orientation or direction (the ordering used to flip with axis orientation) - Default focus policy for QCustomPlot is now Qt::ClickFocus, instead of Qt::NoFocus. - tweaked QCPLegend and QCPAbstractLegendItem margins: The items have by default zero own margins, and QCPLegend row- and column spacing was increased to compensate. Legend was made slightly denser by default. - Used doxygen version is now 1.8.12, and documentation/postprocessing-scripts were adapted accordingly. Expect minor issues and some warnings when using older doxygen. Other after beta: - Integrated OpenGL support (QCustomPlot::setOpenGl) is experimental for now, due the strong dependency on the system/graphics driver of the current implementation - fixed some plot title font sizes in the example projects that were too small due to switch to QCPTextElement - added missing override specifiers on reimplemented virtual methods - changed to more intuitive defaults for QCPSelectionDecorator scatter style (now doesn't define an own scatter pen by default) #### Version 1.3.2 released on 22.12.15 #### Bugfixes [Backported from 2.0.0 branch]: - Fixed possible crash when having a QCPGraph with scatters only and a non-transparent main/fill brush of the graph - Fixed QCPItemPixmap not updating internally cached scaled pixmap if new pixmap set with same scaled dimensions - When using log axis scale and zooming out as far as possible (~1e-280..1e280), axis doesn't end up in (via mouse) unrecoverable range with strange axis ticks anymore - Axis tick label algorithm for beautifully typeset powers now checks whether "e" in tick label is actually part of a number before converting the exponent to superscript - Fixed QCustomPlot::moveLayer performing incorrect move and possible crash in certain situations - Fixed possible crash on QCustomPlot destruction due to wrong QObject-hierarchy. Only occurs if a QCPAxisRect is removed from the normal QCustomPlot destruction hierarchy by taking it out of its layout - Fixed possible freeze when data values become infinity after coord-to-pixel transformation (e.g. maximally zoomed out log axis), and line style is not solid (e.g. dashed) or phFastPolylines is disabled Other [Backported from 2.0.0 branch]: - A few documentation fixes/improvements - Qt5.5 compatibility (If you use PDF export, test your outputs, as output dimensions might change when switching Qt versions -- QCP does not try to emulate previous Qt version behaviour here) - QCP now includes instead of just because some users had problems with the latter. Please report if you now experience issues due to the new include. #### Version 1.3.1 released on 25.04.15 #### Bugfixes: - Fixed bug that prevented automatic axis rescaling when some graphs/curves had only NaN data points - Improved QCPItemBracket selection boundaries, especially bsCurly and bsCalligraphic - Fixed bug of axis rect and colorscale background shifted downward by one logical pixel (visible in scaled png and pdf export) - Replot upon mouse release is now only performed if a selection change has actually happened (improves responsivity on particularly complex plots) - Fixed bug that allowed scatter-only graphs to be selected by clicking the non-existent line between scatters - Fixed crash when trying to select a scatter-only QCPGraph whose only points in the visible key range are at identical key coordinates and vertically off-screen, with adaptive sampling enabled - Fixed pdf export of QCPColorMap with enabled interpolation (didn't appear interpolated in pdf) - Reduced QCPColorMap jitter of internal cell boundaries for small sized maps when viewed with high zoom, by applying oversampling factors dependant on map size - Fixed bug of QCPColorMap::fill() not causing the buffered internal image map to be updated, and thus the change didn't become visible immediately - Axis labels with size set in pixels (setPixelSize) instead of points now correctly calculate the exponent's font size if beautifully typeset powers are enabled - Fixed QCPColorMap appearing at the wrong position for logarithmic axes and color map spanning larger ranges Other: - Pdf export used to embed entire QCPColorMaps, potentially leading to large files. Now only the visible portion of the map is embedded in the pdf - Many documentation fixes and extensions, style modernization - Reduced documentation file size (and thus full package size) by automatically reducing image palettes during package build - Fixed MSVC warning message (at warning level 4) due to temporary QLists in some foreach statements #### Version 1.3.0 released on 27.12.14 #### Added features: - New plottable class QCPFinancial allows display of candlestick/ohlc data - New class QCPBarsGroup allows horizontal grouping of multiple QCPBars plottables - Added QCPBars feature allowing non-zero base values (see property QCPBars::setBaseValue) - Added QCPBars width type, for more flexible bar widths (see property QCPBars::setWidthType) - New QCPCurve optimization algorithm, fixes bug which caused line flicker at deep zoom into curve segment - Item positions can now have different position types and anchors for their x and y coordinates (QCPItemPosition::setTypeX/Y, setParentAnchorX/Y) - QCPGraph and QCPCurve can now display gaps in their lines, when inserting quiet NaNs as values (std::numeric_limits::quiet_NaN()) - QCPAxis now supports placing the tick labels inside the axis rect, for particularly space saving plots (QCPAxis::setTickLabelSide) Added features after beta: - Made code compatible with QT_NO_CAST_FROM_ASCII, QT_NO_CAST_TO_ASCII - Added compatibility with QT_NO_KEYWORDS after sending code files through a simple reg-ex script - Added possibility to inject own QCPAxis(-subclasses) via second, optional QCPAxisRect::addAxis parameter - Added parameter to QCPItemPixmap::setScaled to specify transformation mode Bugfixes: - Fixed bug in QCPCurve rendering of very zoomed-in curves (via new optimization algorithm) - Fixed conflict with MSVC-specific keyword "interface" in text-document-integration example - Fixed QCPScatterStyle bug ignoring the specified pen in the custom scatter shape constructor - Fixed bug (possible crash) during QCustomPlot teardown, when a QCPLegend that has no parent layout (i.e. was removed from layout manually) gets deleted Bugfixes after beta: - Fixed bug of QCPColorMap/QCPColorGradient colors being off by one color sampling step (only noticeable in special cases) - Fixed bug of QCPGraph adaptive sampling on vertical key axis, causing staggered look - Fixed low (float) precision in QCPCurve optimization algorithm, by not using QVector2D anymore Other: - Qt 5.3 and Qt 5.4 compatibility #### Version 1.2.1 released on 07.04.14 #### Bugfixes: - Fixed regression which garbled date-time tick labels on axes, if setTickLabelType is ltDateTime and setNumberFormat contains the "b" option #### Version 1.2.0 released on 14.03.14 #### Added features: - Adaptive Sampling for QCPGraph greatly improves performance for high data densities (see QCPGraph::setAdaptiveSampling) - QCPColorMap plottable with QCPColorScale layout element allows plotting of 2D color maps - QCustomPlot::savePdf now has additional optional parameters pdfCreator and pdfTitle to set according PDF metadata fields - QCustomPlot::replot now allows specifying whether the widget update is immediate (repaint) or queued (update) - QCPRange operators +, -, *, / with double operand for range shifting and scaling, and ==, != for range comparison - Layers now have a visibility property (QCPLayer::setVisible) - static functions QCPAxis::opposite and QCPAxis::orientation now offer more convenience when handling axis types - added notification signals for selectability change (selectableChanged) on all objects that have a selected/selectable property - added notification signal for QCPAxis scaleType property - added notification signal QCPLayerable::layerChanged Bugfixes: - Fixed assert halt, when QCPAxis auto tick labels not disabled but nevertheless a custom non-number tick label ending in "e" given - Fixed painting glitches when QCustomPlot resized inside a QMdiArea or under certain conditions inside a QLayout - If changing QCPAxis::scaleType and thus causing range sanitizing and a range modification, rangeChanged wouldn't be emitted - Fixed documentation bug that caused indentation to be lost in code examples Bugfixes after beta: - Fixed bug that caused crash if clicked-on legend item is removed in mousePressEvent. - On some systems, font size defaults to -1, which used to cause a debug output in QCPAxisPainterPrivate::TickLabelDataQCP. Now it's checked before setting values based on the default font size. - When using multiple axes on one side, setting one to invisible didn't properly compress the freed space. - Fixed bug that allowed selection of plottables when clicking in the bottom or top margin of a QCPAxisRect (outside the inner rect) Other: - In method QCPAbstractPlottable::getKeyRange/getValueRange, renamed parameter "validRange" to "foundRange", to better reflect its meaning (and contrast it from QCPRange::validRange) - QCPAxis low-level axis painting methods exported to QCPAxisPainterPrivate #### Version 1.1.1 released on 09.12.13 #### Bugfixes: - Fixed bug causing legends blocking input events from reaching underlying axis rect even if legend is invisible - Added missing Q_PROPERTY for QCPAxis::setDateTimeSpec - Fixed behaviour of QCPAxisRect::setupFullAxesBox (now transfers more properties from bottom/left to top/right axes and sets visibility of bottom/left axes to true) - Made sure PDF export doesn't default to grayscale output on some systems Other: - Plotting hint QCP::phForceRepaint is now enabled on all systems (and not only on windows) by default - Documentation improvements #### Version 1.1.0 released on 04.11.13 #### Added features: - Added QCPRange::expand and QCPRange::expanded - Added QCPAxis::rescale to rescale axis to all associated plottables - Added QCPAxis::setDateTimeSpec/dateTimeSpec to allow axis labels either in UTC or local time - QCPAxis now additionally emits a rangeChanged signal overload that provides the old range as second parameter Bugfixes: - Fixed QCustomPlot::rescaleAxes not rescaling properly if first plottable has an empty range - QCPGraph::rescaleAxes/rescaleKeyAxis/rescaleValueAxis are no longer virtual (never were in base class, was a mistake) - Fixed bugs in QCPAxis::items and QCPAxisRect::items not properly returning associated items and potentially stalling Other: - Internal change from QWeakPointer to QPointer, thus got rid of deprecated Qt functionality - Qt5.1 and Qt5.2 (beta1) compatibility - Release packages now extract to single subdirectory and don't place multiple files in current working directory #### Version 1.0.1 released on 05.09.13 #### Bugfixes: - using define flag QCUSTOMPLOT_CHECK_DATA caused debug output when data was correct, instead of invalid (fixed QCP::isInvalidData) - documentation images are now properly shown when viewed with Qt Assistant - fixed various documentation mistakes Other: - Adapted documentation style sheet to better match Qt5 documentation #### Version 1.0.0 released on 01.08.13 #### Quick Summary: - Layout system for multiple axis rects in one plot - Multiple axes per side - Qt5 compatibility - More flexible and consistent scatter configuration with QCPScatterStyle - Various interface cleanups/refactoring - Pixmap-cached axis labels for improved replot performance Changes that break backward compatibility: - QCustomPlot::axisRect() changed meaning due to the extensive changes to how axes and axis rects are handled it now returns a pointer to a QCPAxisRect and takes an integer index as parameter. - QCPAxis constructor changed to now take QCPAxisRect* as parent - setAutoMargin, setMarginLeft/Right/Top/Bottom removed due to the axis rect changes (see QCPAxisRect::setMargins/setAutoMargins) - setAxisRect removed due to the axis rect changes - setAxisBackground(-Scaled/-ScaledMode) now moved to QCPAxisRect as setBackground(-Scaled/ScaledMode) (access via QCustomPlot::axisRects()) - QCPLegend now is a QCPLayoutElement - QCPAbstractPlottable::drawLegendIcon parameter "rect" changed from QRect to QRectF - QCPAbstractLegendItem::draw second parameter removed (position/size now handled via QCPLayoutElement base class) - removed QCPLegend::setMargin/setMarginLeft/Right/Top/Bottom (now inherits the capability from QCPLayoutElement::setMargins) - removed QCPLegend::setMinimumSize (now inherits the capability from QCPLayoutElement::setMinimumSize) - removed enum QCPLegend::PositionStyle, QCPLegend::positionStyle/setPositionStyle/position/setPosition (replaced by capabilities of QCPLayoutInset) - QCPLegend transformed to work with new layout system (almost everything changed) - removed entire title interface: QCustomPlot::setTitle/setTitleFont/setTitleColor/setTitleSelected/setTitleSelectedFont/setTitleSelectedColor and the QCustomPlot::iSelectTitle interaction flag (all functionality is now given by the layout element "QCPPlotTitle" which can be added to the plot layout) - selectTest functions now take two additional parameters: bool onlySelectable and QVariant *details=0 - selectTest functions now ignores visibility of objects and (if parameter onlySelectable is true) does not anymore ignore selectability of the object - moved QCustomPlot::Interaction/Interactions to QCP namespace as QCP::Interaction/Interactions - moved QCustomPlot::setupFullAxesBox() to QCPAxisRect::setupFullAxesBox. Now also accepts parameter to decide whether to connect opposite axis ranges - moved range dragging/zooming interface from QCustomPlot to QCPAxisRect (setRangeDrag, setRangeZoom, setRangeDragAxes, setRangeZoomAxes,...) - rangeDrag/Zoom is now set to Qt::Horizontal|Qt::Vertical instead of 0 by default, on the other hand, iRangeDrag/Zoom is unset in interactions by default (this makes enabling dragging/zooming easier by just adding the interaction flags) - QCPScatterStyle takes over everything related to handling scatters in all plottables - removed setScatterPen/Size on QCPGraph and QCPCurve, removed setOutlierPen/Size on QCPStatisticalBox (now handled via QCPScatterStyle) - modified setScatterStyle on QCPGraph and QCPCurve, and setOutlierStyle on QCPStatisticalBox, to take QCPScatterStyle - axis grid and subgrid are now reachable via the QCPGrid *QCPAxis::grid() method. (e.g. instead of xAxis->setGrid(true), write xAxis->grid()->setVisible(true)) Added features: - Axis tick labels are now pixmap-cached, thus increasing replot performance (in usual setups by about 24%). See plotting hint phCacheLabels which is set by default - Advanced layout system, including the classes QCPLayoutElement, QCPLayout, QCPLayoutGrid, QCPLayoutInset, QCPAxisRect - QCustomPlot::axisRects() returns all the axis rects in the QCustomPlot. - QCustomPlot::plotLayout() returns the top level layout (initially a QCPLayoutGrid with one QCPAxisRect inside) - QCPAxis now may have an offset to the axis rect (setOffset) - Multiple axes per QCPAxisRect side are now supported (see QCPAxisRect::addAxis) - QCustomPlot::toPixmap renders the plot into a pixmap and returns it - When setting tick label rotation to +90 or -90 degrees on a vertical axis, the labels are now centered vertically on the tick height (This allows space saving vertical tick labels by having the text direction parallel to the axis) - Substantially increased replot performance when using very large manual tick vectors (> 10000 ticks) via QCPAxis::setTickVector - QCPAxis and QCPAxisRect now allow easy access to all plottables(), graphs() and items() that are associated with them - Added QCustomPlot::hasItem method for consistency with plottable interface, hasPlottable - Added QCPAxisRect::setMinimumMargins as replacement for hardcoded minimum axis margin (15 px) when auto margin is enabled - Added Flags type QCPAxis::AxisTypes (from QCPAxis::AxisType), used in QCPAxisRect interface - Automatic margin calculation can now be enabled/disabled on a per-side basis, see QCPAxisRect::setAutoMargins - QCPAxisRect margins of multiple axis rects can be coupled via QCPMarginGroup - Added new default layers "background" and "legend" (QCPAxisRect draws its background on the "background" layer, QCPLegend is on the "legend" layer by default) - Custom scatter style via QCP::ssCustom and respective setCustomScatter functions that take a QPainterPath - Filled scatters via QCPScatterStyle::setBrush Added features after beta: - Added QCustomPlot::toPainter method, to allow rendering with existing painter - QCPItemEllipse now provides a center anchor Bugfixes: - Fixed compile error on ARM - Wrong legend icons were displayed if using pixmaps for scatters that are smaller than the legend icon rect - Fixed clipping inaccuracy for rotated tick labels (were hidden too early, because the non-rotated bounding box was used) - Fixed bug that caused wrong clipping of axis ticks and subticks when the ticks were given manually by QCPAxis::setTickVector - Fixed Qt5 crash when dragging graph out of view (iterator out of bounds in QCPGraph::getVisibleDataBounds) - Fixed QCPItemText not scaling properly when using scaled raster export Bugfixes after beta: - Fixed bug that clipped the rightmost pixel column of tick labels when caching activated (only visible on windows for superscript exponents) - Restored compatibility to Qt4.6 - Restored support for -no-RTTI compilation - Empty manual tick labels are handled more gracefully (no QPainter qDebug messages anymore) - Fixed type ambiguity in QCPLineEnding::draw causing compile error on ARM - Fixed bug of grid layouts not propagating the minimum size from their child elements to the parent layout correctly - Fixed bug of child elements (e.g. axis rects) of inset layouts not properly receiving mouse events Other: - Opened up non-amalgamated project structure to public via git repository #### Version released on 09.06.12 #### Quick Summary: - Items (arrows, text,...) - Layers (easier control over rendering order) - New antialiasing system (Each objects controls own antialiasing with setAntialiased) - Performance Improvements - improved pixel-precise drawing - easier shared library creation/usage Changes that (might) break backward compatibility: - enum QCPGraph::ScatterSymbol was moved to QCP namespace (now QCP::ScatterSymbol). This replace should fix your code: "QCPGraph::ss" -> "QCP::ss" - enum QCustomPlot::AntialiasedElement and flag QCustomPlot::AntialiasedElements was moved to QCP namespace This replace should fix your code: "QCustomPlot::ae" -> "QCP::ae" - the meaning of QCustomPlot::setAntialiasedElements has changed slightly: It is now an override to force elements to be antialiased. If you want to force elements to not be drawn antialiased, use the new setNotAntialiasedElements. If an element is mentioned in neither of those functions, it now controls its antialiasing itself via its "setAntialiased" function(s). (e.g. QCPAxis::setAntialiased(bool), QCPAbstractPlottable::setAntialiased(bool), QCPAbstractPlottable::setAntialiasedScatters(bool), etc.) - QCPAxis::setTickVector and QCPAxis::setTickVectorLabels no longer take a pointer but a const reference of the respective QVector as parameter. (handing over a pointer didn't give any noticeable performance benefits but was inconsistent with the rest of the interface) - Equally QCPAxis::tickVector and QCPAxis::tickVectorLabels don't return by pointer but by value now - QCustomPlot::savePngScaled was removed, its purpose is now included as optional parameter "scale" of savePng. - If you have derived from QCPAbstractPlottable: all selectTest functions now consistently take the argument "const QPointF &pos" which is the test point in pixel coordinates. (the argument there was "double key, double value" in plot coordinates, before). - QCPAbstractPlottable, QCPAxis and QCPLegend now inherit from QCPLayerable - If you have derived from QCPAbstractPlottable: the draw method signature has changed from "draw (..) const" to "draw (..)", i.e. the method is not const anymore. This allows the draw function of your plottable to perform buffering/caching operations, if necessary. Added features: - Item system: QCPAbstractItem, QCPItemAnchor, QCPItemPosition, QCPLineEnding. Allows placing of lines, arrows, text, pixmaps etc. - New Items: QCPItemStraightLine, QCPItemLine, QCPItemCurve, QCPItemEllipse, QCPItemRect, QCPItemPixmap, QCPItemText, QCPItemBracket, QCPItemTracer - QCustomPlot::addItem/itemCount/item/removeItem/selectedItems - signals QCustomPlot::itemClicked/itemDoubleClicked - the QCustomPlot interactions property now includes iSelectItems (for selection of QCPAbstractItem) - QCPLineEnding. Represents the different styles a line/curve can end (e.g. different arrows, circle, square, bar, etc.), see e.g. QCPItemCurve::setHead - Layer system: QCPLayerable, QCPLayer. Allows more sophisticated control over drawing order and a kind of grouping. - QCPAbstractPlottable, QCPAbstractItem, QCPAxis, QCPGrid, QCPLegend are layerables and derive from QCPLayerable - QCustomPlot::addLayer/moveLayer/removeLayer/setCurrentLayer/layer/currentLayer/layerCount - Initially there are three layers: "grid", "main", and "axes". The "main" layer is initially empty and set as current layer, so new plottables/items are put there. - QCustomPlot::viewport now makes the previously inaccessible viewport rect read-only-accessible (needed that for item-interface) - PNG export now allows transparent background by calling QCustomPlot::setColor(Qt::transparent) before savePng - QCPStatisticalBox outlier symbols may now be all scatter symbols, not only hardcoded circles. - perfect precision of scatter symbol/error bar drawing and clipping in both antialiased and non-antialiased mode, by introducing QCPPainter that works around some QPainter bugs/inconveniences. Further, more complex symbols like ssCrossSquare used to look crooked, now they look good. - new antialiasing control system: Each drawing element now has its own "setAntialiased" function to control whether it is drawn antialiased. - QCustomPlot::setAntialiasedElements and QCustomPlot::setNotAntialiasedElements can be used to override the individual settings. - Subclasses of QCPAbstractPlottable can now use the convenience functions like applyFillAntialiasingHint or applyScattersAntialiasingHint to easily make their drawing code comply with the overall antialiasing system. - QCustomPlot::setNoAntialiasingOnDrag allows greatly improved performance and responsiveness by temporarily disabling all antialiasing while the user is dragging axis ranges - QCPGraph can now show scatter symbols at data points and hide its line (see QCPGraph::setScatterStyle, setScatterSize, setScatterPixmap, setLineStyle) - Grid drawing code was sourced out from QCPAxis to QCPGrid. QCPGrid is mainly an internal class and every QCPAxis owns one. The grid interface still works through QCPAxis and hasn't changed. The separation allows the grid to be drawn on a different layer as the axes, such that e.g. a graph can be above the grid but below the axes. - QCustomPlot::hasPlottable(plottable), returns whether the QCustomPlot contains the plottable - QCustomPlot::setPlottingHint/setPlottingHints, plotting hints control details about the plotting quality/speed - export to jpg and bmp added (QCustomPlot::saveJpg/saveBmp), as well as control over compression quality for png and jpg - multi-select-modifier may now be specified with QCustomPlot::setMultiSelectModifier and is not fixed to Ctrl anymore Bugfixes: - fixed QCustomPlot ignores replot after it had size (0,0) even if size becomes valid again - on Windows, a repaint used to be delayed during dragging/zooming of a complex plot, until the drag operation was done. This was fixed, i.e. repaints are forced after a replot() call. See QCP::phForceRepaint and setPlottingHints. - when using the raster paintengine and exporting to scaled PNG, pen widths are now scaled correctly (QPainter bug workaround via QCPPainter) - PDF export now respects QCustomPlot background color (QCustomPlot::setColor), also Qt::transparent - fixed a bug on QCPBars and QCPStatisticalBox where auto-rescaling of axis would fail when all data is very small (< 1e-11) - fixed mouse event propagation bug that prevented range dragging from working on KDE (GNU/Linux) - fixed a compiler warning on 64-bit systems due to pointer cast to int instead of quintptr in a qDebug output Other: - Added support for easier shared library creation (including examples for compiling and using QCustomPlot as shared library) - QCustomPlot now has the Qt::WA_OpaquePaintEvent widget attribute (gives slightly improved performance). - QCP::aeGraphs (enum QCP::AntialiasedElement, previously QCustomPlot::aeGraphs) has been marked deprecated since version 02.02.12 and was now removed. Use QCP::aePlottables instead. - optional performance-quality-tradeoff for solid graph lines (see QCustomPlot::setPlottingHints). - marked data classes and QCPRange as Q_MOVABLE_TYPE - replaced usage of own macro FUNCNAME with Qt macro Q_FUNC_INFO - QCustomPlot now returns a minimum size hint of 50*50 #### Version released on 31.03.12 #### Changes that (might) break backward compatibility: - QCPAbstractLegendItem now inherits from QObject - mousePress, mouseMove and mouseRelease signals are now emitted before and not after any QCustomPlot processing (range dragging, selecting, etc.) Added features: - Interaction system: now allows selecting of objects like plottables, axes, legend and plot title, see QCustomPlot::setInteractions documentation - Interaction system for plottables: - setSelectable, setSelected, setSelectedPen, setSelectedBrush, selectTest on QCPAbstractPlottable and all derived plottables - setSelectionTolerance on QCustomPlot - selectedPlottables and selectedGraphs on QCustomPlot (returns the list of currently selected plottables/graphs) - Interaction system for axes: - setSelectable, setSelected, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, setSelectedLabelFont, setSelectedTickLabelFont, setSelectedLabelColor, setSelectedTickLabelColor, selectTest on QCPAxis - selectedAxes on QCustomPlot (returns a list of the axes that currently have selected parts) - Interaction system for legend: - setSelectable, setSelected, setSelectedBorderPen, setSelectedIconBorderPen, setSelectedBrush, setSelectedFont, setSelectedTextColor, selectedItems on QCPLegend - setSelectedFont, setSelectedTextColor, setSelectable, setSelected on QCPAbstractLegendItem - selectedLegends on QCustomPlot - Interaction system for title: - setSelectedTitleFont, setSelectedTitleColor, setTitleSelected on QCustomPlot - new signals in accordance with the interaction system: - selectionChangedByUser on QCustomPlot - selectionChanged on QCPAbstractPlottable - selectionChanged on QCPAxis - selectionChanged on QCPLegend and QCPAbstractLegendItem - plottableClick, legendClick, axisClick, titleClick, plottableDoubleClick, legendDoubleClick, axisDoubleClick, titleDoubleClick on QCustomPlot - QCustomPlot::deselectAll (deselects everything, i.e. axes and plottables) - QCPAbstractPlottable::pixelsToCoords (inverse function to the already existing coordsToPixels function) - QCPRange::contains(double value) - QCPAxis::setLabelColor and setTickLabelColor - QCustomPlot::setTitleColor - QCustomPlot now emits beforeReplot and afterReplot signals. Note that it is safe to make two customPlots mutually call eachothers replot functions in one of these slots, it will not cause an infinite loop. (usefull for synchronizing axes ranges between two customPlots, because setRange alone doesn't replot) - If the Qt version is 4.7 or greater, the tick label strings in date-time-mode now support sub-second accuracy (e.g. with format like "hh:mm:ss.zzz"). Bugfixes: - tick labels/margins should no longer oscillate by one pixel when dragging range or replotting repeatedly while changing e.g. data. This was caused by a bug in Qt's QFontMetrics::boundingRect function when the font has an integer point size (probably some rounding problem). The fix hence consists of creating a temporary font (only for bounding-box calculation) which is 0.05pt larger and thus avoiding the jittering rounding outcome. - tick label, axis label and plot title colors used to be undefined. This was fixed by providing explicit color properties. Other: - fixed some glitches in the documentation - QCustomPlot::replot and QCustomPlot::rescaleAxes are now slots #### Version released on 02.02.12 #### Changes that break backward compatibility: - renamed all secondary classes from QCustomPlot[...] to QCP[...]: QCustomPlotAxis -> QCPAxis QCustomPlotGraph -> QCPGraph QCustomPlotRange -> QCPRange QCustomPlotData -> QCPData QCustomPlotDataMap -> QCPDataMap QCustomPlotLegend -> QCPLegend QCustomPlotDataMapIterator -> QCPDataMapIterator QCustomPlotDataMutableMapIterator -> QCPDataMutableMapIterator A simple search and replace on all code files should make your code run again, e.g. consider the regex "QCustomPlot(?=[AGRDL])" -> "QCP". Make sure not to just replace "QCustomPlot" with "QCP" because the main class QCustomPlot hasn't changed to QCP. This change was necessary because class names became unhandy, pardon my bad naming decision in the beginning. - QCPAxis::tickLength() and QCPAxis::subTickLength() now each split into two functions for inward and outward ticks (tickLengthIn/tickLengthOut). - QCPLegend now uses QCPAbstractLegendItem to carry item data (before, the legend was passed QCPGraphs directly) - QCustomPlot::addGraph() now doesn't return the index of the created graph anymore, but a pointer to the created QCPGraph. - QCustomPlot::setAutoAddGraphToLegend is replaced by setAutoAddPlottableToLegend Added features: - Reversed axis range with QCPAxis::setRangeReversed(bool) - Tick labels are now only drawn if not clipped by the viewport (widget border) on the sides (e.g. left and right on a horizontal axis). - Zerolines. Like grid lines only with a separate pen (QCPAxis::setZeroLinePen), at tick position zero. - Outward ticks. QCPAxis::setTickLength/setSubTickLength now accepts two arguments for inward and outward tick length. This doesn't break backward compatibility because the second argument (outward) has default value zero and thereby a call with one argument hasn't changed its meaning. - QCPGraph now inherits from QCPAbstractPlottable - QCustomPlot::addPlottable/plottable/removePlottable/clearPlottables added to interface with the new QCPAbstractPlottable-based system. The simpler interface which only acts on QCPGraphs (addGraph, graph, removeGraph, etc.) was adapted internally and is kept for backward compatibility and ease of use. - QCPLegend items for plottables (e.g. graphs) can automatically wrap their texts to fit the widths, see QCPLegend::setMinimumSize and QCPPlottableLegendItem::setTextWrap. - QCustomPlot::rescaleAxes. Adapts axis ranges to show all plottables/graphs, by calling QCPAbstractPlottable::rescaleAxes on all plottables in the plot. - QCPCurve. For plotting of parametric curves. - QCPBars. For plotting of bar charts. - QCPStatisticalBox. For statistical box plots. Bugfixes: - Fixed QCustomPlot::removeGraph(int) not being able to remove graph index 0 - made QCustomPlot::replot() abort painting when painter initialization fails (e.g. because width/height of QCustomPlot is zero) - The distance of the axis label from the axis ignored the tick label padding, this could have caused overlapping axis labels and tick labels - fixed memory leak in QCustomPlot (dtor didn't delete legend) - fixed bug that prevented QCPAxis::setRangeLower/Upper from setting the value to exactly 0. Other: - Changed default error bar handle size (QCustomPlotGraph::setErrorBarSize) from 4 to 6. - Removed QCustomPlotDataFetcher. Was deprecated and not used class. - Extended documentation, especially class descriptions. #### Version released on 15.01.12 #### Changes that (might) break backward compatibility: - QCustomPlotGraph now inherits from QObject Added features: - Added axis background pixmap (QCustomPlot::setAxisBackground, setAxisBackgroundScaled, setAxisBackgroundScaledMode) - Added width and height parameter on PDF export function QCustomPlot::savePdf(). This now allows PDF export to have arbitrary dimensions, independent of the current geometry of the QCustomPlot. - Added overload of QCustomPlot::removeGraph that takes QCustomPlotGraph* as parameter, instead the index of the graph - Added all enums to the Qt meta system via Q_ENUMS(). The enums can now be transformed to QString values easily with the Qt meta system, which makes saving state e.g. as XML significantly nicer. - added typedef QMapIterator QCustomPlotDataMapIterator and typedef QMutableMapIterator QCustomPlotDataMutableMapIterator for improved information hiding, when using iterators outside QCustomPlot code Bugfixes: - Fixed savePngScaled. Axis/label drawing functions used to reset the painter transform and thereby break savePngScaled. Now they buffer the current transform and restore it afterwards. - Fixed some glitches in the doxygen comments (affects documentation only) Other: - Changed the default tickLabelPadding of top axis from 3 to 6 pixels. Looks better. - Changed the default QCustomPlot::setAntialiasedElements setting: Graph fills are now antialiased by default. That's a bit slower, but makes fill borders look better. #### Version released on 19.11.11 #### Changes that break backward compatibility: - QCustomPlotAxis: tickFont and setTickFont renamed to tickLabelFont and setTickLabelFont (for naming consistency) Other: - QCustomPlotAxis: Added rotated tick labels, see setTickLabelRotation qcustomplot-2.1.0+dfsg1/qcustomplot.h0000644000175000017500000113334514030601016017576 0ustar rusconirusconi/*************************************************************************** ** ** ** QCustomPlot, an easy to use, modern plotting widget for Qt ** ** Copyright (C) 2011-2021 Emanuel Eichhammer ** ** ** ** This program is free software: you can redistribute it and/or modify ** ** it under the terms of the GNU General Public License as published by ** ** the Free Software Foundation, either version 3 of the License, or ** ** (at your option) any later version. ** ** ** ** This program is distributed in the hope that it will be useful, ** ** but WITHOUT ANY WARRANTY; without even the implied warranty of ** ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ** ** GNU General Public License for more details. ** ** ** ** You should have received a copy of the GNU General Public License ** ** along with this program. If not, see http://www.gnu.org/licenses/. ** ** ** **************************************************************************** ** Author: Emanuel Eichhammer ** ** Website/Contact: http://www.qcustomplot.com/ ** ** Date: 29.03.21 ** ** Version: 2.1.0 ** ****************************************************************************/ #ifndef QCUSTOMPLOT_H #define QCUSTOMPLOT_H #include // some Qt version/configuration dependent macros to include or exclude certain code paths: #ifdef QCUSTOMPLOT_USE_OPENGL # if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) # define QCP_OPENGL_PBUFFER # else # define QCP_OPENGL_FBO # endif # if QT_VERSION >= QT_VERSION_CHECK(5, 3, 0) # define QCP_OPENGL_OFFSCREENSURFACE # endif #endif #if QT_VERSION >= QT_VERSION_CHECK(5, 4, 0) # define QCP_DEVICEPIXELRATIO_SUPPORTED # if QT_VERSION >= QT_VERSION_CHECK(5, 6, 0) # define QCP_DEVICEPIXELRATIO_FLOAT # endif #endif #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef QCP_OPENGL_FBO # include # if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) # include # else # include # include # endif # ifdef QCP_OPENGL_OFFSCREENSURFACE # include # else # include # endif #endif #ifdef QCP_OPENGL_PBUFFER # include #endif #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) # include # include # include # include #else # include # include # include #endif #if QT_VERSION >= QT_VERSION_CHECK(4, 8, 0) # include #endif # if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) # include #endif class QCPPainter; class QCustomPlot; class QCPLayerable; class QCPLayoutElement; class QCPLayout; class QCPAxis; class QCPAxisRect; class QCPAxisPainterPrivate; class QCPAbstractPlottable; class QCPGraph; class QCPAbstractItem; class QCPPlottableInterface1D; class QCPLegend; class QCPItemPosition; class QCPLayer; class QCPAbstractLegendItem; class QCPSelectionRect; class QCPColorMap; class QCPColorScale; class QCPBars; class QCPPolarAxisRadial; class QCPPolarAxisAngular; class QCPPolarGrid; class QCPPolarGraph; /* including file 'src/global.h' */ /* modified 2021-03-29T02:30:44, size 16981 */ #define QCUSTOMPLOT_VERSION_STR "2.1.0" #define QCUSTOMPLOT_VERSION 0x020100 // decl definitions for shared library compilation/usage: #if defined(QT_STATIC_BUILD) # define QCP_LIB_DECL #elif defined(QCUSTOMPLOT_COMPILE_LIBRARY) # define QCP_LIB_DECL Q_DECL_EXPORT #elif defined(QCUSTOMPLOT_USE_LIBRARY) # define QCP_LIB_DECL Q_DECL_IMPORT #else # define QCP_LIB_DECL #endif // define empty macro for Q_DECL_OVERRIDE if it doesn't exist (Qt < 5) #ifndef Q_DECL_OVERRIDE # define Q_DECL_OVERRIDE #endif /*! The QCP Namespace contains general enums, QFlags and functions used throughout the QCustomPlot library. It provides QMetaObject-based reflection of its enums and flags via \a QCP::staticMetaObject. */ #ifndef Q_MOC_RUN namespace QCP { #else class QCP { // when in moc-run, make it look like a class, so we get Q_GADGET, Q_ENUMS/Q_FLAGS features in namespace Q_GADGET Q_ENUMS(ExportPen) Q_ENUMS(ResolutionUnit) Q_ENUMS(SignDomain) Q_ENUMS(MarginSide) Q_FLAGS(MarginSides) Q_ENUMS(AntialiasedElement) Q_FLAGS(AntialiasedElements) Q_ENUMS(PlottingHint) Q_FLAGS(PlottingHints) Q_ENUMS(Interaction) Q_FLAGS(Interactions) Q_ENUMS(SelectionRectMode) Q_ENUMS(SelectionType) public: #endif /*! Defines the different units in which the image resolution can be specified in the export functions. \see QCustomPlot::savePng, QCustomPlot::saveJpg, QCustomPlot::saveBmp, QCustomPlot::saveRastered */ enum ResolutionUnit { ruDotsPerMeter ///< Resolution is given in dots per meter (dpm) ,ruDotsPerCentimeter ///< Resolution is given in dots per centimeter (dpcm) ,ruDotsPerInch ///< Resolution is given in dots per inch (DPI/PPI) }; /*! Defines how cosmetic pens (pens with numerical width 0) are handled during export. \see QCustomPlot::savePdf */ enum ExportPen { epNoCosmetic ///< Cosmetic pens are converted to pens with pixel width 1 when exporting ,epAllowCosmetic ///< Cosmetic pens are exported normally (e.g. in PDF exports, cosmetic pens always appear as 1 pixel on screen, independent of viewer zoom level) }; /*! Represents negative and positive sign domain, e.g. for passing to \ref QCPAbstractPlottable::getKeyRange and \ref QCPAbstractPlottable::getValueRange. This is primarily needed when working with logarithmic axis scales, since only one of the sign domains can be visible at a time. */ enum SignDomain { sdNegative ///< The negative sign domain, i.e. numbers smaller than zero ,sdBoth ///< Both sign domains, including zero, i.e. all numbers ,sdPositive ///< The positive sign domain, i.e. numbers greater than zero }; /*! Defines the sides of a rectangular entity to which margins can be applied. \see QCPLayoutElement::setAutoMargins, QCPAxisRect::setAutoMargins */ enum MarginSide { msLeft = 0x01 ///< 0x01 left margin ,msRight = 0x02 ///< 0x02 right margin ,msTop = 0x04 ///< 0x04 top margin ,msBottom = 0x08 ///< 0x08 bottom margin ,msAll = 0xFF ///< 0xFF all margins ,msNone = 0x00 ///< 0x00 no margin }; Q_DECLARE_FLAGS(MarginSides, MarginSide) /*! Defines what objects of a plot can be forcibly drawn antialiased/not antialiased. If an object is neither forcibly drawn antialiased nor forcibly drawn not antialiased, it is up to the respective element how it is drawn. Typically it provides a \a setAntialiased function for this. \c AntialiasedElements is a flag of or-combined elements of this enum type. \see QCustomPlot::setAntialiasedElements, QCustomPlot::setNotAntialiasedElements */ enum AntialiasedElement { aeAxes = 0x0001 ///< 0x0001 Axis base line and tick marks ,aeGrid = 0x0002 ///< 0x0002 Grid lines ,aeSubGrid = 0x0004 ///< 0x0004 Sub grid lines ,aeLegend = 0x0008 ///< 0x0008 Legend box ,aeLegendItems = 0x0010 ///< 0x0010 Legend items ,aePlottables = 0x0020 ///< 0x0020 Main lines of plottables ,aeItems = 0x0040 ///< 0x0040 Main lines of items ,aeScatters = 0x0080 ///< 0x0080 Scatter symbols of plottables (excluding scatter symbols of type ssPixmap) ,aeFills = 0x0100 ///< 0x0100 Borders of fills (e.g. under or between graphs) ,aeZeroLine = 0x0200 ///< 0x0200 Zero-lines, see \ref QCPGrid::setZeroLinePen ,aeOther = 0x8000 ///< 0x8000 Other elements that don't fit into any of the existing categories ,aeAll = 0xFFFF ///< 0xFFFF All elements ,aeNone = 0x0000 ///< 0x0000 No elements }; Q_DECLARE_FLAGS(AntialiasedElements, AntialiasedElement) /*! Defines plotting hints that control various aspects of the quality and speed of plotting. \see QCustomPlot::setPlottingHints */ enum PlottingHint { phNone = 0x000 ///< 0x000 No hints are set ,phFastPolylines = 0x001 ///< 0x001 Graph/Curve lines are drawn with a faster method. This reduces the quality especially of the line segment ///< joins, thus is most effective for pen sizes larger than 1. It is only used for solid line pens. ,phImmediateRefresh = 0x002 ///< 0x002 causes an immediate repaint() instead of a soft update() when QCustomPlot::replot() is called with parameter \ref QCustomPlot::rpRefreshHint. ///< This is set by default to prevent the plot from freezing on fast consecutive replots (e.g. user drags ranges with mouse). ,phCacheLabels = 0x004 ///< 0x004 axis (tick) labels will be cached as pixmaps, increasing replot performance. }; Q_DECLARE_FLAGS(PlottingHints, PlottingHint) /*! Defines the mouse interactions possible with QCustomPlot. \c Interactions is a flag of or-combined elements of this enum type. \see QCustomPlot::setInteractions */ enum Interaction { iNone = 0x000 ///< 0x000 None of the interactions are possible ,iRangeDrag = 0x001 ///< 0x001 Axis ranges are draggable (see \ref QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeDragAxes) ,iRangeZoom = 0x002 ///< 0x002 Axis ranges are zoomable with the mouse wheel (see \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeZoomAxes) ,iMultiSelect = 0x004 ///< 0x004 The user can select multiple objects by holding the modifier set by \ref QCustomPlot::setMultiSelectModifier while clicking ,iSelectPlottables = 0x008 ///< 0x008 Plottables are selectable (e.g. graphs, curves, bars,... see QCPAbstractPlottable) ,iSelectAxes = 0x010 ///< 0x010 Axes are selectable (or parts of them, see QCPAxis::setSelectableParts) ,iSelectLegend = 0x020 ///< 0x020 Legends are selectable (or their child items, see QCPLegend::setSelectableParts) ,iSelectItems = 0x040 ///< 0x040 Items are selectable (Rectangles, Arrows, Textitems, etc. see \ref QCPAbstractItem) ,iSelectOther = 0x080 ///< 0x080 All other objects are selectable (e.g. your own derived layerables, other layout elements,...) ,iSelectPlottablesBeyondAxisRect = 0x100 ///< 0x100 When performing plottable selection/hit tests, this flag extends the sensitive area beyond the axis rect }; Q_DECLARE_FLAGS(Interactions, Interaction) /*! Defines the behaviour of the selection rect. \see QCustomPlot::setSelectionRectMode, QCustomPlot::selectionRect, QCPSelectionRect */ enum SelectionRectMode { srmNone ///< The selection rect is disabled, and all mouse events are forwarded to the underlying objects, e.g. for axis range dragging ,srmZoom ///< When dragging the mouse, a selection rect becomes active. Upon releasing, the axes that are currently set as range zoom axes (\ref QCPAxisRect::setRangeZoomAxes) will have their ranges zoomed accordingly. ,srmSelect ///< When dragging the mouse, a selection rect becomes active. Upon releasing, plottable data points that were within the selection rect are selected, if the plottable's selectability setting permits. (See \ref dataselection "data selection mechanism" for details.) ,srmCustom ///< When dragging the mouse, a selection rect becomes active. It is the programmer's responsibility to connect according slots to the selection rect's signals (e.g. \ref QCPSelectionRect::accepted) in order to process the user interaction. }; /*! Defines the different ways a plottable can be selected. These images show the effect of the different selection types, when the indicated selection rect was dragged:
\image html selectiontype-none.png stNone \image html selectiontype-whole.png stWhole \image html selectiontype-singledata.png stSingleData \image html selectiontype-datarange.png stDataRange \image html selectiontype-multipledataranges.png stMultipleDataRanges
\see QCPAbstractPlottable::setSelectable, QCPDataSelection::enforceType */ enum SelectionType { stNone ///< The plottable is not selectable ,stWhole ///< Selection behaves like \ref stMultipleDataRanges, but if there are any data points selected, the entire plottable is drawn as selected. ,stSingleData ///< One individual data point can be selected at a time ,stDataRange ///< Multiple contiguous data points (a data range) can be selected ,stMultipleDataRanges ///< Any combination of data points/ranges can be selected }; /*! \internal Returns whether the specified \a value is considered an invalid data value for plottables (i.e. is \e nan or \e +/-inf). This function is used to check data validity upon replots, when the compiler flag \c QCUSTOMPLOT_CHECK_DATA is set. */ inline bool isInvalidData(double value) { return qIsNaN(value) || qIsInf(value); } /*! \internal \overload Checks two arguments instead of one. */ inline bool isInvalidData(double value1, double value2) { return isInvalidData(value1) || isInvalidData(value2); } /*! \internal Sets the specified \a side of \a margins to \a value \see getMarginValue */ inline void setMarginValue(QMargins &margins, QCP::MarginSide side, int value) { switch (side) { case QCP::msLeft: margins.setLeft(value); break; case QCP::msRight: margins.setRight(value); break; case QCP::msTop: margins.setTop(value); break; case QCP::msBottom: margins.setBottom(value); break; case QCP::msAll: margins = QMargins(value, value, value, value); break; default: break; } } /*! \internal Returns the value of the specified \a side of \a margins. If \a side is \ref QCP::msNone or \ref QCP::msAll, returns 0. \see setMarginValue */ inline int getMarginValue(const QMargins &margins, QCP::MarginSide side) { switch (side) { case QCP::msLeft: return margins.left(); case QCP::msRight: return margins.right(); case QCP::msTop: return margins.top(); case QCP::msBottom: return margins.bottom(); default: break; } return 0; } extern const QMetaObject staticMetaObject; // in moc-run we create a static meta object for QCP "fake" object. This line is the link to it via QCP::staticMetaObject in normal operation as namespace } // end of namespace QCP Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::AntialiasedElements) Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::PlottingHints) Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::MarginSides) Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::Interactions) Q_DECLARE_METATYPE(QCP::ExportPen) Q_DECLARE_METATYPE(QCP::ResolutionUnit) Q_DECLARE_METATYPE(QCP::SignDomain) Q_DECLARE_METATYPE(QCP::MarginSide) Q_DECLARE_METATYPE(QCP::AntialiasedElement) Q_DECLARE_METATYPE(QCP::PlottingHint) Q_DECLARE_METATYPE(QCP::Interaction) Q_DECLARE_METATYPE(QCP::SelectionRectMode) Q_DECLARE_METATYPE(QCP::SelectionType) /* end of 'src/global.h' */ /* including file 'src/vector2d.h' */ /* modified 2021-03-29T02:30:44, size 4988 */ class QCP_LIB_DECL QCPVector2D { public: QCPVector2D(); QCPVector2D(double x, double y); QCPVector2D(const QPoint &point); QCPVector2D(const QPointF &point); // getters: double x() const { return mX; } double y() const { return mY; } double &rx() { return mX; } double &ry() { return mY; } // setters: void setX(double x) { mX = x; } void setY(double y) { mY = y; } // non-virtual methods: double length() const { return qSqrt(mX*mX+mY*mY); } double lengthSquared() const { return mX*mX+mY*mY; } double angle() const { return qAtan2(mY, mX); } QPoint toPoint() const { return QPoint(int(mX), int(mY)); } QPointF toPointF() const { return QPointF(mX, mY); } bool isNull() const { return qIsNull(mX) && qIsNull(mY); } void normalize(); QCPVector2D normalized() const; QCPVector2D perpendicular() const { return QCPVector2D(-mY, mX); } double dot(const QCPVector2D &vec) const { return mX*vec.mX+mY*vec.mY; } double distanceSquaredToLine(const QCPVector2D &start, const QCPVector2D &end) const; double distanceSquaredToLine(const QLineF &line) const; double distanceToStraightLine(const QCPVector2D &base, const QCPVector2D &direction) const; QCPVector2D &operator*=(double factor); QCPVector2D &operator/=(double divisor); QCPVector2D &operator+=(const QCPVector2D &vector); QCPVector2D &operator-=(const QCPVector2D &vector); private: // property members: double mX, mY; friend inline const QCPVector2D operator*(double factor, const QCPVector2D &vec); friend inline const QCPVector2D operator*(const QCPVector2D &vec, double factor); friend inline const QCPVector2D operator/(const QCPVector2D &vec, double divisor); friend inline const QCPVector2D operator+(const QCPVector2D &vec1, const QCPVector2D &vec2); friend inline const QCPVector2D operator-(const QCPVector2D &vec1, const QCPVector2D &vec2); friend inline const QCPVector2D operator-(const QCPVector2D &vec); }; Q_DECLARE_TYPEINFO(QCPVector2D, Q_MOVABLE_TYPE); inline const QCPVector2D operator*(double factor, const QCPVector2D &vec) { return QCPVector2D(vec.mX*factor, vec.mY*factor); } inline const QCPVector2D operator*(const QCPVector2D &vec, double factor) { return QCPVector2D(vec.mX*factor, vec.mY*factor); } inline const QCPVector2D operator/(const QCPVector2D &vec, double divisor) { return QCPVector2D(vec.mX/divisor, vec.mY/divisor); } inline const QCPVector2D operator+(const QCPVector2D &vec1, const QCPVector2D &vec2) { return QCPVector2D(vec1.mX+vec2.mX, vec1.mY+vec2.mY); } inline const QCPVector2D operator-(const QCPVector2D &vec1, const QCPVector2D &vec2) { return QCPVector2D(vec1.mX-vec2.mX, vec1.mY-vec2.mY); } inline const QCPVector2D operator-(const QCPVector2D &vec) { return QCPVector2D(-vec.mX, -vec.mY); } /*! \relates QCPVector2D Prints \a vec in a human readable format to the qDebug output. */ inline QDebug operator<< (QDebug d, const QCPVector2D &vec) { d.nospace() << "QCPVector2D(" << vec.x() << ", " << vec.y() << ")"; return d.space(); } /* end of 'src/vector2d.h' */ /* including file 'src/painter.h' */ /* modified 2021-03-29T02:30:44, size 4035 */ class QCP_LIB_DECL QCPPainter : public QPainter { Q_GADGET public: /*! Defines special modes the painter can operate in. They disable or enable certain subsets of features/fixes/workarounds, depending on whether they are wanted on the respective output device. */ enum PainterMode { pmDefault = 0x00 ///< 0x00 Default mode for painting on screen devices ,pmVectorized = 0x01 ///< 0x01 Mode for vectorized painting (e.g. PDF export). For example, this prevents some antialiasing fixes. ,pmNoCaching = 0x02 ///< 0x02 Mode for all sorts of exports (e.g. PNG, PDF,...). For example, this prevents using cached pixmap labels ,pmNonCosmetic = 0x04 ///< 0x04 Turns pen widths 0 to 1, i.e. disables cosmetic pens. (A cosmetic pen is always drawn with width 1 pixel in the vector image/pdf viewer, independent of zoom.) }; Q_ENUMS(PainterMode) Q_FLAGS(PainterModes) Q_DECLARE_FLAGS(PainterModes, PainterMode) QCPPainter(); explicit QCPPainter(QPaintDevice *device); // getters: bool antialiasing() const { return testRenderHint(QPainter::Antialiasing); } PainterModes modes() const { return mModes; } // setters: void setAntialiasing(bool enabled); void setMode(PainterMode mode, bool enabled=true); void setModes(PainterModes modes); // methods hiding non-virtual base class functions (QPainter bug workarounds): bool begin(QPaintDevice *device); void setPen(const QPen &pen); void setPen(const QColor &color); void setPen(Qt::PenStyle penStyle); void drawLine(const QLineF &line); void drawLine(const QPointF &p1, const QPointF &p2) {drawLine(QLineF(p1, p2));} void save(); void restore(); // non-virtual methods: void makeNonCosmetic(); protected: // property members: PainterModes mModes; bool mIsAntialiasing; // non-property members: QStack mAntialiasingStack; }; Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPainter::PainterModes) Q_DECLARE_METATYPE(QCPPainter::PainterMode) /* end of 'src/painter.h' */ /* including file 'src/paintbuffer.h' */ /* modified 2021-03-29T02:30:44, size 5006 */ class QCP_LIB_DECL QCPAbstractPaintBuffer { public: explicit QCPAbstractPaintBuffer(const QSize &size, double devicePixelRatio); virtual ~QCPAbstractPaintBuffer(); // getters: QSize size() const { return mSize; } bool invalidated() const { return mInvalidated; } double devicePixelRatio() const { return mDevicePixelRatio; } // setters: void setSize(const QSize &size); void setInvalidated(bool invalidated=true); void setDevicePixelRatio(double ratio); // introduced virtual methods: virtual QCPPainter *startPainting() = 0; virtual void donePainting() {} virtual void draw(QCPPainter *painter) const = 0; virtual void clear(const QColor &color) = 0; protected: // property members: QSize mSize; double mDevicePixelRatio; // non-property members: bool mInvalidated; // introduced virtual methods: virtual void reallocateBuffer() = 0; }; class QCP_LIB_DECL QCPPaintBufferPixmap : public QCPAbstractPaintBuffer { public: explicit QCPPaintBufferPixmap(const QSize &size, double devicePixelRatio); virtual ~QCPPaintBufferPixmap() Q_DECL_OVERRIDE; // reimplemented virtual methods: virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; void clear(const QColor &color) Q_DECL_OVERRIDE; protected: // non-property members: QPixmap mBuffer; // reimplemented virtual methods: virtual void reallocateBuffer() Q_DECL_OVERRIDE; }; #ifdef QCP_OPENGL_PBUFFER class QCP_LIB_DECL QCPPaintBufferGlPbuffer : public QCPAbstractPaintBuffer { public: explicit QCPPaintBufferGlPbuffer(const QSize &size, double devicePixelRatio, int multisamples); virtual ~QCPPaintBufferGlPbuffer() Q_DECL_OVERRIDE; // reimplemented virtual methods: virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; void clear(const QColor &color) Q_DECL_OVERRIDE; protected: // non-property members: QGLPixelBuffer *mGlPBuffer; int mMultisamples; // reimplemented virtual methods: virtual void reallocateBuffer() Q_DECL_OVERRIDE; }; #endif // QCP_OPENGL_PBUFFER #ifdef QCP_OPENGL_FBO class QCP_LIB_DECL QCPPaintBufferGlFbo : public QCPAbstractPaintBuffer { public: explicit QCPPaintBufferGlFbo(const QSize &size, double devicePixelRatio, QWeakPointer glContext, QWeakPointer glPaintDevice); virtual ~QCPPaintBufferGlFbo() Q_DECL_OVERRIDE; // reimplemented virtual methods: virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; virtual void donePainting() Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; void clear(const QColor &color) Q_DECL_OVERRIDE; protected: // non-property members: QWeakPointer mGlContext; QWeakPointer mGlPaintDevice; QOpenGLFramebufferObject *mGlFrameBuffer; // reimplemented virtual methods: virtual void reallocateBuffer() Q_DECL_OVERRIDE; }; #endif // QCP_OPENGL_FBO /* end of 'src/paintbuffer.h' */ /* including file 'src/layer.h' */ /* modified 2021-03-29T02:30:44, size 7038 */ class QCP_LIB_DECL QCPLayer : public QObject { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QCustomPlot* parentPlot READ parentPlot) Q_PROPERTY(QString name READ name) Q_PROPERTY(int index READ index) Q_PROPERTY(QList children READ children) Q_PROPERTY(bool visible READ visible WRITE setVisible) Q_PROPERTY(LayerMode mode READ mode WRITE setMode) /// \endcond public: /*! Defines the different rendering modes of a layer. Depending on the mode, certain layers can be replotted individually, without the need to replot (possibly complex) layerables on other layers. \see setMode */ enum LayerMode { lmLogical ///< Layer is used only for rendering order, and shares paint buffer with all other adjacent logical layers. ,lmBuffered ///< Layer has its own paint buffer and may be replotted individually (see \ref replot). }; Q_ENUMS(LayerMode) QCPLayer(QCustomPlot* parentPlot, const QString &layerName); virtual ~QCPLayer(); // getters: QCustomPlot *parentPlot() const { return mParentPlot; } QString name() const { return mName; } int index() const { return mIndex; } QList children() const { return mChildren; } bool visible() const { return mVisible; } LayerMode mode() const { return mMode; } // setters: void setVisible(bool visible); void setMode(LayerMode mode); // non-virtual methods: void replot(); protected: // property members: QCustomPlot *mParentPlot; QString mName; int mIndex; QList mChildren; bool mVisible; LayerMode mMode; // non-property members: QWeakPointer mPaintBuffer; // non-virtual methods: void draw(QCPPainter *painter); void drawToPaintBuffer(); void addChild(QCPLayerable *layerable, bool prepend); void removeChild(QCPLayerable *layerable); private: Q_DISABLE_COPY(QCPLayer) friend class QCustomPlot; friend class QCPLayerable; }; Q_DECLARE_METATYPE(QCPLayer::LayerMode) class QCP_LIB_DECL QCPLayerable : public QObject { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(bool visible READ visible WRITE setVisible) Q_PROPERTY(QCustomPlot* parentPlot READ parentPlot) Q_PROPERTY(QCPLayerable* parentLayerable READ parentLayerable) Q_PROPERTY(QCPLayer* layer READ layer WRITE setLayer NOTIFY layerChanged) Q_PROPERTY(bool antialiased READ antialiased WRITE setAntialiased) /// \endcond public: QCPLayerable(QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=nullptr); virtual ~QCPLayerable(); // getters: bool visible() const { return mVisible; } QCustomPlot *parentPlot() const { return mParentPlot; } QCPLayerable *parentLayerable() const { return mParentLayerable.data(); } QCPLayer *layer() const { return mLayer; } bool antialiased() const { return mAntialiased; } // setters: void setVisible(bool on); Q_SLOT bool setLayer(QCPLayer *layer); bool setLayer(const QString &layerName); void setAntialiased(bool enabled); // introduced virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const; // non-property methods: bool realVisibility() const; signals: void layerChanged(QCPLayer *newLayer); protected: // property members: bool mVisible; QCustomPlot *mParentPlot; QPointer mParentLayerable; QCPLayer *mLayer; bool mAntialiased; // introduced virtual methods: virtual void parentPlotInitialized(QCustomPlot *parentPlot); virtual QCP::Interaction selectionCategory() const; virtual QRect clipRect() const; virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const = 0; virtual void draw(QCPPainter *painter) = 0; // selection events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged); virtual void deselectEvent(bool *selectionStateChanged); // low-level mouse events: virtual void mousePressEvent(QMouseEvent *event, const QVariant &details); virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos); virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos); virtual void mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details); virtual void wheelEvent(QWheelEvent *event); // non-property methods: void initializeParentPlot(QCustomPlot *parentPlot); void setParentLayerable(QCPLayerable* parentLayerable); bool moveToLayer(QCPLayer *layer, bool prepend); void applyAntialiasingHint(QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const; private: Q_DISABLE_COPY(QCPLayerable) friend class QCustomPlot; friend class QCPLayer; friend class QCPAxisRect; }; /* end of 'src/layer.h' */ /* including file 'src/axis/range.h' */ /* modified 2021-03-29T02:30:44, size 5280 */ class QCP_LIB_DECL QCPRange { public: double lower, upper; QCPRange(); QCPRange(double lower, double upper); bool operator==(const QCPRange& other) const { return lower == other.lower && upper == other.upper; } bool operator!=(const QCPRange& other) const { return !(*this == other); } QCPRange &operator+=(const double& value) { lower+=value; upper+=value; return *this; } QCPRange &operator-=(const double& value) { lower-=value; upper-=value; return *this; } QCPRange &operator*=(const double& value) { lower*=value; upper*=value; return *this; } QCPRange &operator/=(const double& value) { lower/=value; upper/=value; return *this; } friend inline const QCPRange operator+(const QCPRange&, double); friend inline const QCPRange operator+(double, const QCPRange&); friend inline const QCPRange operator-(const QCPRange& range, double value); friend inline const QCPRange operator*(const QCPRange& range, double value); friend inline const QCPRange operator*(double value, const QCPRange& range); friend inline const QCPRange operator/(const QCPRange& range, double value); double size() const { return upper-lower; } double center() const { return (upper+lower)*0.5; } void normalize() { if (lower > upper) qSwap(lower, upper); } void expand(const QCPRange &otherRange); void expand(double includeCoord); QCPRange expanded(const QCPRange &otherRange) const; QCPRange expanded(double includeCoord) const; QCPRange bounded(double lowerBound, double upperBound) const; QCPRange sanitizedForLogScale() const; QCPRange sanitizedForLinScale() const; bool contains(double value) const { return value >= lower && value <= upper; } static bool validRange(double lower, double upper); static bool validRange(const QCPRange &range); static const double minRange; static const double maxRange; }; Q_DECLARE_TYPEINFO(QCPRange, Q_MOVABLE_TYPE); /*! \relates QCPRange Prints \a range in a human readable format to the qDebug output. */ inline QDebug operator<< (QDebug d, const QCPRange &range) { d.nospace() << "QCPRange(" << range.lower << ", " << range.upper << ")"; return d.space(); } /*! Adds \a value to both boundaries of the range. */ inline const QCPRange operator+(const QCPRange& range, double value) { QCPRange result(range); result += value; return result; } /*! Adds \a value to both boundaries of the range. */ inline const QCPRange operator+(double value, const QCPRange& range) { QCPRange result(range); result += value; return result; } /*! Subtracts \a value from both boundaries of the range. */ inline const QCPRange operator-(const QCPRange& range, double value) { QCPRange result(range); result -= value; return result; } /*! Multiplies both boundaries of the range by \a value. */ inline const QCPRange operator*(const QCPRange& range, double value) { QCPRange result(range); result *= value; return result; } /*! Multiplies both boundaries of the range by \a value. */ inline const QCPRange operator*(double value, const QCPRange& range) { QCPRange result(range); result *= value; return result; } /*! Divides both boundaries of the range by \a value. */ inline const QCPRange operator/(const QCPRange& range, double value) { QCPRange result(range); result /= value; return result; } /* end of 'src/axis/range.h' */ /* including file 'src/selection.h' */ /* modified 2021-03-29T02:30:44, size 8569 */ class QCP_LIB_DECL QCPDataRange { public: QCPDataRange(); QCPDataRange(int begin, int end); bool operator==(const QCPDataRange& other) const { return mBegin == other.mBegin && mEnd == other.mEnd; } bool operator!=(const QCPDataRange& other) const { return !(*this == other); } // getters: int begin() const { return mBegin; } int end() const { return mEnd; } int size() const { return mEnd-mBegin; } int length() const { return size(); } // setters: void setBegin(int begin) { mBegin = begin; } void setEnd(int end) { mEnd = end; } // non-property methods: bool isValid() const { return (mEnd >= mBegin) && (mBegin >= 0); } bool isEmpty() const { return length() == 0; } QCPDataRange bounded(const QCPDataRange &other) const; QCPDataRange expanded(const QCPDataRange &other) const; QCPDataRange intersection(const QCPDataRange &other) const; QCPDataRange adjusted(int changeBegin, int changeEnd) const { return QCPDataRange(mBegin+changeBegin, mEnd+changeEnd); } bool intersects(const QCPDataRange &other) const; bool contains(const QCPDataRange &other) const; private: // property members: int mBegin, mEnd; }; Q_DECLARE_TYPEINFO(QCPDataRange, Q_MOVABLE_TYPE); class QCP_LIB_DECL QCPDataSelection { public: explicit QCPDataSelection(); explicit QCPDataSelection(const QCPDataRange &range); bool operator==(const QCPDataSelection& other) const; bool operator!=(const QCPDataSelection& other) const { return !(*this == other); } QCPDataSelection &operator+=(const QCPDataSelection& other); QCPDataSelection &operator+=(const QCPDataRange& other); QCPDataSelection &operator-=(const QCPDataSelection& other); QCPDataSelection &operator-=(const QCPDataRange& other); friend inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataSelection& b); friend inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataSelection& b); friend inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataRange& b); friend inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataRange& b); friend inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataSelection& b); friend inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataSelection& b); friend inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataRange& b); friend inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataRange& b); // getters: int dataRangeCount() const { return mDataRanges.size(); } int dataPointCount() const; QCPDataRange dataRange(int index=0) const; QList dataRanges() const { return mDataRanges; } QCPDataRange span() const; // non-property methods: void addDataRange(const QCPDataRange &dataRange, bool simplify=true); void clear(); bool isEmpty() const { return mDataRanges.isEmpty(); } void simplify(); void enforceType(QCP::SelectionType type); bool contains(const QCPDataSelection &other) const; QCPDataSelection intersection(const QCPDataRange &other) const; QCPDataSelection intersection(const QCPDataSelection &other) const; QCPDataSelection inverse(const QCPDataRange &outerRange) const; private: // property members: QList mDataRanges; inline static bool lessThanDataRangeBegin(const QCPDataRange &a, const QCPDataRange &b) { return a.begin() < b.begin(); } }; Q_DECLARE_METATYPE(QCPDataSelection) /*! Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). */ inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataSelection& b) { QCPDataSelection result(a); result += b; return result; } /*! Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). */ inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataSelection& b) { QCPDataSelection result(a); result += b; return result; } /*! Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). */ inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataRange& b) { QCPDataSelection result(a); result += b; return result; } /*! Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). */ inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataRange& b) { QCPDataSelection result(a); result += b; return result; } /*! Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. */ inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataSelection& b) { QCPDataSelection result(a); result -= b; return result; } /*! Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. */ inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataSelection& b) { QCPDataSelection result(a); result -= b; return result; } /*! Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. */ inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataRange& b) { QCPDataSelection result(a); result -= b; return result; } /*! Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. */ inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataRange& b) { QCPDataSelection result(a); result -= b; return result; } /*! \relates QCPDataRange Prints \a dataRange in a human readable format to the qDebug output. */ inline QDebug operator<< (QDebug d, const QCPDataRange &dataRange) { d.nospace() << "QCPDataRange(" << dataRange.begin() << ", " << dataRange.end() << ")"; return d; } /*! \relates QCPDataSelection Prints \a selection in a human readable format to the qDebug output. */ inline QDebug operator<< (QDebug d, const QCPDataSelection &selection) { d.nospace() << "QCPDataSelection("; for (int i=0; i elements(QCP::MarginSide side) const { return mChildren.value(side); } bool isEmpty() const; void clear(); protected: // non-property members: QCustomPlot *mParentPlot; QHash > mChildren; // introduced virtual methods: virtual int commonMargin(QCP::MarginSide side) const; // non-virtual methods: void addChild(QCP::MarginSide side, QCPLayoutElement *element); void removeChild(QCP::MarginSide side, QCPLayoutElement *element); private: Q_DISABLE_COPY(QCPMarginGroup) friend class QCPLayoutElement; }; class QCP_LIB_DECL QCPLayoutElement : public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QCPLayout* layout READ layout) Q_PROPERTY(QRect rect READ rect) Q_PROPERTY(QRect outerRect READ outerRect WRITE setOuterRect) Q_PROPERTY(QMargins margins READ margins WRITE setMargins) Q_PROPERTY(QMargins minimumMargins READ minimumMargins WRITE setMinimumMargins) Q_PROPERTY(QSize minimumSize READ minimumSize WRITE setMinimumSize) Q_PROPERTY(QSize maximumSize READ maximumSize WRITE setMaximumSize) Q_PROPERTY(SizeConstraintRect sizeConstraintRect READ sizeConstraintRect WRITE setSizeConstraintRect) /// \endcond public: /*! Defines the phases of the update process, that happens just before a replot. At each phase, \ref update is called with the according UpdatePhase value. */ enum UpdatePhase { upPreparation ///< Phase used for any type of preparation that needs to be done before margin calculation and layout ,upMargins ///< Phase in which the margins are calculated and set ,upLayout ///< Final phase in which the layout system places the rects of the elements }; Q_ENUMS(UpdatePhase) /*! Defines to which rect of a layout element the size constraints that can be set via \ref setMinimumSize and \ref setMaximumSize apply. The outer rect (\ref outerRect) includes the margins (e.g. in the case of a QCPAxisRect the axis labels), whereas the inner rect (\ref rect) does not. \see setSizeConstraintRect */ enum SizeConstraintRect { scrInnerRect ///< Minimum/Maximum size constraints apply to inner rect , scrOuterRect ///< Minimum/Maximum size constraints apply to outer rect, thus include layout element margins }; Q_ENUMS(SizeConstraintRect) explicit QCPLayoutElement(QCustomPlot *parentPlot=nullptr); virtual ~QCPLayoutElement() Q_DECL_OVERRIDE; // getters: QCPLayout *layout() const { return mParentLayout; } QRect rect() const { return mRect; } QRect outerRect() const { return mOuterRect; } QMargins margins() const { return mMargins; } QMargins minimumMargins() const { return mMinimumMargins; } QCP::MarginSides autoMargins() const { return mAutoMargins; } QSize minimumSize() const { return mMinimumSize; } QSize maximumSize() const { return mMaximumSize; } SizeConstraintRect sizeConstraintRect() const { return mSizeConstraintRect; } QCPMarginGroup *marginGroup(QCP::MarginSide side) const { return mMarginGroups.value(side, nullptr); } QHash marginGroups() const { return mMarginGroups; } // setters: void setOuterRect(const QRect &rect); void setMargins(const QMargins &margins); void setMinimumMargins(const QMargins &margins); void setAutoMargins(QCP::MarginSides sides); void setMinimumSize(const QSize &size); void setMinimumSize(int width, int height); void setMaximumSize(const QSize &size); void setMaximumSize(int width, int height); void setSizeConstraintRect(SizeConstraintRect constraintRect); void setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group); // introduced virtual methods: virtual void update(UpdatePhase phase); virtual QSize minimumOuterSizeHint() const; virtual QSize maximumOuterSizeHint() const; virtual QList elements(bool recursive) const; // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; protected: // property members: QCPLayout *mParentLayout; QSize mMinimumSize, mMaximumSize; SizeConstraintRect mSizeConstraintRect; QRect mRect, mOuterRect; QMargins mMargins, mMinimumMargins; QCP::MarginSides mAutoMargins; QHash mMarginGroups; // introduced virtual methods: virtual int calculateAutoMargin(QCP::MarginSide side); virtual void layoutChanged(); // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE { Q_UNUSED(painter) } virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE { Q_UNUSED(painter) } virtual void parentPlotInitialized(QCustomPlot *parentPlot) Q_DECL_OVERRIDE; private: Q_DISABLE_COPY(QCPLayoutElement) friend class QCustomPlot; friend class QCPLayout; friend class QCPMarginGroup; }; Q_DECLARE_METATYPE(QCPLayoutElement::UpdatePhase) class QCP_LIB_DECL QCPLayout : public QCPLayoutElement { Q_OBJECT public: explicit QCPLayout(); // reimplemented virtual methods: virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; // introduced virtual methods: virtual int elementCount() const = 0; virtual QCPLayoutElement* elementAt(int index) const = 0; virtual QCPLayoutElement* takeAt(int index) = 0; virtual bool take(QCPLayoutElement* element) = 0; virtual void simplify(); // non-virtual methods: bool removeAt(int index); bool remove(QCPLayoutElement* element); void clear(); protected: // introduced virtual methods: virtual void updateLayout(); // non-virtual methods: void sizeConstraintsChanged() const; void adoptElement(QCPLayoutElement *el); void releaseElement(QCPLayoutElement *el); QVector getSectionSizes(QVector maxSizes, QVector minSizes, QVector stretchFactors, int totalSize) const; static QSize getFinalMinimumOuterSize(const QCPLayoutElement *el); static QSize getFinalMaximumOuterSize(const QCPLayoutElement *el); private: Q_DISABLE_COPY(QCPLayout) friend class QCPLayoutElement; }; class QCP_LIB_DECL QCPLayoutGrid : public QCPLayout { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(int rowCount READ rowCount) Q_PROPERTY(int columnCount READ columnCount) Q_PROPERTY(QList columnStretchFactors READ columnStretchFactors WRITE setColumnStretchFactors) Q_PROPERTY(QList rowStretchFactors READ rowStretchFactors WRITE setRowStretchFactors) Q_PROPERTY(int columnSpacing READ columnSpacing WRITE setColumnSpacing) Q_PROPERTY(int rowSpacing READ rowSpacing WRITE setRowSpacing) Q_PROPERTY(FillOrder fillOrder READ fillOrder WRITE setFillOrder) Q_PROPERTY(int wrap READ wrap WRITE setWrap) /// \endcond public: /*! Defines in which direction the grid is filled when using \ref addElement(QCPLayoutElement*). The column/row at which wrapping into the next row/column occurs can be specified with \ref setWrap. \see setFillOrder */ enum FillOrder { foRowsFirst ///< Rows are filled first, and a new element is wrapped to the next column if the row count would exceed \ref setWrap. ,foColumnsFirst ///< Columns are filled first, and a new element is wrapped to the next row if the column count would exceed \ref setWrap. }; Q_ENUMS(FillOrder) explicit QCPLayoutGrid(); virtual ~QCPLayoutGrid() Q_DECL_OVERRIDE; // getters: int rowCount() const { return mElements.size(); } int columnCount() const { return mElements.size() > 0 ? mElements.first().size() : 0; } QList columnStretchFactors() const { return mColumnStretchFactors; } QList rowStretchFactors() const { return mRowStretchFactors; } int columnSpacing() const { return mColumnSpacing; } int rowSpacing() const { return mRowSpacing; } int wrap() const { return mWrap; } FillOrder fillOrder() const { return mFillOrder; } // setters: void setColumnStretchFactor(int column, double factor); void setColumnStretchFactors(const QList &factors); void setRowStretchFactor(int row, double factor); void setRowStretchFactors(const QList &factors); void setColumnSpacing(int pixels); void setRowSpacing(int pixels); void setWrap(int count); void setFillOrder(FillOrder order, bool rearrange=true); // reimplemented virtual methods: virtual void updateLayout() Q_DECL_OVERRIDE; virtual int elementCount() const Q_DECL_OVERRIDE { return rowCount()*columnCount(); } virtual QCPLayoutElement* elementAt(int index) const Q_DECL_OVERRIDE; virtual QCPLayoutElement* takeAt(int index) Q_DECL_OVERRIDE; virtual bool take(QCPLayoutElement* element) Q_DECL_OVERRIDE; virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; virtual void simplify() Q_DECL_OVERRIDE; virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; virtual QSize maximumOuterSizeHint() const Q_DECL_OVERRIDE; // non-virtual methods: QCPLayoutElement *element(int row, int column) const; bool addElement(int row, int column, QCPLayoutElement *element); bool addElement(QCPLayoutElement *element); bool hasElement(int row, int column); void expandTo(int newRowCount, int newColumnCount); void insertRow(int newIndex); void insertColumn(int newIndex); int rowColToIndex(int row, int column) const; void indexToRowCol(int index, int &row, int &column) const; protected: // property members: QList > mElements; QList mColumnStretchFactors; QList mRowStretchFactors; int mColumnSpacing, mRowSpacing; int mWrap; FillOrder mFillOrder; // non-virtual methods: void getMinimumRowColSizes(QVector *minColWidths, QVector *minRowHeights) const; void getMaximumRowColSizes(QVector *maxColWidths, QVector *maxRowHeights) const; private: Q_DISABLE_COPY(QCPLayoutGrid) }; Q_DECLARE_METATYPE(QCPLayoutGrid::FillOrder) class QCP_LIB_DECL QCPLayoutInset : public QCPLayout { Q_OBJECT public: /*! Defines how the placement and sizing is handled for a certain element in a QCPLayoutInset. */ enum InsetPlacement { ipFree ///< The element may be positioned/sized arbitrarily, see \ref setInsetRect ,ipBorderAligned ///< The element is aligned to one of the layout sides, see \ref setInsetAlignment }; Q_ENUMS(InsetPlacement) explicit QCPLayoutInset(); virtual ~QCPLayoutInset() Q_DECL_OVERRIDE; // getters: InsetPlacement insetPlacement(int index) const; Qt::Alignment insetAlignment(int index) const; QRectF insetRect(int index) const; // setters: void setInsetPlacement(int index, InsetPlacement placement); void setInsetAlignment(int index, Qt::Alignment alignment); void setInsetRect(int index, const QRectF &rect); // reimplemented virtual methods: virtual void updateLayout() Q_DECL_OVERRIDE; virtual int elementCount() const Q_DECL_OVERRIDE; virtual QCPLayoutElement* elementAt(int index) const Q_DECL_OVERRIDE; virtual QCPLayoutElement* takeAt(int index) Q_DECL_OVERRIDE; virtual bool take(QCPLayoutElement* element) Q_DECL_OVERRIDE; virtual void simplify() Q_DECL_OVERRIDE {} virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; // non-virtual methods: void addElement(QCPLayoutElement *element, Qt::Alignment alignment); void addElement(QCPLayoutElement *element, const QRectF &rect); protected: // property members: QList mElements; QList mInsetPlacement; QList mInsetAlignment; QList mInsetRect; private: Q_DISABLE_COPY(QCPLayoutInset) }; Q_DECLARE_METATYPE(QCPLayoutInset::InsetPlacement) /* end of 'src/layout.h' */ /* including file 'src/lineending.h' */ /* modified 2021-03-29T02:30:44, size 4426 */ class QCP_LIB_DECL QCPLineEnding { Q_GADGET public: /*! Defines the type of ending decoration for line-like items, e.g. an arrow. \image html QCPLineEnding.png The width and length of these decorations can be controlled with the functions \ref setWidth and \ref setLength. Some decorations like \ref esDisc, \ref esSquare, \ref esDiamond and \ref esBar only support a width, the length property is ignored. \see QCPItemLine::setHead, QCPItemLine::setTail, QCPItemCurve::setHead, QCPItemCurve::setTail, QCPAxis::setLowerEnding, QCPAxis::setUpperEnding */ enum EndingStyle { esNone ///< No ending decoration ,esFlatArrow ///< A filled arrow head with a straight/flat back (a triangle) ,esSpikeArrow ///< A filled arrow head with an indented back ,esLineArrow ///< A non-filled arrow head with open back ,esDisc ///< A filled circle ,esSquare ///< A filled square ,esDiamond ///< A filled diamond (45 degrees rotated square) ,esBar ///< A bar perpendicular to the line ,esHalfBar ///< A bar perpendicular to the line, pointing out to only one side (to which side can be changed with \ref setInverted) ,esSkewedBar ///< A bar that is skewed (skew controllable via \ref setLength) }; Q_ENUMS(EndingStyle) QCPLineEnding(); QCPLineEnding(EndingStyle style, double width=8, double length=10, bool inverted=false); // getters: EndingStyle style() const { return mStyle; } double width() const { return mWidth; } double length() const { return mLength; } bool inverted() const { return mInverted; } // setters: void setStyle(EndingStyle style); void setWidth(double width); void setLength(double length); void setInverted(bool inverted); // non-property methods: double boundingDistance() const; double realLength() const; void draw(QCPPainter *painter, const QCPVector2D &pos, const QCPVector2D &dir) const; void draw(QCPPainter *painter, const QCPVector2D &pos, double angle) const; protected: // property members: EndingStyle mStyle; double mWidth, mLength; bool mInverted; }; Q_DECLARE_TYPEINFO(QCPLineEnding, Q_MOVABLE_TYPE); Q_DECLARE_METATYPE(QCPLineEnding::EndingStyle) /* end of 'src/lineending.h' */ /* including file 'src/axis/labelpainter.h' */ /* modified 2021-03-29T02:30:44, size 7086 */ class QCPLabelPainterPrivate { Q_GADGET public: /*! TODO */ enum AnchorMode { amRectangular ///< ,amSkewedUpright ///< ,amSkewedRotated ///< }; Q_ENUMS(AnchorMode) /*! TODO */ enum AnchorReferenceType { artNormal ///< ,artTangent ///< }; Q_ENUMS(AnchorReferenceType) /*! TODO */ enum AnchorSide { asLeft ///< ,asRight ///< ,asTop ///< ,asBottom ///< ,asTopLeft ,asTopRight ,asBottomRight ,asBottomLeft }; Q_ENUMS(AnchorSide) explicit QCPLabelPainterPrivate(QCustomPlot *parentPlot); virtual ~QCPLabelPainterPrivate(); // setters: void setAnchorSide(AnchorSide side); void setAnchorMode(AnchorMode mode); void setAnchorReference(const QPointF &pixelPoint); void setAnchorReferenceType(AnchorReferenceType type); void setFont(const QFont &font); void setColor(const QColor &color); void setPadding(int padding); void setRotation(double rotation); void setSubstituteExponent(bool enabled); void setMultiplicationSymbol(QChar symbol); void setAbbreviateDecimalPowers(bool enabled); void setCacheSize(int labelCount); // getters: AnchorMode anchorMode() const { return mAnchorMode; } AnchorSide anchorSide() const { return mAnchorSide; } QPointF anchorReference() const { return mAnchorReference; } AnchorReferenceType anchorReferenceType() const { return mAnchorReferenceType; } QFont font() const { return mFont; } QColor color() const { return mColor; } int padding() const { return mPadding; } double rotation() const { return mRotation; } bool substituteExponent() const { return mSubstituteExponent; } QChar multiplicationSymbol() const { return mMultiplicationSymbol; } bool abbreviateDecimalPowers() const { return mAbbreviateDecimalPowers; } int cacheSize() const; //virtual int size() const; // non-property methods: void drawTickLabel(QCPPainter *painter, const QPointF &tickPos, const QString &text); void clearCache(); // constants that may be used with setMultiplicationSymbol: static const QChar SymbolDot; static const QChar SymbolCross; protected: struct CachedLabel { QPoint offset; QPixmap pixmap; }; struct LabelData { AnchorSide side; double rotation; // angle in degrees QTransform transform; // the transform about the label anchor which is at (0, 0). Does not contain final absolute x/y positioning on the plot/axis QString basePart, expPart, suffixPart; QRect baseBounds, expBounds, suffixBounds; QRect totalBounds; // is in a coordinate system where label top left is at (0, 0) QRect rotatedTotalBounds; // is in a coordinate system where the label anchor is at (0, 0) QFont baseFont, expFont; QColor color; }; // property members: AnchorMode mAnchorMode; AnchorSide mAnchorSide; QPointF mAnchorReference; AnchorReferenceType mAnchorReferenceType; QFont mFont; QColor mColor; int mPadding; double mRotation; // this is the rotation applied uniformly to all labels, not the heterogeneous rotation in amCircularRotated mode bool mSubstituteExponent; QChar mMultiplicationSymbol; bool mAbbreviateDecimalPowers; // non-property members: QCustomPlot *mParentPlot; QByteArray mLabelParameterHash; // to determine whether mLabelCache needs to be cleared due to changed parameters QCache mLabelCache; QRect mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox; int mLetterCapHeight, mLetterDescent; // introduced virtual methods: virtual void drawLabelMaybeCached(QCPPainter *painter, const QFont &font, const QColor &color, const QPointF &pos, AnchorSide side, double rotation, const QString &text); virtual QByteArray generateLabelParameterHash() const; // TODO: get rid of this in favor of invalidation flag upon setters? // non-virtual methods: QPointF getAnchorPos(const QPointF &tickPos); void drawText(QCPPainter *painter, const QPointF &pos, const LabelData &labelData) const; LabelData getTickLabelData(const QFont &font, const QColor &color, double rotation, AnchorSide side, const QString &text) const; void applyAnchorTransform(LabelData &labelData) const; //void getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const; CachedLabel *createCachedLabel(const LabelData &labelData) const; QByteArray cacheKey(const QString &text, const QColor &color, double rotation, AnchorSide side) const; AnchorSide skewedAnchorSide(const QPointF &tickPos, double sideExpandHorz, double sideExpandVert) const; AnchorSide rotationCorrectedSide(AnchorSide side, double rotation) const; void analyzeFontMetrics(); }; Q_DECLARE_METATYPE(QCPLabelPainterPrivate::AnchorMode) Q_DECLARE_METATYPE(QCPLabelPainterPrivate::AnchorSide) /* end of 'src/axis/labelpainter.h' */ /* including file 'src/axis/axisticker.h' */ /* modified 2021-03-29T02:30:44, size 4230 */ class QCP_LIB_DECL QCPAxisTicker { Q_GADGET public: /*! Defines the strategies that the axis ticker may follow when choosing the size of the tick step. \see setTickStepStrategy */ enum TickStepStrategy { tssReadability ///< A nicely readable tick step is prioritized over matching the requested number of ticks (see \ref setTickCount) ,tssMeetTickCount ///< Less readable tick steps are allowed which in turn facilitates getting closer to the requested tick count }; Q_ENUMS(TickStepStrategy) QCPAxisTicker(); virtual ~QCPAxisTicker(); // getters: TickStepStrategy tickStepStrategy() const { return mTickStepStrategy; } int tickCount() const { return mTickCount; } double tickOrigin() const { return mTickOrigin; } // setters: void setTickStepStrategy(TickStepStrategy strategy); void setTickCount(int count); void setTickOrigin(double origin); // introduced virtual methods: virtual void generate(const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector &ticks, QVector *subTicks, QVector *tickLabels); protected: // property members: TickStepStrategy mTickStepStrategy; int mTickCount; double mTickOrigin; // introduced virtual methods: virtual double getTickStep(const QCPRange &range); virtual int getSubTickCount(double tickStep); virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision); virtual QVector createTickVector(double tickStep, const QCPRange &range); virtual QVector createSubTickVector(int subTickCount, const QVector &ticks); virtual QVector createLabelVector(const QVector &ticks, const QLocale &locale, QChar formatChar, int precision); // non-virtual methods: void trimTicks(const QCPRange &range, QVector &ticks, bool keepOneOutlier) const; double pickClosest(double target, const QVector &candidates) const; double getMantissa(double input, double *magnitude=nullptr) const; double cleanMantissa(double input) const; private: Q_DISABLE_COPY(QCPAxisTicker) }; Q_DECLARE_METATYPE(QCPAxisTicker::TickStepStrategy) Q_DECLARE_METATYPE(QSharedPointer) /* end of 'src/axis/axisticker.h' */ /* including file 'src/axis/axistickerdatetime.h' */ /* modified 2021-03-29T02:30:44, size 3600 */ class QCP_LIB_DECL QCPAxisTickerDateTime : public QCPAxisTicker { public: QCPAxisTickerDateTime(); // getters: QString dateTimeFormat() const { return mDateTimeFormat; } Qt::TimeSpec dateTimeSpec() const { return mDateTimeSpec; } # if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) QTimeZone timeZone() const { return mTimeZone; } #endif // setters: void setDateTimeFormat(const QString &format); void setDateTimeSpec(Qt::TimeSpec spec); # if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) void setTimeZone(const QTimeZone &zone); # endif void setTickOrigin(double origin); // hides base class method but calls baseclass implementation ("using" throws off IDEs and doxygen) void setTickOrigin(const QDateTime &origin); // static methods: static QDateTime keyToDateTime(double key); static double dateTimeToKey(const QDateTime &dateTime); static double dateTimeToKey(const QDate &date, Qt::TimeSpec timeSpec=Qt::LocalTime); protected: // property members: QString mDateTimeFormat; Qt::TimeSpec mDateTimeSpec; # if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) QTimeZone mTimeZone; # endif // non-property members: enum DateStrategy {dsNone, dsUniformTimeInDay, dsUniformDayInMonth} mDateStrategy; // reimplemented virtual methods: virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; }; /* end of 'src/axis/axistickerdatetime.h' */ /* including file 'src/axis/axistickertime.h' */ /* modified 2021-03-29T02:30:44, size 3542 */ class QCP_LIB_DECL QCPAxisTickerTime : public QCPAxisTicker { Q_GADGET public: /*! Defines the logical units in which fractions of time spans can be expressed. \see setFieldWidth, setTimeFormat */ enum TimeUnit { tuMilliseconds ///< Milliseconds, one thousandth of a second (%%z in \ref setTimeFormat) ,tuSeconds ///< Seconds (%%s in \ref setTimeFormat) ,tuMinutes ///< Minutes (%%m in \ref setTimeFormat) ,tuHours ///< Hours (%%h in \ref setTimeFormat) ,tuDays ///< Days (%%d in \ref setTimeFormat) }; Q_ENUMS(TimeUnit) QCPAxisTickerTime(); // getters: QString timeFormat() const { return mTimeFormat; } int fieldWidth(TimeUnit unit) const { return mFieldWidth.value(unit); } // setters: void setTimeFormat(const QString &format); void setFieldWidth(TimeUnit unit, int width); protected: // property members: QString mTimeFormat; QHash mFieldWidth; // non-property members: TimeUnit mSmallestUnit, mBiggestUnit; QHash mFormatPattern; // reimplemented virtual methods: virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; // non-virtual methods: void replaceUnit(QString &text, TimeUnit unit, int value) const; }; Q_DECLARE_METATYPE(QCPAxisTickerTime::TimeUnit) /* end of 'src/axis/axistickertime.h' */ /* including file 'src/axis/axistickerfixed.h' */ /* modified 2021-03-29T02:30:44, size 3308 */ class QCP_LIB_DECL QCPAxisTickerFixed : public QCPAxisTicker { Q_GADGET public: /*! Defines how the axis ticker may modify the specified tick step (\ref setTickStep) in order to control the number of ticks in the axis range. \see setScaleStrategy */ enum ScaleStrategy { ssNone ///< Modifications are not allowed, the specified tick step is absolutely fixed. This might cause a high tick density and overlapping labels if the axis range is zoomed out. ,ssMultiples ///< An integer multiple of the specified tick step is allowed. The used factor follows the base class properties of \ref setTickStepStrategy and \ref setTickCount. ,ssPowers ///< An integer power of the specified tick step is allowed. }; Q_ENUMS(ScaleStrategy) QCPAxisTickerFixed(); // getters: double tickStep() const { return mTickStep; } ScaleStrategy scaleStrategy() const { return mScaleStrategy; } // setters: void setTickStep(double step); void setScaleStrategy(ScaleStrategy strategy); protected: // property members: double mTickStep; ScaleStrategy mScaleStrategy; // reimplemented virtual methods: virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; }; Q_DECLARE_METATYPE(QCPAxisTickerFixed::ScaleStrategy) /* end of 'src/axis/axistickerfixed.h' */ /* including file 'src/axis/axistickertext.h' */ /* modified 2021-03-29T02:30:44, size 3090 */ class QCP_LIB_DECL QCPAxisTickerText : public QCPAxisTicker { public: QCPAxisTickerText(); // getters: QMap &ticks() { return mTicks; } int subTickCount() const { return mSubTickCount; } // setters: void setTicks(const QMap &ticks); void setTicks(const QVector &positions, const QVector &labels); void setSubTickCount(int subTicks); // non-virtual methods: void clear(); void addTick(double position, const QString &label); void addTicks(const QMap &ticks); void addTicks(const QVector &positions, const QVector &labels); protected: // property members: QMap mTicks; int mSubTickCount; // reimplemented virtual methods: virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; }; /* end of 'src/axis/axistickertext.h' */ /* including file 'src/axis/axistickerpi.h' */ /* modified 2021-03-29T02:30:44, size 3911 */ class QCP_LIB_DECL QCPAxisTickerPi : public QCPAxisTicker { Q_GADGET public: /*! Defines how fractions should be displayed in tick labels. \see setFractionStyle */ enum FractionStyle { fsFloatingPoint ///< Fractions are displayed as regular decimal floating point numbers, e.g. "0.25" or "0.125". ,fsAsciiFractions ///< Fractions are written as rationals using ASCII characters only, e.g. "1/4" or "1/8" ,fsUnicodeFractions ///< Fractions are written using sub- and superscript UTF-8 digits and the fraction symbol. }; Q_ENUMS(FractionStyle) QCPAxisTickerPi(); // getters: QString piSymbol() const { return mPiSymbol; } double piValue() const { return mPiValue; } bool periodicity() const { return mPeriodicity; } FractionStyle fractionStyle() const { return mFractionStyle; } // setters: void setPiSymbol(QString symbol); void setPiValue(double pi); void setPeriodicity(int multiplesOfPi); void setFractionStyle(FractionStyle style); protected: // property members: QString mPiSymbol; double mPiValue; int mPeriodicity; FractionStyle mFractionStyle; // non-property members: double mPiTickStep; // size of one tick step in units of mPiValue // reimplemented virtual methods: virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; // non-virtual methods: void simplifyFraction(int &numerator, int &denominator) const; QString fractionToString(int numerator, int denominator) const; QString unicodeFraction(int numerator, int denominator) const; QString unicodeSuperscript(int number) const; QString unicodeSubscript(int number) const; }; Q_DECLARE_METATYPE(QCPAxisTickerPi::FractionStyle) /* end of 'src/axis/axistickerpi.h' */ /* including file 'src/axis/axistickerlog.h' */ /* modified 2021-03-29T02:30:44, size 2594 */ class QCP_LIB_DECL QCPAxisTickerLog : public QCPAxisTicker { public: QCPAxisTickerLog(); // getters: double logBase() const { return mLogBase; } int subTickCount() const { return mSubTickCount; } // setters: void setLogBase(double base); void setSubTickCount(int subTicks); protected: // property members: double mLogBase; int mSubTickCount; // non-property members: double mLogBaseLnInv; // reimplemented virtual methods: virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; }; /* end of 'src/axis/axistickerlog.h' */ /* including file 'src/axis/axis.h' */ /* modified 2021-03-29T02:30:44, size 20913 */ class QCP_LIB_DECL QCPGrid :public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(bool subGridVisible READ subGridVisible WRITE setSubGridVisible) Q_PROPERTY(bool antialiasedSubGrid READ antialiasedSubGrid WRITE setAntialiasedSubGrid) Q_PROPERTY(bool antialiasedZeroLine READ antialiasedZeroLine WRITE setAntialiasedZeroLine) Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen subGridPen READ subGridPen WRITE setSubGridPen) Q_PROPERTY(QPen zeroLinePen READ zeroLinePen WRITE setZeroLinePen) /// \endcond public: explicit QCPGrid(QCPAxis *parentAxis); // getters: bool subGridVisible() const { return mSubGridVisible; } bool antialiasedSubGrid() const { return mAntialiasedSubGrid; } bool antialiasedZeroLine() const { return mAntialiasedZeroLine; } QPen pen() const { return mPen; } QPen subGridPen() const { return mSubGridPen; } QPen zeroLinePen() const { return mZeroLinePen; } // setters: void setSubGridVisible(bool visible); void setAntialiasedSubGrid(bool enabled); void setAntialiasedZeroLine(bool enabled); void setPen(const QPen &pen); void setSubGridPen(const QPen &pen); void setZeroLinePen(const QPen &pen); protected: // property members: bool mSubGridVisible; bool mAntialiasedSubGrid, mAntialiasedZeroLine; QPen mPen, mSubGridPen, mZeroLinePen; // non-property members: QCPAxis *mParentAxis; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // non-virtual methods: void drawGridLines(QCPPainter *painter) const; void drawSubGridLines(QCPPainter *painter) const; friend class QCPAxis; }; class QCP_LIB_DECL QCPAxis : public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(AxisType axisType READ axisType) Q_PROPERTY(QCPAxisRect* axisRect READ axisRect) Q_PROPERTY(ScaleType scaleType READ scaleType WRITE setScaleType NOTIFY scaleTypeChanged) Q_PROPERTY(QCPRange range READ range WRITE setRange NOTIFY rangeChanged) Q_PROPERTY(bool rangeReversed READ rangeReversed WRITE setRangeReversed) Q_PROPERTY(QSharedPointer ticker READ ticker WRITE setTicker) Q_PROPERTY(bool ticks READ ticks WRITE setTicks) Q_PROPERTY(bool tickLabels READ tickLabels WRITE setTickLabels) Q_PROPERTY(int tickLabelPadding READ tickLabelPadding WRITE setTickLabelPadding) Q_PROPERTY(QFont tickLabelFont READ tickLabelFont WRITE setTickLabelFont) Q_PROPERTY(QColor tickLabelColor READ tickLabelColor WRITE setTickLabelColor) Q_PROPERTY(double tickLabelRotation READ tickLabelRotation WRITE setTickLabelRotation) Q_PROPERTY(LabelSide tickLabelSide READ tickLabelSide WRITE setTickLabelSide) Q_PROPERTY(QString numberFormat READ numberFormat WRITE setNumberFormat) Q_PROPERTY(int numberPrecision READ numberPrecision WRITE setNumberPrecision) Q_PROPERTY(QVector tickVector READ tickVector) Q_PROPERTY(QVector tickVectorLabels READ tickVectorLabels) Q_PROPERTY(int tickLengthIn READ tickLengthIn WRITE setTickLengthIn) Q_PROPERTY(int tickLengthOut READ tickLengthOut WRITE setTickLengthOut) Q_PROPERTY(bool subTicks READ subTicks WRITE setSubTicks) Q_PROPERTY(int subTickLengthIn READ subTickLengthIn WRITE setSubTickLengthIn) Q_PROPERTY(int subTickLengthOut READ subTickLengthOut WRITE setSubTickLengthOut) Q_PROPERTY(QPen basePen READ basePen WRITE setBasePen) Q_PROPERTY(QPen tickPen READ tickPen WRITE setTickPen) Q_PROPERTY(QPen subTickPen READ subTickPen WRITE setSubTickPen) Q_PROPERTY(QFont labelFont READ labelFont WRITE setLabelFont) Q_PROPERTY(QColor labelColor READ labelColor WRITE setLabelColor) Q_PROPERTY(QString label READ label WRITE setLabel) Q_PROPERTY(int labelPadding READ labelPadding WRITE setLabelPadding) Q_PROPERTY(int padding READ padding WRITE setPadding) Q_PROPERTY(int offset READ offset WRITE setOffset) Q_PROPERTY(SelectableParts selectedParts READ selectedParts WRITE setSelectedParts NOTIFY selectionChanged) Q_PROPERTY(SelectableParts selectableParts READ selectableParts WRITE setSelectableParts NOTIFY selectableChanged) Q_PROPERTY(QFont selectedTickLabelFont READ selectedTickLabelFont WRITE setSelectedTickLabelFont) Q_PROPERTY(QFont selectedLabelFont READ selectedLabelFont WRITE setSelectedLabelFont) Q_PROPERTY(QColor selectedTickLabelColor READ selectedTickLabelColor WRITE setSelectedTickLabelColor) Q_PROPERTY(QColor selectedLabelColor READ selectedLabelColor WRITE setSelectedLabelColor) Q_PROPERTY(QPen selectedBasePen READ selectedBasePen WRITE setSelectedBasePen) Q_PROPERTY(QPen selectedTickPen READ selectedTickPen WRITE setSelectedTickPen) Q_PROPERTY(QPen selectedSubTickPen READ selectedSubTickPen WRITE setSelectedSubTickPen) Q_PROPERTY(QCPLineEnding lowerEnding READ lowerEnding WRITE setLowerEnding) Q_PROPERTY(QCPLineEnding upperEnding READ upperEnding WRITE setUpperEnding) Q_PROPERTY(QCPGrid* grid READ grid) /// \endcond public: /*! Defines at which side of the axis rect the axis will appear. This also affects how the tick marks are drawn, on which side the labels are placed etc. */ enum AxisType { atLeft = 0x01 ///< 0x01 Axis is vertical and on the left side of the axis rect ,atRight = 0x02 ///< 0x02 Axis is vertical and on the right side of the axis rect ,atTop = 0x04 ///< 0x04 Axis is horizontal and on the top side of the axis rect ,atBottom = 0x08 ///< 0x08 Axis is horizontal and on the bottom side of the axis rect }; Q_ENUMS(AxisType) Q_FLAGS(AxisTypes) Q_DECLARE_FLAGS(AxisTypes, AxisType) /*! Defines on which side of the axis the tick labels (numbers) shall appear. \see setTickLabelSide */ enum LabelSide { lsInside ///< Tick labels will be displayed inside the axis rect and clipped to the inner axis rect ,lsOutside ///< Tick labels will be displayed outside the axis rect }; Q_ENUMS(LabelSide) /*! Defines the scale of an axis. \see setScaleType */ enum ScaleType { stLinear ///< Linear scaling ,stLogarithmic ///< Logarithmic scaling with correspondingly transformed axis coordinates (possibly also \ref setTicker to a \ref QCPAxisTickerLog instance). }; Q_ENUMS(ScaleType) /*! Defines the selectable parts of an axis. \see setSelectableParts, setSelectedParts */ enum SelectablePart { spNone = 0 ///< None of the selectable parts ,spAxis = 0x001 ///< The axis backbone and tick marks ,spTickLabels = 0x002 ///< Tick labels (numbers) of this axis (as a whole, not individually) ,spAxisLabel = 0x004 ///< The axis label }; Q_ENUMS(SelectablePart) Q_FLAGS(SelectableParts) Q_DECLARE_FLAGS(SelectableParts, SelectablePart) explicit QCPAxis(QCPAxisRect *parent, AxisType type); virtual ~QCPAxis() Q_DECL_OVERRIDE; // getters: AxisType axisType() const { return mAxisType; } QCPAxisRect *axisRect() const { return mAxisRect; } ScaleType scaleType() const { return mScaleType; } const QCPRange range() const { return mRange; } bool rangeReversed() const { return mRangeReversed; } QSharedPointer ticker() const { return mTicker; } bool ticks() const { return mTicks; } bool tickLabels() const { return mTickLabels; } int tickLabelPadding() const; QFont tickLabelFont() const { return mTickLabelFont; } QColor tickLabelColor() const { return mTickLabelColor; } double tickLabelRotation() const; LabelSide tickLabelSide() const; QString numberFormat() const; int numberPrecision() const { return mNumberPrecision; } QVector tickVector() const { return mTickVector; } QVector tickVectorLabels() const { return mTickVectorLabels; } int tickLengthIn() const; int tickLengthOut() const; bool subTicks() const { return mSubTicks; } int subTickLengthIn() const; int subTickLengthOut() const; QPen basePen() const { return mBasePen; } QPen tickPen() const { return mTickPen; } QPen subTickPen() const { return mSubTickPen; } QFont labelFont() const { return mLabelFont; } QColor labelColor() const { return mLabelColor; } QString label() const { return mLabel; } int labelPadding() const; int padding() const { return mPadding; } int offset() const; SelectableParts selectedParts() const { return mSelectedParts; } SelectableParts selectableParts() const { return mSelectableParts; } QFont selectedTickLabelFont() const { return mSelectedTickLabelFont; } QFont selectedLabelFont() const { return mSelectedLabelFont; } QColor selectedTickLabelColor() const { return mSelectedTickLabelColor; } QColor selectedLabelColor() const { return mSelectedLabelColor; } QPen selectedBasePen() const { return mSelectedBasePen; } QPen selectedTickPen() const { return mSelectedTickPen; } QPen selectedSubTickPen() const { return mSelectedSubTickPen; } QCPLineEnding lowerEnding() const; QCPLineEnding upperEnding() const; QCPGrid *grid() const { return mGrid; } // setters: Q_SLOT void setScaleType(QCPAxis::ScaleType type); Q_SLOT void setRange(const QCPRange &range); void setRange(double lower, double upper); void setRange(double position, double size, Qt::AlignmentFlag alignment); void setRangeLower(double lower); void setRangeUpper(double upper); void setRangeReversed(bool reversed); void setTicker(QSharedPointer ticker); void setTicks(bool show); void setTickLabels(bool show); void setTickLabelPadding(int padding); void setTickLabelFont(const QFont &font); void setTickLabelColor(const QColor &color); void setTickLabelRotation(double degrees); void setTickLabelSide(LabelSide side); void setNumberFormat(const QString &formatCode); void setNumberPrecision(int precision); void setTickLength(int inside, int outside=0); void setTickLengthIn(int inside); void setTickLengthOut(int outside); void setSubTicks(bool show); void setSubTickLength(int inside, int outside=0); void setSubTickLengthIn(int inside); void setSubTickLengthOut(int outside); void setBasePen(const QPen &pen); void setTickPen(const QPen &pen); void setSubTickPen(const QPen &pen); void setLabelFont(const QFont &font); void setLabelColor(const QColor &color); void setLabel(const QString &str); void setLabelPadding(int padding); void setPadding(int padding); void setOffset(int offset); void setSelectedTickLabelFont(const QFont &font); void setSelectedLabelFont(const QFont &font); void setSelectedTickLabelColor(const QColor &color); void setSelectedLabelColor(const QColor &color); void setSelectedBasePen(const QPen &pen); void setSelectedTickPen(const QPen &pen); void setSelectedSubTickPen(const QPen &pen); Q_SLOT void setSelectableParts(const QCPAxis::SelectableParts &selectableParts); Q_SLOT void setSelectedParts(const QCPAxis::SelectableParts &selectedParts); void setLowerEnding(const QCPLineEnding &ending); void setUpperEnding(const QCPLineEnding &ending); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; // non-property methods: Qt::Orientation orientation() const { return mOrientation; } int pixelOrientation() const { return rangeReversed() != (orientation()==Qt::Vertical) ? -1 : 1; } void moveRange(double diff); void scaleRange(double factor); void scaleRange(double factor, double center); void setScaleRatio(const QCPAxis *otherAxis, double ratio=1.0); void rescale(bool onlyVisiblePlottables=false); double pixelToCoord(double value) const; double coordToPixel(double value) const; SelectablePart getPartAt(const QPointF &pos) const; QList plottables() const; QList graphs() const; QList items() const; static AxisType marginSideToAxisType(QCP::MarginSide side); static Qt::Orientation orientation(AxisType type) { return type==atBottom || type==atTop ? Qt::Horizontal : Qt::Vertical; } static AxisType opposite(AxisType type); signals: void rangeChanged(const QCPRange &newRange); void rangeChanged(const QCPRange &newRange, const QCPRange &oldRange); void scaleTypeChanged(QCPAxis::ScaleType scaleType); void selectionChanged(const QCPAxis::SelectableParts &parts); void selectableChanged(const QCPAxis::SelectableParts &parts); protected: // property members: // axis base: AxisType mAxisType; QCPAxisRect *mAxisRect; //int mOffset; // in QCPAxisPainter int mPadding; Qt::Orientation mOrientation; SelectableParts mSelectableParts, mSelectedParts; QPen mBasePen, mSelectedBasePen; //QCPLineEnding mLowerEnding, mUpperEnding; // in QCPAxisPainter // axis label: //int mLabelPadding; // in QCPAxisPainter QString mLabel; QFont mLabelFont, mSelectedLabelFont; QColor mLabelColor, mSelectedLabelColor; // tick labels: //int mTickLabelPadding; // in QCPAxisPainter bool mTickLabels; //double mTickLabelRotation; // in QCPAxisPainter QFont mTickLabelFont, mSelectedTickLabelFont; QColor mTickLabelColor, mSelectedTickLabelColor; int mNumberPrecision; QLatin1Char mNumberFormatChar; bool mNumberBeautifulPowers; //bool mNumberMultiplyCross; // QCPAxisPainter // ticks and subticks: bool mTicks; bool mSubTicks; //int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; // QCPAxisPainter QPen mTickPen, mSelectedTickPen; QPen mSubTickPen, mSelectedSubTickPen; // scale and range: QCPRange mRange; bool mRangeReversed; ScaleType mScaleType; // non-property members: QCPGrid *mGrid; QCPAxisPainterPrivate *mAxisPainter; QSharedPointer mTicker; QVector mTickVector; QVector mTickVectorLabels; QVector mSubTickVector; bool mCachedMarginValid; int mCachedMargin; bool mDragging; QCPRange mDragStartRange; QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; // introduced virtual methods: virtual int calculateMargin(); // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; // mouse events: virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; // non-virtual methods: void setupTickVectors(); QPen getBasePen() const; QPen getTickPen() const; QPen getSubTickPen() const; QFont getTickLabelFont() const; QFont getLabelFont() const; QColor getTickLabelColor() const; QColor getLabelColor() const; private: Q_DISABLE_COPY(QCPAxis) friend class QCustomPlot; friend class QCPGrid; friend class QCPAxisRect; }; Q_DECLARE_OPERATORS_FOR_FLAGS(QCPAxis::SelectableParts) Q_DECLARE_OPERATORS_FOR_FLAGS(QCPAxis::AxisTypes) Q_DECLARE_METATYPE(QCPAxis::AxisType) Q_DECLARE_METATYPE(QCPAxis::LabelSide) Q_DECLARE_METATYPE(QCPAxis::ScaleType) Q_DECLARE_METATYPE(QCPAxis::SelectablePart) class QCPAxisPainterPrivate { public: explicit QCPAxisPainterPrivate(QCustomPlot *parentPlot); virtual ~QCPAxisPainterPrivate(); virtual void draw(QCPPainter *painter); virtual int size(); void clearCache(); QRect axisSelectionBox() const { return mAxisSelectionBox; } QRect tickLabelsSelectionBox() const { return mTickLabelsSelectionBox; } QRect labelSelectionBox() const { return mLabelSelectionBox; } // public property members: QCPAxis::AxisType type; QPen basePen; QCPLineEnding lowerEnding, upperEnding; // directly accessed by QCPAxis setters/getters int labelPadding; // directly accessed by QCPAxis setters/getters QFont labelFont; QColor labelColor; QString label; int tickLabelPadding; // directly accessed by QCPAxis setters/getters double tickLabelRotation; // directly accessed by QCPAxis setters/getters QCPAxis::LabelSide tickLabelSide; // directly accessed by QCPAxis setters/getters bool substituteExponent; bool numberMultiplyCross; // directly accessed by QCPAxis setters/getters int tickLengthIn, tickLengthOut, subTickLengthIn, subTickLengthOut; // directly accessed by QCPAxis setters/getters QPen tickPen, subTickPen; QFont tickLabelFont; QColor tickLabelColor; QRect axisRect, viewportRect; int offset; // directly accessed by QCPAxis setters/getters bool abbreviateDecimalPowers; bool reversedEndings; QVector subTickPositions; QVector tickPositions; QVector tickLabels; protected: struct CachedLabel { QPointF offset; QPixmap pixmap; }; struct TickLabelData { QString basePart, expPart, suffixPart; QRect baseBounds, expBounds, suffixBounds, totalBounds, rotatedTotalBounds; QFont baseFont, expFont; }; QCustomPlot *mParentPlot; QByteArray mLabelParameterHash; // to determine whether mLabelCache needs to be cleared due to changed parameters QCache mLabelCache; QRect mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox; virtual QByteArray generateLabelParameterHash() const; virtual void placeTickLabel(QCPPainter *painter, double position, int distanceToAxis, const QString &text, QSize *tickLabelsSize); virtual void drawTickLabel(QCPPainter *painter, double x, double y, const TickLabelData &labelData) const; virtual TickLabelData getTickLabelData(const QFont &font, const QString &text) const; virtual QPointF getTickLabelDrawOffset(const TickLabelData &labelData) const; virtual void getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const; }; /* end of 'src/axis/axis.h' */ /* including file 'src/scatterstyle.h' */ /* modified 2021-03-29T02:30:44, size 7275 */ class QCP_LIB_DECL QCPScatterStyle { Q_GADGET public: /*! Represents the various properties of a scatter style instance. For example, this enum is used to specify which properties of \ref QCPSelectionDecorator::setScatterStyle will be used when highlighting selected data points. Specific scatter properties can be transferred between \ref QCPScatterStyle instances via \ref setFromOther. */ enum ScatterProperty { spNone = 0x00 ///< 0x00 None ,spPen = 0x01 ///< 0x01 The pen property, see \ref setPen ,spBrush = 0x02 ///< 0x02 The brush property, see \ref setBrush ,spSize = 0x04 ///< 0x04 The size property, see \ref setSize ,spShape = 0x08 ///< 0x08 The shape property, see \ref setShape ,spAll = 0xFF ///< 0xFF All properties }; Q_ENUMS(ScatterProperty) Q_FLAGS(ScatterProperties) Q_DECLARE_FLAGS(ScatterProperties, ScatterProperty) /*! Defines the shape used for scatter points. On plottables/items that draw scatters, the sizes of these visualizations (with exception of \ref ssDot and \ref ssPixmap) can be controlled with the \ref setSize function. Scatters are drawn with the pen and brush specified with \ref setPen and \ref setBrush. */ enum ScatterShape { ssNone ///< no scatter symbols are drawn (e.g. in QCPGraph, data only represented with lines) ,ssDot ///< \enumimage{ssDot.png} a single pixel (use \ref ssDisc or \ref ssCircle if you want a round shape with a certain radius) ,ssCross ///< \enumimage{ssCross.png} a cross ,ssPlus ///< \enumimage{ssPlus.png} a plus ,ssCircle ///< \enumimage{ssCircle.png} a circle ,ssDisc ///< \enumimage{ssDisc.png} a circle which is filled with the pen's color (not the brush as with ssCircle) ,ssSquare ///< \enumimage{ssSquare.png} a square ,ssDiamond ///< \enumimage{ssDiamond.png} a diamond ,ssStar ///< \enumimage{ssStar.png} a star with eight arms, i.e. a combination of cross and plus ,ssTriangle ///< \enumimage{ssTriangle.png} an equilateral triangle, standing on baseline ,ssTriangleInverted ///< \enumimage{ssTriangleInverted.png} an equilateral triangle, standing on corner ,ssCrossSquare ///< \enumimage{ssCrossSquare.png} a square with a cross inside ,ssPlusSquare ///< \enumimage{ssPlusSquare.png} a square with a plus inside ,ssCrossCircle ///< \enumimage{ssCrossCircle.png} a circle with a cross inside ,ssPlusCircle ///< \enumimage{ssPlusCircle.png} a circle with a plus inside ,ssPeace ///< \enumimage{ssPeace.png} a circle, with one vertical and two downward diagonal lines ,ssPixmap ///< a custom pixmap specified by \ref setPixmap, centered on the data point coordinates ,ssCustom ///< custom painter operations are performed per scatter (As QPainterPath, see \ref setCustomPath) }; Q_ENUMS(ScatterShape) QCPScatterStyle(); QCPScatterStyle(ScatterShape shape, double size=6); QCPScatterStyle(ScatterShape shape, const QColor &color, double size); QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size); QCPScatterStyle(ScatterShape shape, const QPen &pen, const QBrush &brush, double size); QCPScatterStyle(const QPixmap &pixmap); QCPScatterStyle(const QPainterPath &customPath, const QPen &pen, const QBrush &brush=Qt::NoBrush, double size=6); // getters: double size() const { return mSize; } ScatterShape shape() const { return mShape; } QPen pen() const { return mPen; } QBrush brush() const { return mBrush; } QPixmap pixmap() const { return mPixmap; } QPainterPath customPath() const { return mCustomPath; } // setters: void setFromOther(const QCPScatterStyle &other, ScatterProperties properties); void setSize(double size); void setShape(ScatterShape shape); void setPen(const QPen &pen); void setBrush(const QBrush &brush); void setPixmap(const QPixmap &pixmap); void setCustomPath(const QPainterPath &customPath); // non-property methods: bool isNone() const { return mShape == ssNone; } bool isPenDefined() const { return mPenDefined; } void undefinePen(); void applyTo(QCPPainter *painter, const QPen &defaultPen) const; void drawShape(QCPPainter *painter, const QPointF &pos) const; void drawShape(QCPPainter *painter, double x, double y) const; protected: // property members: double mSize; ScatterShape mShape; QPen mPen; QBrush mBrush; QPixmap mPixmap; QPainterPath mCustomPath; // non-property members: bool mPenDefined; }; Q_DECLARE_TYPEINFO(QCPScatterStyle, Q_MOVABLE_TYPE); Q_DECLARE_OPERATORS_FOR_FLAGS(QCPScatterStyle::ScatterProperties) Q_DECLARE_METATYPE(QCPScatterStyle::ScatterProperty) Q_DECLARE_METATYPE(QCPScatterStyle::ScatterShape) /* end of 'src/scatterstyle.h' */ /* including file 'src/datacontainer.h' */ /* modified 2021-03-29T02:30:44, size 34070 */ /*! \relates QCPDataContainer Returns whether the sort key of \a a is less than the sort key of \a b. \see QCPDataContainer::sort */ template inline bool qcpLessThanSortKey(const DataType &a, const DataType &b) { return a.sortKey() < b.sortKey(); } template class QCPDataContainer // no QCP_LIB_DECL, template class ends up in header (cpp included below) { public: typedef typename QVector::const_iterator const_iterator; typedef typename QVector::iterator iterator; QCPDataContainer(); // getters: int size() const { return mData.size()-mPreallocSize; } bool isEmpty() const { return size() == 0; } bool autoSqueeze() const { return mAutoSqueeze; } // setters: void setAutoSqueeze(bool enabled); // non-virtual methods: void set(const QCPDataContainer &data); void set(const QVector &data, bool alreadySorted=false); void add(const QCPDataContainer &data); void add(const QVector &data, bool alreadySorted=false); void add(const DataType &data); void removeBefore(double sortKey); void removeAfter(double sortKey); void remove(double sortKeyFrom, double sortKeyTo); void remove(double sortKey); void clear(); void sort(); void squeeze(bool preAllocation=true, bool postAllocation=true); const_iterator constBegin() const { return mData.constBegin()+mPreallocSize; } const_iterator constEnd() const { return mData.constEnd(); } iterator begin() { return mData.begin()+mPreallocSize; } iterator end() { return mData.end(); } const_iterator findBegin(double sortKey, bool expandedRange=true) const; const_iterator findEnd(double sortKey, bool expandedRange=true) const; const_iterator at(int index) const { return constBegin()+qBound(0, index, size()); } QCPRange keyRange(bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth); QCPRange valueRange(bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()); QCPDataRange dataRange() const { return QCPDataRange(0, size()); } void limitIteratorsToDataRange(const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const; protected: // property members: bool mAutoSqueeze; // non-property memebers: QVector mData; int mPreallocSize; int mPreallocIteration; // non-virtual methods: void preallocateGrow(int minimumPreallocSize); void performAutoSqueeze(); }; // include implementation in header since it is a class template: //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPDataContainer //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPDataContainer \brief The generic data container for one-dimensional plottables This class template provides a fast container for data storage of one-dimensional data. The data type is specified as template parameter (called \a DataType in the following) and must provide some methods as described in the \ref qcpdatacontainer-datatype "next section". The data is stored in a sorted fashion, which allows very quick lookups by the sorted key as well as retrieval of ranges (see \ref findBegin, \ref findEnd, \ref keyRange) using binary search. The container uses a preallocation and a postallocation scheme, such that appending and prepending data (with respect to the sort key) is very fast and minimizes reallocations. If data is added which needs to be inserted between existing keys, the merge usually can be done quickly too, using the fact that existing data is always sorted. The user can further improve performance by specifying that added data is already itself sorted by key, if he can guarantee that this is the case (see for example \ref add(const QVector &data, bool alreadySorted)). The data can be accessed with the provided const iterators (\ref constBegin, \ref constEnd). If it is necessary to alter existing data in-place, the non-const iterators can be used (\ref begin, \ref end). Changing data members that are not the sort key (for most data types called \a key) is safe from the container's perspective. Great care must be taken however if the sort key is modified through the non-const iterators. For performance reasons, the iterators don't automatically cause a re-sorting upon their manipulation. It is thus the responsibility of the user to leave the container in a sorted state when finished with the data manipulation, before calling any other methods on the container. A complete re-sort (e.g. after finishing all sort key manipulation) can be done by calling \ref sort. Failing to do so can not be detected by the container efficiently and will cause both rendering artifacts and potential data loss. Implementing one-dimensional plottables that make use of a \ref QCPDataContainer is usually done by subclassing from \ref QCPAbstractPlottable1D "QCPAbstractPlottable1D", which introduces an according \a mDataContainer member and some convenience methods. \section qcpdatacontainer-datatype Requirements for the DataType template parameter The template parameter DataType is the type of the stored data points. It must be trivially copyable and have the following public methods, preferably inline: \li double sortKey() const\n Returns the member variable of this data point that is the sort key, defining the ordering in the container. Often this variable is simply called \a key. \li static DataType fromSortKey(double sortKey)\n Returns a new instance of the data type initialized with its sort key set to \a sortKey. \li static bool sortKeyIsMainKey()\n Returns true if the sort key is equal to the main key (see method \c mainKey below). For most plottables this is the case. It is not the case for example for \ref QCPCurve, which uses \a t as sort key and \a key as main key. This is the reason why QCPCurve unlike QCPGraph can display parametric curves with loops. \li double mainKey() const\n Returns the variable of this data point considered the main key. This is commonly the variable that is used as the coordinate of this data point on the key axis of the plottable. This method is used for example when determining the automatic axis rescaling of key axes (\ref QCPAxis::rescale). \li double mainValue() const\n Returns the variable of this data point considered the main value. This is commonly the variable that is used as the coordinate of this data point on the value axis of the plottable. \li QCPRange valueRange() const\n Returns the range this data point spans in the value axis coordinate. If the data is single-valued (e.g. QCPGraphData), this is simply a range with both lower and upper set to the main data point value. However if the data points can represent multiple values at once (e.g QCPFinancialData with its \a high, \a low, \a open and \a close values at each \a key) this method should return the range those values span. This method is used for example when determining the automatic axis rescaling of value axes (\ref QCPAxis::rescale). */ /* start documentation of inline functions */ /*! \fn int QCPDataContainer::size() const Returns the number of data points in the container. */ /*! \fn bool QCPDataContainer::isEmpty() const Returns whether this container holds no data points. */ /*! \fn QCPDataContainer::const_iterator QCPDataContainer::constBegin() const Returns a const iterator to the first data point in this container. */ /*! \fn QCPDataContainer::const_iterator QCPDataContainer::constEnd() const Returns a const iterator to the element past the last data point in this container. */ /*! \fn QCPDataContainer::iterator QCPDataContainer::begin() const Returns a non-const iterator to the first data point in this container. You can manipulate the data points in-place through the non-const iterators, but great care must be taken when manipulating the sort key of a data point, see \ref sort, or the detailed description of this class. */ /*! \fn QCPDataContainer::iterator QCPDataContainer::end() const Returns a non-const iterator to the element past the last data point in this container. You can manipulate the data points in-place through the non-const iterators, but great care must be taken when manipulating the sort key of a data point, see \ref sort, or the detailed description of this class. */ /*! \fn QCPDataContainer::const_iterator QCPDataContainer::at(int index) const Returns a const iterator to the element with the specified \a index. If \a index points beyond the available elements in this container, returns \ref constEnd, i.e. an iterator past the last valid element. You can use this method to easily obtain iterators from a \ref QCPDataRange, see the \ref dataselection-accessing "data selection page" for an example. */ /*! \fn QCPDataRange QCPDataContainer::dataRange() const Returns a \ref QCPDataRange encompassing the entire data set of this container. This means the begin index of the returned range is 0, and the end index is \ref size. */ /* end documentation of inline functions */ /*! Constructs a QCPDataContainer used for plottable classes that represent a series of key-sorted data */ template QCPDataContainer::QCPDataContainer() : mAutoSqueeze(true), mPreallocSize(0), mPreallocIteration(0) { } /*! Sets whether the container automatically decides when to release memory from its post- and preallocation pools when data points are removed. By default this is enabled and for typical applications shouldn't be changed. If auto squeeze is disabled, you can manually decide when to release pre-/postallocation with \ref squeeze. */ template void QCPDataContainer::setAutoSqueeze(bool enabled) { if (mAutoSqueeze != enabled) { mAutoSqueeze = enabled; if (mAutoSqueeze) performAutoSqueeze(); } } /*! \overload Replaces the current data in this container with the provided \a data. \see add, remove */ template void QCPDataContainer::set(const QCPDataContainer &data) { clear(); add(data); } /*! \overload Replaces the current data in this container with the provided \a data If you can guarantee that the data points in \a data have ascending order with respect to the DataType's sort key, set \a alreadySorted to true to avoid an unnecessary sorting run. \see add, remove */ template void QCPDataContainer::set(const QVector &data, bool alreadySorted) { mData = data; mPreallocSize = 0; mPreallocIteration = 0; if (!alreadySorted) sort(); } /*! \overload Adds the provided \a data to the current data in this container. \see set, remove */ template void QCPDataContainer::add(const QCPDataContainer &data) { if (data.isEmpty()) return; const int n = data.size(); const int oldSize = size(); if (oldSize > 0 && !qcpLessThanSortKey(*constBegin(), *(data.constEnd()-1))) // prepend if new data keys are all smaller than or equal to existing ones { if (mPreallocSize < n) preallocateGrow(n); mPreallocSize -= n; std::copy(data.constBegin(), data.constEnd(), begin()); } else // don't need to prepend, so append and merge if necessary { mData.resize(mData.size()+n); std::copy(data.constBegin(), data.constEnd(), end()-n); if (oldSize > 0 && !qcpLessThanSortKey(*(constEnd()-n-1), *(constEnd()-n))) // if appended range keys aren't all greater than existing ones, merge the two partitions std::inplace_merge(begin(), end()-n, end(), qcpLessThanSortKey); } } /*! Adds the provided data points in \a data to the current data. If you can guarantee that the data points in \a data have ascending order with respect to the DataType's sort key, set \a alreadySorted to true to avoid an unnecessary sorting run. \see set, remove */ template void QCPDataContainer::add(const QVector &data, bool alreadySorted) { if (data.isEmpty()) return; if (isEmpty()) { set(data, alreadySorted); return; } const int n = data.size(); const int oldSize = size(); if (alreadySorted && oldSize > 0 && !qcpLessThanSortKey(*constBegin(), *(data.constEnd()-1))) // prepend if new data is sorted and keys are all smaller than or equal to existing ones { if (mPreallocSize < n) preallocateGrow(n); mPreallocSize -= n; std::copy(data.constBegin(), data.constEnd(), begin()); } else // don't need to prepend, so append and then sort and merge if necessary { mData.resize(mData.size()+n); std::copy(data.constBegin(), data.constEnd(), end()-n); if (!alreadySorted) // sort appended subrange if it wasn't already sorted std::sort(end()-n, end(), qcpLessThanSortKey); if (oldSize > 0 && !qcpLessThanSortKey(*(constEnd()-n-1), *(constEnd()-n))) // if appended range keys aren't all greater than existing ones, merge the two partitions std::inplace_merge(begin(), end()-n, end(), qcpLessThanSortKey); } } /*! \overload Adds the provided single data point to the current data. \see remove */ template void QCPDataContainer::add(const DataType &data) { if (isEmpty() || !qcpLessThanSortKey(data, *(constEnd()-1))) // quickly handle appends if new data key is greater or equal to existing ones { mData.append(data); } else if (qcpLessThanSortKey(data, *constBegin())) // quickly handle prepends using preallocated space { if (mPreallocSize < 1) preallocateGrow(1); --mPreallocSize; *begin() = data; } else // handle inserts, maintaining sorted keys { QCPDataContainer::iterator insertionPoint = std::lower_bound(begin(), end(), data, qcpLessThanSortKey); mData.insert(insertionPoint, data); } } /*! Removes all data points with (sort-)keys smaller than or equal to \a sortKey. \see removeAfter, remove, clear */ template void QCPDataContainer::removeBefore(double sortKey) { QCPDataContainer::iterator it = begin(); QCPDataContainer::iterator itEnd = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); mPreallocSize += int(itEnd-it); // don't actually delete, just add it to the preallocated block (if it gets too large, squeeze will take care of it) if (mAutoSqueeze) performAutoSqueeze(); } /*! Removes all data points with (sort-)keys greater than or equal to \a sortKey. \see removeBefore, remove, clear */ template void QCPDataContainer::removeAfter(double sortKey) { QCPDataContainer::iterator it = std::upper_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); QCPDataContainer::iterator itEnd = end(); mData.erase(it, itEnd); // typically adds it to the postallocated block if (mAutoSqueeze) performAutoSqueeze(); } /*! Removes all data points with (sort-)keys between \a sortKeyFrom and \a sortKeyTo. if \a sortKeyFrom is greater or equal to \a sortKeyTo, the function does nothing. To remove a single data point with known (sort-)key, use \ref remove(double sortKey). \see removeBefore, removeAfter, clear */ template void QCPDataContainer::remove(double sortKeyFrom, double sortKeyTo) { if (sortKeyFrom >= sortKeyTo || isEmpty()) return; QCPDataContainer::iterator it = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKeyFrom), qcpLessThanSortKey); QCPDataContainer::iterator itEnd = std::upper_bound(it, end(), DataType::fromSortKey(sortKeyTo), qcpLessThanSortKey); mData.erase(it, itEnd); if (mAutoSqueeze) performAutoSqueeze(); } /*! \overload Removes a single data point at \a sortKey. If the position is not known with absolute (binary) precision, consider using \ref remove(double sortKeyFrom, double sortKeyTo) with a small fuzziness interval around the suspected position, depeding on the precision with which the (sort-)key is known. \see removeBefore, removeAfter, clear */ template void QCPDataContainer::remove(double sortKey) { QCPDataContainer::iterator it = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); if (it != end() && it->sortKey() == sortKey) { if (it == begin()) ++mPreallocSize; // don't actually delete, just add it to the preallocated block (if it gets too large, squeeze will take care of it) else mData.erase(it); } if (mAutoSqueeze) performAutoSqueeze(); } /*! Removes all data points. \see remove, removeAfter, removeBefore */ template void QCPDataContainer::clear() { mData.clear(); mPreallocIteration = 0; mPreallocSize = 0; } /*! Re-sorts all data points in the container by their sort key. When setting, adding or removing points using the QCPDataContainer interface (\ref set, \ref add, \ref remove, etc.), the container makes sure to always stay in a sorted state such that a full resort is never necessary. However, if you choose to directly manipulate the sort key on data points by accessing and modifying it through the non-const iterators (\ref begin, \ref end), it is your responsibility to bring the container back into a sorted state before any other methods are called on it. This can be achieved by calling this method immediately after finishing the sort key manipulation. */ template void QCPDataContainer::sort() { std::sort(begin(), end(), qcpLessThanSortKey); } /*! Frees all unused memory that is currently in the preallocation and postallocation pools. Note that QCPDataContainer automatically decides whether squeezing is necessary, if \ref setAutoSqueeze is left enabled. It should thus not be necessary to use this method for typical applications. The parameters \a preAllocation and \a postAllocation control whether pre- and/or post allocation should be freed, respectively. */ template void QCPDataContainer::squeeze(bool preAllocation, bool postAllocation) { if (preAllocation) { if (mPreallocSize > 0) { std::copy(begin(), end(), mData.begin()); mData.resize(size()); mPreallocSize = 0; } mPreallocIteration = 0; } if (postAllocation) mData.squeeze(); } /*! Returns an iterator to the data point with a (sort-)key that is equal to, just below, or just above \a sortKey. If \a expandedRange is true, the data point just below \a sortKey will be considered, otherwise the one just above. This can be used in conjunction with \ref findEnd to iterate over data points within a given key range, including or excluding the bounding data points that are just beyond the specified range. If \a expandedRange is true but there are no data points below \a sortKey, \ref constBegin is returned. If the container is empty, returns \ref constEnd. \see findEnd, QCPPlottableInterface1D::findBegin */ template typename QCPDataContainer::const_iterator QCPDataContainer::findBegin(double sortKey, bool expandedRange) const { if (isEmpty()) return constEnd(); QCPDataContainer::const_iterator it = std::lower_bound(constBegin(), constEnd(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); if (expandedRange && it != constBegin()) // also covers it == constEnd case, and we know --constEnd is valid because mData isn't empty --it; return it; } /*! Returns an iterator to the element after the data point with a (sort-)key that is equal to, just above or just below \a sortKey. If \a expandedRange is true, the data point just above \a sortKey will be considered, otherwise the one just below. This can be used in conjunction with \ref findBegin to iterate over data points within a given key range, including the bounding data points that are just below and above the specified range. If \a expandedRange is true but there are no data points above \a sortKey, \ref constEnd is returned. If the container is empty, \ref constEnd is returned. \see findBegin, QCPPlottableInterface1D::findEnd */ template typename QCPDataContainer::const_iterator QCPDataContainer::findEnd(double sortKey, bool expandedRange) const { if (isEmpty()) return constEnd(); QCPDataContainer::const_iterator it = std::upper_bound(constBegin(), constEnd(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); if (expandedRange && it != constEnd()) ++it; return it; } /*! Returns the range encompassed by the (main-)key coordinate of all data points. The output parameter \a foundRange indicates whether a sensible range was found. If this is false, you should not use the returned QCPRange (e.g. the data container is empty or all points have the same key). Use \a signDomain to control which sign of the key coordinates should be considered. This is relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a time. If the DataType reports that its main key is equal to the sort key (\a sortKeyIsMainKey), as is the case for most plottables, this method uses this fact and finds the range very quickly. \see valueRange */ template QCPRange QCPDataContainer::keyRange(bool &foundRange, QCP::SignDomain signDomain) { if (isEmpty()) { foundRange = false; return QCPRange(); } QCPRange range; bool haveLower = false; bool haveUpper = false; double current; QCPDataContainer::const_iterator it = constBegin(); QCPDataContainer::const_iterator itEnd = constEnd(); if (signDomain == QCP::sdBoth) // range may be anywhere { if (DataType::sortKeyIsMainKey()) // if DataType is sorted by main key (e.g. QCPGraph, but not QCPCurve), use faster algorithm by finding just first and last key with non-NaN value { while (it != itEnd) // find first non-nan going up from left { if (!qIsNaN(it->mainValue())) { range.lower = it->mainKey(); haveLower = true; break; } ++it; } it = itEnd; while (it != constBegin()) // find first non-nan going down from right { --it; if (!qIsNaN(it->mainValue())) { range.upper = it->mainKey(); haveUpper = true; break; } } } else // DataType is not sorted by main key, go through all data points and accordingly expand range { while (it != itEnd) { if (!qIsNaN(it->mainValue())) { current = it->mainKey(); if (current < range.lower || !haveLower) { range.lower = current; haveLower = true; } if (current > range.upper || !haveUpper) { range.upper = current; haveUpper = true; } } ++it; } } } else if (signDomain == QCP::sdNegative) // range may only be in the negative sign domain { while (it != itEnd) { if (!qIsNaN(it->mainValue())) { current = it->mainKey(); if ((current < range.lower || !haveLower) && current < 0) { range.lower = current; haveLower = true; } if ((current > range.upper || !haveUpper) && current < 0) { range.upper = current; haveUpper = true; } } ++it; } } else if (signDomain == QCP::sdPositive) // range may only be in the positive sign domain { while (it != itEnd) { if (!qIsNaN(it->mainValue())) { current = it->mainKey(); if ((current < range.lower || !haveLower) && current > 0) { range.lower = current; haveLower = true; } if ((current > range.upper || !haveUpper) && current > 0) { range.upper = current; haveUpper = true; } } ++it; } } foundRange = haveLower && haveUpper; return range; } /*! Returns the range encompassed by the value coordinates of the data points in the specified key range (\a inKeyRange), using the full \a DataType::valueRange reported by the data points. The output parameter \a foundRange indicates whether a sensible range was found. If this is false, you should not use the returned QCPRange (e.g. the data container is empty or all points have the same value). If \a inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), all data points are considered, without any restriction on the keys. Use \a signDomain to control which sign of the value coordinates should be considered. This is relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a time. \see keyRange */ template QCPRange QCPDataContainer::valueRange(bool &foundRange, QCP::SignDomain signDomain, const QCPRange &inKeyRange) { if (isEmpty()) { foundRange = false; return QCPRange(); } QCPRange range; const bool restrictKeyRange = inKeyRange != QCPRange(); bool haveLower = false; bool haveUpper = false; QCPRange current; QCPDataContainer::const_iterator itBegin = constBegin(); QCPDataContainer::const_iterator itEnd = constEnd(); if (DataType::sortKeyIsMainKey() && restrictKeyRange) { itBegin = findBegin(inKeyRange.lower, false); itEnd = findEnd(inKeyRange.upper, false); } if (signDomain == QCP::sdBoth) // range may be anywhere { for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) { if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) continue; current = it->valueRange(); if ((current.lower < range.lower || !haveLower) && !qIsNaN(current.lower)) { range.lower = current.lower; haveLower = true; } if ((current.upper > range.upper || !haveUpper) && !qIsNaN(current.upper)) { range.upper = current.upper; haveUpper = true; } } } else if (signDomain == QCP::sdNegative) // range may only be in the negative sign domain { for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) { if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) continue; current = it->valueRange(); if ((current.lower < range.lower || !haveLower) && current.lower < 0 && !qIsNaN(current.lower)) { range.lower = current.lower; haveLower = true; } if ((current.upper > range.upper || !haveUpper) && current.upper < 0 && !qIsNaN(current.upper)) { range.upper = current.upper; haveUpper = true; } } } else if (signDomain == QCP::sdPositive) // range may only be in the positive sign domain { for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) { if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) continue; current = it->valueRange(); if ((current.lower < range.lower || !haveLower) && current.lower > 0 && !qIsNaN(current.lower)) { range.lower = current.lower; haveLower = true; } if ((current.upper > range.upper || !haveUpper) && current.upper > 0 && !qIsNaN(current.upper)) { range.upper = current.upper; haveUpper = true; } } } foundRange = haveLower && haveUpper; return range; } /*! Makes sure \a begin and \a end mark a data range that is both within the bounds of this data container's data, as well as within the specified \a dataRange. The initial range described by the passed iterators \a begin and \a end is never expanded, only contracted if necessary. This function doesn't require for \a dataRange to be within the bounds of this data container's valid range. */ template void QCPDataContainer::limitIteratorsToDataRange(const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const { QCPDataRange iteratorRange(int(begin-constBegin()), int(end-constBegin())); iteratorRange = iteratorRange.bounded(dataRange.bounded(this->dataRange())); begin = constBegin()+iteratorRange.begin(); end = constBegin()+iteratorRange.end(); } /*! \internal Increases the preallocation pool to have a size of at least \a minimumPreallocSize. Depending on the preallocation history, the container will grow by more than requested, to speed up future consecutive size increases. if \a minimumPreallocSize is smaller than or equal to the current preallocation pool size, this method does nothing. */ template void QCPDataContainer::preallocateGrow(int minimumPreallocSize) { if (minimumPreallocSize <= mPreallocSize) return; int newPreallocSize = minimumPreallocSize; newPreallocSize += (1u< void QCPDataContainer::performAutoSqueeze() { const int totalAlloc = mData.capacity(); const int postAllocSize = totalAlloc-mData.size(); const int usedSize = size(); bool shrinkPostAllocation = false; bool shrinkPreAllocation = false; if (totalAlloc > 650000) // if allocation is larger, shrink earlier with respect to total used size { shrinkPostAllocation = postAllocSize > usedSize*1.5; // QVector grow strategy is 2^n for static data. Watch out not to oscillate! shrinkPreAllocation = mPreallocSize*10 > usedSize; } else if (totalAlloc > 1000) // below 10 MiB raw data be generous with preallocated memory, below 1k points don't even bother { shrinkPostAllocation = postAllocSize > usedSize*5; shrinkPreAllocation = mPreallocSize > usedSize*1.5; // preallocation can grow into postallocation, so can be smaller } if (shrinkPreAllocation || shrinkPostAllocation) squeeze(shrinkPreAllocation, shrinkPostAllocation); } /* end of 'src/datacontainer.h' */ /* including file 'src/plottable.h' */ /* modified 2021-03-29T02:30:44, size 8461 */ class QCP_LIB_DECL QCPSelectionDecorator { Q_GADGET public: QCPSelectionDecorator(); virtual ~QCPSelectionDecorator(); // getters: QPen pen() const { return mPen; } QBrush brush() const { return mBrush; } QCPScatterStyle scatterStyle() const { return mScatterStyle; } QCPScatterStyle::ScatterProperties usedScatterProperties() const { return mUsedScatterProperties; } // setters: void setPen(const QPen &pen); void setBrush(const QBrush &brush); void setScatterStyle(const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties=QCPScatterStyle::spPen); void setUsedScatterProperties(const QCPScatterStyle::ScatterProperties &properties); // non-virtual methods: void applyPen(QCPPainter *painter) const; void applyBrush(QCPPainter *painter) const; QCPScatterStyle getFinalScatterStyle(const QCPScatterStyle &unselectedStyle) const; // introduced virtual methods: virtual void copyFrom(const QCPSelectionDecorator *other); virtual void drawDecoration(QCPPainter *painter, QCPDataSelection selection); protected: // property members: QPen mPen; QBrush mBrush; QCPScatterStyle mScatterStyle; QCPScatterStyle::ScatterProperties mUsedScatterProperties; // non-property members: QCPAbstractPlottable *mPlottable; // introduced virtual methods: virtual bool registerWithPlottable(QCPAbstractPlottable *plottable); private: Q_DISABLE_COPY(QCPSelectionDecorator) friend class QCPAbstractPlottable; }; Q_DECLARE_METATYPE(QCPSelectionDecorator*) class QCP_LIB_DECL QCPAbstractPlottable : public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QString name READ name WRITE setName) Q_PROPERTY(bool antialiasedFill READ antialiasedFill WRITE setAntialiasedFill) Q_PROPERTY(bool antialiasedScatters READ antialiasedScatters WRITE setAntialiasedScatters) Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QBrush brush READ brush WRITE setBrush) Q_PROPERTY(QCPAxis* keyAxis READ keyAxis WRITE setKeyAxis) Q_PROPERTY(QCPAxis* valueAxis READ valueAxis WRITE setValueAxis) Q_PROPERTY(QCP::SelectionType selectable READ selectable WRITE setSelectable NOTIFY selectableChanged) Q_PROPERTY(QCPDataSelection selection READ selection WRITE setSelection NOTIFY selectionChanged) Q_PROPERTY(QCPSelectionDecorator* selectionDecorator READ selectionDecorator WRITE setSelectionDecorator) /// \endcond public: QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPAbstractPlottable() Q_DECL_OVERRIDE; // getters: QString name() const { return mName; } bool antialiasedFill() const { return mAntialiasedFill; } bool antialiasedScatters() const { return mAntialiasedScatters; } QPen pen() const { return mPen; } QBrush brush() const { return mBrush; } QCPAxis *keyAxis() const { return mKeyAxis.data(); } QCPAxis *valueAxis() const { return mValueAxis.data(); } QCP::SelectionType selectable() const { return mSelectable; } bool selected() const { return !mSelection.isEmpty(); } QCPDataSelection selection() const { return mSelection; } QCPSelectionDecorator *selectionDecorator() const { return mSelectionDecorator; } // setters: void setName(const QString &name); void setAntialiasedFill(bool enabled); void setAntialiasedScatters(bool enabled); void setPen(const QPen &pen); void setBrush(const QBrush &brush); void setKeyAxis(QCPAxis *axis); void setValueAxis(QCPAxis *axis); Q_SLOT void setSelectable(QCP::SelectionType selectable); Q_SLOT void setSelection(QCPDataSelection selection); void setSelectionDecorator(QCPSelectionDecorator *decorator); // introduced virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE = 0; // actually introduced in QCPLayerable as non-pure, but we want to force reimplementation for plottables virtual QCPPlottableInterface1D *interface1D() { return nullptr; } virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const = 0; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const = 0; // non-property methods: void coordsToPixels(double key, double value, double &x, double &y) const; const QPointF coordsToPixels(double key, double value) const; void pixelsToCoords(double x, double y, double &key, double &value) const; void pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const; void rescaleAxes(bool onlyEnlarge=false) const; void rescaleKeyAxis(bool onlyEnlarge=false) const; void rescaleValueAxis(bool onlyEnlarge=false, bool inKeyRange=false) const; bool addToLegend(QCPLegend *legend); bool addToLegend(); bool removeFromLegend(QCPLegend *legend) const; bool removeFromLegend() const; signals: void selectionChanged(bool selected); void selectionChanged(const QCPDataSelection &selection); void selectableChanged(QCP::SelectionType selectable); protected: // property members: QString mName; bool mAntialiasedFill, mAntialiasedScatters; QPen mPen; QBrush mBrush; QPointer mKeyAxis, mValueAxis; QCP::SelectionType mSelectable; QCPDataSelection mSelection; QCPSelectionDecorator *mSelectionDecorator; // reimplemented virtual methods: virtual QRect clipRect() const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; // introduced virtual methods: virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const = 0; // non-virtual methods: void applyFillAntialiasingHint(QCPPainter *painter) const; void applyScattersAntialiasingHint(QCPPainter *painter) const; private: Q_DISABLE_COPY(QCPAbstractPlottable) friend class QCustomPlot; friend class QCPAxis; friend class QCPPlottableLegendItem; }; /* end of 'src/plottable.h' */ /* including file 'src/item.h' */ /* modified 2021-03-29T02:30:44, size 9425 */ class QCP_LIB_DECL QCPItemAnchor { Q_GADGET public: QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId=-1); virtual ~QCPItemAnchor(); // getters: QString name() const { return mName; } virtual QPointF pixelPosition() const; protected: // property members: QString mName; // non-property members: QCustomPlot *mParentPlot; QCPAbstractItem *mParentItem; int mAnchorId; QSet mChildrenX, mChildrenY; // introduced virtual methods: virtual QCPItemPosition *toQCPItemPosition() { return nullptr; } // non-virtual methods: void addChildX(QCPItemPosition* pos); // called from pos when this anchor is set as parent void removeChildX(QCPItemPosition *pos); // called from pos when its parent anchor is reset or pos deleted void addChildY(QCPItemPosition* pos); // called from pos when this anchor is set as parent void removeChildY(QCPItemPosition *pos); // called from pos when its parent anchor is reset or pos deleted private: Q_DISABLE_COPY(QCPItemAnchor) friend class QCPItemPosition; }; class QCP_LIB_DECL QCPItemPosition : public QCPItemAnchor { Q_GADGET public: /*! Defines the ways an item position can be specified. Thus it defines what the numbers passed to \ref setCoords actually mean. \see setType */ enum PositionType { ptAbsolute ///< Static positioning in pixels, starting from the top left corner of the viewport/widget. ,ptViewportRatio ///< Static positioning given by a fraction of the viewport size. For example, if you call setCoords(0, 0), the position will be at the top ///< left corner of the viewport/widget. setCoords(1, 1) will be at the bottom right corner, setCoords(0.5, 0) will be horizontally centered and ///< vertically at the top of the viewport/widget, etc. ,ptAxisRectRatio ///< Static positioning given by a fraction of the axis rect size (see \ref setAxisRect). For example, if you call setCoords(0, 0), the position will be at the top ///< left corner of the axis rect. setCoords(1, 1) will be at the bottom right corner, setCoords(0.5, 0) will be horizontally centered and ///< vertically at the top of the axis rect, etc. You can also go beyond the axis rect by providing negative coordinates or coordinates larger than 1. ,ptPlotCoords ///< Dynamic positioning at a plot coordinate defined by two axes (see \ref setAxes). }; Q_ENUMS(PositionType) QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name); virtual ~QCPItemPosition() Q_DECL_OVERRIDE; // getters: PositionType type() const { return typeX(); } PositionType typeX() const { return mPositionTypeX; } PositionType typeY() const { return mPositionTypeY; } QCPItemAnchor *parentAnchor() const { return parentAnchorX(); } QCPItemAnchor *parentAnchorX() const { return mParentAnchorX; } QCPItemAnchor *parentAnchorY() const { return mParentAnchorY; } double key() const { return mKey; } double value() const { return mValue; } QPointF coords() const { return QPointF(mKey, mValue); } QCPAxis *keyAxis() const { return mKeyAxis.data(); } QCPAxis *valueAxis() const { return mValueAxis.data(); } QCPAxisRect *axisRect() const; virtual QPointF pixelPosition() const Q_DECL_OVERRIDE; // setters: void setType(PositionType type); void setTypeX(PositionType type); void setTypeY(PositionType type); bool setParentAnchor(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false); bool setParentAnchorX(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false); bool setParentAnchorY(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false); void setCoords(double key, double value); void setCoords(const QPointF &pos); void setAxes(QCPAxis* keyAxis, QCPAxis* valueAxis); void setAxisRect(QCPAxisRect *axisRect); void setPixelPosition(const QPointF &pixelPosition); protected: // property members: PositionType mPositionTypeX, mPositionTypeY; QPointer mKeyAxis, mValueAxis; QPointer mAxisRect; double mKey, mValue; QCPItemAnchor *mParentAnchorX, *mParentAnchorY; // reimplemented virtual methods: virtual QCPItemPosition *toQCPItemPosition() Q_DECL_OVERRIDE { return this; } private: Q_DISABLE_COPY(QCPItemPosition) }; Q_DECLARE_METATYPE(QCPItemPosition::PositionType) class QCP_LIB_DECL QCPAbstractItem : public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(bool clipToAxisRect READ clipToAxisRect WRITE setClipToAxisRect) Q_PROPERTY(QCPAxisRect* clipAxisRect READ clipAxisRect WRITE setClipAxisRect) Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectableChanged) Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectionChanged) /// \endcond public: explicit QCPAbstractItem(QCustomPlot *parentPlot); virtual ~QCPAbstractItem() Q_DECL_OVERRIDE; // getters: bool clipToAxisRect() const { return mClipToAxisRect; } QCPAxisRect *clipAxisRect() const; bool selectable() const { return mSelectable; } bool selected() const { return mSelected; } // setters: void setClipToAxisRect(bool clip); void setClipAxisRect(QCPAxisRect *rect); Q_SLOT void setSelectable(bool selectable); Q_SLOT void setSelected(bool selected); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE = 0; // non-virtual methods: QList positions() const { return mPositions; } QList anchors() const { return mAnchors; } QCPItemPosition *position(const QString &name) const; QCPItemAnchor *anchor(const QString &name) const; bool hasAnchor(const QString &name) const; signals: void selectionChanged(bool selected); void selectableChanged(bool selectable); protected: // property members: bool mClipToAxisRect; QPointer mClipAxisRect; QList mPositions; QList mAnchors; bool mSelectable, mSelected; // reimplemented virtual methods: virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; virtual QRect clipRect() const Q_DECL_OVERRIDE; virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; // introduced virtual methods: virtual QPointF anchorPixelPosition(int anchorId) const; // non-virtual methods: double rectDistance(const QRectF &rect, const QPointF &pos, bool filledRect) const; QCPItemPosition *createPosition(const QString &name); QCPItemAnchor *createAnchor(const QString &name, int anchorId); private: Q_DISABLE_COPY(QCPAbstractItem) friend class QCustomPlot; friend class QCPItemAnchor; }; /* end of 'src/item.h' */ /* including file 'src/core.h' */ /* modified 2021-03-29T02:30:44, size 19304 */ class QCP_LIB_DECL QCustomPlot : public QWidget { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QRect viewport READ viewport WRITE setViewport) Q_PROPERTY(QPixmap background READ background WRITE setBackground) Q_PROPERTY(bool backgroundScaled READ backgroundScaled WRITE setBackgroundScaled) Q_PROPERTY(Qt::AspectRatioMode backgroundScaledMode READ backgroundScaledMode WRITE setBackgroundScaledMode) Q_PROPERTY(QCPLayoutGrid* plotLayout READ plotLayout) Q_PROPERTY(bool autoAddPlottableToLegend READ autoAddPlottableToLegend WRITE setAutoAddPlottableToLegend) Q_PROPERTY(int selectionTolerance READ selectionTolerance WRITE setSelectionTolerance) Q_PROPERTY(bool noAntialiasingOnDrag READ noAntialiasingOnDrag WRITE setNoAntialiasingOnDrag) Q_PROPERTY(Qt::KeyboardModifier multiSelectModifier READ multiSelectModifier WRITE setMultiSelectModifier) Q_PROPERTY(bool openGl READ openGl WRITE setOpenGl) /// \endcond public: /*! Defines how a layer should be inserted relative to an other layer. \see addLayer, moveLayer */ enum LayerInsertMode { limBelow ///< Layer is inserted below other layer ,limAbove ///< Layer is inserted above other layer }; Q_ENUMS(LayerInsertMode) /*! Defines with what timing the QCustomPlot surface is refreshed after a replot. \see replot */ enum RefreshPriority { rpImmediateRefresh ///< Replots immediately and repaints the widget immediately by calling QWidget::repaint() after the replot ,rpQueuedRefresh ///< Replots immediately, but queues the widget repaint, by calling QWidget::update() after the replot. This way multiple redundant widget repaints can be avoided. ,rpRefreshHint ///< Whether to use immediate or queued refresh depends on whether the plotting hint \ref QCP::phImmediateRefresh is set, see \ref setPlottingHints. ,rpQueuedReplot ///< Queues the entire replot for the next event loop iteration. This way multiple redundant replots can be avoided. The actual replot is then done with \ref rpRefreshHint priority. }; Q_ENUMS(RefreshPriority) explicit QCustomPlot(QWidget *parent = nullptr); virtual ~QCustomPlot() Q_DECL_OVERRIDE; // getters: QRect viewport() const { return mViewport; } double bufferDevicePixelRatio() const { return mBufferDevicePixelRatio; } QPixmap background() const { return mBackgroundPixmap; } bool backgroundScaled() const { return mBackgroundScaled; } Qt::AspectRatioMode backgroundScaledMode() const { return mBackgroundScaledMode; } QCPLayoutGrid *plotLayout() const { return mPlotLayout; } QCP::AntialiasedElements antialiasedElements() const { return mAntialiasedElements; } QCP::AntialiasedElements notAntialiasedElements() const { return mNotAntialiasedElements; } bool autoAddPlottableToLegend() const { return mAutoAddPlottableToLegend; } const QCP::Interactions interactions() const { return mInteractions; } int selectionTolerance() const { return mSelectionTolerance; } bool noAntialiasingOnDrag() const { return mNoAntialiasingOnDrag; } QCP::PlottingHints plottingHints() const { return mPlottingHints; } Qt::KeyboardModifier multiSelectModifier() const { return mMultiSelectModifier; } QCP::SelectionRectMode selectionRectMode() const { return mSelectionRectMode; } QCPSelectionRect *selectionRect() const { return mSelectionRect; } bool openGl() const { return mOpenGl; } // setters: void setViewport(const QRect &rect); void setBufferDevicePixelRatio(double ratio); void setBackground(const QPixmap &pm); void setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding); void setBackground(const QBrush &brush); void setBackgroundScaled(bool scaled); void setBackgroundScaledMode(Qt::AspectRatioMode mode); void setAntialiasedElements(const QCP::AntialiasedElements &antialiasedElements); void setAntialiasedElement(QCP::AntialiasedElement antialiasedElement, bool enabled=true); void setNotAntialiasedElements(const QCP::AntialiasedElements ¬AntialiasedElements); void setNotAntialiasedElement(QCP::AntialiasedElement notAntialiasedElement, bool enabled=true); void setAutoAddPlottableToLegend(bool on); void setInteractions(const QCP::Interactions &interactions); void setInteraction(const QCP::Interaction &interaction, bool enabled=true); void setSelectionTolerance(int pixels); void setNoAntialiasingOnDrag(bool enabled); void setPlottingHints(const QCP::PlottingHints &hints); void setPlottingHint(QCP::PlottingHint hint, bool enabled=true); void setMultiSelectModifier(Qt::KeyboardModifier modifier); void setSelectionRectMode(QCP::SelectionRectMode mode); void setSelectionRect(QCPSelectionRect *selectionRect); void setOpenGl(bool enabled, int multisampling=16); // non-property methods: // plottable interface: QCPAbstractPlottable *plottable(int index); QCPAbstractPlottable *plottable(); bool removePlottable(QCPAbstractPlottable *plottable); bool removePlottable(int index); int clearPlottables(); int plottableCount() const; QList selectedPlottables() const; template PlottableType *plottableAt(const QPointF &pos, bool onlySelectable=false, int *dataIndex=nullptr) const; QCPAbstractPlottable *plottableAt(const QPointF &pos, bool onlySelectable=false, int *dataIndex=nullptr) const; bool hasPlottable(QCPAbstractPlottable *plottable) const; // specialized interface for QCPGraph: QCPGraph *graph(int index) const; QCPGraph *graph() const; QCPGraph *addGraph(QCPAxis *keyAxis=nullptr, QCPAxis *valueAxis=nullptr); bool removeGraph(QCPGraph *graph); bool removeGraph(int index); int clearGraphs(); int graphCount() const; QList selectedGraphs() const; // item interface: QCPAbstractItem *item(int index) const; QCPAbstractItem *item() const; bool removeItem(QCPAbstractItem *item); bool removeItem(int index); int clearItems(); int itemCount() const; QList selectedItems() const; template ItemType *itemAt(const QPointF &pos, bool onlySelectable=false) const; QCPAbstractItem *itemAt(const QPointF &pos, bool onlySelectable=false) const; bool hasItem(QCPAbstractItem *item) const; // layer interface: QCPLayer *layer(const QString &name) const; QCPLayer *layer(int index) const; QCPLayer *currentLayer() const; bool setCurrentLayer(const QString &name); bool setCurrentLayer(QCPLayer *layer); int layerCount() const; bool addLayer(const QString &name, QCPLayer *otherLayer=nullptr, LayerInsertMode insertMode=limAbove); bool removeLayer(QCPLayer *layer); bool moveLayer(QCPLayer *layer, QCPLayer *otherLayer, LayerInsertMode insertMode=limAbove); // axis rect/layout interface: int axisRectCount() const; QCPAxisRect* axisRect(int index=0) const; QList axisRects() const; QCPLayoutElement* layoutElementAt(const QPointF &pos) const; QCPAxisRect* axisRectAt(const QPointF &pos) const; Q_SLOT void rescaleAxes(bool onlyVisiblePlottables=false); QList selectedAxes() const; QList selectedLegends() const; Q_SLOT void deselectAll(); bool savePdf(const QString &fileName, int width=0, int height=0, QCP::ExportPen exportPen=QCP::epAllowCosmetic, const QString &pdfCreator=QString(), const QString &pdfTitle=QString()); bool savePng(const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); bool saveJpg(const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); bool saveBmp(const QString &fileName, int width=0, int height=0, double scale=1.0, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); bool saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); QPixmap toPixmap(int width=0, int height=0, double scale=1.0); void toPainter(QCPPainter *painter, int width=0, int height=0); Q_SLOT void replot(QCustomPlot::RefreshPriority refreshPriority=QCustomPlot::rpRefreshHint); double replotTime(bool average=false) const; QCPAxis *xAxis, *yAxis, *xAxis2, *yAxis2; QCPLegend *legend; signals: void mouseDoubleClick(QMouseEvent *event); void mousePress(QMouseEvent *event); void mouseMove(QMouseEvent *event); void mouseRelease(QMouseEvent *event); void mouseWheel(QWheelEvent *event); void plottableClick(QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event); void plottableDoubleClick(QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event); void itemClick(QCPAbstractItem *item, QMouseEvent *event); void itemDoubleClick(QCPAbstractItem *item, QMouseEvent *event); void axisClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event); void axisDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event); void legendClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event); void legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event); void selectionChangedByUser(); void beforeReplot(); void afterLayout(); void afterReplot(); protected: // property members: QRect mViewport; double mBufferDevicePixelRatio; QCPLayoutGrid *mPlotLayout; bool mAutoAddPlottableToLegend; QList mPlottables; QList mGraphs; // extra list of plottables also in mPlottables that are of type QCPGraph QList mItems; QList mLayers; QCP::AntialiasedElements mAntialiasedElements, mNotAntialiasedElements; QCP::Interactions mInteractions; int mSelectionTolerance; bool mNoAntialiasingOnDrag; QBrush mBackgroundBrush; QPixmap mBackgroundPixmap; QPixmap mScaledBackgroundPixmap; bool mBackgroundScaled; Qt::AspectRatioMode mBackgroundScaledMode; QCPLayer *mCurrentLayer; QCP::PlottingHints mPlottingHints; Qt::KeyboardModifier mMultiSelectModifier; QCP::SelectionRectMode mSelectionRectMode; QCPSelectionRect *mSelectionRect; bool mOpenGl; // non-property members: QList > mPaintBuffers; QPoint mMousePressPos; bool mMouseHasMoved; QPointer mMouseEventLayerable; QPointer mMouseSignalLayerable; QVariant mMouseEventLayerableDetails; QVariant mMouseSignalLayerableDetails; bool mReplotting; bool mReplotQueued; double mReplotTime, mReplotTimeAverage; int mOpenGlMultisamples; QCP::AntialiasedElements mOpenGlAntialiasedElementsBackup; bool mOpenGlCacheLabelsBackup; #ifdef QCP_OPENGL_FBO QSharedPointer mGlContext; QSharedPointer mGlSurface; QSharedPointer mGlPaintDevice; #endif // reimplemented virtual methods: virtual QSize minimumSizeHint() const Q_DECL_OVERRIDE; virtual QSize sizeHint() const Q_DECL_OVERRIDE; virtual void paintEvent(QPaintEvent *event) Q_DECL_OVERRIDE; virtual void resizeEvent(QResizeEvent *event) Q_DECL_OVERRIDE; virtual void mouseDoubleClickEvent(QMouseEvent *event) Q_DECL_OVERRIDE; virtual void mousePressEvent(QMouseEvent *event) Q_DECL_OVERRIDE; virtual void mouseMoveEvent(QMouseEvent *event) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event) Q_DECL_OVERRIDE; virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; // introduced virtual methods: virtual void draw(QCPPainter *painter); virtual void updateLayout(); virtual void axisRemoved(QCPAxis *axis); virtual void legendRemoved(QCPLegend *legend); Q_SLOT virtual void processRectSelection(QRect rect, QMouseEvent *event); Q_SLOT virtual void processRectZoom(QRect rect, QMouseEvent *event); Q_SLOT virtual void processPointSelection(QMouseEvent *event); // non-virtual methods: bool registerPlottable(QCPAbstractPlottable *plottable); bool registerGraph(QCPGraph *graph); bool registerItem(QCPAbstractItem* item); void updateLayerIndices() const; QCPLayerable *layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails=nullptr) const; QList layerableListAt(const QPointF &pos, bool onlySelectable, QList *selectionDetails=nullptr) const; void drawBackground(QCPPainter *painter); void setupPaintBuffers(); QCPAbstractPaintBuffer *createPaintBuffer(); bool hasInvalidatedPaintBuffers(); bool setupOpenGl(); void freeOpenGl(); friend class QCPLegend; friend class QCPAxis; friend class QCPLayer; friend class QCPAxisRect; friend class QCPAbstractPlottable; friend class QCPGraph; friend class QCPAbstractItem; }; Q_DECLARE_METATYPE(QCustomPlot::LayerInsertMode) Q_DECLARE_METATYPE(QCustomPlot::RefreshPriority) // implementation of template functions: /*! Returns the plottable at the pixel position \a pos. The plottable type (a QCPAbstractPlottable subclass) that shall be taken into consideration can be specified via the template parameter. Plottables that only consist of single lines (like graphs) have a tolerance band around them, see \ref setSelectionTolerance. If multiple plottables come into consideration, the one closest to \a pos is returned. If \a onlySelectable is true, only plottables that are selectable (QCPAbstractPlottable::setSelectable) are considered. if \a dataIndex is non-null, it is set to the index of the plottable's data point that is closest to \a pos. If there is no plottable of the specified type at \a pos, returns \c nullptr. \see itemAt, layoutElementAt */ template PlottableType *QCustomPlot::plottableAt(const QPointF &pos, bool onlySelectable, int *dataIndex) const { PlottableType *resultPlottable = 0; QVariant resultDetails; double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value foreach (QCPAbstractPlottable *plottable, mPlottables) { PlottableType *currentPlottable = qobject_cast(plottable); if (!currentPlottable || (onlySelectable && !currentPlottable->selectable())) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPAbstractPlottable::selectable continue; if (currentPlottable->clipRect().contains(pos.toPoint())) // only consider clicks where the plottable is actually visible { QVariant details; double currentDistance = currentPlottable->selectTest(pos, false, dataIndex ? &details : nullptr); if (currentDistance >= 0 && currentDistance < resultDistance) { resultPlottable = currentPlottable; resultDetails = details; resultDistance = currentDistance; } } } if (resultPlottable && dataIndex) { QCPDataSelection sel = resultDetails.value(); if (!sel.isEmpty()) *dataIndex = sel.dataRange(0).begin(); } return resultPlottable; } /*! Returns the item at the pixel position \a pos. The item type (a QCPAbstractItem subclass) that shall be taken into consideration can be specified via the template parameter. Items that only consist of single lines (e.g. \ref QCPItemLine or \ref QCPItemCurve) have a tolerance band around them, see \ref setSelectionTolerance. If multiple items come into consideration, the one closest to \a pos is returned. If \a onlySelectable is true, only items that are selectable (QCPAbstractItem::setSelectable) are considered. If there is no item at \a pos, returns \c nullptr. \see plottableAt, layoutElementAt */ template ItemType *QCustomPlot::itemAt(const QPointF &pos, bool onlySelectable) const { ItemType *resultItem = 0; double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value foreach (QCPAbstractItem *item, mItems) { ItemType *currentItem = qobject_cast(item); if (!currentItem || (onlySelectable && !currentItem->selectable())) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPAbstractItem::selectable continue; if (!currentItem->clipToAxisRect() || currentItem->clipRect().contains(pos.toPoint())) // only consider clicks inside axis cliprect of the item if actually clipped to it { double currentDistance = currentItem->selectTest(pos, false); if (currentDistance >= 0 && currentDistance < resultDistance) { resultItem = currentItem; resultDistance = currentDistance; } } } return resultItem; } /* end of 'src/core.h' */ /* including file 'src/plottable1d.h' */ /* modified 2021-03-29T02:30:44, size 25638 */ class QCPPlottableInterface1D { public: virtual ~QCPPlottableInterface1D() = default; // introduced pure virtual methods: virtual int dataCount() const = 0; virtual double dataMainKey(int index) const = 0; virtual double dataSortKey(int index) const = 0; virtual double dataMainValue(int index) const = 0; virtual QCPRange dataValueRange(int index) const = 0; virtual QPointF dataPixelPosition(int index) const = 0; virtual bool sortKeyIsMainKey() const = 0; virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const = 0; virtual int findBegin(double sortKey, bool expandedRange=true) const = 0; virtual int findEnd(double sortKey, bool expandedRange=true) const = 0; }; template class QCPAbstractPlottable1D : public QCPAbstractPlottable, public QCPPlottableInterface1D // no QCP_LIB_DECL, template class ends up in header (cpp included below) { // No Q_OBJECT macro due to template class public: QCPAbstractPlottable1D(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPAbstractPlottable1D() Q_DECL_OVERRIDE; // virtual methods of 1d plottable interface: virtual int dataCount() const Q_DECL_OVERRIDE; virtual double dataMainKey(int index) const Q_DECL_OVERRIDE; virtual double dataSortKey(int index) const Q_DECL_OVERRIDE; virtual double dataMainValue(int index) const Q_DECL_OVERRIDE; virtual QCPRange dataValueRange(int index) const Q_DECL_OVERRIDE; virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; virtual bool sortKeyIsMainKey() const Q_DECL_OVERRIDE; virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; virtual int findBegin(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; virtual int findEnd(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPPlottableInterface1D *interface1D() Q_DECL_OVERRIDE { return this; } protected: // property members: QSharedPointer > mDataContainer; // helpers for subclasses: void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; void drawPolyline(QCPPainter *painter, const QVector &lineData) const; private: Q_DISABLE_COPY(QCPAbstractPlottable1D) }; // include implementation in header since it is a class template: //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPPlottableInterface1D //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPPlottableInterface1D \brief Defines an abstract interface for one-dimensional plottables This class contains only pure virtual methods which define a common interface to the data of one-dimensional plottables. For example, it is implemented by the template class \ref QCPAbstractPlottable1D (the preferred base class for one-dimensional plottables). So if you use that template class as base class of your one-dimensional plottable, you won't have to care about implementing the 1d interface yourself. If your plottable doesn't derive from \ref QCPAbstractPlottable1D but still wants to provide a 1d interface (e.g. like \ref QCPErrorBars does), you should inherit from both \ref QCPAbstractPlottable and \ref QCPPlottableInterface1D and accordingly reimplement the pure virtual methods of the 1d interface, matching your data container. Also, reimplement \ref QCPAbstractPlottable::interface1D to return the \c this pointer. If you have a \ref QCPAbstractPlottable pointer, you can check whether it implements this interface by calling \ref QCPAbstractPlottable::interface1D and testing it for a non-zero return value. If it indeed implements this interface, you may use it to access the plottable's data without needing to know the exact type of the plottable or its data point type. */ /* start documentation of pure virtual functions */ /*! \fn virtual int QCPPlottableInterface1D::dataCount() const = 0; Returns the number of data points of the plottable. */ /*! \fn virtual QCPDataSelection QCPPlottableInterface1D::selectTestRect(const QRectF &rect, bool onlySelectable) const = 0; Returns a data selection containing all the data points of this plottable which are contained (or hit by) \a rect. This is used mainly in the selection rect interaction for data selection (\ref dataselection "data selection mechanism"). If \a onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not selectable (i.e. if \ref QCPAbstractPlottable::setSelectable is \ref QCP::stNone). \note \a rect must be a normalized rect (positive or zero width and height). This is especially important when using the rect of \ref QCPSelectionRect::accepted, which is not necessarily normalized. Use QRect::normalized() when passing a rect which might not be normalized. */ /*! \fn virtual double QCPPlottableInterface1D::dataMainKey(int index) const = 0 Returns the main key of the data point at the given \a index. What the main key is, is defined by the plottable's data type. See the \ref qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming convention. */ /*! \fn virtual double QCPPlottableInterface1D::dataSortKey(int index) const = 0 Returns the sort key of the data point at the given \a index. What the sort key is, is defined by the plottable's data type. See the \ref qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming convention. */ /*! \fn virtual double QCPPlottableInterface1D::dataMainValue(int index) const = 0 Returns the main value of the data point at the given \a index. What the main value is, is defined by the plottable's data type. See the \ref qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming convention. */ /*! \fn virtual QCPRange QCPPlottableInterface1D::dataValueRange(int index) const = 0 Returns the value range of the data point at the given \a index. What the value range is, is defined by the plottable's data type. See the \ref qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming convention. */ /*! \fn virtual QPointF QCPPlottableInterface1D::dataPixelPosition(int index) const = 0 Returns the pixel position on the widget surface at which the data point at the given \a index appears. Usually this corresponds to the point of \ref dataMainKey/\ref dataMainValue, in pixel coordinates. However, depending on the plottable, this might be a different apparent position than just a coord-to-pixel transform of those values. For example, \ref QCPBars apparent data values can be shifted depending on their stacking, bar grouping or configured base value. */ /*! \fn virtual bool QCPPlottableInterface1D::sortKeyIsMainKey() const = 0 Returns whether the sort key (\ref dataSortKey) is identical to the main key (\ref dataMainKey). What the sort and main keys are, is defined by the plottable's data type. See the \ref qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming convention. */ /*! \fn virtual int QCPPlottableInterface1D::findBegin(double sortKey, bool expandedRange) const = 0 Returns the index of the data point with a (sort-)key that is equal to, just below, or just above \a sortKey. If \a expandedRange is true, the data point just below \a sortKey will be considered, otherwise the one just above. This can be used in conjunction with \ref findEnd to iterate over data points within a given key range, including or excluding the bounding data points that are just beyond the specified range. If \a expandedRange is true but there are no data points below \a sortKey, 0 is returned. If the container is empty, returns 0 (in that case, \ref findEnd will also return 0, so a loop using these methods will not iterate over the index 0). \see findEnd, QCPDataContainer::findBegin */ /*! \fn virtual int QCPPlottableInterface1D::findEnd(double sortKey, bool expandedRange) const = 0 Returns the index one after the data point with a (sort-)key that is equal to, just above, or just below \a sortKey. If \a expandedRange is true, the data point just above \a sortKey will be considered, otherwise the one just below. This can be used in conjunction with \ref findBegin to iterate over data points within a given key range, including the bounding data points that are just below and above the specified range. If \a expandedRange is true but there are no data points above \a sortKey, the index just above the highest data point is returned. If the container is empty, returns 0. \see findBegin, QCPDataContainer::findEnd */ /* end documentation of pure virtual functions */ //////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////// QCPAbstractPlottable1D //////////////////////////////////////////////////////////////////////////////////////////////////// /*! \class QCPAbstractPlottable1D \brief A template base class for plottables with one-dimensional data This template class derives from \ref QCPAbstractPlottable and from the abstract interface \ref QCPPlottableInterface1D. It serves as a base class for all one-dimensional data (i.e. data with one key dimension), such as \ref QCPGraph and QCPCurve. The template parameter \a DataType is the type of the data points of this plottable (e.g. \ref QCPGraphData or \ref QCPCurveData). The main purpose of this base class is to provide the member \a mDataContainer (a shared pointer to a \ref QCPDataContainer "QCPDataContainer") and implement the according virtual methods of the \ref QCPPlottableInterface1D, such that most subclassed plottables don't need to worry about this anymore. Further, it provides a convenience method for retrieving selected/unselected data segments via \ref getDataSegments. This is useful when subclasses implement their \ref draw method and need to draw selected segments with a different pen/brush than unselected segments (also see \ref QCPSelectionDecorator). This class implements basic functionality of \ref QCPAbstractPlottable::selectTest and \ref QCPPlottableInterface1D::selectTestRect, assuming point-like data points, based on the 1D data interface. In spite of that, most plottable subclasses will want to reimplement those methods again, to provide a more accurate hit test based on their specific data visualization geometry. */ /* start documentation of inline functions */ /*! \fn QCPPlottableInterface1D *QCPAbstractPlottable1D::interface1D() Returns a \ref QCPPlottableInterface1D pointer to this plottable, providing access to its 1D interface. \seebaseclassmethod */ /* end documentation of inline functions */ /*! Forwards \a keyAxis and \a valueAxis to the \ref QCPAbstractPlottable::QCPAbstractPlottable "QCPAbstractPlottable" constructor and allocates the \a mDataContainer. */ template QCPAbstractPlottable1D::QCPAbstractPlottable1D(QCPAxis *keyAxis, QCPAxis *valueAxis) : QCPAbstractPlottable(keyAxis, valueAxis), mDataContainer(new QCPDataContainer) { } template QCPAbstractPlottable1D::~QCPAbstractPlottable1D() { } /*! \copydoc QCPPlottableInterface1D::dataCount */ template int QCPAbstractPlottable1D::dataCount() const { return mDataContainer->size(); } /*! \copydoc QCPPlottableInterface1D::dataMainKey */ template double QCPAbstractPlottable1D::dataMainKey(int index) const { if (index >= 0 && index < mDataContainer->size()) { return (mDataContainer->constBegin()+index)->mainKey(); } else { qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; return 0; } } /*! \copydoc QCPPlottableInterface1D::dataSortKey */ template double QCPAbstractPlottable1D::dataSortKey(int index) const { if (index >= 0 && index < mDataContainer->size()) { return (mDataContainer->constBegin()+index)->sortKey(); } else { qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; return 0; } } /*! \copydoc QCPPlottableInterface1D::dataMainValue */ template double QCPAbstractPlottable1D::dataMainValue(int index) const { if (index >= 0 && index < mDataContainer->size()) { return (mDataContainer->constBegin()+index)->mainValue(); } else { qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; return 0; } } /*! \copydoc QCPPlottableInterface1D::dataValueRange */ template QCPRange QCPAbstractPlottable1D::dataValueRange(int index) const { if (index >= 0 && index < mDataContainer->size()) { return (mDataContainer->constBegin()+index)->valueRange(); } else { qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; return QCPRange(0, 0); } } /*! \copydoc QCPPlottableInterface1D::dataPixelPosition */ template QPointF QCPAbstractPlottable1D::dataPixelPosition(int index) const { if (index >= 0 && index < mDataContainer->size()) { const typename QCPDataContainer::const_iterator it = mDataContainer->constBegin()+index; return coordsToPixels(it->mainKey(), it->mainValue()); } else { qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; return QPointF(); } } /*! \copydoc QCPPlottableInterface1D::sortKeyIsMainKey */ template bool QCPAbstractPlottable1D::sortKeyIsMainKey() const { return DataType::sortKeyIsMainKey(); } /*! Implements a rect-selection algorithm assuming the data (accessed via the 1D data interface) is point-like. Most subclasses will want to reimplement this method again, to provide a more accurate hit test based on the true data visualization geometry. \seebaseclassmethod */ template QCPDataSelection QCPAbstractPlottable1D::selectTestRect(const QRectF &rect, bool onlySelectable) const { QCPDataSelection result; if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return result; if (!mKeyAxis || !mValueAxis) return result; // convert rect given in pixels to ranges given in plot coordinates: double key1, value1, key2, value2; pixelsToCoords(rect.topLeft(), key1, value1); pixelsToCoords(rect.bottomRight(), key2, value2); QCPRange keyRange(key1, key2); // QCPRange normalizes internally so we don't have to care about whether key1 < key2 QCPRange valueRange(value1, value2); typename QCPDataContainer::const_iterator begin = mDataContainer->constBegin(); typename QCPDataContainer::const_iterator end = mDataContainer->constEnd(); if (DataType::sortKeyIsMainKey()) // we can assume that data is sorted by main key, so can reduce the searched key interval: { begin = mDataContainer->findBegin(keyRange.lower, false); end = mDataContainer->findEnd(keyRange.upper, false); } if (begin == end) return result; int currentSegmentBegin = -1; // -1 means we're currently not in a segment that's contained in rect for (typename QCPDataContainer::const_iterator it=begin; it!=end; ++it) { if (currentSegmentBegin == -1) { if (valueRange.contains(it->mainValue()) && keyRange.contains(it->mainKey())) // start segment currentSegmentBegin = int(it-mDataContainer->constBegin()); } else if (!valueRange.contains(it->mainValue()) || !keyRange.contains(it->mainKey())) // segment just ended { result.addDataRange(QCPDataRange(currentSegmentBegin, int(it-mDataContainer->constBegin())), false); currentSegmentBegin = -1; } } // process potential last segment: if (currentSegmentBegin != -1) result.addDataRange(QCPDataRange(currentSegmentBegin, int(end-mDataContainer->constBegin())), false); result.simplify(); return result; } /*! \copydoc QCPPlottableInterface1D::findBegin */ template int QCPAbstractPlottable1D::findBegin(double sortKey, bool expandedRange) const { return int(mDataContainer->findBegin(sortKey, expandedRange)-mDataContainer->constBegin()); } /*! \copydoc QCPPlottableInterface1D::findEnd */ template int QCPAbstractPlottable1D::findEnd(double sortKey, bool expandedRange) const { return int(mDataContainer->findEnd(sortKey, expandedRange)-mDataContainer->constBegin()); } /*! Implements a point-selection algorithm assuming the data (accessed via the 1D data interface) is point-like. Most subclasses will want to reimplement this method again, to provide a more accurate hit test based on the true data visualization geometry. If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. \seebaseclassmethod */ template double QCPAbstractPlottable1D::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const { if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) return -1; if (!mKeyAxis || !mValueAxis) return -1; QCPDataSelection selectionResult; double minDistSqr = (std::numeric_limits::max)(); int minDistIndex = mDataContainer->size(); typename QCPDataContainer::const_iterator begin = mDataContainer->constBegin(); typename QCPDataContainer::const_iterator end = mDataContainer->constEnd(); if (DataType::sortKeyIsMainKey()) // we can assume that data is sorted by main key, so can reduce the searched key interval: { // determine which key range comes into question, taking selection tolerance around pos into account: double posKeyMin, posKeyMax, dummy; pixelsToCoords(pos-QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMin, dummy); pixelsToCoords(pos+QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMax, dummy); if (posKeyMin > posKeyMax) qSwap(posKeyMin, posKeyMax); begin = mDataContainer->findBegin(posKeyMin, true); end = mDataContainer->findEnd(posKeyMax, true); } if (begin == end) return -1; QCPRange keyRange(mKeyAxis->range()); QCPRange valueRange(mValueAxis->range()); for (typename QCPDataContainer::const_iterator it=begin; it!=end; ++it) { const double mainKey = it->mainKey(); const double mainValue = it->mainValue(); if (keyRange.contains(mainKey) && valueRange.contains(mainValue)) // make sure data point is inside visible range, for speedup in cases where sort key isn't main key and we iterate over all points { const double currentDistSqr = QCPVector2D(coordsToPixels(mainKey, mainValue)-pos).lengthSquared(); if (currentDistSqr < minDistSqr) { minDistSqr = currentDistSqr; minDistIndex = int(it-mDataContainer->constBegin()); } } } if (minDistIndex != mDataContainer->size()) selectionResult.addDataRange(QCPDataRange(minDistIndex, minDistIndex+1), false); selectionResult.simplify(); if (details) details->setValue(selectionResult); return qSqrt(minDistSqr); } /*! Splits all data into selected and unselected segments and outputs them via \a selectedSegments and \a unselectedSegments, respectively. This is useful when subclasses implement their \ref draw method and need to draw selected segments with a different pen/brush than unselected segments (also see \ref QCPSelectionDecorator). \see setSelection */ template void QCPAbstractPlottable1D::getDataSegments(QList &selectedSegments, QList &unselectedSegments) const { selectedSegments.clear(); unselectedSegments.clear(); if (mSelectable == QCP::stWhole) // stWhole selection type draws the entire plottable with selected style if mSelection isn't empty { if (selected()) selectedSegments << QCPDataRange(0, dataCount()); else unselectedSegments << QCPDataRange(0, dataCount()); } else { QCPDataSelection sel(selection()); sel.simplify(); selectedSegments = sel.dataRanges(); unselectedSegments = sel.inverse(QCPDataRange(0, dataCount())).dataRanges(); } } /*! A helper method which draws a line with the passed \a painter, according to the pixel data in \a lineData. NaN points create gaps in the line, as expected from QCustomPlot's plottables (this is the main difference to QPainter's regular drawPolyline, which handles NaNs by lagging or crashing). Further it uses a faster line drawing technique based on \ref QCPPainter::drawLine rather than \c QPainter::drawPolyline if the configured \ref QCustomPlot::setPlottingHints() and \a painter style allows. */ template void QCPAbstractPlottable1D::drawPolyline(QCPPainter *painter, const QVector &lineData) const { // if drawing lines in plot (instead of PDF), reduce 1px lines to cosmetic, because at least in // Qt6 drawing of "1px" width lines is much slower even though it has same appearance apart from // High-DPI. In High-DPI cases people must set a pen width slightly larger than 1.0 to get // correct DPI scaling of width, but of course with performance penalty. if (!painter->modes().testFlag(QCPPainter::pmVectorized) && qFuzzyCompare(painter->pen().widthF(), 1.0)) { QPen newPen = painter->pen(); newPen.setWidth(0); painter->setPen(newPen); } // if drawing solid line and not in PDF, use much faster line drawing instead of polyline: if (mParentPlot->plottingHints().testFlag(QCP::phFastPolylines) && painter->pen().style() == Qt::SolidLine && !painter->modes().testFlag(QCPPainter::pmVectorized) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) { int i = 0; bool lastIsNan = false; const int lineDataSize = lineData.size(); while (i < lineDataSize && (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()))) // make sure first point is not NaN ++i; ++i; // because drawing works in 1 point retrospect while (i < lineDataSize) { if (!qIsNaN(lineData.at(i).y()) && !qIsNaN(lineData.at(i).x())) // NaNs create a gap in the line { if (!lastIsNan) painter->drawLine(lineData.at(i-1), lineData.at(i)); else lastIsNan = false; } else lastIsNan = true; ++i; } } else { int segmentStart = 0; int i = 0; const int lineDataSize = lineData.size(); while (i < lineDataSize) { if (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()) || qIsInf(lineData.at(i).y())) // NaNs create a gap in the line. Also filter Infs which make drawPolyline block { painter->drawPolyline(lineData.constData()+segmentStart, i-segmentStart); // i, because we don't want to include the current NaN point segmentStart = i+1; } ++i; } // draw last segment: painter->drawPolyline(lineData.constData()+segmentStart, lineDataSize-segmentStart); } } /* end of 'src/plottable1d.h' */ /* including file 'src/colorgradient.h' */ /* modified 2021-03-29T02:30:44, size 7262 */ class QCP_LIB_DECL QCPColorGradient { Q_GADGET public: /*! Defines the color spaces in which color interpolation between gradient stops can be performed. \see setColorInterpolation */ enum ColorInterpolation { ciRGB ///< Color channels red, green and blue are linearly interpolated ,ciHSV ///< Color channels hue, saturation and value are linearly interpolated (The hue is interpolated over the shortest angle distance) }; Q_ENUMS(ColorInterpolation) /*! Defines how NaN data points shall appear in the plot. \see setNanHandling, setNanColor */ enum NanHandling { nhNone ///< NaN data points are not explicitly handled and shouldn't occur in the data (this gives slight performance improvement) ,nhLowestColor ///< NaN data points appear as the lowest color defined in this QCPColorGradient ,nhHighestColor ///< NaN data points appear as the highest color defined in this QCPColorGradient ,nhTransparent ///< NaN data points appear transparent ,nhNanColor ///< NaN data points appear as the color defined with \ref setNanColor }; Q_ENUMS(NanHandling) /*! Defines the available presets that can be loaded with \ref loadPreset. See the documentation there for an image of the presets. */ enum GradientPreset { gpGrayscale ///< Continuous lightness from black to white (suited for non-biased data representation) ,gpHot ///< Continuous lightness from black over firey colors to white (suited for non-biased data representation) ,gpCold ///< Continuous lightness from black over icey colors to white (suited for non-biased data representation) ,gpNight ///< Continuous lightness from black over weak blueish colors to white (suited for non-biased data representation) ,gpCandy ///< Blue over pink to white ,gpGeography ///< Colors suitable to represent different elevations on geographical maps ,gpIon ///< Half hue spectrum from black over purple to blue and finally green (creates banding illusion but allows more precise magnitude estimates) ,gpThermal ///< Colors suitable for thermal imaging, ranging from dark blue over purple to orange, yellow and white ,gpPolar ///< Colors suitable to emphasize polarity around the center, with blue for negative, black in the middle and red for positive values ,gpSpectrum ///< An approximation of the visible light spectrum (creates banding illusion but allows more precise magnitude estimates) ,gpJet ///< Hue variation similar to a spectrum, often used in numerical visualization (creates banding illusion but allows more precise magnitude estimates) ,gpHues ///< Full hue cycle, with highest and lowest color red (suitable for periodic data, such as angles and phases, see \ref setPeriodic) }; Q_ENUMS(GradientPreset) QCPColorGradient(); QCPColorGradient(GradientPreset preset); bool operator==(const QCPColorGradient &other) const; bool operator!=(const QCPColorGradient &other) const { return !(*this == other); } // getters: int levelCount() const { return mLevelCount; } QMap colorStops() const { return mColorStops; } ColorInterpolation colorInterpolation() const { return mColorInterpolation; } NanHandling nanHandling() const { return mNanHandling; } QColor nanColor() const { return mNanColor; } bool periodic() const { return mPeriodic; } // setters: void setLevelCount(int n); void setColorStops(const QMap &colorStops); void setColorStopAt(double position, const QColor &color); void setColorInterpolation(ColorInterpolation interpolation); void setNanHandling(NanHandling handling); void setNanColor(const QColor &color); void setPeriodic(bool enabled); // non-property methods: void colorize(const double *data, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor=1, bool logarithmic=false); void colorize(const double *data, const unsigned char *alpha, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor=1, bool logarithmic=false); QRgb color(double position, const QCPRange &range, bool logarithmic=false); void loadPreset(GradientPreset preset); void clearColorStops(); QCPColorGradient inverted() const; protected: // property members: int mLevelCount; QMap mColorStops; ColorInterpolation mColorInterpolation; NanHandling mNanHandling; QColor mNanColor; bool mPeriodic; // non-property members: QVector mColorBuffer; // have colors premultiplied with alpha (for usage with QImage::Format_ARGB32_Premultiplied) bool mColorBufferInvalidated; // non-virtual methods: bool stopsUseAlpha() const; void updateColorBuffer(); }; Q_DECLARE_METATYPE(QCPColorGradient::ColorInterpolation) Q_DECLARE_METATYPE(QCPColorGradient::NanHandling) Q_DECLARE_METATYPE(QCPColorGradient::GradientPreset) /* end of 'src/colorgradient.h' */ /* including file 'src/selectiondecorator-bracket.h' */ /* modified 2021-03-29T02:30:44, size 4458 */ class QCP_LIB_DECL QCPSelectionDecoratorBracket : public QCPSelectionDecorator { Q_GADGET public: /*! Defines which shape is drawn at the boundaries of selected data ranges. Some of the bracket styles further allow specifying a height and/or width, see \ref setBracketHeight and \ref setBracketWidth. */ enum BracketStyle { bsSquareBracket ///< A square bracket is drawn. ,bsHalfEllipse ///< A half ellipse is drawn. The size of the ellipse is given by the bracket width/height properties. ,bsEllipse ///< An ellipse is drawn. The size of the ellipse is given by the bracket width/height properties. ,bsPlus ///< A plus is drawn. ,bsUserStyle ///< Start custom bracket styles at this index when subclassing and reimplementing \ref drawBracket. }; Q_ENUMS(BracketStyle) QCPSelectionDecoratorBracket(); virtual ~QCPSelectionDecoratorBracket() Q_DECL_OVERRIDE; // getters: QPen bracketPen() const { return mBracketPen; } QBrush bracketBrush() const { return mBracketBrush; } int bracketWidth() const { return mBracketWidth; } int bracketHeight() const { return mBracketHeight; } BracketStyle bracketStyle() const { return mBracketStyle; } bool tangentToData() const { return mTangentToData; } int tangentAverage() const { return mTangentAverage; } // setters: void setBracketPen(const QPen &pen); void setBracketBrush(const QBrush &brush); void setBracketWidth(int width); void setBracketHeight(int height); void setBracketStyle(BracketStyle style); void setTangentToData(bool enabled); void setTangentAverage(int pointCount); // introduced virtual methods: virtual void drawBracket(QCPPainter *painter, int direction) const; // virtual methods: virtual void drawDecoration(QCPPainter *painter, QCPDataSelection selection) Q_DECL_OVERRIDE; protected: // property members: QPen mBracketPen; QBrush mBracketBrush; int mBracketWidth; int mBracketHeight; BracketStyle mBracketStyle; bool mTangentToData; int mTangentAverage; // non-virtual methods: double getTangentAngle(const QCPPlottableInterface1D *interface1d, int dataIndex, int direction) const; QPointF getPixelCoordinates(const QCPPlottableInterface1D *interface1d, int dataIndex) const; }; Q_DECLARE_METATYPE(QCPSelectionDecoratorBracket::BracketStyle) /* end of 'src/selectiondecorator-bracket.h' */ /* including file 'src/layoutelements/layoutelement-axisrect.h' */ /* modified 2021-03-29T02:30:44, size 7529 */ class QCP_LIB_DECL QCPAxisRect : public QCPLayoutElement { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPixmap background READ background WRITE setBackground) Q_PROPERTY(bool backgroundScaled READ backgroundScaled WRITE setBackgroundScaled) Q_PROPERTY(Qt::AspectRatioMode backgroundScaledMode READ backgroundScaledMode WRITE setBackgroundScaledMode) Q_PROPERTY(Qt::Orientations rangeDrag READ rangeDrag WRITE setRangeDrag) Q_PROPERTY(Qt::Orientations rangeZoom READ rangeZoom WRITE setRangeZoom) /// \endcond public: explicit QCPAxisRect(QCustomPlot *parentPlot, bool setupDefaultAxes=true); virtual ~QCPAxisRect() Q_DECL_OVERRIDE; // getters: QPixmap background() const { return mBackgroundPixmap; } QBrush backgroundBrush() const { return mBackgroundBrush; } bool backgroundScaled() const { return mBackgroundScaled; } Qt::AspectRatioMode backgroundScaledMode() const { return mBackgroundScaledMode; } Qt::Orientations rangeDrag() const { return mRangeDrag; } Qt::Orientations rangeZoom() const { return mRangeZoom; } QCPAxis *rangeDragAxis(Qt::Orientation orientation); QCPAxis *rangeZoomAxis(Qt::Orientation orientation); QList rangeDragAxes(Qt::Orientation orientation); QList rangeZoomAxes(Qt::Orientation orientation); double rangeZoomFactor(Qt::Orientation orientation); // setters: void setBackground(const QPixmap &pm); void setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding); void setBackground(const QBrush &brush); void setBackgroundScaled(bool scaled); void setBackgroundScaledMode(Qt::AspectRatioMode mode); void setRangeDrag(Qt::Orientations orientations); void setRangeZoom(Qt::Orientations orientations); void setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical); void setRangeDragAxes(QList axes); void setRangeDragAxes(QList horizontal, QList vertical); void setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical); void setRangeZoomAxes(QList axes); void setRangeZoomAxes(QList horizontal, QList vertical); void setRangeZoomFactor(double horizontalFactor, double verticalFactor); void setRangeZoomFactor(double factor); // non-property methods: int axisCount(QCPAxis::AxisType type) const; QCPAxis *axis(QCPAxis::AxisType type, int index=0) const; QList axes(QCPAxis::AxisTypes types) const; QList axes() const; QCPAxis *addAxis(QCPAxis::AxisType type, QCPAxis *axis=nullptr); QList addAxes(QCPAxis::AxisTypes types); bool removeAxis(QCPAxis *axis); QCPLayoutInset *insetLayout() const { return mInsetLayout; } void zoom(const QRectF &pixelRect); void zoom(const QRectF &pixelRect, const QList &affectedAxes); void setupFullAxesBox(bool connectRanges=false); QList plottables() const; QList graphs() const; QList items() const; // read-only interface imitating a QRect: int left() const { return mRect.left(); } int right() const { return mRect.right(); } int top() const { return mRect.top(); } int bottom() const { return mRect.bottom(); } int width() const { return mRect.width(); } int height() const { return mRect.height(); } QSize size() const { return mRect.size(); } QPoint topLeft() const { return mRect.topLeft(); } QPoint topRight() const { return mRect.topRight(); } QPoint bottomLeft() const { return mRect.bottomLeft(); } QPoint bottomRight() const { return mRect.bottomRight(); } QPoint center() const { return mRect.center(); } // reimplemented virtual methods: virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; protected: // property members: QBrush mBackgroundBrush; QPixmap mBackgroundPixmap; QPixmap mScaledBackgroundPixmap; bool mBackgroundScaled; Qt::AspectRatioMode mBackgroundScaledMode; QCPLayoutInset *mInsetLayout; Qt::Orientations mRangeDrag, mRangeZoom; QList > mRangeDragHorzAxis, mRangeDragVertAxis; QList > mRangeZoomHorzAxis, mRangeZoomVertAxis; double mRangeZoomFactorHorz, mRangeZoomFactorVert; // non-property members: QList mDragStartHorzRange, mDragStartVertRange; QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; bool mDragging; QHash > mAxes; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual int calculateAutoMargin(QCP::MarginSide side) Q_DECL_OVERRIDE; virtual void layoutChanged() Q_DECL_OVERRIDE; // events: virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; // non-property methods: void drawBackground(QCPPainter *painter); void updateAxesOffset(QCPAxis::AxisType type); private: Q_DISABLE_COPY(QCPAxisRect) friend class QCustomPlot; }; /* end of 'src/layoutelements/layoutelement-axisrect.h' */ /* including file 'src/layoutelements/layoutelement-legend.h' */ /* modified 2021-03-29T02:30:44, size 10425 */ class QCP_LIB_DECL QCPAbstractLegendItem : public QCPLayoutElement { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QCPLegend* parentLegend READ parentLegend) Q_PROPERTY(QFont font READ font WRITE setFont) Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor) Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont) Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor) Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectionChanged) Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectableChanged) /// \endcond public: explicit QCPAbstractLegendItem(QCPLegend *parent); // getters: QCPLegend *parentLegend() const { return mParentLegend; } QFont font() const { return mFont; } QColor textColor() const { return mTextColor; } QFont selectedFont() const { return mSelectedFont; } QColor selectedTextColor() const { return mSelectedTextColor; } bool selectable() const { return mSelectable; } bool selected() const { return mSelected; } // setters: void setFont(const QFont &font); void setTextColor(const QColor &color); void setSelectedFont(const QFont &font); void setSelectedTextColor(const QColor &color); Q_SLOT void setSelectable(bool selectable); Q_SLOT void setSelected(bool selected); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; signals: void selectionChanged(bool selected); void selectableChanged(bool selectable); protected: // property members: QCPLegend *mParentLegend; QFont mFont; QColor mTextColor; QFont mSelectedFont; QColor mSelectedTextColor; bool mSelectable, mSelected; // reimplemented virtual methods: virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual QRect clipRect() const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; private: Q_DISABLE_COPY(QCPAbstractLegendItem) friend class QCPLegend; }; class QCP_LIB_DECL QCPPlottableLegendItem : public QCPAbstractLegendItem { Q_OBJECT public: QCPPlottableLegendItem(QCPLegend *parent, QCPAbstractPlottable *plottable); // getters: QCPAbstractPlottable *plottable() { return mPlottable; } protected: // property members: QCPAbstractPlottable *mPlottable; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; // non-virtual methods: QPen getIconBorderPen() const; QColor getTextColor() const; QFont getFont() const; }; class QCP_LIB_DECL QCPLegend : public QCPLayoutGrid { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen borderPen READ borderPen WRITE setBorderPen) Q_PROPERTY(QBrush brush READ brush WRITE setBrush) Q_PROPERTY(QFont font READ font WRITE setFont) Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor) Q_PROPERTY(QSize iconSize READ iconSize WRITE setIconSize) Q_PROPERTY(int iconTextPadding READ iconTextPadding WRITE setIconTextPadding) Q_PROPERTY(QPen iconBorderPen READ iconBorderPen WRITE setIconBorderPen) Q_PROPERTY(SelectableParts selectableParts READ selectableParts WRITE setSelectableParts NOTIFY selectionChanged) Q_PROPERTY(SelectableParts selectedParts READ selectedParts WRITE setSelectedParts NOTIFY selectableChanged) Q_PROPERTY(QPen selectedBorderPen READ selectedBorderPen WRITE setSelectedBorderPen) Q_PROPERTY(QPen selectedIconBorderPen READ selectedIconBorderPen WRITE setSelectedIconBorderPen) Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush) Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont) Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor) /// \endcond public: /*! Defines the selectable parts of a legend \see setSelectedParts, setSelectableParts */ enum SelectablePart { spNone = 0x000 ///< 0x000 None ,spLegendBox = 0x001 ///< 0x001 The legend box (frame) ,spItems = 0x002 ///< 0x002 Legend items individually (see \ref selectedItems) }; Q_ENUMS(SelectablePart) Q_FLAGS(SelectableParts) Q_DECLARE_FLAGS(SelectableParts, SelectablePart) explicit QCPLegend(); virtual ~QCPLegend() Q_DECL_OVERRIDE; // getters: QPen borderPen() const { return mBorderPen; } QBrush brush() const { return mBrush; } QFont font() const { return mFont; } QColor textColor() const { return mTextColor; } QSize iconSize() const { return mIconSize; } int iconTextPadding() const { return mIconTextPadding; } QPen iconBorderPen() const { return mIconBorderPen; } SelectableParts selectableParts() const { return mSelectableParts; } SelectableParts selectedParts() const; QPen selectedBorderPen() const { return mSelectedBorderPen; } QPen selectedIconBorderPen() const { return mSelectedIconBorderPen; } QBrush selectedBrush() const { return mSelectedBrush; } QFont selectedFont() const { return mSelectedFont; } QColor selectedTextColor() const { return mSelectedTextColor; } // setters: void setBorderPen(const QPen &pen); void setBrush(const QBrush &brush); void setFont(const QFont &font); void setTextColor(const QColor &color); void setIconSize(const QSize &size); void setIconSize(int width, int height); void setIconTextPadding(int padding); void setIconBorderPen(const QPen &pen); Q_SLOT void setSelectableParts(const SelectableParts &selectableParts); Q_SLOT void setSelectedParts(const SelectableParts &selectedParts); void setSelectedBorderPen(const QPen &pen); void setSelectedIconBorderPen(const QPen &pen); void setSelectedBrush(const QBrush &brush); void setSelectedFont(const QFont &font); void setSelectedTextColor(const QColor &color); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; // non-virtual methods: QCPAbstractLegendItem *item(int index) const; QCPPlottableLegendItem *itemWithPlottable(const QCPAbstractPlottable *plottable) const; int itemCount() const; bool hasItem(QCPAbstractLegendItem *item) const; bool hasItemWithPlottable(const QCPAbstractPlottable *plottable) const; bool addItem(QCPAbstractLegendItem *item); bool removeItem(int index); bool removeItem(QCPAbstractLegendItem *item); void clearItems(); QList selectedItems() const; signals: void selectionChanged(QCPLegend::SelectableParts parts); void selectableChanged(QCPLegend::SelectableParts parts); protected: // property members: QPen mBorderPen, mIconBorderPen; QBrush mBrush; QFont mFont; QColor mTextColor; QSize mIconSize; int mIconTextPadding; SelectableParts mSelectedParts, mSelectableParts; QPen mSelectedBorderPen, mSelectedIconBorderPen; QBrush mSelectedBrush; QFont mSelectedFont; QColor mSelectedTextColor; // reimplemented virtual methods: virtual void parentPlotInitialized(QCustomPlot *parentPlot) Q_DECL_OVERRIDE; virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; // non-virtual methods: QPen getBorderPen() const; QBrush getBrush() const; private: Q_DISABLE_COPY(QCPLegend) friend class QCustomPlot; friend class QCPAbstractLegendItem; }; Q_DECLARE_OPERATORS_FOR_FLAGS(QCPLegend::SelectableParts) Q_DECLARE_METATYPE(QCPLegend::SelectablePart) /* end of 'src/layoutelements/layoutelement-legend.h' */ /* including file 'src/layoutelements/layoutelement-textelement.h' */ /* modified 2021-03-29T02:30:44, size 5359 */ class QCP_LIB_DECL QCPTextElement : public QCPLayoutElement { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QString text READ text WRITE setText) Q_PROPERTY(QFont font READ font WRITE setFont) Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor) Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont) Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor) Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectableChanged) Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectionChanged) /// \endcond public: explicit QCPTextElement(QCustomPlot *parentPlot); QCPTextElement(QCustomPlot *parentPlot, const QString &text); QCPTextElement(QCustomPlot *parentPlot, const QString &text, double pointSize); QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QString &fontFamily, double pointSize); QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QFont &font); // getters: QString text() const { return mText; } int textFlags() const { return mTextFlags; } QFont font() const { return mFont; } QColor textColor() const { return mTextColor; } QFont selectedFont() const { return mSelectedFont; } QColor selectedTextColor() const { return mSelectedTextColor; } bool selectable() const { return mSelectable; } bool selected() const { return mSelected; } // setters: void setText(const QString &text); void setTextFlags(int flags); void setFont(const QFont &font); void setTextColor(const QColor &color); void setSelectedFont(const QFont &font); void setSelectedTextColor(const QColor &color); Q_SLOT void setSelectable(bool selectable); Q_SLOT void setSelected(bool selected); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; signals: void selectionChanged(bool selected); void selectableChanged(bool selectable); void clicked(QMouseEvent *event); void doubleClicked(QMouseEvent *event); protected: // property members: QString mText; int mTextFlags; QFont mFont; QColor mTextColor; QFont mSelectedFont; QColor mSelectedTextColor; QRect mTextBoundingRect; bool mSelectable, mSelected; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; virtual QSize maximumOuterSizeHint() const Q_DECL_OVERRIDE; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; // non-virtual methods: QFont mainFont() const; QColor mainTextColor() const; private: Q_DISABLE_COPY(QCPTextElement) }; /* end of 'src/layoutelements/layoutelement-textelement.h' */ /* including file 'src/layoutelements/layoutelement-colorscale.h' */ /* modified 2021-03-29T02:30:44, size 5939 */ class QCPColorScaleAxisRectPrivate : public QCPAxisRect { Q_OBJECT public: explicit QCPColorScaleAxisRectPrivate(QCPColorScale *parentColorScale); protected: QCPColorScale *mParentColorScale; QImage mGradientImage; bool mGradientImageInvalidated; // re-using some methods of QCPAxisRect to make them available to friend class QCPColorScale using QCPAxisRect::calculateAutoMargin; using QCPAxisRect::mousePressEvent; using QCPAxisRect::mouseMoveEvent; using QCPAxisRect::mouseReleaseEvent; using QCPAxisRect::wheelEvent; using QCPAxisRect::update; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; void updateGradientImage(); Q_SLOT void axisSelectionChanged(QCPAxis::SelectableParts selectedParts); Q_SLOT void axisSelectableChanged(QCPAxis::SelectableParts selectableParts); friend class QCPColorScale; }; class QCP_LIB_DECL QCPColorScale : public QCPLayoutElement { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QCPAxis::AxisType type READ type WRITE setType) Q_PROPERTY(QCPRange dataRange READ dataRange WRITE setDataRange NOTIFY dataRangeChanged) Q_PROPERTY(QCPAxis::ScaleType dataScaleType READ dataScaleType WRITE setDataScaleType NOTIFY dataScaleTypeChanged) Q_PROPERTY(QCPColorGradient gradient READ gradient WRITE setGradient NOTIFY gradientChanged) Q_PROPERTY(QString label READ label WRITE setLabel) Q_PROPERTY(int barWidth READ barWidth WRITE setBarWidth) Q_PROPERTY(bool rangeDrag READ rangeDrag WRITE setRangeDrag) Q_PROPERTY(bool rangeZoom READ rangeZoom WRITE setRangeZoom) /// \endcond public: explicit QCPColorScale(QCustomPlot *parentPlot); virtual ~QCPColorScale() Q_DECL_OVERRIDE; // getters: QCPAxis *axis() const { return mColorAxis.data(); } QCPAxis::AxisType type() const { return mType; } QCPRange dataRange() const { return mDataRange; } QCPAxis::ScaleType dataScaleType() const { return mDataScaleType; } QCPColorGradient gradient() const { return mGradient; } QString label() const; int barWidth () const { return mBarWidth; } bool rangeDrag() const; bool rangeZoom() const; // setters: void setType(QCPAxis::AxisType type); Q_SLOT void setDataRange(const QCPRange &dataRange); Q_SLOT void setDataScaleType(QCPAxis::ScaleType scaleType); Q_SLOT void setGradient(const QCPColorGradient &gradient); void setLabel(const QString &str); void setBarWidth(int width); void setRangeDrag(bool enabled); void setRangeZoom(bool enabled); // non-property methods: QList colorMaps() const; void rescaleDataRange(bool onlyVisibleMaps); // reimplemented virtual methods: virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; signals: void dataRangeChanged(const QCPRange &newRange); void dataScaleTypeChanged(QCPAxis::ScaleType scaleType); void gradientChanged(const QCPColorGradient &newGradient); protected: // property members: QCPAxis::AxisType mType; QCPRange mDataRange; QCPAxis::ScaleType mDataScaleType; QCPColorGradient mGradient; int mBarWidth; // non-property members: QPointer mAxisRect; QPointer mColorAxis; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; // events: virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; private: Q_DISABLE_COPY(QCPColorScale) friend class QCPColorScaleAxisRectPrivate; }; /* end of 'src/layoutelements/layoutelement-colorscale.h' */ /* including file 'src/plottables/plottable-graph.h' */ /* modified 2021-03-29T02:30:44, size 9316 */ class QCP_LIB_DECL QCPGraphData { public: QCPGraphData(); QCPGraphData(double key, double value); inline double sortKey() const { return key; } inline static QCPGraphData fromSortKey(double sortKey) { return QCPGraphData(sortKey, 0); } inline static bool sortKeyIsMainKey() { return true; } inline double mainKey() const { return key; } inline double mainValue() const { return value; } inline QCPRange valueRange() const { return QCPRange(value, value); } double key, value; }; Q_DECLARE_TYPEINFO(QCPGraphData, Q_PRIMITIVE_TYPE); /*! \typedef QCPGraphDataContainer Container for storing \ref QCPGraphData points. The data is stored sorted by \a key. This template instantiation is the container in which QCPGraph holds its data. For details about the generic container, see the documentation of the class template \ref QCPDataContainer. \see QCPGraphData, QCPGraph::setData */ typedef QCPDataContainer QCPGraphDataContainer; class QCP_LIB_DECL QCPGraph : public QCPAbstractPlottable1D { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(LineStyle lineStyle READ lineStyle WRITE setLineStyle) Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle) Q_PROPERTY(int scatterSkip READ scatterSkip WRITE setScatterSkip) Q_PROPERTY(QCPGraph* channelFillGraph READ channelFillGraph WRITE setChannelFillGraph) Q_PROPERTY(bool adaptiveSampling READ adaptiveSampling WRITE setAdaptiveSampling) /// \endcond public: /*! Defines how the graph's line is represented visually in the plot. The line is drawn with the current pen of the graph (\ref setPen). \see setLineStyle */ enum LineStyle { lsNone ///< data points are not connected with any lines (e.g. data only represented ///< with symbols according to the scatter style, see \ref setScatterStyle) ,lsLine ///< data points are connected by a straight line ,lsStepLeft ///< line is drawn as steps where the step height is the value of the left data point ,lsStepRight ///< line is drawn as steps where the step height is the value of the right data point ,lsStepCenter ///< line is drawn as steps where the step is in between two data points ,lsImpulse ///< each data point is represented by a line parallel to the value axis, which reaches from the data point to the zero-value-line }; Q_ENUMS(LineStyle) explicit QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPGraph() Q_DECL_OVERRIDE; // getters: QSharedPointer data() const { return mDataContainer; } LineStyle lineStyle() const { return mLineStyle; } QCPScatterStyle scatterStyle() const { return mScatterStyle; } int scatterSkip() const { return mScatterSkip; } QCPGraph *channelFillGraph() const { return mChannelFillGraph.data(); } bool adaptiveSampling() const { return mAdaptiveSampling; } // setters: void setData(QSharedPointer data); void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); void setLineStyle(LineStyle ls); void setScatterStyle(const QCPScatterStyle &style); void setScatterSkip(int skip); void setChannelFillGraph(QCPGraph *targetGraph); void setAdaptiveSampling(bool enabled); // non-property methods: void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); void addData(double key, double value); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; protected: // property members: LineStyle mLineStyle; QCPScatterStyle mScatterStyle; int mScatterSkip; QPointer mChannelFillGraph; bool mAdaptiveSampling; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; // introduced virtual methods: virtual void drawFill(QCPPainter *painter, QVector *lines) const; virtual void drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const; virtual void drawLinePlot(QCPPainter *painter, const QVector &lines) const; virtual void drawImpulsePlot(QCPPainter *painter, const QVector &lines) const; virtual void getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const; virtual void getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const; // non-virtual methods: void getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; void getLines(QVector *lines, const QCPDataRange &dataRange) const; void getScatters(QVector *scatters, const QCPDataRange &dataRange) const; QVector dataToLines(const QVector &data) const; QVector dataToStepLeftLines(const QVector &data) const; QVector dataToStepRightLines(const QVector &data) const; QVector dataToStepCenterLines(const QVector &data) const; QVector dataToImpulseLines(const QVector &data) const; QVector getNonNanSegments(const QVector *lineData, Qt::Orientation keyOrientation) const; QVector > getOverlappingSegments(QVector thisSegments, const QVector *thisData, QVector otherSegments, const QVector *otherData) const; bool segmentsIntersect(double aLower, double aUpper, double bLower, double bUpper, int &bPrecedence) const; QPointF getFillBasePoint(QPointF matchingDataPoint) const; const QPolygonF getFillPolygon(const QVector *lineData, QCPDataRange segment) const; const QPolygonF getChannelFillPolygon(const QVector *thisData, QCPDataRange thisSegment, const QVector *otherData, QCPDataRange otherSegment) const; int findIndexBelowX(const QVector *data, double x) const; int findIndexAboveX(const QVector *data, double x) const; int findIndexBelowY(const QVector *data, double y) const; int findIndexAboveY(const QVector *data, double y) const; double pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const; friend class QCustomPlot; friend class QCPLegend; }; Q_DECLARE_METATYPE(QCPGraph::LineStyle) /* end of 'src/plottables/plottable-graph.h' */ /* including file 'src/plottables/plottable-curve.h' */ /* modified 2021-03-29T02:30:44, size 7434 */ class QCP_LIB_DECL QCPCurveData { public: QCPCurveData(); QCPCurveData(double t, double key, double value); inline double sortKey() const { return t; } inline static QCPCurveData fromSortKey(double sortKey) { return QCPCurveData(sortKey, 0, 0); } inline static bool sortKeyIsMainKey() { return false; } inline double mainKey() const { return key; } inline double mainValue() const { return value; } inline QCPRange valueRange() const { return QCPRange(value, value); } double t, key, value; }; Q_DECLARE_TYPEINFO(QCPCurveData, Q_PRIMITIVE_TYPE); /*! \typedef QCPCurveDataContainer Container for storing \ref QCPCurveData points. The data is stored sorted by \a t, so the \a sortKey() (returning \a t) is different from \a mainKey() (returning \a key). This template instantiation is the container in which QCPCurve holds its data. For details about the generic container, see the documentation of the class template \ref QCPDataContainer. \see QCPCurveData, QCPCurve::setData */ typedef QCPDataContainer QCPCurveDataContainer; class QCP_LIB_DECL QCPCurve : public QCPAbstractPlottable1D { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle) Q_PROPERTY(int scatterSkip READ scatterSkip WRITE setScatterSkip) Q_PROPERTY(LineStyle lineStyle READ lineStyle WRITE setLineStyle) /// \endcond public: /*! Defines how the curve's line is represented visually in the plot. The line is drawn with the current pen of the curve (\ref setPen). \see setLineStyle */ enum LineStyle { lsNone ///< No line is drawn between data points (e.g. only scatters) ,lsLine ///< Data points are connected with a straight line }; Q_ENUMS(LineStyle) explicit QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPCurve() Q_DECL_OVERRIDE; // getters: QSharedPointer data() const { return mDataContainer; } QCPScatterStyle scatterStyle() const { return mScatterStyle; } int scatterSkip() const { return mScatterSkip; } LineStyle lineStyle() const { return mLineStyle; } // setters: void setData(QSharedPointer data); void setData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted=false); void setData(const QVector &keys, const QVector &values); void setScatterStyle(const QCPScatterStyle &style); void setScatterSkip(int skip); void setLineStyle(LineStyle style); // non-property methods: void addData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted=false); void addData(const QVector &keys, const QVector &values); void addData(double t, double key, double value); void addData(double key, double value); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; protected: // property members: QCPScatterStyle mScatterStyle; int mScatterSkip; LineStyle mLineStyle; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; // introduced virtual methods: virtual void drawCurveLine(QCPPainter *painter, const QVector &lines) const; virtual void drawScatterPlot(QCPPainter *painter, const QVector &points, const QCPScatterStyle &style) const; // non-virtual methods: void getCurveLines(QVector *lines, const QCPDataRange &dataRange, double penWidth) const; void getScatters(QVector *scatters, const QCPDataRange &dataRange, double scatterWidth) const; int getRegion(double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; QPointF getOptimizedPoint(int otherRegion, double otherKey, double otherValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; QVector getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; bool mayTraverse(int prevRegion, int currentRegion) const; bool getTraverse(double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const; void getTraverseCornerPoints(int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector &beforeTraverse, QVector &afterTraverse) const; double pointDistance(const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const; friend class QCustomPlot; friend class QCPLegend; }; Q_DECLARE_METATYPE(QCPCurve::LineStyle) /* end of 'src/plottables/plottable-curve.h' */ /* including file 'src/plottables/plottable-bars.h' */ /* modified 2021-03-29T02:30:44, size 8955 */ class QCP_LIB_DECL QCPBarsGroup : public QObject { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(SpacingType spacingType READ spacingType WRITE setSpacingType) Q_PROPERTY(double spacing READ spacing WRITE setSpacing) /// \endcond public: /*! Defines the ways the spacing between bars in the group can be specified. Thus it defines what the number passed to \ref setSpacing actually means. \see setSpacingType, setSpacing */ enum SpacingType { stAbsolute ///< Bar spacing is in absolute pixels ,stAxisRectRatio ///< Bar spacing is given by a fraction of the axis rect size ,stPlotCoords ///< Bar spacing is in key coordinates and thus scales with the key axis range }; Q_ENUMS(SpacingType) explicit QCPBarsGroup(QCustomPlot *parentPlot); virtual ~QCPBarsGroup(); // getters: SpacingType spacingType() const { return mSpacingType; } double spacing() const { return mSpacing; } // setters: void setSpacingType(SpacingType spacingType); void setSpacing(double spacing); // non-virtual methods: QList bars() const { return mBars; } QCPBars* bars(int index) const; int size() const { return mBars.size(); } bool isEmpty() const { return mBars.isEmpty(); } void clear(); bool contains(QCPBars *bars) const { return mBars.contains(bars); } void append(QCPBars *bars); void insert(int i, QCPBars *bars); void remove(QCPBars *bars); protected: // non-property members: QCustomPlot *mParentPlot; SpacingType mSpacingType; double mSpacing; QList mBars; // non-virtual methods: void registerBars(QCPBars *bars); void unregisterBars(QCPBars *bars); // virtual methods: double keyPixelOffset(const QCPBars *bars, double keyCoord); double getPixelSpacing(const QCPBars *bars, double keyCoord); private: Q_DISABLE_COPY(QCPBarsGroup) friend class QCPBars; }; Q_DECLARE_METATYPE(QCPBarsGroup::SpacingType) class QCP_LIB_DECL QCPBarsData { public: QCPBarsData(); QCPBarsData(double key, double value); inline double sortKey() const { return key; } inline static QCPBarsData fromSortKey(double sortKey) { return QCPBarsData(sortKey, 0); } inline static bool sortKeyIsMainKey() { return true; } inline double mainKey() const { return key; } inline double mainValue() const { return value; } inline QCPRange valueRange() const { return QCPRange(value, value); } // note that bar base value isn't held in each QCPBarsData and thus can't/shouldn't be returned here double key, value; }; Q_DECLARE_TYPEINFO(QCPBarsData, Q_PRIMITIVE_TYPE); /*! \typedef QCPBarsDataContainer Container for storing \ref QCPBarsData points. The data is stored sorted by \a key. This template instantiation is the container in which QCPBars holds its data. For details about the generic container, see the documentation of the class template \ref QCPDataContainer. \see QCPBarsData, QCPBars::setData */ typedef QCPDataContainer QCPBarsDataContainer; class QCP_LIB_DECL QCPBars : public QCPAbstractPlottable1D { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(double width READ width WRITE setWidth) Q_PROPERTY(WidthType widthType READ widthType WRITE setWidthType) Q_PROPERTY(QCPBarsGroup* barsGroup READ barsGroup WRITE setBarsGroup) Q_PROPERTY(double baseValue READ baseValue WRITE setBaseValue) Q_PROPERTY(double stackingGap READ stackingGap WRITE setStackingGap) Q_PROPERTY(QCPBars* barBelow READ barBelow) Q_PROPERTY(QCPBars* barAbove READ barAbove) /// \endcond public: /*! Defines the ways the width of the bar can be specified. Thus it defines what the number passed to \ref setWidth actually means. \see setWidthType, setWidth */ enum WidthType { wtAbsolute ///< Bar width is in absolute pixels ,wtAxisRectRatio ///< Bar width is given by a fraction of the axis rect size ,wtPlotCoords ///< Bar width is in key coordinates and thus scales with the key axis range }; Q_ENUMS(WidthType) explicit QCPBars(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPBars() Q_DECL_OVERRIDE; // getters: double width() const { return mWidth; } WidthType widthType() const { return mWidthType; } QCPBarsGroup *barsGroup() const { return mBarsGroup; } double baseValue() const { return mBaseValue; } double stackingGap() const { return mStackingGap; } QCPBars *barBelow() const { return mBarBelow.data(); } QCPBars *barAbove() const { return mBarAbove.data(); } QSharedPointer data() const { return mDataContainer; } // setters: void setData(QSharedPointer data); void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); void setWidth(double width); void setWidthType(WidthType widthType); void setBarsGroup(QCPBarsGroup *barsGroup); void setBaseValue(double baseValue); void setStackingGap(double pixels); // non-property methods: void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); void addData(double key, double value); void moveBelow(QCPBars *bars); void moveAbove(QCPBars *bars); // reimplemented virtual methods: virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; protected: // property members: double mWidth; WidthType mWidthType; QCPBarsGroup *mBarsGroup; double mBaseValue; double mStackingGap; QPointer mBarBelow, mBarAbove; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; // non-virtual methods: void getVisibleDataBounds(QCPBarsDataContainer::const_iterator &begin, QCPBarsDataContainer::const_iterator &end) const; QRectF getBarRect(double key, double value) const; void getPixelWidth(double key, double &lower, double &upper) const; double getStackedBaseValue(double key, bool positive) const; static void connectBars(QCPBars* lower, QCPBars* upper); friend class QCustomPlot; friend class QCPLegend; friend class QCPBarsGroup; }; Q_DECLARE_METATYPE(QCPBars::WidthType) /* end of 'src/plottables/plottable-bars.h' */ /* including file 'src/plottables/plottable-statisticalbox.h' */ /* modified 2021-03-29T02:30:44, size 7522 */ class QCP_LIB_DECL QCPStatisticalBoxData { public: QCPStatisticalBoxData(); QCPStatisticalBoxData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector& outliers=QVector()); inline double sortKey() const { return key; } inline static QCPStatisticalBoxData fromSortKey(double sortKey) { return QCPStatisticalBoxData(sortKey, 0, 0, 0, 0, 0); } inline static bool sortKeyIsMainKey() { return true; } inline double mainKey() const { return key; } inline double mainValue() const { return median; } inline QCPRange valueRange() const { QCPRange result(minimum, maximum); for (QVector::const_iterator it = outliers.constBegin(); it != outliers.constEnd(); ++it) result.expand(*it); return result; } double key, minimum, lowerQuartile, median, upperQuartile, maximum; QVector outliers; }; Q_DECLARE_TYPEINFO(QCPStatisticalBoxData, Q_MOVABLE_TYPE); /*! \typedef QCPStatisticalBoxDataContainer Container for storing \ref QCPStatisticalBoxData points. The data is stored sorted by \a key. This template instantiation is the container in which QCPStatisticalBox holds its data. For details about the generic container, see the documentation of the class template \ref QCPDataContainer. \see QCPStatisticalBoxData, QCPStatisticalBox::setData */ typedef QCPDataContainer QCPStatisticalBoxDataContainer; class QCP_LIB_DECL QCPStatisticalBox : public QCPAbstractPlottable1D { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(double width READ width WRITE setWidth) Q_PROPERTY(double whiskerWidth READ whiskerWidth WRITE setWhiskerWidth) Q_PROPERTY(QPen whiskerPen READ whiskerPen WRITE setWhiskerPen) Q_PROPERTY(QPen whiskerBarPen READ whiskerBarPen WRITE setWhiskerBarPen) Q_PROPERTY(bool whiskerAntialiased READ whiskerAntialiased WRITE setWhiskerAntialiased) Q_PROPERTY(QPen medianPen READ medianPen WRITE setMedianPen) Q_PROPERTY(QCPScatterStyle outlierStyle READ outlierStyle WRITE setOutlierStyle) /// \endcond public: explicit QCPStatisticalBox(QCPAxis *keyAxis, QCPAxis *valueAxis); // getters: QSharedPointer data() const { return mDataContainer; } double width() const { return mWidth; } double whiskerWidth() const { return mWhiskerWidth; } QPen whiskerPen() const { return mWhiskerPen; } QPen whiskerBarPen() const { return mWhiskerBarPen; } bool whiskerAntialiased() const { return mWhiskerAntialiased; } QPen medianPen() const { return mMedianPen; } QCPScatterStyle outlierStyle() const { return mOutlierStyle; } // setters: void setData(QSharedPointer data); void setData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted=false); void setWidth(double width); void setWhiskerWidth(double width); void setWhiskerPen(const QPen &pen); void setWhiskerBarPen(const QPen &pen); void setWhiskerAntialiased(bool enabled); void setMedianPen(const QPen &pen); void setOutlierStyle(const QCPScatterStyle &style); // non-property methods: void addData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted=false); void addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers=QVector()); // reimplemented virtual methods: virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; protected: // property members: double mWidth; double mWhiskerWidth; QPen mWhiskerPen, mWhiskerBarPen; bool mWhiskerAntialiased; QPen mMedianPen; QCPScatterStyle mOutlierStyle; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; // introduced virtual methods: virtual void drawStatisticalBox(QCPPainter *painter, QCPStatisticalBoxDataContainer::const_iterator it, const QCPScatterStyle &outlierStyle) const; // non-virtual methods: void getVisibleDataBounds(QCPStatisticalBoxDataContainer::const_iterator &begin, QCPStatisticalBoxDataContainer::const_iterator &end) const; QRectF getQuartileBox(QCPStatisticalBoxDataContainer::const_iterator it) const; QVector getWhiskerBackboneLines(QCPStatisticalBoxDataContainer::const_iterator it) const; QVector getWhiskerBarLines(QCPStatisticalBoxDataContainer::const_iterator it) const; friend class QCustomPlot; friend class QCPLegend; }; /* end of 'src/plottables/plottable-statisticalbox.h' */ /* including file 'src/plottables/plottable-colormap.h' */ /* modified 2021-03-29T02:30:44, size 7092 */ class QCP_LIB_DECL QCPColorMapData { public: QCPColorMapData(int keySize, int valueSize, const QCPRange &keyRange, const QCPRange &valueRange); ~QCPColorMapData(); QCPColorMapData(const QCPColorMapData &other); QCPColorMapData &operator=(const QCPColorMapData &other); // getters: int keySize() const { return mKeySize; } int valueSize() const { return mValueSize; } QCPRange keyRange() const { return mKeyRange; } QCPRange valueRange() const { return mValueRange; } QCPRange dataBounds() const { return mDataBounds; } double data(double key, double value); double cell(int keyIndex, int valueIndex); unsigned char alpha(int keyIndex, int valueIndex); // setters: void setSize(int keySize, int valueSize); void setKeySize(int keySize); void setValueSize(int valueSize); void setRange(const QCPRange &keyRange, const QCPRange &valueRange); void setKeyRange(const QCPRange &keyRange); void setValueRange(const QCPRange &valueRange); void setData(double key, double value, double z); void setCell(int keyIndex, int valueIndex, double z); void setAlpha(int keyIndex, int valueIndex, unsigned char alpha); // non-property methods: void recalculateDataBounds(); void clear(); void clearAlpha(); void fill(double z); void fillAlpha(unsigned char alpha); bool isEmpty() const { return mIsEmpty; } void coordToCell(double key, double value, int *keyIndex, int *valueIndex) const; void cellToCoord(int keyIndex, int valueIndex, double *key, double *value) const; protected: // property members: int mKeySize, mValueSize; QCPRange mKeyRange, mValueRange; bool mIsEmpty; // non-property members: double *mData; unsigned char *mAlpha; QCPRange mDataBounds; bool mDataModified; bool createAlpha(bool initializeOpaque=true); friend class QCPColorMap; }; class QCP_LIB_DECL QCPColorMap : public QCPAbstractPlottable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QCPRange dataRange READ dataRange WRITE setDataRange NOTIFY dataRangeChanged) Q_PROPERTY(QCPAxis::ScaleType dataScaleType READ dataScaleType WRITE setDataScaleType NOTIFY dataScaleTypeChanged) Q_PROPERTY(QCPColorGradient gradient READ gradient WRITE setGradient NOTIFY gradientChanged) Q_PROPERTY(bool interpolate READ interpolate WRITE setInterpolate) Q_PROPERTY(bool tightBoundary READ tightBoundary WRITE setTightBoundary) Q_PROPERTY(QCPColorScale* colorScale READ colorScale WRITE setColorScale) /// \endcond public: explicit QCPColorMap(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPColorMap() Q_DECL_OVERRIDE; // getters: QCPColorMapData *data() const { return mMapData; } QCPRange dataRange() const { return mDataRange; } QCPAxis::ScaleType dataScaleType() const { return mDataScaleType; } bool interpolate() const { return mInterpolate; } bool tightBoundary() const { return mTightBoundary; } QCPColorGradient gradient() const { return mGradient; } QCPColorScale *colorScale() const { return mColorScale.data(); } // setters: void setData(QCPColorMapData *data, bool copy=false); Q_SLOT void setDataRange(const QCPRange &dataRange); Q_SLOT void setDataScaleType(QCPAxis::ScaleType scaleType); Q_SLOT void setGradient(const QCPColorGradient &gradient); void setInterpolate(bool enabled); void setTightBoundary(bool enabled); void setColorScale(QCPColorScale *colorScale); // non-property methods: void rescaleDataRange(bool recalculateDataBounds=false); Q_SLOT void updateLegendIcon(Qt::TransformationMode transformMode=Qt::SmoothTransformation, const QSize &thumbSize=QSize(32, 18)); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; signals: void dataRangeChanged(const QCPRange &newRange); void dataScaleTypeChanged(QCPAxis::ScaleType scaleType); void gradientChanged(const QCPColorGradient &newGradient); protected: // property members: QCPRange mDataRange; QCPAxis::ScaleType mDataScaleType; QCPColorMapData *mMapData; QCPColorGradient mGradient; bool mInterpolate; bool mTightBoundary; QPointer mColorScale; // non-property members: QImage mMapImage, mUndersampledMapImage; QPixmap mLegendIcon; bool mMapImageInvalidated; // introduced virtual methods: virtual void updateMapImage(); // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; friend class QCustomPlot; friend class QCPLegend; }; /* end of 'src/plottables/plottable-colormap.h' */ /* including file 'src/plottables/plottable-financial.h' */ /* modified 2021-03-29T02:30:44, size 8644 */ class QCP_LIB_DECL QCPFinancialData { public: QCPFinancialData(); QCPFinancialData(double key, double open, double high, double low, double close); inline double sortKey() const { return key; } inline static QCPFinancialData fromSortKey(double sortKey) { return QCPFinancialData(sortKey, 0, 0, 0, 0); } inline static bool sortKeyIsMainKey() { return true; } inline double mainKey() const { return key; } inline double mainValue() const { return open; } inline QCPRange valueRange() const { return QCPRange(low, high); } // open and close must lie between low and high, so we don't need to check them double key, open, high, low, close; }; Q_DECLARE_TYPEINFO(QCPFinancialData, Q_PRIMITIVE_TYPE); /*! \typedef QCPFinancialDataContainer Container for storing \ref QCPFinancialData points. The data is stored sorted by \a key. This template instantiation is the container in which QCPFinancial holds its data. For details about the generic container, see the documentation of the class template \ref QCPDataContainer. \see QCPFinancialData, QCPFinancial::setData */ typedef QCPDataContainer QCPFinancialDataContainer; class QCP_LIB_DECL QCPFinancial : public QCPAbstractPlottable1D { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(ChartStyle chartStyle READ chartStyle WRITE setChartStyle) Q_PROPERTY(double width READ width WRITE setWidth) Q_PROPERTY(WidthType widthType READ widthType WRITE setWidthType) Q_PROPERTY(bool twoColored READ twoColored WRITE setTwoColored) Q_PROPERTY(QBrush brushPositive READ brushPositive WRITE setBrushPositive) Q_PROPERTY(QBrush brushNegative READ brushNegative WRITE setBrushNegative) Q_PROPERTY(QPen penPositive READ penPositive WRITE setPenPositive) Q_PROPERTY(QPen penNegative READ penNegative WRITE setPenNegative) /// \endcond public: /*! Defines the ways the width of the financial bar can be specified. Thus it defines what the number passed to \ref setWidth actually means. \see setWidthType, setWidth */ enum WidthType { wtAbsolute ///< width is in absolute pixels ,wtAxisRectRatio ///< width is given by a fraction of the axis rect size ,wtPlotCoords ///< width is in key coordinates and thus scales with the key axis range }; Q_ENUMS(WidthType) /*! Defines the possible representations of OHLC data in the plot. \see setChartStyle */ enum ChartStyle { csOhlc ///< Open-High-Low-Close bar representation ,csCandlestick ///< Candlestick representation }; Q_ENUMS(ChartStyle) explicit QCPFinancial(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPFinancial() Q_DECL_OVERRIDE; // getters: QSharedPointer data() const { return mDataContainer; } ChartStyle chartStyle() const { return mChartStyle; } double width() const { return mWidth; } WidthType widthType() const { return mWidthType; } bool twoColored() const { return mTwoColored; } QBrush brushPositive() const { return mBrushPositive; } QBrush brushNegative() const { return mBrushNegative; } QPen penPositive() const { return mPenPositive; } QPen penNegative() const { return mPenNegative; } // setters: void setData(QSharedPointer data); void setData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted=false); void setChartStyle(ChartStyle style); void setWidth(double width); void setWidthType(WidthType widthType); void setTwoColored(bool twoColored); void setBrushPositive(const QBrush &brush); void setBrushNegative(const QBrush &brush); void setPenPositive(const QPen &pen); void setPenNegative(const QPen &pen); // non-property methods: void addData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted=false); void addData(double key, double open, double high, double low, double close); // reimplemented virtual methods: virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; // static methods: static QCPFinancialDataContainer timeSeriesToOhlc(const QVector &time, const QVector &value, double timeBinSize, double timeBinOffset = 0); protected: // property members: ChartStyle mChartStyle; double mWidth; WidthType mWidthType; bool mTwoColored; QBrush mBrushPositive, mBrushNegative; QPen mPenPositive, mPenNegative; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; // non-virtual methods: void drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected); void drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected); double getPixelWidth(double key, double keyPixel) const; double ohlcSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const; double candlestickSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const; void getVisibleDataBounds(QCPFinancialDataContainer::const_iterator &begin, QCPFinancialDataContainer::const_iterator &end) const; QRectF selectionHitBox(QCPFinancialDataContainer::const_iterator it) const; friend class QCustomPlot; friend class QCPLegend; }; Q_DECLARE_METATYPE(QCPFinancial::ChartStyle) /* end of 'src/plottables/plottable-financial.h' */ /* including file 'src/plottables/plottable-errorbar.h' */ /* modified 2021-03-29T02:30:44, size 7749 */ class QCP_LIB_DECL QCPErrorBarsData { public: QCPErrorBarsData(); explicit QCPErrorBarsData(double error); QCPErrorBarsData(double errorMinus, double errorPlus); double errorMinus, errorPlus; }; Q_DECLARE_TYPEINFO(QCPErrorBarsData, Q_PRIMITIVE_TYPE); /*! \typedef QCPErrorBarsDataContainer Container for storing \ref QCPErrorBarsData points. It is a typedef for QVector<\ref QCPErrorBarsData>. This is the container in which \ref QCPErrorBars holds its data. Unlike most other data containers for plottables, it is not based on \ref QCPDataContainer. This is because the error bars plottable is special in that it doesn't store its own key and value coordinate per error bar. It adopts the key and value from the plottable to which the error bars shall be applied (\ref QCPErrorBars::setDataPlottable). So the stored \ref QCPErrorBarsData doesn't need a sortable key, but merely an index (as \c QVector provides), which maps one-to-one to the indices of the other plottable's data. \see QCPErrorBarsData, QCPErrorBars::setData */ typedef QVector QCPErrorBarsDataContainer; class QCP_LIB_DECL QCPErrorBars : public QCPAbstractPlottable, public QCPPlottableInterface1D { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QSharedPointer data READ data WRITE setData) Q_PROPERTY(QCPAbstractPlottable* dataPlottable READ dataPlottable WRITE setDataPlottable) Q_PROPERTY(ErrorType errorType READ errorType WRITE setErrorType) Q_PROPERTY(double whiskerWidth READ whiskerWidth WRITE setWhiskerWidth) Q_PROPERTY(double symbolGap READ symbolGap WRITE setSymbolGap) /// \endcond public: /*! Defines in which orientation the error bars shall appear. If your data needs both error dimensions, create two \ref QCPErrorBars with different \ref ErrorType. \see setErrorType */ enum ErrorType { etKeyError ///< The errors are for the key dimension (bars appear parallel to the key axis) ,etValueError ///< The errors are for the value dimension (bars appear parallel to the value axis) }; Q_ENUMS(ErrorType) explicit QCPErrorBars(QCPAxis *keyAxis, QCPAxis *valueAxis); virtual ~QCPErrorBars() Q_DECL_OVERRIDE; // getters: QSharedPointer data() const { return mDataContainer; } QCPAbstractPlottable *dataPlottable() const { return mDataPlottable.data(); } ErrorType errorType() const { return mErrorType; } double whiskerWidth() const { return mWhiskerWidth; } double symbolGap() const { return mSymbolGap; } // setters: void setData(QSharedPointer data); void setData(const QVector &error); void setData(const QVector &errorMinus, const QVector &errorPlus); void setDataPlottable(QCPAbstractPlottable* plottable); void setErrorType(ErrorType type); void setWhiskerWidth(double pixels); void setSymbolGap(double pixels); // non-property methods: void addData(const QVector &error); void addData(const QVector &errorMinus, const QVector &errorPlus); void addData(double error); void addData(double errorMinus, double errorPlus); // virtual methods of 1d plottable interface: virtual int dataCount() const Q_DECL_OVERRIDE; virtual double dataMainKey(int index) const Q_DECL_OVERRIDE; virtual double dataSortKey(int index) const Q_DECL_OVERRIDE; virtual double dataMainValue(int index) const Q_DECL_OVERRIDE; virtual QCPRange dataValueRange(int index) const Q_DECL_OVERRIDE; virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; virtual bool sortKeyIsMainKey() const Q_DECL_OVERRIDE; virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; virtual int findBegin(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; virtual int findEnd(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; virtual QCPPlottableInterface1D *interface1D() Q_DECL_OVERRIDE { return this; } protected: // property members: QSharedPointer mDataContainer; QPointer mDataPlottable; ErrorType mErrorType; double mWhiskerWidth; double mSymbolGap; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; // non-virtual methods: void getErrorBarLines(QCPErrorBarsDataContainer::const_iterator it, QVector &backbones, QVector &whiskers) const; void getVisibleDataBounds(QCPErrorBarsDataContainer::const_iterator &begin, QCPErrorBarsDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; double pointDistance(const QPointF &pixelPoint, QCPErrorBarsDataContainer::const_iterator &closestData) const; // helpers: void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; bool errorBarVisible(int index) const; bool rectIntersectsLine(const QRectF &pixelRect, const QLineF &line) const; friend class QCustomPlot; friend class QCPLegend; }; /* end of 'src/plottables/plottable-errorbar.h' */ /* including file 'src/items/item-straightline.h' */ /* modified 2021-03-29T02:30:44, size 3137 */ class QCP_LIB_DECL QCPItemStraightLine : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) /// \endcond public: explicit QCPItemStraightLine(QCustomPlot *parentPlot); virtual ~QCPItemStraightLine() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const point1; QCPItemPosition * const point2; protected: // property members: QPen mPen, mSelectedPen; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // non-virtual methods: QLineF getRectClippedStraightLine(const QCPVector2D &base, const QCPVector2D &vec, const QRect &rect) const; QPen mainPen() const; }; /* end of 'src/items/item-straightline.h' */ /* including file 'src/items/item-line.h' */ /* modified 2021-03-29T02:30:44, size 3429 */ class QCP_LIB_DECL QCPItemLine : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(QCPLineEnding head READ head WRITE setHead) Q_PROPERTY(QCPLineEnding tail READ tail WRITE setTail) /// \endcond public: explicit QCPItemLine(QCustomPlot *parentPlot); virtual ~QCPItemLine() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } QCPLineEnding head() const { return mHead; } QCPLineEnding tail() const { return mTail; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setHead(const QCPLineEnding &head); void setTail(const QCPLineEnding &tail); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const start; QCPItemPosition * const end; protected: // property members: QPen mPen, mSelectedPen; QCPLineEnding mHead, mTail; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // non-virtual methods: QLineF getRectClippedLine(const QCPVector2D &start, const QCPVector2D &end, const QRect &rect) const; QPen mainPen() const; }; /* end of 'src/items/item-line.h' */ /* including file 'src/items/item-curve.h' */ /* modified 2021-03-29T02:30:44, size 3401 */ class QCP_LIB_DECL QCPItemCurve : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(QCPLineEnding head READ head WRITE setHead) Q_PROPERTY(QCPLineEnding tail READ tail WRITE setTail) /// \endcond public: explicit QCPItemCurve(QCustomPlot *parentPlot); virtual ~QCPItemCurve() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } QCPLineEnding head() const { return mHead; } QCPLineEnding tail() const { return mTail; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setHead(const QCPLineEnding &head); void setTail(const QCPLineEnding &tail); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const start; QCPItemPosition * const startDir; QCPItemPosition * const endDir; QCPItemPosition * const end; protected: // property members: QPen mPen, mSelectedPen; QCPLineEnding mHead, mTail; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // non-virtual methods: QPen mainPen() const; }; /* end of 'src/items/item-curve.h' */ /* including file 'src/items/item-rect.h' */ /* modified 2021-03-29T02:30:44, size 3710 */ class QCP_LIB_DECL QCPItemRect : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(QBrush brush READ brush WRITE setBrush) Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush) /// \endcond public: explicit QCPItemRect(QCustomPlot *parentPlot); virtual ~QCPItemRect() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } QBrush brush() const { return mBrush; } QBrush selectedBrush() const { return mSelectedBrush; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setBrush(const QBrush &brush); void setSelectedBrush(const QBrush &brush); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const topLeft; QCPItemPosition * const bottomRight; QCPItemAnchor * const top; QCPItemAnchor * const topRight; QCPItemAnchor * const right; QCPItemAnchor * const bottom; QCPItemAnchor * const bottomLeft; QCPItemAnchor * const left; protected: enum AnchorIndex {aiTop, aiTopRight, aiRight, aiBottom, aiBottomLeft, aiLeft}; // property members: QPen mPen, mSelectedPen; QBrush mBrush, mSelectedBrush; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; // non-virtual methods: QPen mainPen() const; QBrush mainBrush() const; }; /* end of 'src/items/item-rect.h' */ /* including file 'src/items/item-text.h' */ /* modified 2021-03-29T02:30:44, size 5576 */ class QCP_LIB_DECL QCPItemText : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QColor color READ color WRITE setColor) Q_PROPERTY(QColor selectedColor READ selectedColor WRITE setSelectedColor) Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(QBrush brush READ brush WRITE setBrush) Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush) Q_PROPERTY(QFont font READ font WRITE setFont) Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont) Q_PROPERTY(QString text READ text WRITE setText) Q_PROPERTY(Qt::Alignment positionAlignment READ positionAlignment WRITE setPositionAlignment) Q_PROPERTY(Qt::Alignment textAlignment READ textAlignment WRITE setTextAlignment) Q_PROPERTY(double rotation READ rotation WRITE setRotation) Q_PROPERTY(QMargins padding READ padding WRITE setPadding) /// \endcond public: explicit QCPItemText(QCustomPlot *parentPlot); virtual ~QCPItemText() Q_DECL_OVERRIDE; // getters: QColor color() const { return mColor; } QColor selectedColor() const { return mSelectedColor; } QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } QBrush brush() const { return mBrush; } QBrush selectedBrush() const { return mSelectedBrush; } QFont font() const { return mFont; } QFont selectedFont() const { return mSelectedFont; } QString text() const { return mText; } Qt::Alignment positionAlignment() const { return mPositionAlignment; } Qt::Alignment textAlignment() const { return mTextAlignment; } double rotation() const { return mRotation; } QMargins padding() const { return mPadding; } // setters; void setColor(const QColor &color); void setSelectedColor(const QColor &color); void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setBrush(const QBrush &brush); void setSelectedBrush(const QBrush &brush); void setFont(const QFont &font); void setSelectedFont(const QFont &font); void setText(const QString &text); void setPositionAlignment(Qt::Alignment alignment); void setTextAlignment(Qt::Alignment alignment); void setRotation(double degrees); void setPadding(const QMargins &padding); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const position; QCPItemAnchor * const topLeft; QCPItemAnchor * const top; QCPItemAnchor * const topRight; QCPItemAnchor * const right; QCPItemAnchor * const bottomRight; QCPItemAnchor * const bottom; QCPItemAnchor * const bottomLeft; QCPItemAnchor * const left; protected: enum AnchorIndex {aiTopLeft, aiTop, aiTopRight, aiRight, aiBottomRight, aiBottom, aiBottomLeft, aiLeft}; // property members: QColor mColor, mSelectedColor; QPen mPen, mSelectedPen; QBrush mBrush, mSelectedBrush; QFont mFont, mSelectedFont; QString mText; Qt::Alignment mPositionAlignment; Qt::Alignment mTextAlignment; double mRotation; QMargins mPadding; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; // non-virtual methods: QPointF getTextDrawPoint(const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const; QFont mainFont() const; QColor mainColor() const; QPen mainPen() const; QBrush mainBrush() const; }; /* end of 'src/items/item-text.h' */ /* including file 'src/items/item-ellipse.h' */ /* modified 2021-03-29T02:30:44, size 3890 */ class QCP_LIB_DECL QCPItemEllipse : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(QBrush brush READ brush WRITE setBrush) Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush) /// \endcond public: explicit QCPItemEllipse(QCustomPlot *parentPlot); virtual ~QCPItemEllipse() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } QBrush brush() const { return mBrush; } QBrush selectedBrush() const { return mSelectedBrush; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setBrush(const QBrush &brush); void setSelectedBrush(const QBrush &brush); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const topLeft; QCPItemPosition * const bottomRight; QCPItemAnchor * const topLeftRim; QCPItemAnchor * const top; QCPItemAnchor * const topRightRim; QCPItemAnchor * const right; QCPItemAnchor * const bottomRightRim; QCPItemAnchor * const bottom; QCPItemAnchor * const bottomLeftRim; QCPItemAnchor * const left; QCPItemAnchor * const center; protected: enum AnchorIndex {aiTopLeftRim, aiTop, aiTopRightRim, aiRight, aiBottomRightRim, aiBottom, aiBottomLeftRim, aiLeft, aiCenter}; // property members: QPen mPen, mSelectedPen; QBrush mBrush, mSelectedBrush; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; // non-virtual methods: QPen mainPen() const; QBrush mainBrush() const; }; /* end of 'src/items/item-ellipse.h' */ /* including file 'src/items/item-pixmap.h' */ /* modified 2021-03-29T02:30:44, size 4407 */ class QCP_LIB_DECL QCPItemPixmap : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPixmap pixmap READ pixmap WRITE setPixmap) Q_PROPERTY(bool scaled READ scaled WRITE setScaled) Q_PROPERTY(Qt::AspectRatioMode aspectRatioMode READ aspectRatioMode) Q_PROPERTY(Qt::TransformationMode transformationMode READ transformationMode) Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) /// \endcond public: explicit QCPItemPixmap(QCustomPlot *parentPlot); virtual ~QCPItemPixmap() Q_DECL_OVERRIDE; // getters: QPixmap pixmap() const { return mPixmap; } bool scaled() const { return mScaled; } Qt::AspectRatioMode aspectRatioMode() const { return mAspectRatioMode; } Qt::TransformationMode transformationMode() const { return mTransformationMode; } QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } // setters; void setPixmap(const QPixmap &pixmap); void setScaled(bool scaled, Qt::AspectRatioMode aspectRatioMode=Qt::KeepAspectRatio, Qt::TransformationMode transformationMode=Qt::SmoothTransformation); void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const topLeft; QCPItemPosition * const bottomRight; QCPItemAnchor * const top; QCPItemAnchor * const topRight; QCPItemAnchor * const right; QCPItemAnchor * const bottom; QCPItemAnchor * const bottomLeft; QCPItemAnchor * const left; protected: enum AnchorIndex {aiTop, aiTopRight, aiRight, aiBottom, aiBottomLeft, aiLeft}; // property members: QPixmap mPixmap; QPixmap mScaledPixmap; bool mScaled; bool mScaledPixmapInvalidated; Qt::AspectRatioMode mAspectRatioMode; Qt::TransformationMode mTransformationMode; QPen mPen, mSelectedPen; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; // non-virtual methods: void updateScaledPixmap(QRect finalRect=QRect(), bool flipHorz=false, bool flipVert=false); QRect getFinalRect(bool *flippedHorz=nullptr, bool *flippedVert=nullptr) const; QPen mainPen() const; }; /* end of 'src/items/item-pixmap.h' */ /* including file 'src/items/item-tracer.h' */ /* modified 2021-03-29T02:30:44, size 4811 */ class QCP_LIB_DECL QCPItemTracer : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(QBrush brush READ brush WRITE setBrush) Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush) Q_PROPERTY(double size READ size WRITE setSize) Q_PROPERTY(TracerStyle style READ style WRITE setStyle) Q_PROPERTY(QCPGraph* graph READ graph WRITE setGraph) Q_PROPERTY(double graphKey READ graphKey WRITE setGraphKey) Q_PROPERTY(bool interpolating READ interpolating WRITE setInterpolating) /// \endcond public: /*! The different visual appearances a tracer item can have. Some styles size may be controlled with \ref setSize. \see setStyle */ enum TracerStyle { tsNone ///< The tracer is not visible ,tsPlus ///< A plus shaped crosshair with limited size ,tsCrosshair ///< A plus shaped crosshair which spans the complete axis rect ,tsCircle ///< A circle ,tsSquare ///< A square }; Q_ENUMS(TracerStyle) explicit QCPItemTracer(QCustomPlot *parentPlot); virtual ~QCPItemTracer() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } QBrush brush() const { return mBrush; } QBrush selectedBrush() const { return mSelectedBrush; } double size() const { return mSize; } TracerStyle style() const { return mStyle; } QCPGraph *graph() const { return mGraph; } double graphKey() const { return mGraphKey; } bool interpolating() const { return mInterpolating; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setBrush(const QBrush &brush); void setSelectedBrush(const QBrush &brush); void setSize(double size); void setStyle(TracerStyle style); void setGraph(QCPGraph *graph); void setGraphKey(double key); void setInterpolating(bool enabled); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; // non-virtual methods: void updatePosition(); QCPItemPosition * const position; protected: // property members: QPen mPen, mSelectedPen; QBrush mBrush, mSelectedBrush; double mSize; TracerStyle mStyle; QCPGraph *mGraph; double mGraphKey; bool mInterpolating; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // non-virtual methods: QPen mainPen() const; QBrush mainBrush() const; }; Q_DECLARE_METATYPE(QCPItemTracer::TracerStyle) /* end of 'src/items/item-tracer.h' */ /* including file 'src/items/item-bracket.h' */ /* modified 2021-03-29T02:30:44, size 3991 */ class QCP_LIB_DECL QCPItemBracket : public QCPAbstractItem { Q_OBJECT /// \cond INCLUDE_QPROPERTIES Q_PROPERTY(QPen pen READ pen WRITE setPen) Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen) Q_PROPERTY(double length READ length WRITE setLength) Q_PROPERTY(BracketStyle style READ style WRITE setStyle) /// \endcond public: /*! Defines the various visual shapes of the bracket item. The appearance can be further modified by \ref setLength and \ref setPen. \see setStyle */ enum BracketStyle { bsSquare ///< A brace with angled edges ,bsRound ///< A brace with round edges ,bsCurly ///< A curly brace ,bsCalligraphic ///< A curly brace with varying stroke width giving a calligraphic impression }; Q_ENUMS(BracketStyle) explicit QCPItemBracket(QCustomPlot *parentPlot); virtual ~QCPItemBracket() Q_DECL_OVERRIDE; // getters: QPen pen() const { return mPen; } QPen selectedPen() const { return mSelectedPen; } double length() const { return mLength; } BracketStyle style() const { return mStyle; } // setters; void setPen(const QPen &pen); void setSelectedPen(const QPen &pen); void setLength(double length); void setStyle(BracketStyle style); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; QCPItemPosition * const left; QCPItemPosition * const right; QCPItemAnchor * const center; protected: // property members: enum AnchorIndex {aiCenter}; QPen mPen, mSelectedPen; double mLength; BracketStyle mStyle; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; // non-virtual methods: QPen mainPen() const; }; Q_DECLARE_METATYPE(QCPItemBracket::BracketStyle) /* end of 'src/items/item-bracket.h' */ /* including file 'src/polar/radialaxis.h' */ /* modified 2021-03-29T02:30:44, size 12227 */ class QCP_LIB_DECL QCPPolarAxisRadial : public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES /// \endcond public: /*! Defines the reference of the angle at which a radial axis is tilted (\ref setAngle). */ enum AngleReference { arAbsolute ///< The axis tilt is given in absolute degrees. The zero is to the right and positive angles are measured counter-clockwise. ,arAngularAxis ///< The axis tilt is measured in the angular coordinate system given by the parent angular axis. }; Q_ENUMS(AngleReference) /*! Defines the scale of an axis. \see setScaleType */ enum ScaleType { stLinear ///< Linear scaling ,stLogarithmic ///< Logarithmic scaling with correspondingly transformed axis coordinates (possibly also \ref setTicker to a \ref QCPAxisTickerLog instance). }; Q_ENUMS(ScaleType) /*! Defines the selectable parts of an axis. \see setSelectableParts, setSelectedParts */ enum SelectablePart { spNone = 0 ///< None of the selectable parts ,spAxis = 0x001 ///< The axis backbone and tick marks ,spTickLabels = 0x002 ///< Tick labels (numbers) of this axis (as a whole, not individually) ,spAxisLabel = 0x004 ///< The axis label }; Q_ENUMS(SelectablePart) Q_FLAGS(SelectableParts) Q_DECLARE_FLAGS(SelectableParts, SelectablePart) enum LabelMode { lmUpright ///< ,lmRotated ///< }; Q_ENUMS(LabelMode) explicit QCPPolarAxisRadial(QCPPolarAxisAngular *parent); virtual ~QCPPolarAxisRadial(); // getters: bool rangeDrag() const { return mRangeDrag; } bool rangeZoom() const { return mRangeZoom; } double rangeZoomFactor() const { return mRangeZoomFactor; } QCPPolarAxisAngular *angularAxis() const { return mAngularAxis; } ScaleType scaleType() const { return mScaleType; } const QCPRange range() const { return mRange; } bool rangeReversed() const { return mRangeReversed; } double angle() const { return mAngle; } AngleReference angleReference() const { return mAngleReference; } QSharedPointer ticker() const { return mTicker; } bool ticks() const { return mTicks; } bool tickLabels() const { return mTickLabels; } int tickLabelPadding() const { return mLabelPainter.padding(); } QFont tickLabelFont() const { return mTickLabelFont; } QColor tickLabelColor() const { return mTickLabelColor; } double tickLabelRotation() const { return mLabelPainter.rotation(); } LabelMode tickLabelMode() const; QString numberFormat() const; int numberPrecision() const { return mNumberPrecision; } QVector tickVector() const { return mTickVector; } QVector subTickVector() const { return mSubTickVector; } QVector tickVectorLabels() const { return mTickVectorLabels; } int tickLengthIn() const; int tickLengthOut() const; bool subTicks() const { return mSubTicks; } int subTickLengthIn() const; int subTickLengthOut() const; QPen basePen() const { return mBasePen; } QPen tickPen() const { return mTickPen; } QPen subTickPen() const { return mSubTickPen; } QFont labelFont() const { return mLabelFont; } QColor labelColor() const { return mLabelColor; } QString label() const { return mLabel; } int labelPadding() const; SelectableParts selectedParts() const { return mSelectedParts; } SelectableParts selectableParts() const { return mSelectableParts; } QFont selectedTickLabelFont() const { return mSelectedTickLabelFont; } QFont selectedLabelFont() const { return mSelectedLabelFont; } QColor selectedTickLabelColor() const { return mSelectedTickLabelColor; } QColor selectedLabelColor() const { return mSelectedLabelColor; } QPen selectedBasePen() const { return mSelectedBasePen; } QPen selectedTickPen() const { return mSelectedTickPen; } QPen selectedSubTickPen() const { return mSelectedSubTickPen; } // setters: void setRangeDrag(bool enabled); void setRangeZoom(bool enabled); void setRangeZoomFactor(double factor); Q_SLOT void setScaleType(QCPPolarAxisRadial::ScaleType type); Q_SLOT void setRange(const QCPRange &range); void setRange(double lower, double upper); void setRange(double position, double size, Qt::AlignmentFlag alignment); void setRangeLower(double lower); void setRangeUpper(double upper); void setRangeReversed(bool reversed); void setAngle(double degrees); void setAngleReference(AngleReference reference); void setTicker(QSharedPointer ticker); void setTicks(bool show); void setTickLabels(bool show); void setTickLabelPadding(int padding); void setTickLabelFont(const QFont &font); void setTickLabelColor(const QColor &color); void setTickLabelRotation(double degrees); void setTickLabelMode(LabelMode mode); void setNumberFormat(const QString &formatCode); void setNumberPrecision(int precision); void setTickLength(int inside, int outside=0); void setTickLengthIn(int inside); void setTickLengthOut(int outside); void setSubTicks(bool show); void setSubTickLength(int inside, int outside=0); void setSubTickLengthIn(int inside); void setSubTickLengthOut(int outside); void setBasePen(const QPen &pen); void setTickPen(const QPen &pen); void setSubTickPen(const QPen &pen); void setLabelFont(const QFont &font); void setLabelColor(const QColor &color); void setLabel(const QString &str); void setLabelPadding(int padding); void setSelectedTickLabelFont(const QFont &font); void setSelectedLabelFont(const QFont &font); void setSelectedTickLabelColor(const QColor &color); void setSelectedLabelColor(const QColor &color); void setSelectedBasePen(const QPen &pen); void setSelectedTickPen(const QPen &pen); void setSelectedSubTickPen(const QPen &pen); Q_SLOT void setSelectableParts(const QCPPolarAxisRadial::SelectableParts &selectableParts); Q_SLOT void setSelectedParts(const QCPPolarAxisRadial::SelectableParts &selectedParts); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; // non-property methods: void moveRange(double diff); void scaleRange(double factor); void scaleRange(double factor, double center); void rescale(bool onlyVisiblePlottables=false); void pixelToCoord(QPointF pixelPos, double &angleCoord, double &radiusCoord) const; QPointF coordToPixel(double angleCoord, double radiusCoord) const; double coordToRadius(double coord) const; double radiusToCoord(double radius) const; SelectablePart getPartAt(const QPointF &pos) const; signals: void rangeChanged(const QCPRange &newRange); void rangeChanged(const QCPRange &newRange, const QCPRange &oldRange); void scaleTypeChanged(QCPPolarAxisRadial::ScaleType scaleType); void selectionChanged(const QCPPolarAxisRadial::SelectableParts &parts); void selectableChanged(const QCPPolarAxisRadial::SelectableParts &parts); protected: // property members: bool mRangeDrag; bool mRangeZoom; double mRangeZoomFactor; // axis base: QCPPolarAxisAngular *mAngularAxis; double mAngle; AngleReference mAngleReference; SelectableParts mSelectableParts, mSelectedParts; QPen mBasePen, mSelectedBasePen; // axis label: int mLabelPadding; QString mLabel; QFont mLabelFont, mSelectedLabelFont; QColor mLabelColor, mSelectedLabelColor; // tick labels: //int mTickLabelPadding; in label painter bool mTickLabels; //double mTickLabelRotation; in label painter QFont mTickLabelFont, mSelectedTickLabelFont; QColor mTickLabelColor, mSelectedTickLabelColor; int mNumberPrecision; QLatin1Char mNumberFormatChar; bool mNumberBeautifulPowers; bool mNumberMultiplyCross; // ticks and subticks: bool mTicks; bool mSubTicks; int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; QPen mTickPen, mSelectedTickPen; QPen mSubTickPen, mSelectedSubTickPen; // scale and range: QCPRange mRange; bool mRangeReversed; ScaleType mScaleType; // non-property members: QPointF mCenter; double mRadius; QSharedPointer mTicker; QVector mTickVector; QVector mTickVectorLabels; QVector mSubTickVector; bool mDragging; QCPRange mDragStartRange; QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; QCPLabelPainterPrivate mLabelPainter; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; // mouse events: virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; // non-virtual methods: void updateGeometry(const QPointF ¢er, double radius); void setupTickVectors(); QPen getBasePen() const; QPen getTickPen() const; QPen getSubTickPen() const; QFont getTickLabelFont() const; QFont getLabelFont() const; QColor getTickLabelColor() const; QColor getLabelColor() const; private: Q_DISABLE_COPY(QCPPolarAxisRadial) friend class QCustomPlot; friend class QCPPolarAxisAngular; }; Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPolarAxisRadial::SelectableParts) Q_DECLARE_METATYPE(QCPPolarAxisRadial::AngleReference) Q_DECLARE_METATYPE(QCPPolarAxisRadial::ScaleType) Q_DECLARE_METATYPE(QCPPolarAxisRadial::SelectablePart) /* end of 'src/polar/radialaxis.h' */ /* including file 'src/polar/layoutelement-angularaxis.h' */ /* modified 2021-03-29T02:30:44, size 13461 */ class QCP_LIB_DECL QCPPolarAxisAngular : public QCPLayoutElement { Q_OBJECT /// \cond INCLUDE_QPROPERTIES /// \endcond public: /*! Defines the selectable parts of an axis. \see setSelectableParts, setSelectedParts */ enum SelectablePart { spNone = 0 ///< None of the selectable parts ,spAxis = 0x001 ///< The axis backbone and tick marks ,spTickLabels = 0x002 ///< Tick labels (numbers) of this axis (as a whole, not individually) ,spAxisLabel = 0x004 ///< The axis label }; Q_ENUMS(SelectablePart) Q_FLAGS(SelectableParts) Q_DECLARE_FLAGS(SelectableParts, SelectablePart) /*! TODO */ enum LabelMode { lmUpright ///< ,lmRotated ///< }; Q_ENUMS(LabelMode) explicit QCPPolarAxisAngular(QCustomPlot *parentPlot); virtual ~QCPPolarAxisAngular(); // getters: QPixmap background() const { return mBackgroundPixmap; } QBrush backgroundBrush() const { return mBackgroundBrush; } bool backgroundScaled() const { return mBackgroundScaled; } Qt::AspectRatioMode backgroundScaledMode() const { return mBackgroundScaledMode; } bool rangeDrag() const { return mRangeDrag; } bool rangeZoom() const { return mRangeZoom; } double rangeZoomFactor() const { return mRangeZoomFactor; } const QCPRange range() const { return mRange; } bool rangeReversed() const { return mRangeReversed; } double angle() const { return mAngle; } QSharedPointer ticker() const { return mTicker; } bool ticks() const { return mTicks; } bool tickLabels() const { return mTickLabels; } int tickLabelPadding() const { return mLabelPainter.padding(); } QFont tickLabelFont() const { return mTickLabelFont; } QColor tickLabelColor() const { return mTickLabelColor; } double tickLabelRotation() const { return mLabelPainter.rotation(); } LabelMode tickLabelMode() const; QString numberFormat() const; int numberPrecision() const { return mNumberPrecision; } QVector tickVector() const { return mTickVector; } QVector tickVectorLabels() const { return mTickVectorLabels; } int tickLengthIn() const { return mTickLengthIn; } int tickLengthOut() const { return mTickLengthOut; } bool subTicks() const { return mSubTicks; } int subTickLengthIn() const { return mSubTickLengthIn; } int subTickLengthOut() const { return mSubTickLengthOut; } QPen basePen() const { return mBasePen; } QPen tickPen() const { return mTickPen; } QPen subTickPen() const { return mSubTickPen; } QFont labelFont() const { return mLabelFont; } QColor labelColor() const { return mLabelColor; } QString label() const { return mLabel; } int labelPadding() const { return mLabelPadding; } SelectableParts selectedParts() const { return mSelectedParts; } SelectableParts selectableParts() const { return mSelectableParts; } QFont selectedTickLabelFont() const { return mSelectedTickLabelFont; } QFont selectedLabelFont() const { return mSelectedLabelFont; } QColor selectedTickLabelColor() const { return mSelectedTickLabelColor; } QColor selectedLabelColor() const { return mSelectedLabelColor; } QPen selectedBasePen() const { return mSelectedBasePen; } QPen selectedTickPen() const { return mSelectedTickPen; } QPen selectedSubTickPen() const { return mSelectedSubTickPen; } QCPPolarGrid *grid() const { return mGrid; } // setters: void setBackground(const QPixmap &pm); void setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding); void setBackground(const QBrush &brush); void setBackgroundScaled(bool scaled); void setBackgroundScaledMode(Qt::AspectRatioMode mode); void setRangeDrag(bool enabled); void setRangeZoom(bool enabled); void setRangeZoomFactor(double factor); Q_SLOT void setRange(const QCPRange &range); void setRange(double lower, double upper); void setRange(double position, double size, Qt::AlignmentFlag alignment); void setRangeLower(double lower); void setRangeUpper(double upper); void setRangeReversed(bool reversed); void setAngle(double degrees); void setTicker(QSharedPointer ticker); void setTicks(bool show); void setTickLabels(bool show); void setTickLabelPadding(int padding); void setTickLabelFont(const QFont &font); void setTickLabelColor(const QColor &color); void setTickLabelRotation(double degrees); void setTickLabelMode(LabelMode mode); void setNumberFormat(const QString &formatCode); void setNumberPrecision(int precision); void setTickLength(int inside, int outside=0); void setTickLengthIn(int inside); void setTickLengthOut(int outside); void setSubTicks(bool show); void setSubTickLength(int inside, int outside=0); void setSubTickLengthIn(int inside); void setSubTickLengthOut(int outside); void setBasePen(const QPen &pen); void setTickPen(const QPen &pen); void setSubTickPen(const QPen &pen); void setLabelFont(const QFont &font); void setLabelColor(const QColor &color); void setLabel(const QString &str); void setLabelPadding(int padding); void setLabelPosition(Qt::AlignmentFlag position); void setSelectedTickLabelFont(const QFont &font); void setSelectedLabelFont(const QFont &font); void setSelectedTickLabelColor(const QColor &color); void setSelectedLabelColor(const QColor &color); void setSelectedBasePen(const QPen &pen); void setSelectedTickPen(const QPen &pen); void setSelectedSubTickPen(const QPen &pen); Q_SLOT void setSelectableParts(const QCPPolarAxisAngular::SelectableParts &selectableParts); Q_SLOT void setSelectedParts(const QCPPolarAxisAngular::SelectableParts &selectedParts); // reimplemented virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; // non-property methods: bool removeGraph(QCPPolarGraph *graph); int radialAxisCount() const; QCPPolarAxisRadial *radialAxis(int index=0) const; QList radialAxes() const; QCPPolarAxisRadial *addRadialAxis(QCPPolarAxisRadial *axis=0); bool removeRadialAxis(QCPPolarAxisRadial *axis); QCPLayoutInset *insetLayout() const { return mInsetLayout; } QRegion exactClipRegion() const; void moveRange(double diff); void scaleRange(double factor); void scaleRange(double factor, double center); void rescale(bool onlyVisiblePlottables=false); double coordToAngleRad(double coord) const { return mAngleRad+(coord-mRange.lower)/mRange.size()*(mRangeReversed ? -2.0*M_PI : 2.0*M_PI); } // mention in doc that return doesn't wrap double angleRadToCoord(double angleRad) const { return mRange.lower+(angleRad-mAngleRad)/(mRangeReversed ? -2.0*M_PI : 2.0*M_PI)*mRange.size(); } void pixelToCoord(QPointF pixelPos, double &angleCoord, double &radiusCoord) const; QPointF coordToPixel(double angleCoord, double radiusCoord) const; SelectablePart getPartAt(const QPointF &pos) const; // read-only interface imitating a QRect: int left() const { return mRect.left(); } int right() const { return mRect.right(); } int top() const { return mRect.top(); } int bottom() const { return mRect.bottom(); } int width() const { return mRect.width(); } int height() const { return mRect.height(); } QSize size() const { return mRect.size(); } QPoint topLeft() const { return mRect.topLeft(); } QPoint topRight() const { return mRect.topRight(); } QPoint bottomLeft() const { return mRect.bottomLeft(); } QPoint bottomRight() const { return mRect.bottomRight(); } QPointF center() const { return mCenter; } double radius() const { return mRadius; } signals: void rangeChanged(const QCPRange &newRange); void rangeChanged(const QCPRange &newRange, const QCPRange &oldRange); void selectionChanged(const QCPPolarAxisAngular::SelectableParts &parts); void selectableChanged(const QCPPolarAxisAngular::SelectableParts &parts); protected: // property members: QBrush mBackgroundBrush; QPixmap mBackgroundPixmap; QPixmap mScaledBackgroundPixmap; bool mBackgroundScaled; Qt::AspectRatioMode mBackgroundScaledMode; QCPLayoutInset *mInsetLayout; bool mRangeDrag; bool mRangeZoom; double mRangeZoomFactor; // axis base: double mAngle, mAngleRad; SelectableParts mSelectableParts, mSelectedParts; QPen mBasePen, mSelectedBasePen; // axis label: int mLabelPadding; QString mLabel; QFont mLabelFont, mSelectedLabelFont; QColor mLabelColor, mSelectedLabelColor; // tick labels: //int mTickLabelPadding; in label painter bool mTickLabels; //double mTickLabelRotation; in label painter QFont mTickLabelFont, mSelectedTickLabelFont; QColor mTickLabelColor, mSelectedTickLabelColor; int mNumberPrecision; QLatin1Char mNumberFormatChar; bool mNumberBeautifulPowers; bool mNumberMultiplyCross; // ticks and subticks: bool mTicks; bool mSubTicks; int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; QPen mTickPen, mSelectedTickPen; QPen mSubTickPen, mSelectedSubTickPen; // scale and range: QCPRange mRange; bool mRangeReversed; // non-property members: QPointF mCenter; double mRadius; QList mRadialAxes; QCPPolarGrid *mGrid; QList mGraphs; QSharedPointer mTicker; QVector mTickVector; QVector mTickVectorLabels; QVector mTickVectorCosSin; QVector mSubTickVector; QVector mSubTickVectorCosSin; bool mDragging; QCPRange mDragAngularStart; QList mDragRadialStart; QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; QCPLabelPainterPrivate mLabelPainter; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; // events: virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; // non-virtual methods: bool registerPolarGraph(QCPPolarGraph *graph); void drawBackground(QCPPainter *painter, const QPointF ¢er, double radius); void setupTickVectors(); QPen getBasePen() const; QPen getTickPen() const; QPen getSubTickPen() const; QFont getTickLabelFont() const; QFont getLabelFont() const; QColor getTickLabelColor() const; QColor getLabelColor() const; private: Q_DISABLE_COPY(QCPPolarAxisAngular) friend class QCustomPlot; friend class QCPPolarGrid; friend class QCPPolarGraph; }; Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPolarAxisAngular::SelectableParts) Q_DECLARE_METATYPE(QCPPolarAxisAngular::SelectablePart) /* end of 'src/polar/layoutelement-angularaxis.h' */ /* including file 'src/polar/polargrid.h' */ /* modified 2021-03-29T02:30:44, size 4506 */ class QCP_LIB_DECL QCPPolarGrid :public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES /// \endcond public: /*! TODO */ enum GridType { gtAngular = 0x01 ///< ,gtRadial = 0x02 ///< ,gtAll = 0xFF ///< ,gtNone = 0x00 ///< }; Q_ENUMS(GridType) Q_FLAGS(GridTypes) Q_DECLARE_FLAGS(GridTypes, GridType) explicit QCPPolarGrid(QCPPolarAxisAngular *parentAxis); // getters: QCPPolarAxisRadial *radialAxis() const { return mRadialAxis.data(); } GridTypes type() const { return mType; } GridTypes subGridType() const { return mSubGridType; } bool antialiasedSubGrid() const { return mAntialiasedSubGrid; } bool antialiasedZeroLine() const { return mAntialiasedZeroLine; } QPen angularPen() const { return mAngularPen; } QPen angularSubGridPen() const { return mAngularSubGridPen; } QPen radialPen() const { return mRadialPen; } QPen radialSubGridPen() const { return mRadialSubGridPen; } QPen radialZeroLinePen() const { return mRadialZeroLinePen; } // setters: void setRadialAxis(QCPPolarAxisRadial *axis); void setType(GridTypes type); void setSubGridType(GridTypes type); void setAntialiasedSubGrid(bool enabled); void setAntialiasedZeroLine(bool enabled); void setAngularPen(const QPen &pen); void setAngularSubGridPen(const QPen &pen); void setRadialPen(const QPen &pen); void setRadialSubGridPen(const QPen &pen); void setRadialZeroLinePen(const QPen &pen); protected: // property members: GridTypes mType; GridTypes mSubGridType; bool mAntialiasedSubGrid, mAntialiasedZeroLine; QPen mAngularPen, mAngularSubGridPen; QPen mRadialPen, mRadialSubGridPen, mRadialZeroLinePen; // non-property members: QCPPolarAxisAngular *mParentAxis; QPointer mRadialAxis; // reimplemented virtual methods: virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; // non-virtual methods: void drawRadialGrid(QCPPainter *painter, const QPointF ¢er, const QVector &coords, const QPen &pen, const QPen &zeroPen=Qt::NoPen); void drawAngularGrid(QCPPainter *painter, const QPointF ¢er, double radius, const QVector &ticksCosSin, const QPen &pen); private: Q_DISABLE_COPY(QCPPolarGrid) }; Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPolarGrid::GridTypes) Q_DECLARE_METATYPE(QCPPolarGrid::GridType) /* end of 'src/polar/polargrid.h' */ /* including file 'src/polar/polargraph.h' */ /* modified 2021-03-29T02:30:44, size 9606 */ class QCP_LIB_DECL QCPPolarLegendItem : public QCPAbstractLegendItem { Q_OBJECT public: QCPPolarLegendItem(QCPLegend *parent, QCPPolarGraph *graph); // getters: QCPPolarGraph *polarGraph() { return mPolarGraph; } protected: // property members: QCPPolarGraph *mPolarGraph; // reimplemented virtual methods: virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; // non-virtual methods: QPen getIconBorderPen() const; QColor getTextColor() const; QFont getFont() const; }; class QCP_LIB_DECL QCPPolarGraph : public QCPLayerable { Q_OBJECT /// \cond INCLUDE_QPROPERTIES /// \endcond public: /*! Defines how the graph's line is represented visually in the plot. The line is drawn with the current pen of the graph (\ref setPen). \see setLineStyle */ enum LineStyle { lsNone ///< data points are not connected with any lines (e.g. data only represented ///< with symbols according to the scatter style, see \ref setScatterStyle) ,lsLine ///< data points are connected by a straight line }; Q_ENUMS(LineStyle) QCPPolarGraph(QCPPolarAxisAngular *keyAxis, QCPPolarAxisRadial *valueAxis); virtual ~QCPPolarGraph(); // getters: QString name() const { return mName; } bool antialiasedFill() const { return mAntialiasedFill; } bool antialiasedScatters() const { return mAntialiasedScatters; } QPen pen() const { return mPen; } QBrush brush() const { return mBrush; } bool periodic() const { return mPeriodic; } QCPPolarAxisAngular *keyAxis() const { return mKeyAxis.data(); } QCPPolarAxisRadial *valueAxis() const { return mValueAxis.data(); } QCP::SelectionType selectable() const { return mSelectable; } bool selected() const { return !mSelection.isEmpty(); } QCPDataSelection selection() const { return mSelection; } //QCPSelectionDecorator *selectionDecorator() const { return mSelectionDecorator; } QSharedPointer data() const { return mDataContainer; } LineStyle lineStyle() const { return mLineStyle; } QCPScatterStyle scatterStyle() const { return mScatterStyle; } // setters: void setName(const QString &name); void setAntialiasedFill(bool enabled); void setAntialiasedScatters(bool enabled); void setPen(const QPen &pen); void setBrush(const QBrush &brush); void setPeriodic(bool enabled); void setKeyAxis(QCPPolarAxisAngular *axis); void setValueAxis(QCPPolarAxisRadial *axis); Q_SLOT void setSelectable(QCP::SelectionType selectable); Q_SLOT void setSelection(QCPDataSelection selection); //void setSelectionDecorator(QCPSelectionDecorator *decorator); void setData(QSharedPointer data); void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); void setLineStyle(LineStyle ls); void setScatterStyle(const QCPScatterStyle &style); // non-property methods: void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); void addData(double key, double value); void coordsToPixels(double key, double value, double &x, double &y) const; const QPointF coordsToPixels(double key, double value) const; void pixelsToCoords(double x, double y, double &key, double &value) const; void pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const; void rescaleAxes(bool onlyEnlarge=false) const; void rescaleKeyAxis(bool onlyEnlarge=false) const; void rescaleValueAxis(bool onlyEnlarge=false, bool inKeyRange=false) const; bool addToLegend(QCPLegend *legend); bool addToLegend(); bool removeFromLegend(QCPLegend *legend) const; bool removeFromLegend() const; // introduced virtual methods: virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const; // actually introduced in QCPLayerable as non-pure, but we want to force reimplementation for plottables virtual QCPPlottableInterface1D *interface1D() { return 0; } // TODO: return this later, when QCPAbstractPolarPlottable is created virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const; virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const; signals: void selectionChanged(bool selected); void selectionChanged(const QCPDataSelection &selection); void selectableChanged(QCP::SelectionType selectable); protected: // property members: QSharedPointer mDataContainer; LineStyle mLineStyle; QCPScatterStyle mScatterStyle; QString mName; bool mAntialiasedFill, mAntialiasedScatters; QPen mPen; QBrush mBrush; bool mPeriodic; QPointer mKeyAxis; QPointer mValueAxis; QCP::SelectionType mSelectable; QCPDataSelection mSelection; //QCPSelectionDecorator *mSelectionDecorator; // introduced virtual methods (later reimplemented TODO from QCPAbstractPolarPlottable): virtual QRect clipRect() const; virtual void draw(QCPPainter *painter); virtual QCP::Interaction selectionCategory() const; void applyDefaultAntialiasingHint(QCPPainter *painter) const; // events: virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged); virtual void deselectEvent(bool *selectionStateChanged); // virtual drawing helpers: virtual void drawLinePlot(QCPPainter *painter, const QVector &lines) const; virtual void drawFill(QCPPainter *painter, QVector *lines) const; virtual void drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const; // introduced virtual methods: virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const; // non-virtual methods: void applyFillAntialiasingHint(QCPPainter *painter) const; void applyScattersAntialiasingHint(QCPPainter *painter) const; double pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const; // drawing helpers: virtual int dataCount() const; void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; void drawPolyline(QCPPainter *painter, const QVector &lineData) const; void getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; void getLines(QVector *lines, const QCPDataRange &dataRange) const; void getScatters(QVector *scatters, const QCPDataRange &dataRange) const; void getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const; void getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const; QVector dataToLines(const QVector &data) const; private: Q_DISABLE_COPY(QCPPolarGraph) friend class QCPPolarLegendItem; }; /* end of 'src/polar/polargraph.h' */ #endif // QCUSTOMPLOT_H